How prawshant123-ui/safa-city works
SafaCity is a municipal waste-management platform: citizens submit and follow reports, administrators oversee bins and analytics and assign work, and collectors manage assigned tasks. The React SPA serves role-specific workflows and calls an Express REST API; backend controllers use Prisma for persistence, with Cloudinary for report media. The README also describes live vehicle tracking, though the sampled source does not establish its runtime data path. Several domain pages and routes were not sampled, so their connections are limited to documented or indexed evidence.
Main entry points: App.jsx React application · prisma.js Prisma client · api API client · admin Admin operations
Components 24
Role-based client
- React application
Frontend/src/App.jsx - Auth state
Frontend/src/context/AuthContext.jsx - Citizen reports
Frontend/src/pages/citizen - Admin operations
Frontend/src/pages/admin - Collector tasks
Frontend/src/pages/collector - Bin and map views
Frontend/src/components/map/BinMap.jsx - API client
Frontend/src/api - Leaflet map
Backend API
- Express API
Backend/src/app.js - Auth routes
Backend/src/routes/authRoute.js - Domain routes
Backend/src/routes - Authentication
Backend/src/controllers/authController.js - Domain controllers
Backend/src/controllers - Access control
Backend/src/middlewares
Waste operations
- Dashboard analytics
Backend/src/controllers/dashboardController.js - Collection dispatch
Backend/src/controllers/collectionController.js - Vehicle management
Backend/src/controllers/vehicleController.js
Persistence and media
- Prisma client
Backend/src/config/prisma.js - PostgreSQL
- Media upload
Backend/src/utils/cloudinaryUpload.js - Cloudinary
Other components
- Citizens
- Administrators
- Collectors
Connections 26
- Citizens → React application: use
- Administrators → React application: use
- Collectors → React application: use
- React application → Auth state: reads auth
Frontend/src/App.jsx - React application → Citizen reports: routes to
Frontend/src/App.jsx - React application → Admin operations: routes to
Frontend/src/App.jsx - React application → Collector tasks: routes to
Frontend/src/App.jsx - Citizen reports → API client: requests data
Frontend/src/pages/citizen/CitizenDashboard.jsx - Admin operations → API client: requests analytics
Frontend/src/pages/admin/AdminDashboard.jsx - Collector tasks → API client: loads tasks
Frontend/src/pages/collector/MyTasks.jsx - API client → Express API: calls REST API
- Express API → Auth routes: mounts
Backend/src/app.js - Express API → Domain routes: mounts
Backend/src/app.js - Auth routes → Authentication: dispatches
Backend/src/routes/authRoute.js - Domain routes → Domain controllers: dispatches
Backend/src/routes/authRoute.js - Domain controllers → Prisma client: queries
Backend/src/controllers/binController.js - Dashboard analytics → Prisma client: queries
Backend/src/controllers/dashboardController.js - Collection dispatch → Prisma client: queries
Backend/src/controllers/collectionController.js - Vehicle management → Prisma client: queries
Backend/src/controllers/vehicleController.js - Prisma client → PostgreSQL: accesses
- Collection dispatch → Media upload: uploads media
Backend/src/controllers/collectionController.js - Media upload → Cloudinary: stores media
- Admin operations → Bin and map views: renders hotspots
Frontend/src/pages/admin/AdminDashboard.jsx - Bin and map views → Leaflet map: renders map
- Administrators → Vehicle management: manage vehicles
- Collectors → Collection dispatch: complete assignments