# ovezshaikh/rfid-backend architecture

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

- Interactive diagram: https://gitdiagram.com/ovezshaikh/rfid-backend
- Repository: https://github.com/ovezshaikh/rfid-backend

## Overview

This is a backend for RFID-based tracking of reusable components and container sets. Users authenticate and manage inventory, scan items through dispatch/return workflows, create delivery challans, inspect history and reports, and administer email notifications; WhatsApp queries provide a conversational lookup path. The graph separates HTTP routing, inventory and movement operations, administration/reporting, and notifications. Several unsampled controllers are represented by their existing directories; their detailed behavior is not inferred beyond indexed route connections.

Main entry points: [`server.js`](https://github.com/ovezshaikh/rfid-backend/blob/master/server.js) (Express server), [`config/db.js`](https://github.com/ovezshaikh/rfid-backend/blob/master/config/db.js) (MySQL database), [`routes/emailRoutes.js`](https://github.com/ovezshaikh/rfid-backend/blob/master/routes/emailRoutes.js) (Email settings routes), [`routes/assetRoutes.js`](https://github.com/ovezshaikh/rfid-backend/blob/master/routes/assetRoutes.js) (Asset routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_http["HTTP and access"]
  node_server["Express server<br/>[server.js]"]
  node_auth_routes["Authentication routes<br/>[authRoutes.js]"]
  node_auth_controller["Authentication<br/>[authController.js]"]
  node_auth["Token and role checks<br/>[authMiddleware.js]"]
  node_asset_routes["Asset routes<br/>[assetRoutes.js]"]
  node_scan_routes["Scan routes<br/>[scanRoutes.js]"]
  node_challan_routes["Challan routes<br/>[challanRoutes.js]"]
  node_email_routes["Email settings routes<br/>[emailRoutes.js]"]
end

subgraph group_inventory["Inventory tracking"]
  node_asset_controller["Asset management<br/>[assetController.js]"]
  node_container_controller["Container sets"]
  node_history_controller["Audit history"]
  node_db[("MySQL database<br/>[db.js]")]
end

subgraph group_operations["Movement operations"]
  node_scan_controller["RFID scan workflows<br/>[scanController.js]"]
  node_challan_controller["Delivery challans"]
  node_locations["Location management"]
end

subgraph group_admin["Administration and insight"]
  node_reports["Reports"]
  node_users["User administration<br/>[userController.js]"]
  node_devices["Device management"]
  node_clients["Client management"]
  node_configs["Vehicle configuration"]
end

subgraph group_comms["Notifications and chat"]
  node_email_admin["Email settings and logs<br/>[emailController.js]"]
  node_email_groups["Recipient groups"]
  node_email_templates["Email templates"]
  node_email_logs["Email logs"]
  node_email_trigger["Email event delivery<br/>[emailTrigger.js]"]
  node_mailer["SMTP mailer<br/>[mailer.js]"]
  node_whatsapp["WhatsApp webhook"]
  node_whatsapp_sim["Chat simulation"]
  node_chat["Tracking chat queries<br/>[chatEngine.js]"]
end

node_user(("API user"))

node_user -->|"sends requests"| node_server
node_server -->|"mounts"| node_auth_routes
node_server -->|"mounts"| node_asset_routes
node_server -->|"mounts"| node_scan_routes
node_server -->|"mounts"| node_challan_routes
node_server -->|"verifies requests"| node_auth
node_server -->|"routes reports"| node_reports
node_server -->|"routes users"| node_users
node_server -->|"routes devices"| node_devices
node_server -->|"routes clients"| node_clients
node_server -->|"routes locations"| node_locations
node_server -->|"routes containers"| node_container_controller
node_server -->|"routes configuration"| node_configs
node_server -->|"mounts"| node_email_routes
node_server -->|"routes webhook"| node_whatsapp
node_server -->|"routes simulation"| node_whatsapp_sim
node_auth_routes -->|"dispatches"| node_auth_controller
node_asset_routes -->|"dispatches"| node_asset_controller
node_asset_routes -->|"dispatches history"| node_history_controller
node_asset_routes -->|"checks access"| node_auth
node_scan_routes -->|"dispatches"| node_scan_controller
node_challan_routes -->|"dispatches"| node_challan_controller
node_challan_controller -->|"logs dispatches"| node_history_controller
node_scan_controller -->|"logs scan events"| node_history_controller
node_challan_controller -->|"triggers notification"| node_email_trigger
node_email_routes -->|"dispatches settings"| node_email_admin
node_email_routes -->|"dispatches groups"| node_email_groups
node_email_routes -->|"dispatches templates"| node_email_templates
node_email_routes -->|"dispatches logs"| node_email_logs
node_email_trigger -->|"sends mail"| node_mailer
node_whatsapp -->|"processes queries"| node_chat
node_whatsapp_sim -->|"processes queries"| node_chat
node_asset_controller -->|"queries inventory"| node_db
node_scan_controller -->|"reads and updates"| node_db
node_container_controller -->|"queries sets"| node_db
node_challan_controller -->|"writes challans"| node_db
node_history_controller -->|"reads and writes logs"| node_db
node_email_trigger -->|"loads and logs"| node_db
node_chat -->|"queries tracking data"| node_db
node_reports -->|"queries reports"| node_db
node_users -->|"queries users"| node_db
node_devices -->|"queries devices"| node_db
node_locations -->|"queries locations"| node_db
node_clients -->|"queries clients"| node_db
node_configs -->|"queries settings"| node_db
node_email_admin -->|"queries settings"| node_db
node_email_groups -->|"queries groups"| node_db
node_email_templates -->|"queries templates"| node_db

click node_server "https://github.com/ovezshaikh/rfid-backend/blob/master/server.js"
click node_auth_routes "https://github.com/ovezshaikh/rfid-backend/blob/master/routes/authRoutes.js"
click node_auth_controller "https://github.com/ovezshaikh/rfid-backend/blob/master/controllers/authController.js"
click node_auth "https://github.com/ovezshaikh/rfid-backend/blob/master/middleware/authMiddleware.js"
click node_asset_routes "https://github.com/ovezshaikh/rfid-backend/blob/master/routes/assetRoutes.js"
click node_asset_controller "https://github.com/ovezshaikh/rfid-backend/blob/master/controllers/assetController.js"
click node_scan_routes "https://github.com/ovezshaikh/rfid-backend/blob/master/routes/scanRoutes.js"
click node_scan_controller "https://github.com/ovezshaikh/rfid-backend/blob/master/controllers/scanController.js"
click node_container_controller "https://github.com/ovezshaikh/rfid-backend/blob/master/controllers/containerController.js"
click node_challan_routes "https://github.com/ovezshaikh/rfid-backend/blob/master/routes/challanRoutes.js"
click node_challan_controller "https://github.com/ovezshaikh/rfid-backend/blob/master/controllers/challanController.js"
click node_history_controller "https://github.com/ovezshaikh/rfid-backend/blob/master/controllers/historyController.js"
click node_locations "https://github.com/ovezshaikh/rfid-backend/blob/master/controllers/locationController.js"
click node_db "https://github.com/ovezshaikh/rfid-backend/blob/master/config/db.js"
click node_reports "https://github.com/ovezshaikh/rfid-backend/blob/master/controllers/reportController.js"
click node_users "https://github.com/ovezshaikh/rfid-backend/blob/master/controllers/userController.js"
click node_devices "https://github.com/ovezshaikh/rfid-backend/blob/master/controllers/deviceController.js"
click node_clients "https://github.com/ovezshaikh/rfid-backend/blob/master/controllers/clientController.js"
click node_configs "https://github.com/ovezshaikh/rfid-backend/blob/master/controllers/configController.js"
click node_email_routes "https://github.com/ovezshaikh/rfid-backend/blob/master/routes/emailRoutes.js"
click node_email_admin "https://github.com/ovezshaikh/rfid-backend/blob/master/controllers/emailController.js"
click node_email_groups "https://github.com/ovezshaikh/rfid-backend/blob/master/controllers/emailGroupController.js"
click node_email_templates "https://github.com/ovezshaikh/rfid-backend/blob/master/controllers/emailTemplateController.js"
click node_email_logs "https://github.com/ovezshaikh/rfid-backend/blob/master/controllers/emailLogController.js"
click node_email_trigger "https://github.com/ovezshaikh/rfid-backend/blob/master/services/emailTrigger.js"
click node_mailer "https://github.com/ovezshaikh/rfid-backend/blob/master/services/mailer.js"
click node_whatsapp "https://github.com/ovezshaikh/rfid-backend/blob/master/controllers/whatsappWebhookController.js"
click node_whatsapp_sim "https://github.com/ovezshaikh/rfid-backend/blob/master/controllers/whatsappController.js"
click node_chat "https://github.com/ovezshaikh/rfid-backend/blob/master/utils/chatEngine.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_server,node_auth_routes,node_auth_controller,node_auth,node_asset_routes,node_scan_routes,node_challan_routes,node_email_routes,node_user toneBlue
class node_asset_controller,node_container_controller,node_history_controller,node_db toneAmber
class node_scan_controller,node_challan_controller,node_locations toneMint
class node_reports,node_users,node_devices,node_clients,node_configs toneRose
class node_email_admin,node_email_groups,node_email_templates,node_email_logs,node_email_trigger,node_mailer,node_whatsapp,node_whatsapp_sim,node_chat toneIndigo
```

## Components

### HTTP and access

- [Express server](https://github.com/ovezshaikh/rfid-backend/blob/master/server.js): `server.js`
- [Authentication routes](https://github.com/ovezshaikh/rfid-backend/blob/master/routes/authRoutes.js): `routes/authRoutes.js`
- [Authentication](https://github.com/ovezshaikh/rfid-backend/blob/master/controllers/authController.js): `controllers/authController.js`
- [Token and role checks](https://github.com/ovezshaikh/rfid-backend/blob/master/middleware/authMiddleware.js): `middleware/authMiddleware.js`
- [Asset routes](https://github.com/ovezshaikh/rfid-backend/blob/master/routes/assetRoutes.js): `routes/assetRoutes.js`
- [Scan routes](https://github.com/ovezshaikh/rfid-backend/blob/master/routes/scanRoutes.js): `routes/scanRoutes.js`
- [Challan routes](https://github.com/ovezshaikh/rfid-backend/blob/master/routes/challanRoutes.js): `routes/challanRoutes.js`
- [Email settings routes](https://github.com/ovezshaikh/rfid-backend/blob/master/routes/emailRoutes.js): `routes/emailRoutes.js`

### Inventory tracking

- [Asset management](https://github.com/ovezshaikh/rfid-backend/blob/master/controllers/assetController.js): `controllers/assetController.js`
- [Container sets](https://github.com/ovezshaikh/rfid-backend/blob/master/controllers/containerController.js): `controllers/containerController.js`
- [Audit history](https://github.com/ovezshaikh/rfid-backend/blob/master/controllers/historyController.js): `controllers/historyController.js`
- [MySQL database](https://github.com/ovezshaikh/rfid-backend/blob/master/config/db.js): `config/db.js`

### Movement operations

- [RFID scan workflows](https://github.com/ovezshaikh/rfid-backend/blob/master/controllers/scanController.js): `controllers/scanController.js`
- [Delivery challans](https://github.com/ovezshaikh/rfid-backend/blob/master/controllers/challanController.js): `controllers/challanController.js`
- [Location management](https://github.com/ovezshaikh/rfid-backend/blob/master/controllers/locationController.js): `controllers/locationController.js`

### Administration and insight

- [Reports](https://github.com/ovezshaikh/rfid-backend/blob/master/controllers/reportController.js): `controllers/reportController.js`
- [User administration](https://github.com/ovezshaikh/rfid-backend/blob/master/controllers/userController.js): `controllers/userController.js`
- [Device management](https://github.com/ovezshaikh/rfid-backend/blob/master/controllers/deviceController.js): `controllers/deviceController.js`
- [Client management](https://github.com/ovezshaikh/rfid-backend/blob/master/controllers/clientController.js): `controllers/clientController.js`
- [Vehicle configuration](https://github.com/ovezshaikh/rfid-backend/blob/master/controllers/configController.js): `controllers/configController.js`

### Notifications and chat

- [Email settings and logs](https://github.com/ovezshaikh/rfid-backend/blob/master/controllers/emailController.js): `controllers/emailController.js`
- [Recipient groups](https://github.com/ovezshaikh/rfid-backend/blob/master/controllers/emailGroupController.js): `controllers/emailGroupController.js`
- [Email templates](https://github.com/ovezshaikh/rfid-backend/blob/master/controllers/emailTemplateController.js): `controllers/emailTemplateController.js`
- [Email logs](https://github.com/ovezshaikh/rfid-backend/blob/master/controllers/emailLogController.js): `controllers/emailLogController.js`
- [Email event delivery](https://github.com/ovezshaikh/rfid-backend/blob/master/services/emailTrigger.js): `services/emailTrigger.js`
- [SMTP mailer](https://github.com/ovezshaikh/rfid-backend/blob/master/services/mailer.js): `services/mailer.js`
- [WhatsApp webhook](https://github.com/ovezshaikh/rfid-backend/blob/master/controllers/whatsappWebhookController.js): `controllers/whatsappWebhookController.js`
- [Chat simulation](https://github.com/ovezshaikh/rfid-backend/blob/master/controllers/whatsappController.js): `controllers/whatsappController.js`
- [Tracking chat queries](https://github.com/ovezshaikh/rfid-backend/blob/master/utils/chatEngine.js): `utils/chatEngine.js`

### Other components

- **API user**

## Connections

- API user → Express server: sends requests (evidence: `server.js`)
- Express server → Authentication routes: mounts (evidence: `server.js`)
- Express server → Asset routes: mounts (evidence: `server.js`)
- Express server → Scan routes: mounts (evidence: `server.js`)
- Express server → Challan routes: mounts (evidence: `server.js`)
- Express server → Token and role checks: verifies requests (evidence: `server.js`)
- Express server → Reports: routes reports (evidence: `server.js`)
- Express server → User administration: routes users (evidence: `server.js`)
- Express server → Device management: routes devices (evidence: `server.js`)
- Express server → Client management: routes clients (evidence: `server.js`)
- Express server → Location management: routes locations (evidence: `server.js`)
- Express server → Container sets: routes containers (evidence: `server.js`)
- Express server → Vehicle configuration: routes configuration (evidence: `server.js`)
- Express server → Email settings routes: mounts (evidence: `server.js`)
- Express server → WhatsApp webhook: routes webhook (evidence: `server.js`)
- Express server → Chat simulation: routes simulation (evidence: `server.js`)
- Authentication routes → Authentication: dispatches (evidence: `routes/authRoutes.js`)
- Asset routes → Asset management: dispatches (evidence: `routes/assetRoutes.js`)
- Asset routes → Audit history: dispatches history (evidence: `routes/assetRoutes.js`)
- Asset routes → Token and role checks: checks access (evidence: `routes/assetRoutes.js`)
- Scan routes → RFID scan workflows: dispatches (evidence: `routes/scanRoutes.js`)
- Challan routes → Delivery challans: dispatches (evidence: `routes/challanRoutes.js`)
- Delivery challans → Audit history: logs dispatches (evidence: `controllers/challanController.js`)
- RFID scan workflows → Audit history: logs scan events (evidence: `controllers/scanController.js`)
- Delivery challans → Email event delivery: triggers notification (evidence: `controllers/challanController.js`)
- Email settings routes → Email settings and logs: dispatches settings (evidence: `routes/emailRoutes.js`)
- Email settings routes → Recipient groups: dispatches groups (evidence: `routes/emailRoutes.js`)
- Email settings routes → Email templates: dispatches templates (evidence: `routes/emailRoutes.js`)
- Email settings routes → Email logs: dispatches logs (evidence: `routes/emailRoutes.js`)
- Email event delivery → SMTP mailer: sends mail (evidence: `services/emailTrigger.js`)
- WhatsApp webhook → Tracking chat queries: processes queries (evidence: `controllers/whatsappWebhookController.js`)
- Chat simulation → Tracking chat queries: processes queries (evidence: `controllers/whatsappController.js`)
- Asset management → MySQL database: queries inventory (evidence: `controllers/assetController.js`)
- RFID scan workflows → MySQL database: reads and updates (evidence: `controllers/scanController.js`)
- Container sets → MySQL database: queries sets (evidence: `controllers/containerController.js`)
- Delivery challans → MySQL database: writes challans (evidence: `controllers/challanController.js`)
- Audit history → MySQL database: reads and writes logs (evidence: `controllers/historyController.js`)
- Email event delivery → MySQL database: loads and logs (evidence: `services/emailTrigger.js`)
- Tracking chat queries → MySQL database: queries tracking data (evidence: `utils/chatEngine.js`)
- Reports → MySQL database: queries reports (evidence: `controllers/reportController.js`)
- User administration → MySQL database: queries users (evidence: `controllers/userController.js`)
- Device management → MySQL database: queries devices (evidence: `controllers/deviceController.js`)
- Location management → MySQL database: queries locations (evidence: `controllers/locationController.js`)
- Client management → MySQL database: queries clients (evidence: `controllers/clientController.js`)
- Vehicle configuration → MySQL database: queries settings (evidence: `controllers/configController.js`)
- Email settings and logs → MySQL database: queries settings (evidence: `controllers/emailController.js`)
- Recipient groups → MySQL database: queries groups (evidence: `controllers/emailGroupController.js`)
- Email templates → MySQL database: queries templates (evidence: `controllers/emailTemplateController.js`)
