# sanketkalambe/rationsetu architecture

> Architecture diagram of the GitHub repository sanketkalambe/rationsetu, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sanketkalambe/rationsetu
- Repository: https://github.com/sanketkalambe/rationsetu

## Overview

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: [`server/src/controllers/auth.controller.js`](https://github.com/sanketkalambe/rationsetu/blob/main/server/src/controllers/auth.controller.js) (Authentication Workflows), [`client/src/App.jsx`](https://github.com/sanketkalambe/rationsetu/blob/main/client/src/App.jsx) (Web App), [`server/src/controllers/consumer.controller.js`](https://github.com/sanketkalambe/rationsetu/blob/main/server/src/controllers/consumer.controller.js) (Consumer Services), [`server/server.js`](https://github.com/sanketkalambe/rationsetu/blob/main/server/server.js) (Express API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Role Portals"]
  node_webapp["Web App<br/>[App.jsx]"]
  node_consumer_portal["Consumer Portal"]
  node_distributor_portal["Distributor Portal"]
  node_admin_portal["Admin Suite"]
  node_auth_pages["Sign In And Registration"]
  node_api_client["API Client<br/>[api.js]"]
end

subgraph group_server["API Workflows"]
  node_api_server["Express API<br/>[server.js]"]
  node_auth_routes["Authentication Routes<br/>[auth.routes.js]"]
  node_admin_routes["Admin Routes<br/>[admin.routes.js]"]
  node_complaint_routes["Complaint Routes"]
  node_admin_controller["Administration Workflows"]
  node_consumer_controller["Consumer Services"]
  node_epos_controller["e-POS Workflows<br/>[epos.controller.js]"]
  node_complaint_controller["Complaint Workflows"]
end

subgraph group_security["Identity And Verification"]
  node_auth_controller["Authentication Workflows<br/>[auth.controller.js]"]
  node_auth_middleware["JWT Protection<br/>[auth.middleware.js]"]
  node_role_middleware["Role Checks<br/>[role.middleware.js]"]
end

subgraph group_data["Domain Data"]
  node_mongodb[("MongoDB<br/>[db.js]")]
  node_user_model["User Accounts<br/>[User.js]"]
  node_consumer_profile["Consumer Profiles<br/>[ConsumerProfile.js]"]
  node_family_members["Family Members<br/>[FamilyMember.js]"]
  node_distributor_profile["Distributor Profiles"]
  node_shop["Fair Price Shops<br/>[Shop.js]"]
  node_transaction["Distribution Ledger<br/>[Transaction.js]"]
  node_slot_booking["Slot Bookings<br/>[SlotBooking.js]"]
  node_system_settings["System Settings<br/>[SystemSettings.js]"]
  node_complaint["Complaints<br/>[Complaint.js]"]
end

subgraph group_services["Distribution Services"]
  node_epos_engine["e-POS State Machine<br/>[epos.service.js]"]
  node_encryption["Aadhaar Encryption"]
  node_kyc["KYC Verification"]
  node_complaint_suggestions["Complaint Suggestions"]
end

node_consumer(("Consumer"))
node_distributor(("Distributor"))
node_admin(("Government Admin"))

node_consumer -->|"uses"| node_webapp
node_distributor -->|"uses"| node_webapp
node_admin -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_consumer_portal
node_webapp -->|"routes to"| node_distributor_portal
node_webapp -->|"routes to"| node_admin_portal
node_webapp -->|"routes to"| node_auth_pages
node_consumer_portal -.->|"requests data"| node_api_client
node_distributor_portal -.->|"requests data"| node_api_client
node_admin_portal -.->|"requests data"| node_api_client
node_auth_pages -->|"requests data"| node_api_client
node_api_client -.->|"calls API"| node_api_server
node_api_server -->|"mounts"| node_auth_routes
node_api_server -->|"mounts"| node_admin_routes
node_api_server -->|"mounts"| node_complaint_routes
node_auth_routes -->|"dispatches"| node_auth_controller
node_admin_routes -->|"protects routes"| node_auth_middleware
node_admin_routes -->|"checks role"| node_role_middleware
node_admin_routes -->|"dispatches"| node_admin_controller
node_complaint_routes -->|"protects routes"| node_auth_middleware
node_complaint_routes -->|"checks role"| node_role_middleware
node_complaint_routes -->|"dispatches"| node_complaint_controller
node_auth_controller -->|"reads and writes"| node_user_model
node_auth_controller -->|"creates and reads"| node_consumer_profile
node_auth_controller -->|"creates and reads"| node_distributor_profile
node_auth_controller -->|"finds or creates"| node_shop
node_auth_controller -->|"encrypts Aadhaar"| node_encryption
node_auth_controller -->|"verifies registration"| node_kyc
node_consumer_controller -->|"calculates entitlement"| node_epos_engine
node_consumer_controller -->|"reads profile"| node_consumer_profile
node_consumer_controller -->|"reads and writes"| node_family_members
node_consumer_controller -->|"reads ledger"| node_transaction
node_consumer_controller -->|"reads booking"| node_slot_booking
node_consumer_controller -->|"reads settings"| node_system_settings
node_epos_controller -->|"runs workflow"| node_epos_engine
node_epos_controller -->|"records distribution"| node_transaction
node_complaint_controller -.->|"suggests category"| node_complaint_suggestions
node_complaint_controller -.->|"records grievances"| node_complaint
node_admin_controller -->|"reads and updates"| node_user_model
node_admin_controller -->|"reads shop"| node_shop
node_admin_controller -->|"updates settings"| node_system_settings
node_admin_controller -->|"reviews grievances"| node_complaint
node_api_server -->|"connects"| node_mongodb
node_mongodb -.->|"persists"| node_user_model

click node_webapp "https://github.com/sanketkalambe/rationsetu/blob/main/client/src/App.jsx"
click node_consumer_portal "https://github.com/sanketkalambe/rationsetu/tree/main/client/src/pages/consumer"
click node_distributor_portal "https://github.com/sanketkalambe/rationsetu/tree/main/client/src/pages/distributor"
click node_admin_portal "https://github.com/sanketkalambe/rationsetu/tree/main/client/src/pages/admin"
click node_auth_pages "https://github.com/sanketkalambe/rationsetu/tree/main/client/src/pages/auth"
click node_api_client "https://github.com/sanketkalambe/rationsetu/blob/main/client/src/services/api.js"
click node_api_server "https://github.com/sanketkalambe/rationsetu/blob/main/server/server.js"
click node_auth_routes "https://github.com/sanketkalambe/rationsetu/blob/main/server/src/routes/auth.routes.js"
click node_admin_routes "https://github.com/sanketkalambe/rationsetu/blob/main/server/src/routes/admin.routes.js"
click node_complaint_routes "https://github.com/sanketkalambe/rationsetu/blob/main/server/src/routes/complaint.routes.js"
click node_auth_controller "https://github.com/sanketkalambe/rationsetu/blob/main/server/src/controllers/auth.controller.js"
click node_auth_middleware "https://github.com/sanketkalambe/rationsetu/blob/main/server/src/middleware/auth.middleware.js"
click node_role_middleware "https://github.com/sanketkalambe/rationsetu/blob/main/server/src/middleware/role.middleware.js"
click node_admin_controller "https://github.com/sanketkalambe/rationsetu/blob/main/server/src/controllers/admin.controller.js"
click node_consumer_controller "https://github.com/sanketkalambe/rationsetu/blob/main/server/src/controllers/consumer.controller.js"
click node_epos_controller "https://github.com/sanketkalambe/rationsetu/blob/main/server/src/controllers/epos.controller.js"
click node_complaint_controller "https://github.com/sanketkalambe/rationsetu/blob/main/server/src/controllers/complaint.controller.js"
click node_epos_engine "https://github.com/sanketkalambe/rationsetu/blob/main/server/src/services/epos.service.js"
click node_encryption "https://github.com/sanketkalambe/rationsetu/blob/main/server/src/services/encryption.service.js"
click node_kyc "https://github.com/sanketkalambe/rationsetu/blob/main/server/src/services/kycVerification.service.js"
click node_complaint_suggestions "https://github.com/sanketkalambe/rationsetu/blob/main/server/src/services/complaintSuggestion.service.js"
click node_mongodb "https://github.com/sanketkalambe/rationsetu/blob/main/server/src/config/db.js"
click node_user_model "https://github.com/sanketkalambe/rationsetu/blob/main/server/src/models/User.js"
click node_consumer_profile "https://github.com/sanketkalambe/rationsetu/blob/main/server/src/models/ConsumerProfile.js"
click node_family_members "https://github.com/sanketkalambe/rationsetu/blob/main/server/src/models/FamilyMember.js"
click node_distributor_profile "https://github.com/sanketkalambe/rationsetu/blob/main/server/src/models/DistributorProfile.js"
click node_shop "https://github.com/sanketkalambe/rationsetu/blob/main/server/src/models/Shop.js"
click node_transaction "https://github.com/sanketkalambe/rationsetu/blob/main/server/src/models/Transaction.js"
click node_slot_booking "https://github.com/sanketkalambe/rationsetu/blob/main/server/src/models/SlotBooking.js"
click node_system_settings "https://github.com/sanketkalambe/rationsetu/blob/main/server/src/models/SystemSettings.js"
click node_complaint "https://github.com/sanketkalambe/rationsetu/blob/main/server/src/models/Complaint.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_webapp,node_consumer_portal,node_distributor_portal,node_admin_portal,node_auth_pages,node_api_client toneBlue
class node_api_server,node_auth_routes,node_admin_routes,node_complaint_routes,node_admin_controller,node_consumer_controller,node_epos_controller,node_complaint_controller toneAmber
class node_auth_controller,node_auth_middleware,node_role_middleware toneMint
class node_mongodb,node_user_model,node_consumer_profile,node_family_members,node_distributor_profile,node_shop,node_transaction,node_slot_booking,node_system_settings,node_complaint toneRose
class node_epos_engine,node_encryption,node_kyc,node_complaint_suggestions,node_consumer,node_distributor,node_admin toneIndigo
```

## Components

### Role Portals

- [Web App](https://github.com/sanketkalambe/rationsetu/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Consumer Portal](https://github.com/sanketkalambe/rationsetu/tree/main/client/src/pages/consumer): `client/src/pages/consumer`
- [Distributor Portal](https://github.com/sanketkalambe/rationsetu/tree/main/client/src/pages/distributor): `client/src/pages/distributor`
- [Admin Suite](https://github.com/sanketkalambe/rationsetu/tree/main/client/src/pages/admin): `client/src/pages/admin`
- [Sign In And Registration](https://github.com/sanketkalambe/rationsetu/tree/main/client/src/pages/auth): `client/src/pages/auth`
- [API Client](https://github.com/sanketkalambe/rationsetu/blob/main/client/src/services/api.js): `client/src/services/api.js`

### API Workflows

- [Express API](https://github.com/sanketkalambe/rationsetu/blob/main/server/server.js): `server/server.js`
- [Authentication Routes](https://github.com/sanketkalambe/rationsetu/blob/main/server/src/routes/auth.routes.js): `server/src/routes/auth.routes.js`
- [Admin Routes](https://github.com/sanketkalambe/rationsetu/blob/main/server/src/routes/admin.routes.js): `server/src/routes/admin.routes.js`
- [Complaint Routes](https://github.com/sanketkalambe/rationsetu/blob/main/server/src/routes/complaint.routes.js): `server/src/routes/complaint.routes.js`
- [Administration Workflows](https://github.com/sanketkalambe/rationsetu/blob/main/server/src/controllers/admin.controller.js): `server/src/controllers/admin.controller.js`
- [Consumer Services](https://github.com/sanketkalambe/rationsetu/blob/main/server/src/controllers/consumer.controller.js): `server/src/controllers/consumer.controller.js`
- [e-POS Workflows](https://github.com/sanketkalambe/rationsetu/blob/main/server/src/controllers/epos.controller.js): `server/src/controllers/epos.controller.js`
- [Complaint Workflows](https://github.com/sanketkalambe/rationsetu/blob/main/server/src/controllers/complaint.controller.js): `server/src/controllers/complaint.controller.js`

### Identity And Verification

- [Authentication Workflows](https://github.com/sanketkalambe/rationsetu/blob/main/server/src/controllers/auth.controller.js): `server/src/controllers/auth.controller.js`
- [JWT Protection](https://github.com/sanketkalambe/rationsetu/blob/main/server/src/middleware/auth.middleware.js): `server/src/middleware/auth.middleware.js`
- [Role Checks](https://github.com/sanketkalambe/rationsetu/blob/main/server/src/middleware/role.middleware.js): `server/src/middleware/role.middleware.js`

### Domain Data

- [MongoDB](https://github.com/sanketkalambe/rationsetu/blob/main/server/src/config/db.js): `server/src/config/db.js`
- [User Accounts](https://github.com/sanketkalambe/rationsetu/blob/main/server/src/models/User.js): `server/src/models/User.js`
- [Consumer Profiles](https://github.com/sanketkalambe/rationsetu/blob/main/server/src/models/ConsumerProfile.js): `server/src/models/ConsumerProfile.js`
- [Family Members](https://github.com/sanketkalambe/rationsetu/blob/main/server/src/models/FamilyMember.js): `server/src/models/FamilyMember.js`
- [Distributor Profiles](https://github.com/sanketkalambe/rationsetu/blob/main/server/src/models/DistributorProfile.js): `server/src/models/DistributorProfile.js`
- [Fair Price Shops](https://github.com/sanketkalambe/rationsetu/blob/main/server/src/models/Shop.js): `server/src/models/Shop.js`
- [Distribution Ledger](https://github.com/sanketkalambe/rationsetu/blob/main/server/src/models/Transaction.js): `server/src/models/Transaction.js`
- [Slot Bookings](https://github.com/sanketkalambe/rationsetu/blob/main/server/src/models/SlotBooking.js): `server/src/models/SlotBooking.js`
- [System Settings](https://github.com/sanketkalambe/rationsetu/blob/main/server/src/models/SystemSettings.js): `server/src/models/SystemSettings.js`
- [Complaints](https://github.com/sanketkalambe/rationsetu/blob/main/server/src/models/Complaint.js): `server/src/models/Complaint.js`

### Distribution Services

- [e-POS State Machine](https://github.com/sanketkalambe/rationsetu/blob/main/server/src/services/epos.service.js): `server/src/services/epos.service.js`
- [Aadhaar Encryption](https://github.com/sanketkalambe/rationsetu/blob/main/server/src/services/encryption.service.js): `server/src/services/encryption.service.js`
- [KYC Verification](https://github.com/sanketkalambe/rationsetu/blob/main/server/src/services/kycVerification.service.js): `server/src/services/kycVerification.service.js`
- [Complaint Suggestions](https://github.com/sanketkalambe/rationsetu/blob/main/server/src/services/complaintSuggestion.service.js): `server/src/services/complaintSuggestion.service.js`

### Other components

- **Consumer**
- **Distributor**
- **Government Admin**

## Connections

- Consumer → Web App: uses (evidence: `README.md`)
- Distributor → Web App: uses (evidence: `README.md`)
- Government Admin → Web App: uses (evidence: `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 (evidence: `client/src/pages/auth/DistributorRegister.jsx`)
- API Client → Express API: calls API
- Express API → Authentication Routes: mounts (evidence: `server/server.js`)
- Express API → Admin Routes: mounts (evidence: `server/server.js`)
- Express API → Complaint Routes: mounts (evidence: `server/server.js`)
- Authentication Routes → Authentication Workflows: dispatches (evidence: `server/src/routes/auth.routes.js`)
- Admin Routes → JWT Protection: protects routes (evidence: `server/src/routes/admin.routes.js`)
- Admin Routes → Role Checks: checks role (evidence: `server/src/routes/admin.routes.js`)
- Admin Routes → Administration Workflows: dispatches (evidence: `server/src/routes/admin.routes.js`)
- Complaint Routes → JWT Protection: protects routes (evidence: `server/src/routes/complaint.routes.js`)
- Complaint Routes → Role Checks: checks role (evidence: `server/src/routes/complaint.routes.js`)
- Complaint Routes → Complaint Workflows: dispatches (evidence: `server/src/routes/complaint.routes.js`)
- Authentication Workflows → User Accounts: reads and writes (evidence: `server/src/controllers/auth.controller.js`)
- Authentication Workflows → Consumer Profiles: creates and reads (evidence: `server/src/controllers/auth.controller.js`)
- Authentication Workflows → Distributor Profiles: creates and reads (evidence: `server/src/controllers/auth.controller.js`)
- Authentication Workflows → Fair Price Shops: finds or creates (evidence: `server/src/controllers/auth.controller.js`)
- Authentication Workflows → Aadhaar Encryption: encrypts Aadhaar (evidence: `server/src/controllers/auth.controller.js`)
- Authentication Workflows → KYC Verification: verifies registration (evidence: `server/src/controllers/auth.controller.js`)
- Consumer Services → e-POS State Machine: calculates entitlement (evidence: `server/src/controllers/consumer.controller.js`)
- Consumer Services → Consumer Profiles: reads profile (evidence: `server/src/controllers/consumer.controller.js`)
- Consumer Services → Family Members: reads and writes (evidence: `server/src/controllers/consumer.controller.js`)
- Consumer Services → Distribution Ledger: reads ledger (evidence: `server/src/controllers/consumer.controller.js`)
- Consumer Services → Slot Bookings: reads booking (evidence: `server/src/controllers/consumer.controller.js`)
- Consumer Services → System Settings: reads settings (evidence: `server/src/controllers/consumer.controller.js`)
- e-POS Workflows → e-POS State Machine: runs workflow (evidence: `server/src/controllers/epos.controller.js`)
- e-POS Workflows → Distribution Ledger: records distribution (evidence: `server/src/controllers/epos.controller.js`)
- Complaint Workflows → Complaint Suggestions: suggests category
- Complaint Workflows → Complaints: records grievances
- Administration Workflows → User Accounts: reads and updates (evidence: `server/src/controllers/admin.controller.js`)
- Administration Workflows → Fair Price Shops: reads shop (evidence: `server/src/controllers/admin.controller.js`)
- Administration Workflows → System Settings: updates settings (evidence: `server/src/controllers/admin.controller.js`)
- Administration Workflows → Complaints: reviews grievances (evidence: `server/src/controllers/admin.controller.js`)
- Express API → MongoDB: connects (evidence: `server/server.js`)
- MongoDB → User Accounts: persists
