https://github.com/sasmithx/spring-pos

A Spring-based backend for a Point of Sale (POS) system provides a robust and scalable architecture for managing key business operations such as customer management, inventory control, order processing, and transaction handling..
https://github.com/sasmithx/spring-pos

hibernate-jpa hibernate-validation hibernate-validator jdk21 jparepository logback modelmapper restful-api spring spring-data-jpa spring-mvc spring-mvc-framework spring-mysql spring-pos-api tomcat-server

Last synced: 6 days ago
JSON representation

A Spring-based backend for a Point of Sale (POS) system provides a robust and scalable architecture for managing key business operations such as customer management, inventory control, order processing, and transaction handling..

• Host: GitHub
• URL: https://github.com/sasmithx/spring-pos
• Owner: sasmithx
• License: mit
• Created: 2024-10-04T13:22:00.000Z (about 1 month ago)
• Default Branch: main
• Last Pushed: 2024-10-17T07:27:48.000Z (20 days ago)
• Last Synced: 2024-10-31T08:06:13.770Z (6 days ago)
• Topics: hibernate-jpa, hibernate-validation, hibernate-validator, jdk21, jparepository, logback, modelmapper, restful-api, spring, spring-data-jpa, spring-mvc, spring-mvc-framework, spring-mysql, spring-pos-api, tomcat-server
• Language: Java
• Homepage:
• Size: 2.3 MB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        

![Logo](https://upload.wikimedia.org/wikipedia/commons/4/44/Spring_Framework_Logo_2018.svg)

# Spring POS

This is a Spring-based backend for a Point of Sale (POS) system. It provides RESTful APIs for managing customers, items, orders, and transactions. The project uses Spring, JPA, Hibernate,Tomcat, and MySQL for database connectivity.

## Features

- Customer Management (Create, Read, Update, Delete)

- Item Management (Create, Read, Update, Delete)

- Order and Transaction Processing

- Exception Handling and Validation using Hibernate Validator

- JSON Response formatting

## Technologies

- **Java Vesion:** JDK 21

- **Backend Framework:** Spring

- **Database:** MySQL

- **ORM:** JPA, Hibernate

- **Server:** Apache Tomcat 11.0.0-M26

- **Validation:** Hibernate Validator

- **Logger:** Logback

## Architecture Overview

- **Entities:** Representations for Customer, Item, Order, and OrderDetail

- **Data Transfer Objects (DTOs):** Includes CustomerDTO, ItemDTO, and OrderDTO

- **Repositories:** Interfaces for database operations, such as CustomerRepository, ItemRepository, OrderRepository, and OrderDetailRepository

- **Services:** Business logic for managing customers, items, and orders in CustomerService, ItemService, and OrderService

- **Controllers:** API endpoints for handling customer, item, and order-related requests via CustomerController, ItemController, and OrderController

- **Utilities:** Helper classes for tasks like object mapping (Mapping) and application utilities (AppUtil)

- **Exceptions:** Custom error handling mechanisms for specific scenarios

- **Configuration:** Application setup classes like WebAppConfig and WebAppRootConfig

## Validation

Data validation is enforced through Hibernate Validator annotations within the DTO classes, ensuring both data integrity and accuracy.

## Logging

Logging is set up with Logback, capturing logs both in the console and in a dedicated file.

## Custom Exceptions

Custom exceptions are designed to address specific error situations, delivering clear and informative error messages to the client.

## Setup and Configuration

**Prerequisites**

- **JDK 21**

- **Tomcat 11**

- **MySQL server**

- **Maven**

## Clone the repository:

```bash

  https://github.com/sasmithx/Spring-POS.git

```

## Database Configuration



## API Documentation

To view this project API Documentation

Refer to the [ Postman API Documentation](https://documenter.getpostman.com/view/35385442/2sAXxV4p5T) for detailed API endpoints and usage instructions.

## License

This project is licensed under the MIT License - see the [ MIT License](https://github.com/sasmithx/Spring-POS?tab=MIT-1-ov-file#) file for details.

##



[![Tech Stack](https://skillicons.dev/icons?i=git,github,spring,hibernate,maven,mysql,postman)](https://skillicons.dev)

 




  © 2024 Sasmith Manawadu