Empowering seamless management for your business success
A modern Point of Sale system built with Spring Boot

Tech Stack

Built With

---

Table of Contents

• Overview
• Getting Started
• Prerequisites
• Installation
• Database Setup
• Usage
• Testing

---

Overview

iOne is a powerful Point of Sale system built with Spring Boot that streamlines inventory and customer management.

Why iOne?

This project provides a complete POS solution with modern web technologies. Key features include:

• 🎨 Spring Boot Backend: Robust Java backend with Spring MVC architecture
• 📊 Thymeleaf Templates: Dynamic server-side rendering for all views
• 🖥️ Modern UI: Clean responsive interface built with Bootstrap 5
• 🔍 Enhanced UX: Select2 for advanced dropdown functionality
• 🔒 Data Management: JPA repositories for efficient database operations
• ✅ Testing: Comprehensive test coverage including integration tests

---

Getting Started

Demo

Dashboard (Placing Orders)

iOne.Dashboard.mp4

Navigation

nav2.mp4

Prerequisites

• Java JDK 17+ (21 is used here)
• Maven 3.8+
• MySQL 8.0+ (or your preferred database)

Installation

1. Clone the repository:

git clone https://github.com/Nethwindu/iOne

2. Navigate to the project directory:

cd iOne

3. Configure the database:

Edit src/main/resources/application.properties with your MySQL credentials:

spring.datasource.url=jdbc:mysql://localhost:3306/your_database
spring.datasource.username=your_username
spring.datasource.password=your_password

4. Import sample database (optional but recommended):

The folder db/ contains an SQL dump file ione_backup.sql with pre-configured tables and sample data.

To import:

mysql -u root -p ione < db/ione_backup.sql

5. Build the project:

mvn clean install

---

Database Setup

This project includes a pre-exported database structure and demo data.

SQL Dump Location

• File: db/ione_backup.sql

Steps to Import

1. Create the database (if not already):

CREATE DATABASE ione;

2. Import the SQL dump:

mysql -u root -p ione < db/ione_backup.sql

3. Ensure your application connects to this database by updating the credentials in application.properties.

---

Usage

Run the application:

mvn spring-boot:run

Then visit:

http://localhost:8080/invoice

---

Testing

Run all tests:

mvn test

---

⬆ Return to top