{"id":20764550,"url":"https://github.com/jlokitha/pos-system-backend","last_synced_at":"2025-07-15T10:43:37.096Z","repository":{"id":252412815,"uuid":"836641436","full_name":"jlokitha/POS-System-Backend","owner":"jlokitha","description":"POS System backend for managing customer, item, and order data.","archived":false,"fork":false,"pushed_at":"2024-08-09T17:10:22.000Z","size":124,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-09T13:04:25.348Z","etag":null,"topics":["api","inventory-management","pos-system","tomcat","tomcat-server"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jlokitha.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-01T09:01:09.000Z","updated_at":"2025-02-20T13:47:32.000Z","dependencies_parsed_at":"2024-08-11T00:31:20.047Z","dependency_job_id":null,"html_url":"https://github.com/jlokitha/POS-System-Backend","commit_stats":null,"previous_names":["jlokitha/pos-system-backend"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jlokitha/POS-System-Backend","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jlokitha%2FPOS-System-Backend","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jlokitha%2FPOS-System-Backend/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jlokitha%2FPOS-System-Backend/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jlokitha%2FPOS-System-Backend/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jlokitha","download_url":"https://codeload.github.com/jlokitha/POS-System-Backend/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jlokitha%2FPOS-System-Backend/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265429285,"owners_count":23763719,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","inventory-management","pos-system","tomcat","tomcat-server"],"created_at":"2024-11-17T10:52:41.564Z","updated_at":"2025-07-15T10:43:37.027Z","avatar_url":"https://github.com/jlokitha.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# POS System Backend\n\n## Overview\nA backend service for a Point of Sale (POS) system designed to manage customer and item data efficiently. This service facilitates the creation, retrieval, updating, and deletion of records, and provides capabilities for saving and retrieving order information.\n\n## Technologies Used\nThe following technologies were used in the development of the Backend Server:\n\n- **JakarthaEE**\n- **MySQL**\n- **Maven**\n- **Tomcat**\n- **JNDI**\n\n## API endpoints\n- **Customer Management:**\n  - Create new customer records.\n  - Read and retrieve customer details.\n  - Update existing customer information.\n  - Delete customer records as needed.\n\n- **Item Management:**\n  - Add new items to the inventory.\n  - Retrieve item details and stock levels.\n  - Update item information and pricing.\n  - Remove items from the inventory.\n\n- **Order Handling:**\n  - Save new orders with customer and item details.\n  - Retrieve order history and status.\n \n## Benefits\n\n- **Efficient Management:** Streamlines customer and item management with CRUD operations, improving operational efficiency.\n- **Robust Order Handling:** Facilitates accurate and reliable order processing, enhancing sales and inventory tracking.\n- **Reliable Data Storage:** Uses Java and JDBC for stable data management and persistence.\n- **Scalable Architecture:** Built on Java and Tomcat, allowing for easy scaling as business needs grow.\n\n## Installation\nTo install and run the System, follow these steps:\n\n1. Clone the repository:\n   \n   ```bash\n   git clone https://github.com/jlokitha/POS-System-Backend.git\n\n2. Navigate to the project directory:\n   \n   ```bash\n   cd POS-System-Backend\n   \n3. Open the project in IntelliJ IDEA:\n   \n   ```bash\n   idea .\n## Setup and Configuration\n- **Configure Tomcat:**\n    - Go to `Run` \u003e `Edit Configurations`.\n    - Click the `+` button and select `Tomcat Server` \u003e `Local`.\n    - Set the Tomcat Home directory to your [Tomcat](https://tomcat.apache.org/download-90.cgi) installation path.\n    - Apply and save the configuration.\n\n- **Update Database Credentials:**\n    - Open the `src/main/webapp/META-INF/context.xml` file.\n    - Update the MySQL username and password:\n  \n      ```bash\n      \u003cContext\u003e\n        \u003cResource name=\"jdbc/POSSystem\" auth=\"Container\" type=\"javax.sql.DataSource\"\n              maxTotal=\"20\" maxIdle=\"10\" maxWaitMillis=\"-1\"\n              username=\"YOUR_USERNAME\" password=\"YOUR_PASSWORD\" driverClassName=\"com.mysql.cj.jdbc.Driver\"\n              url=\"jdbc:mysql://localhost:3306/pos_system\"/\u003e\n      \u003c/Context\u003e\n\n- **Run Tomcat:**\n    - In IntelliJ IDEA, select the Tomcat configuration you created.\n    - Click the `Run` button (green play icon) to start Tomcat.\n    - The application should be deployed and accessible from your browser.\n\n## Front-End Project\nFor the front-end of the POS system, visit the [POS System Front-End Repository](https://github.com/jlokitha/POS-System-Frontend.git).\n\n## API Documentation\nYou can find the API documentation for this project at [API Documentation](https://documenter.getpostman.com/view/35384124/2sA3s1psRe).\n\n## License\nThis project is licensed under the MIT License - see the [MIT License](LICENSE) file for details.\n\n##\n\u003cdiv align=\"center\"\u003e\n\u003ca href=\"https://github.com/jlokitha\" target=\"_blank\"\u003e\u003cimg src = \"https://img.shields.io/badge/GitHub-000000?style=for-the-badge\u0026logo=github\u0026logoColor=white\"\u003e\u003c/a\u003e\n\u003ca href=\"https://git-scm.com/\" target=\"_blank\"\u003e\u003cimg src = \"https://img.shields.io/badge/Git-000000?style=for-the-badge\u0026logo=git\u0026logoColor=white\"\u003e\u003c/a\u003e\n\u003ca href=\"https://jakarta.ee/compatibility/download/\" target=\"_blank\"\u003e\u003cimg src = \"https://img.shields.io/badge/JakarthaEE-000000?style=for-the-badge\u0026logo=eclipse\u0026logoColor=white\"\u003e\u003c/a\u003e\n\u003ca href=\"https://www.mysql.com/downloads/\" target=\"_blank\"\u003e\u003cimg src = \"https://img.shields.io/badge/MySQL-000000?style=for-the-badge\u0026logo=mysql\u0026logoColor=white\"\u003e\u003c/a\u003e\n\u003ca href=\"https://maven.apache.org/download.cgi\" target=\"_blank\"\u003e\u003cimg src = \"https://img.shields.io/badge/Maven-000000?style=for-the-badge\u0026logo=apachemaven\u0026logoColor=white\"\u003e\u003c/a\u003e\n\u003ca href=\"https://tomcat.apache.org/download-90.cgi\" target=\"_blank\"\u003e\u003cimg src = \"https://img.shields.io/badge/Tomcat-000000?style=for-the-badge\u0026logo=apachetomcat\u0026logoColor=white\"\u003e\u003c/a\u003e\n\u003ca href=\"https://www.postman.com/downloads/\" target=\"_blank\"\u003e\u003cimg src = \"https://img.shields.io/badge/Postman-000000?style=for-the-badge\u0026logo=Postman\u0026logoColor=white\"\u003e\u003c/a\u003e\n\u003ca href=\"https://www.jetbrains.com/idea/download/?section=windows\" target=\"_blank\"\u003e\u003cimg src = \"https://img.shields.io/badge/intellij-000000?style=for-the-badge\u0026logo=intellijidea\u0026logoColor=white\"\u003e\u003c/a\u003e\n\u003c/div\u003e \u003cbr\u003e\n\u003cp align=\"center\"\u003e\n  \u0026copy; 2024 Janindu Lokitha\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjlokitha%2Fpos-system-backend","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjlokitha%2Fpos-system-backend","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjlokitha%2Fpos-system-backend/lists"}