How sanketkalambe/rationsetu works
RationSetu is a role-based public distribution system for consumers, fair-price-shop distributors, and government administrators. Consumers register or sign in, manage a digital ration book, book collection slots, and raise complaints; distributors use the e-POS simulator to verify a consumer, check entitlement, dispense ration, and produce a receipt. Administrators verify registrations, allocate stock, manage settings, and review reports and complaints. The graph preserves these documented capabilities; some route-to-controller and persistence relationships are supported by the source index rather than fully shown excerpts.
Main entry points: auth.controller.js Authentication Workflows · App.jsx Web App · consumer.controller.js Consumer Services · server.js Express API
Components 34
Role Portals
- Web App
client/src/App.jsx - Consumer Portal
client/src/pages/consumer - Distributor Portal
client/src/pages/distributor - Admin Suite
client/src/pages/admin - Sign In And Registration
client/src/pages/auth - API Client
client/src/services/api.js
API Workflows
- Express API
server/server.js - Authentication Routes
server/src/routes/auth.routes.js - Admin Routes
server/src/routes/admin.routes.js - Complaint Routes
server/src/routes/complaint.routes.js - Administration Workflows
server/src/controllers/admin.controller.js - Consumer Services
server/src/controllers/consumer.controller.js - e-POS Workflows
server/src/controllers/epos.controller.js - Complaint Workflows
server/src/controllers/complaint.controller.js
Identity And Verification
- Authentication Workflows
server/src/controllers/auth.controller.js - JWT Protection
server/src/middleware/auth.middleware.js - Role Checks
server/src/middleware/role.middleware.js
Domain Data
- MongoDB
server/src/config/db.js - User Accounts
server/src/models/User.js - Consumer Profiles
server/src/models/ConsumerProfile.js - Family Members
server/src/models/FamilyMember.js - Distributor Profiles
server/src/models/DistributorProfile.js - Fair Price Shops
server/src/models/Shop.js - Distribution Ledger
server/src/models/Transaction.js - Slot Bookings
server/src/models/SlotBooking.js - System Settings
server/src/models/SystemSettings.js - Complaints
server/src/models/Complaint.js
Distribution Services
- e-POS State Machine
server/src/services/epos.service.js - Aadhaar Encryption
server/src/services/encryption.service.js - KYC Verification
server/src/services/kycVerification.service.js - Complaint Suggestions
server/src/services/complaintSuggestion.service.js
Other components
- Consumer
- Distributor
- Government Admin
Connections 44
- Consumer → Web App: uses
README.md - Distributor → Web App: uses
README.md - Government Admin → Web App: uses
README.md - Web App → Consumer Portal: routes to
- Web App → Distributor Portal: routes to
- Web App → Admin Suite: routes to
- Web App → Sign In And Registration: routes to
- Consumer Portal → API Client: requests data
- Distributor Portal → API Client: requests data
- Admin Suite → API Client: requests data
- Sign In And Registration → API Client: requests data
client/src/pages/auth/DistributorRegister.jsx - API Client → Express API: calls API
- Express API → Authentication Routes: mounts
server/server.js - Express API → Admin Routes: mounts
server/server.js - Express API → Complaint Routes: mounts
server/server.js - Authentication Routes → Authentication Workflows: dispatches
server/src/routes/auth.routes.js - Admin Routes → JWT Protection: protects routes
server/src/routes/admin.routes.js - Admin Routes → Role Checks: checks role
server/src/routes/admin.routes.js - Admin Routes → Administration Workflows: dispatches
server/src/routes/admin.routes.js - Complaint Routes → JWT Protection: protects routes
server/src/routes/complaint.routes.js - Complaint Routes → Role Checks: checks role
server/src/routes/complaint.routes.js - Complaint Routes → Complaint Workflows: dispatches
server/src/routes/complaint.routes.js - Authentication Workflows → User Accounts: reads and writes
server/src/controllers/auth.controller.js - Authentication Workflows → Consumer Profiles: creates and reads
server/src/controllers/auth.controller.js - Authentication Workflows → Distributor Profiles: creates and reads
server/src/controllers/auth.controller.js - Authentication Workflows → Fair Price Shops: finds or creates
server/src/controllers/auth.controller.js - Authentication Workflows → Aadhaar Encryption: encrypts Aadhaar
server/src/controllers/auth.controller.js - Authentication Workflows → KYC Verification: verifies registration
server/src/controllers/auth.controller.js - Consumer Services → e-POS State Machine: calculates entitlement
server/src/controllers/consumer.controller.js - Consumer Services → Consumer Profiles: reads profile
server/src/controllers/consumer.controller.js - Consumer Services → Family Members: reads and writes
server/src/controllers/consumer.controller.js - Consumer Services → Distribution Ledger: reads ledger
server/src/controllers/consumer.controller.js - Consumer Services → Slot Bookings: reads booking
server/src/controllers/consumer.controller.js - Consumer Services → System Settings: reads settings
server/src/controllers/consumer.controller.js - e-POS Workflows → e-POS State Machine: runs workflow
server/src/controllers/epos.controller.js - e-POS Workflows → Distribution Ledger: records distribution
server/src/controllers/epos.controller.js - Complaint Workflows → Complaint Suggestions: suggests category
- Complaint Workflows → Complaints: records grievances
- Administration Workflows → User Accounts: reads and updates
server/src/controllers/admin.controller.js - Administration Workflows → Fair Price Shops: reads shop
server/src/controllers/admin.controller.js - Administration Workflows → System Settings: updates settings
server/src/controllers/admin.controller.js - Administration Workflows → Complaints: reviews grievances
server/src/controllers/admin.controller.js - Express API → MongoDB: connects
server/server.js - MongoDB → User Accounts: persists