# dakshmiyani/hms architecture

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

- Interactive diagram: https://gitdiagram.com/dakshmiyani/hms
- Repository: https://github.com/dakshmiyani/hms

## Overview

This is an event-management backend for participant and team registration, QR-based check-in and meal tracking, dashboards, and judging. The principal workflow enters through the Express route map, reaches a domain manager, and reads or changes PostgreSQL-backed records. Excel imports feed participant registration; QR scans update participant attendance or meal state; judging endpoints provide scores and leaderboards. The source excerpts establish several routes and manager-to-model calls; other capabilities are retained from the source index, with uncertain links omitted. No README was provided.

Main entry points: [`src/routes/middleware/routeMap.js`](https://github.com/dakshmiyani/hms/blob/main/src/routes/middleware/routeMap.js) (Route map), [`src/models/libs/db.js`](https://github.com/dakshmiyani/hms/blob/main/src/models/libs/db.js) (Database connection), [`src/bussinessLogic/managers/qrManager.js`](https://github.com/dakshmiyani/hms/blob/main/src/bussinessLogic/managers/qrManager.js) (QR check-in), [`src/bussinessLogic/managers/memberManager.js`](https://github.com/dakshmiyani/hms/blob/main/src/bussinessLogic/managers/memberManager.js) (Member registration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["API entry"]
  node_route_map["Route map<br/>[routeMap.js]"]
  node_auth_routes["Authentication routes<br/>[authRouter.js]"]
  node_member_routes["Member routes<br/>[memberRouter.js]"]
  node_team_routes["Team routes<br/>[teamRouter.js]"]
  node_qr_routes["QR scan routes<br/>[qrScanRouter.js]"]
  node_judge_routes["Judge routes<br/>[judgeRouter.js]"]
  node_event_routes["Event routes<br/>[eventRouter.js]"]
  node_bulk_routes["Bulk upload routes"]
  node_dashboard_routes["Dashboard routes<br/>[dashbardRouter.js]"]
end

subgraph group_operations["Event operations"]
  node_auth_manager["Authentication<br/>[authManager.js]"]
  node_member_manager["Member registration<br/>[memberManager.js]"]
  node_team_manager["Team management<br/>[teamManager.js]"]
  node_excel_manager["Spreadsheet imports<br/>[excelmanager.js]"]
  node_qr_manager["QR check-in<br/>[qrManager.js]"]
  node_event_manager["Event management<br/>[eventManager.js]"]
end

subgraph group_evaluation["Judging and reporting"]
  node_dashboard_manager["Dashboard data"]
  node_judge_manager["Scoring and leaderboard<br/>[judgeManager.js]"]
  node_excel_export["Excel export<br/>[jsontoxlsx.js]"]
end

subgraph group_persistence["Persistence and integrations"]
  node_member_model["Member records<br/>[memberModel.js]"]
  node_team_model["Team records<br/>[teamModel.js]"]
  node_event_model["Event records<br/>[eventModel.js]"]
  node_qr_model["QR records<br/>[qrModel.js]"]
  node_user_model["User records<br/>[userModel.js]"]
  node_judge_aiml["AI/ML scores<br/>[judgeAimlModel.js]"]
  node_judge_web["Web scores"]
  node_database[("Database connection<br/>[db.js]")]
  node_qr_generator["QR generation"]
  node_object_storage["Object storage<br/>[s3.js]"]
end

node_client(("API client"))

node_client -->|"sends requests"| node_route_map
node_route_map -->|"routes auth"| node_auth_routes
node_route_map -->|"routes members"| node_member_routes
node_route_map -->|"routes teams"| node_team_routes
node_route_map -->|"routes scans"| node_qr_routes
node_route_map -->|"routes judging"| node_judge_routes
node_route_map -->|"routes events"| node_event_routes
node_route_map -->|"routes uploads"| node_bulk_routes
node_route_map -->|"routes dashboard"| node_dashboard_routes
node_auth_routes -->|"invokes authentication"| node_auth_manager
node_member_routes -->|"invokes member operations"| node_member_manager
node_member_routes -->|"processes uploaded sheet"| node_excel_manager
node_team_routes -->|"invokes team operations"| node_team_manager
node_qr_routes -->|"handles scans"| node_qr_manager
node_judge_routes -->|"requests scores"| node_judge_manager
node_judge_routes -->|"exports leaderboard"| node_excel_export
node_member_manager -->|"reads and updates"| node_member_model
node_member_manager -->|"manages team membership"| node_team_model
node_member_manager -->|"looks up events"| node_event_model
node_team_manager -->|"manages teams"| node_team_model
node_excel_manager -->|"resolves event"| node_event_model
node_excel_manager -->|"creates participants"| node_member_manager
node_qr_manager -->|"reads QR records"| node_qr_model
node_qr_manager -->|"updates scan state"| node_member_model
node_qr_manager -->|"generates QR codes"| node_qr_generator
node_qr_manager -->|"uploads QR assets"| node_object_storage
node_auth_manager -->|"authenticates users"| node_user_model
node_dashboard_manager -.->|"serves dashboard requests"| node_dashboard_routes
node_judge_manager -->|"uses AI/ML scoring"| node_judge_aiml
node_judge_manager -->|"uses web scoring"| node_judge_web
node_member_model -->|"queries database"| node_database
node_team_model -->|"queries database"| node_database
node_event_model -->|"queries database"| node_database
node_qr_model -->|"queries database"| node_database
node_user_model -->|"queries database"| node_database
node_judge_aiml -->|"queries database"| node_database

click node_route_map "https://github.com/dakshmiyani/hms/blob/main/src/routes/middleware/routeMap.js"
click node_auth_routes "https://github.com/dakshmiyani/hms/blob/main/src/routes/controller/authRouter.js"
click node_member_routes "https://github.com/dakshmiyani/hms/blob/main/src/routes/controller/memberRouter.js"
click node_team_routes "https://github.com/dakshmiyani/hms/blob/main/src/routes/controller/teamRouter.js"
click node_qr_routes "https://github.com/dakshmiyani/hms/blob/main/src/routes/controller/qrScanRouter.js"
click node_judge_routes "https://github.com/dakshmiyani/hms/blob/main/src/routes/controller/judgeRouter.js"
click node_event_routes "https://github.com/dakshmiyani/hms/blob/main/src/routes/controller/eventRouter.js"
click node_bulk_routes "https://github.com/dakshmiyani/hms/blob/main/src/routes/controller/bulkUploadRouter.js"
click node_dashboard_routes "https://github.com/dakshmiyani/hms/blob/main/src/routes/controller/dashbardRouter.js"
click node_auth_manager "https://github.com/dakshmiyani/hms/blob/main/src/bussinessLogic/managers/authManager.js"
click node_member_manager "https://github.com/dakshmiyani/hms/blob/main/src/bussinessLogic/managers/memberManager.js"
click node_team_manager "https://github.com/dakshmiyani/hms/blob/main/src/bussinessLogic/managers/teamManager.js"
click node_excel_manager "https://github.com/dakshmiyani/hms/blob/main/src/bussinessLogic/managers/excelmanager.js"
click node_qr_manager "https://github.com/dakshmiyani/hms/blob/main/src/bussinessLogic/managers/qrManager.js"
click node_event_manager "https://github.com/dakshmiyani/hms/blob/main/src/bussinessLogic/managers/eventManager.js"
click node_dashboard_manager "https://github.com/dakshmiyani/hms/blob/main/src/bussinessLogic/managers/dashboardManager.js"
click node_judge_manager "https://github.com/dakshmiyani/hms/blob/main/src/bussinessLogic/managers/judgeManager.js"
click node_member_model "https://github.com/dakshmiyani/hms/blob/main/src/models/memberModel.js"
click node_team_model "https://github.com/dakshmiyani/hms/blob/main/src/models/teamModel.js"
click node_event_model "https://github.com/dakshmiyani/hms/blob/main/src/models/eventModel.js"
click node_qr_model "https://github.com/dakshmiyani/hms/blob/main/src/models/qrModel.js"
click node_user_model "https://github.com/dakshmiyani/hms/blob/main/src/models/userModel.js"
click node_judge_aiml "https://github.com/dakshmiyani/hms/blob/main/src/models/judgeAimlModel.js"
click node_judge_web "https://github.com/dakshmiyani/hms/blob/main/src/models/judgeWebDevModel.js"
click node_database "https://github.com/dakshmiyani/hms/blob/main/src/models/libs/db.js"
click node_qr_generator "https://github.com/dakshmiyani/hms/blob/main/src/utils/qrCodeGeneration.js"
click node_object_storage "https://github.com/dakshmiyani/hms/blob/main/src/utils/s3.js"
click node_excel_export "https://github.com/dakshmiyani/hms/blob/main/src/utils/jsontoxlsx.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_route_map,node_auth_routes,node_member_routes,node_team_routes,node_qr_routes,node_judge_routes,node_event_routes,node_bulk_routes,node_dashboard_routes,node_client toneBlue
class node_auth_manager,node_member_manager,node_team_manager,node_excel_manager,node_qr_manager,node_event_manager toneAmber
class node_dashboard_manager,node_judge_manager,node_excel_export toneMint
class node_member_model,node_team_model,node_event_model,node_qr_model,node_user_model,node_judge_aiml,node_judge_web,node_database,node_qr_generator,node_object_storage toneRose
```

## Components

### API entry

- [Route map](https://github.com/dakshmiyani/hms/blob/main/src/routes/middleware/routeMap.js): `src/routes/middleware/routeMap.js`
- [Authentication routes](https://github.com/dakshmiyani/hms/blob/main/src/routes/controller/authRouter.js): `src/routes/controller/authRouter.js`
- [Member routes](https://github.com/dakshmiyani/hms/blob/main/src/routes/controller/memberRouter.js): `src/routes/controller/memberRouter.js`
- [Team routes](https://github.com/dakshmiyani/hms/blob/main/src/routes/controller/teamRouter.js): `src/routes/controller/teamRouter.js`
- [QR scan routes](https://github.com/dakshmiyani/hms/blob/main/src/routes/controller/qrScanRouter.js): `src/routes/controller/qrScanRouter.js`
- [Judge routes](https://github.com/dakshmiyani/hms/blob/main/src/routes/controller/judgeRouter.js): `src/routes/controller/judgeRouter.js`
- [Event routes](https://github.com/dakshmiyani/hms/blob/main/src/routes/controller/eventRouter.js): `src/routes/controller/eventRouter.js`
- [Bulk upload routes](https://github.com/dakshmiyani/hms/blob/main/src/routes/controller/bulkUploadRouter.js): `src/routes/controller/bulkUploadRouter.js`
- [Dashboard routes](https://github.com/dakshmiyani/hms/blob/main/src/routes/controller/dashbardRouter.js): `src/routes/controller/dashbardRouter.js`

### Event operations

- [Authentication](https://github.com/dakshmiyani/hms/blob/main/src/bussinessLogic/managers/authManager.js): `src/bussinessLogic/managers/authManager.js`
- [Member registration](https://github.com/dakshmiyani/hms/blob/main/src/bussinessLogic/managers/memberManager.js): `src/bussinessLogic/managers/memberManager.js`
- [Team management](https://github.com/dakshmiyani/hms/blob/main/src/bussinessLogic/managers/teamManager.js): `src/bussinessLogic/managers/teamManager.js`
- [Spreadsheet imports](https://github.com/dakshmiyani/hms/blob/main/src/bussinessLogic/managers/excelmanager.js): `src/bussinessLogic/managers/excelmanager.js`
- [QR check-in](https://github.com/dakshmiyani/hms/blob/main/src/bussinessLogic/managers/qrManager.js): `src/bussinessLogic/managers/qrManager.js`
- [Event management](https://github.com/dakshmiyani/hms/blob/main/src/bussinessLogic/managers/eventManager.js): `src/bussinessLogic/managers/eventManager.js`

### Judging and reporting

- [Dashboard data](https://github.com/dakshmiyani/hms/blob/main/src/bussinessLogic/managers/dashboardManager.js): `src/bussinessLogic/managers/dashboardManager.js`
- [Scoring and leaderboard](https://github.com/dakshmiyani/hms/blob/main/src/bussinessLogic/managers/judgeManager.js): `src/bussinessLogic/managers/judgeManager.js`
- [Excel export](https://github.com/dakshmiyani/hms/blob/main/src/utils/jsontoxlsx.js): `src/utils/jsontoxlsx.js`

### Persistence and integrations

- [Member records](https://github.com/dakshmiyani/hms/blob/main/src/models/memberModel.js): `src/models/memberModel.js`
- [Team records](https://github.com/dakshmiyani/hms/blob/main/src/models/teamModel.js): `src/models/teamModel.js`
- [Event records](https://github.com/dakshmiyani/hms/blob/main/src/models/eventModel.js): `src/models/eventModel.js`
- [QR records](https://github.com/dakshmiyani/hms/blob/main/src/models/qrModel.js): `src/models/qrModel.js`
- [User records](https://github.com/dakshmiyani/hms/blob/main/src/models/userModel.js): `src/models/userModel.js`
- [AI/ML scores](https://github.com/dakshmiyani/hms/blob/main/src/models/judgeAimlModel.js): `src/models/judgeAimlModel.js`
- [Web scores](https://github.com/dakshmiyani/hms/blob/main/src/models/judgeWebDevModel.js): `src/models/judgeWebDevModel.js`
- [Database connection](https://github.com/dakshmiyani/hms/blob/main/src/models/libs/db.js): `src/models/libs/db.js`
- [QR generation](https://github.com/dakshmiyani/hms/blob/main/src/utils/qrCodeGeneration.js): `src/utils/qrCodeGeneration.js`
- [Object storage](https://github.com/dakshmiyani/hms/blob/main/src/utils/s3.js): `src/utils/s3.js`

### Other components

- **API client**

## Connections

- API client → Route map: sends requests (evidence: `src/routes/middleware/routeMap.js`)
- Route map → Authentication routes: routes auth (evidence: `src/routes/middleware/routeMap.js`)
- Route map → Member routes: routes members (evidence: `src/routes/middleware/routeMap.js`)
- Route map → Team routes: routes teams (evidence: `src/routes/middleware/routeMap.js`)
- Route map → QR scan routes: routes scans (evidence: `src/routes/middleware/routeMap.js`)
- Route map → Judge routes: routes judging (evidence: `src/routes/middleware/routeMap.js`)
- Route map → Event routes: routes events (evidence: `src/routes/middleware/routeMap.js`)
- Route map → Bulk upload routes: routes uploads (evidence: `src/routes/middleware/routeMap.js`)
- Route map → Dashboard routes: routes dashboard (evidence: `src/routes/middleware/routeMap.js`)
- Authentication routes → Authentication: invokes authentication (evidence: `src/routes/controller/authRouter.js`)
- Member routes → Member registration: invokes member operations (evidence: `src/routes/controller/memberRouter.js`)
- Member routes → Spreadsheet imports: processes uploaded sheet (evidence: `src/routes/controller/memberRouter.js`)
- Team routes → Team management: invokes team operations (evidence: `src/routes/controller/teamRouter.js`)
- QR scan routes → QR check-in: handles scans (evidence: `src/routes/controller/qrScanRouter.js`)
- Judge routes → Scoring and leaderboard: requests scores (evidence: `src/routes/controller/judgeRouter.js`)
- Judge routes → Excel export: exports leaderboard (evidence: `src/routes/controller/judgeRouter.js`)
- Member registration → Member records: reads and updates (evidence: `src/bussinessLogic/managers/memberManager.js`)
- Member registration → Team records: manages team membership (evidence: `src/bussinessLogic/managers/memberManager.js`)
- Member registration → Event records: looks up events (evidence: `src/bussinessLogic/managers/memberManager.js`)
- Team management → Team records: manages teams (evidence: `src/bussinessLogic/managers/teamManager.js`)
- Spreadsheet imports → Event records: resolves event (evidence: `src/bussinessLogic/managers/excelmanager.js`)
- Spreadsheet imports → Member registration: creates participants (evidence: `src/bussinessLogic/managers/excelmanager.js`)
- QR check-in → QR records: reads QR records (evidence: `src/bussinessLogic/managers/qrManager.js`)
- QR check-in → Member records: updates scan state (evidence: `src/bussinessLogic/managers/qrManager.js`)
- QR check-in → QR generation: generates QR codes (evidence: `src/bussinessLogic/managers/qrManager.js`)
- QR check-in → Object storage: uploads QR assets (evidence: `src/bussinessLogic/managers/qrManager.js`)
- Authentication → User records: authenticates users (evidence: `src/bussinessLogic/managers/authManager.js`)
- Dashboard data → Dashboard routes: serves dashboard requests
- Scoring and leaderboard → AI/ML scores: uses AI/ML scoring (evidence: `src/bussinessLogic/managers/judgeManager.js`)
- Scoring and leaderboard → Web scores: uses web scoring (evidence: `src/bussinessLogic/managers/judgeManager.js`)
- Member records → Database connection: queries database (evidence: `src/models/memberModel.js`)
- Team records → Database connection: queries database (evidence: `src/models/teamModel.js`)
- Event records → Database connection: queries database (evidence: `src/models/eventModel.js`)
- QR records → Database connection: queries database (evidence: `src/models/qrModel.js`)
- User records → Database connection: queries database (evidence: `src/models/userModel.js`)
- AI/ML scores → Database connection: queries database (evidence: `src/models/judgeAimlModel.js`)
