π― PROJECT OVERVIEW
Sweet Shop Management System is a full stack web application that allows users to browse, purchase, and manage sweets. It supports authentication, role based access control, inventory management, and a modern user friendly dashboard.
This project is built following Test Driven Development principles and modern software engineering best practices.
π οΈ TECHNOLOGY STACK
NodeJS ExpressJS MongoDB Mongoose JWT Authentication
ReactJS Axios React Router
Testing Jest Supertest
Tools Git GitHub Postman
π AUTHENTICATION FEATURES
User registration User login JWT based authentication Protected API routes Role based access control for admin users
π SWEET MANAGEMENT FEATURES
View all available sweets Add new sweets admin only Update sweet details admin only Delete sweets admin only Search sweets by name Filter sweets by category and price Purchase sweets with live stock update Disable purchase when stock is zero
π¦ INVENTORY MANAGEMENT
Purchase sweets and decrease stock Restock sweets admin only Prevent purchase when stock is unavailable Live inventory update on dashboard
π§ͺ TEST DRIVEN DEVELOPMENT
This project follows Test Driven Development principles.
Test coverage includes Authentication APIs Sweet management APIs Inventory purchase and restock APIs
All tests pass successfully using Jest and Supertest.
π₯οΈ FRONTEND USER EXPERIENCE
Clean and responsive UI Sweet cards layout Search and filter bar Admin dashboard controls Real time inventory updates User friendly alerts and confirmations
πΈ SCREENSHOTS
Login Screen Register Screen Dashboard View Test Report
All screenshots are available in the screenshots folder.
βοΈ HOW TO RUN LOCALLY
Clone the repository Install backend dependencies Configure environment variables Start backend server Install frontend dependencies Start frontend server Open browser and explore the app
π€ MY AI USAGE
I used AI tools such as ChatGPT during development to assist with
Designing REST API structure Writing and improving backend logic Creating and refining Jest test cases Debugging authentication and database issues Improving frontend component structure Enhancing UI and user experience
All AI generated suggestions were reviewed and manually implemented. AI helped improve productivity and code quality while maintaining full ownership of the final solution.
π PROJECT STRUCTURE
Backend folder contains API logic, database models, routes, controllers, middleware, and tests Frontend folder contains React components, pages, context, and styles Screenshots folder contains UI and test evidence
π FUTURE IMPROVEMENTS
Deployment to cloud platforms Pagination and sorting Improved UI animations Order history tracking
π FINAL NOTE
This project demonstrates strong fundamentals in Backend API development Frontend SPA design Authentication and authorization Test Driven Development Git and version control Responsible AI usage
Thank you for reviewing this project π
Author
Harsh Raj