Skip to content

A reliable and flexible Point of Sale (POS) system built on the strong Spring Framework, designed to easily manage customers, items, and orders.

License

Notifications You must be signed in to change notification settings

yasith-chathuranga/posfusion-pos-spring-api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

POSFusion-POS-Spring-API

Introduction

A POS RESTful API built with Spring Framework, handling Customer, Item, Order, and OrderDetail management. It supports CRUD operations and transaction management, using Hibernate for ORM and JPA for repository handling.

Technologies Used

  • Java 17
  • Spring Framework
  • Hibernate ORM
  • Spring Data JPA
  • ModelMapper
  • Logback
  • MySQL

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

Validation

Validation is implemented using Hibernate Validator annotations in the DTO classes to ensure data integrity and correctness.

Logging

Logging is configured using Logback. Logs are written to both the console and a file.

Postman Documentation

For detailed API documentation and testing, please refer to the Postman API Documentation.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Getting Started

Prerequisites

To run this project, ensure you have the following installed:

  • Java Development Kit (JDK) 17 or higher
  • Apache Tomcat (10.1.24)
  • MySQL
  • Maven

Running the Application

  1. Clone the repository:
    git clone https://github.com/yasith-chathuranga/posfusion-pos-spring-api.git
    
  2. Update the MySQL database configuration in WebAppRootConfig.java:
    @Bean
    public DataSource dataSource() {
        DriverManagerDataSource dmds = new DriverManagerDataSource();
        dmds.setDriverClassName("com.mysql.cj.jdbc.Driver");
        dmds.setUrl("jdbc:mysql://localhost:3306/posfusion?createDatabaseIfNotExist=true");
        dmds.setUsername("root");
        dmds.setPassword("your_password");
        return dmds;
    }
    


© 2024 Yasith Chathuranga

About

A reliable and flexible Point of Sale (POS) system built on the strong Spring Framework, designed to easily manage customers, items, and orders.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages