https://github.com/jlokitha/pos-system-backend-v2

The POS System Backend is a comprehensive RESTful service designed for efficient management of customer, item, and order data, built using Spring and MySQL. It facilitates robust CRUD operations, order processing, and integrates profile picture handling for enhanced user experience.
https://github.com/jlokitha/pos-system-backend-v2

logging mysql pos-system postman-collection rest rest-api restful-api spring spring-data-jpa spring-web-mvc tomcat-server

Last synced: about 1 year ago
JSON representation

Host: GitHub
URL: https://github.com/jlokitha/pos-system-backend-v2
Owner: jlokitha
License: mit
Created: 2024-10-11T05:44:48.000Z (over 1 year ago)
Default Branch: main
Last Pushed: 2024-10-16T10:22:08.000Z (over 1 year ago)
Last Synced: 2025-04-30T16:06:09.479Z (about 1 year ago)
Topics: logging, mysql, pos-system, postman-collection, rest, rest-api, restful-api, spring, spring-data-jpa, spring-web-mvc, tomcat-server
Language: Java
Homepage:
Size: 108 KB
Stars: 5
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# POS System Backend - v2

## Overview
A backend service for a Point of Sale (POS) system designed to manage customer, item, and order data efficiently. This service facilitates the creation, retrieval, updating, and deletion of records, providing robust capabilities for handling orders and monitoring application health.

## Technologies Used
The following technologies were used in the development of the Backend Server:

- **Java 17**
- **Spring Framework**
- **Hibernate ORM**
- **Spring Web MVC**
- **Spring Data JPA**
- **MySQL**
- **Maven**
- **Tomcat**

## API endpoints
- **Customer Management:**
- Create new customer records.
- Read and retrieve customer details.
- Update existing customer information.
- Delete customer records as needed.

- **Item Management:**
- Add new items to the inventory.
- Retrieve item details.
- Update item information and pricing.
- Remove items from the inventory.

- **Order Handling:**
- Save new orders with customer and item details.
- Retrieve order history and status.

- **Health Check:**
- Verify the application's health status.

## Benefits

- **Efficient Management:** Streamlines customer and item management with CRUD operations, improving operational efficiency.
- **Robust Order Handling:** Facilitates accurate and reliable order processing, enhancing sales and inventory tracking.
- **Reliable Data Storage:** Uses Spring and JPA for stable data management and persistence.
- **Scalable Architecture:** Built on spring, Java, and Tomcat, allowing for easy scaling as business needs grow.

## Installation
To install and run the System, follow these steps:

1. Clone the repository:

```bash
git clone https://github.com/jlokitha/POS-System-Backend-v2.git

2. Navigate to the project directory:

```bash
cd POS-System-Backend-v2

3. Open the project in IntelliJ IDEA:

```bash
idea .
## Setup and Configuration
- **Configure Tomcat:**
- Go to `Run` > `Edit Configurations`.
- Click the `+` button and select `Tomcat Server` > `Local`.
- Set the Tomcat Home directory to your [Tomcat](https://tomcat.apache.org/download-90.cgi) installation path.
- Apply and save the configuration.

- **Update Database Credentials:**
- Open the `src/main/java/lk/ijse/possystembackendv2/config/WebAppRootConfig.java` file.
- Update the MySQL username and password:

```bash
@Bean
public DataSource dataSource() {
DriverManagerDataSource dmds = new DriverManagerDataSource();
dmds.setDriverClassName("com.mysql.cj.jdbc.Driver");
dmds.setUrl("jdbc:mysql://localhost:3306/pos_system?createDatabaseIfNotExist=true");
dmds.setUsername("Your Username");
dmds.setPassword("Your Password");
return dmds;
}

- **Run Tomcat:**
- In IntelliJ IDEA, select the Tomcat configuration you created.
- Click the `Run` button (green play icon) to start Tomcat.
- The application should be deployed and accessible from your browser.

## API Documentation
You can find the API documentation for this project at [API Documentation](https://documenter.getpostman.com/view/35384124/2sAXxV4pTW).

## License
This project is licensed under the MIT License - see the [MIT License](LICENSE) file for details.