POS Simulator is a web application designed to implement a point-of-sale (POS) system for physical retail stores. Offers a range of features to streamline and secure retail operations, including:
- ➡️Secure Authentication: Staff and admin can securely log into the system.
- ➡️Product Management: Search products by barcode, calculate quantities and total prices, and update stock in the backend database.
- ➡️Payment Options: Customers can choose from various payment methods, and a bill is generated accordingly.
- ➡️Admin Features: Admins are alerted if product stock goes below a threshold, can visualise daily sales, per-terminal transactions, and end-of-day stock levels.
-
Clone the repo:
git clone https://github.com/gantasrilaitha/POS-Simulator-SE-Project
-
Database creation:
- For mongodb compass (local db): Create a database named "pos" in mongodb compass and insert some items into the collections whose schema is defined in
cd server/models/
- For mongodb atlas (cloud db):
Step 1: Create a project in mongodb atlas. ex: point_of_sale_simulator-seproj
Step 2: Navigate to the project created and create a database under Deployment in left pannel. Create a shared cluster(free sandbox)
Step 3: Navigate to Network access under Security in left pannel and add the i.p address0.0.0.0/0
so that it can be accessed by anyone & anywhere
Step 4: Goto Collections tab in your database & insert the required documents and collections whose schema is defined incd server/models/
- For mongodb compass (local db): Create a database named "pos" in mongodb compass and insert some items into the collections whose schema is defined in
-
Configurations for deployment: Create a
.env
file in/pos/server/config
directory and store the URI(mongo atlas connection url format)="mongodb+srv://:<user_password>@<XXX.XXXXX.mongodb.net>/<db_name>?retryWrites=true&w=majority&appName=<cluster_name>" and PORT(you can use any port number as per your convenience). -
Frontend (Client):
cd client npm run dev
-
Backend (Server):
cd server npm start
-
Open, to see the application running locally:
http://localhost:5173/
-
Open, to see the application running on Vercel, after deployment: POS
New.Tab.webm
All documentations wrt to project are available in the repo. Have a look!
Let me know your feedback on srilaitha2003@gmail.com