How mustafaemresahin/post-office-database works
Project Type and Purpose
• This is a full-stack web application for managing postal services (the “Post Office Database Application”).
• Frontend: A React single-page application (SPA) under client/
• Backend: A Node.js/Express server under server/
• Database: MySQL (SQL dump provided)
• Purpose: Enable Admins, Employees, and Customers to register, send/track packages, manage inventory, and view reports.
File Structure
• Top-level:
• client/ (React app with src/, public/, build/)
• server/ (Express entry point index.js, package.json)
• Procfile (Heroku deployment)
• sql dump file.sql (MySQL schema and seed data)
• client/src/: Organized into components/, pages/, context/ (AuthContext, shop-context), CSS, and assets
• server/: Contains Express server code, middleware likely imported from node_modules
• Build and deployment files: Procfile, package.json scripts for dev, build, prod
README for Additional Insights
• Tech stack: React, Node.js, MySQL
• Key features: user roles, package status updates, vehicle & employee assignment, automated notifications, inventory alerts, multiple report types
• Deployment: Supports both development (npm run dev) and production (npm run build + npm run prod) with Heroku integration