# jaivignesh-r/yhack-26 architecture

> Architecture diagram of the GitHub repository jaivignesh-r/yhack-26, 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/jaivignesh-r/yhack-26
- Repository: https://github.com/jaivignesh-r/yhack-26

## Overview

This is a full-stack single-window licensing and compliance platform. Businesses authenticate, maintain a profile, discover applicable approvals and dependencies, submit applications and documents, then track scrutiny, inspections, certificates, renewals and grievances. Officers review and inspect cases; administrators configure departments, rules and dependencies and monitor performance. The graph preserves these documented capabilities. Source excerpts and index support the principal API wiring; some client feature pages and controller internals were not sampled, so those relationships are omitted where not evidenced.

Main entry points: [`client/src/App.jsx`](https://github.com/jaivignesh-r/yhack-26/blob/main/client/src/App.jsx) (Web application), [`server/src/index.js`](https://github.com/jaivignesh-r/yhack-26/blob/main/server/src/index.js) (HTTP API), [`server/src/middleware/auth.js`](https://github.com/jaivignesh-r/yhack-26/blob/main/server/src/middleware/auth.js) (JWT and role access), [`server/src/config/db.js`](https://github.com/jaivignesh-r/yhack-26/blob/main/server/src/config/db.js) (Platform data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web experience"]
  node_web_app["Web application<br/>[App.jsx]"]
  node_auth_context["Session and identity<br/>[AuthContext.jsx]"]
  node_business_ui["Business services UI"]
  node_officer_ui["Officer desk"]
  node_admin_ui["Admin console"]
end

subgraph group_api["API and access"]
  node_api_server["HTTP API<br/>[index.js]"]
  node_auth_routes["Authentication routes<br/>[authRoutes.js]"]
  node_auth_controller["Authentication service<br/>[authController.js]"]
  node_access_control["JWT and role access<br/>[auth.js]"]
  node_compliance_routes["Compliance routes"]
  node_application_routes["Application routes"]
  node_officer_routes["Officer routes<br/>[officerRoutes.js]"]
  node_admin_routes["Admin routes<br/>[adminRoutes.js]"]
  node_grievance_routes["Grievance routes<br/>[grievanceRoutes.js]"]
end

subgraph group_business["Business approvals"]
  node_profile_checklist["Profile and approvals"]
  node_rule_engine["Approval rules and risk<br/>[ruleEngine.js]"]
  node_roadmap["Dependency roadmap"]
  node_application_processing["Application filing"]
  node_document_validation["Document checks"]
  node_licences["Certificates and renewal"]
end

subgraph group_government["Government operations"]
  node_officer_workflow["Review and inspections"]
  node_grievances["Grievance handling"]
  node_admin_management["Configuration and analytics<br/>[adminController.js]"]
end

subgraph group_platform["Platform data and logic"]
  node_data_store[("Platform data<br/>[db.js]")]
end

node_business_actor(("Business user"))
node_officer_actor(("Government officer"))
node_admin_actor(("Platform admin"))

node_business_actor -->|"uses"| node_web_app
node_officer_actor -->|"uses"| node_web_app
node_admin_actor -->|"uses"| node_web_app
node_web_app -->|"provides session"| node_auth_context
node_auth_context -->|"requests login and session"| node_auth_routes
node_web_app -->|"routes business users"| node_business_ui
node_web_app -->|"routes officers"| node_officer_ui
node_web_app -->|"routes administrators"| node_admin_ui
node_business_ui -.->|"calls compliance API"| node_compliance_routes
node_business_ui -.->|"calls application API"| node_application_routes
node_officer_ui -.->|"calls officer API"| node_officer_routes
node_officer_ui -.->|"calls grievance API"| node_grievance_routes
node_admin_ui -->|"calls admin API"| node_admin_routes
node_api_server -->|"mounts"| node_auth_routes
node_api_server -->|"mounts"| node_compliance_routes
node_api_server -->|"mounts"| node_application_routes
node_api_server -->|"mounts"| node_officer_routes
node_api_server -->|"mounts"| node_grievance_routes
node_api_server -->|"mounts"| node_admin_routes
node_auth_routes -->|"routes to"| node_auth_controller
node_auth_routes -->|"applies authentication"| node_access_control
node_compliance_routes -->|"routes to"| node_profile_checklist
node_compliance_routes -->|"applies authentication"| node_access_control
node_application_routes -->|"routes to"| node_application_processing
node_application_routes -->|"applies authentication"| node_access_control
node_officer_routes -->|"routes to"| node_officer_workflow
node_officer_routes -->|"applies access control"| node_access_control
node_admin_routes -->|"routes to"| node_admin_management
node_admin_routes -->|"requires admin role"| node_access_control
node_grievance_routes -->|"routes to"| node_grievances
node_grievance_routes -->|"applies authentication"| node_access_control
node_profile_checklist -->|"evaluates approvals"| node_rule_engine
node_profile_checklist -->|"builds roadmap"| node_roadmap
node_application_processing -->|"uses approval rules"| node_rule_engine
node_application_processing -->|"validates evidence"| node_document_validation
node_officer_workflow -->|"issues licences"| node_licences
node_auth_controller -->|"reads and writes"| node_data_store
node_profile_checklist -->|"reads and writes"| node_data_store
node_application_processing -->|"reads and writes"| node_data_store
node_officer_workflow -->|"reads and writes"| node_data_store
node_grievances -->|"reads and writes"| node_data_store
node_admin_management -->|"reads and writes"| node_data_store

click node_web_app "https://github.com/jaivignesh-r/yhack-26/blob/main/client/src/App.jsx"
click node_auth_context "https://github.com/jaivignesh-r/yhack-26/blob/main/client/src/context/AuthContext.jsx"
click node_business_ui "https://github.com/jaivignesh-r/yhack-26/tree/main/client/src/pages/business"
click node_officer_ui "https://github.com/jaivignesh-r/yhack-26/tree/main/client/src/pages/officer"
click node_admin_ui "https://github.com/jaivignesh-r/yhack-26/tree/main/client/src/pages/admin"
click node_api_server "https://github.com/jaivignesh-r/yhack-26/blob/main/server/src/index.js"
click node_auth_routes "https://github.com/jaivignesh-r/yhack-26/blob/main/server/src/routes/authRoutes.js"
click node_auth_controller "https://github.com/jaivignesh-r/yhack-26/blob/main/server/src/controllers/authController.js"
click node_access_control "https://github.com/jaivignesh-r/yhack-26/blob/main/server/src/middleware/auth.js"
click node_compliance_routes "https://github.com/jaivignesh-r/yhack-26/blob/main/server/src/routes/complianceRoutes.js"
click node_application_routes "https://github.com/jaivignesh-r/yhack-26/blob/main/server/src/routes/applicationRoutes.js"
click node_officer_routes "https://github.com/jaivignesh-r/yhack-26/blob/main/server/src/routes/officerRoutes.js"
click node_admin_routes "https://github.com/jaivignesh-r/yhack-26/blob/main/server/src/routes/adminRoutes.js"
click node_grievance_routes "https://github.com/jaivignesh-r/yhack-26/blob/main/server/src/routes/grievanceRoutes.js"
click node_profile_checklist "https://github.com/jaivignesh-r/yhack-26/blob/main/server/src/controllers/complianceController.js"
click node_rule_engine "https://github.com/jaivignesh-r/yhack-26/blob/main/server/src/services/ruleEngine.js"
click node_roadmap "https://github.com/jaivignesh-r/yhack-26/blob/main/server/src/services/dependencyEngine.js"
click node_application_processing "https://github.com/jaivignesh-r/yhack-26/blob/main/server/src/controllers/applicationController.js"
click node_document_validation "https://github.com/jaivignesh-r/yhack-26/blob/main/server/src/services/documentValidator.js"
click node_licences "https://github.com/jaivignesh-r/yhack-26/blob/main/server/src/controllers/complianceController.js"
click node_officer_workflow "https://github.com/jaivignesh-r/yhack-26/blob/main/server/src/controllers/officerController.js"
click node_grievances "https://github.com/jaivignesh-r/yhack-26/blob/main/server/src/controllers/grievanceController.js"
click node_admin_management "https://github.com/jaivignesh-r/yhack-26/blob/main/server/src/controllers/adminController.js"
click node_data_store "https://github.com/jaivignesh-r/yhack-26/blob/main/server/src/config/db.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_web_app,node_auth_context,node_business_ui,node_officer_ui,node_admin_ui,node_business_actor toneBlue
class node_api_server,node_auth_routes,node_auth_controller,node_access_control,node_compliance_routes,node_application_routes,node_officer_routes,node_admin_routes,node_grievance_routes toneAmber
class node_profile_checklist,node_rule_engine,node_roadmap,node_application_processing,node_document_validation,node_licences toneMint
class node_officer_workflow,node_grievances,node_admin_management toneRose
class node_data_store,node_officer_actor,node_admin_actor toneIndigo
```

## Components

### Web experience

- [Web application](https://github.com/jaivignesh-r/yhack-26/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Session and identity](https://github.com/jaivignesh-r/yhack-26/blob/main/client/src/context/AuthContext.jsx): `client/src/context/AuthContext.jsx`
- [Business services UI](https://github.com/jaivignesh-r/yhack-26/tree/main/client/src/pages/business): `client/src/pages/business`
- [Officer desk](https://github.com/jaivignesh-r/yhack-26/tree/main/client/src/pages/officer): `client/src/pages/officer`
- [Admin console](https://github.com/jaivignesh-r/yhack-26/tree/main/client/src/pages/admin): `client/src/pages/admin`

### API and access

- [HTTP API](https://github.com/jaivignesh-r/yhack-26/blob/main/server/src/index.js): `server/src/index.js`
- [Authentication routes](https://github.com/jaivignesh-r/yhack-26/blob/main/server/src/routes/authRoutes.js): `server/src/routes/authRoutes.js`
- [Authentication service](https://github.com/jaivignesh-r/yhack-26/blob/main/server/src/controllers/authController.js): `server/src/controllers/authController.js`
- [JWT and role access](https://github.com/jaivignesh-r/yhack-26/blob/main/server/src/middleware/auth.js): `server/src/middleware/auth.js`
- [Compliance routes](https://github.com/jaivignesh-r/yhack-26/blob/main/server/src/routes/complianceRoutes.js): `server/src/routes/complianceRoutes.js`
- [Application routes](https://github.com/jaivignesh-r/yhack-26/blob/main/server/src/routes/applicationRoutes.js): `server/src/routes/applicationRoutes.js`
- [Officer routes](https://github.com/jaivignesh-r/yhack-26/blob/main/server/src/routes/officerRoutes.js): `server/src/routes/officerRoutes.js`
- [Admin routes](https://github.com/jaivignesh-r/yhack-26/blob/main/server/src/routes/adminRoutes.js): `server/src/routes/adminRoutes.js`
- [Grievance routes](https://github.com/jaivignesh-r/yhack-26/blob/main/server/src/routes/grievanceRoutes.js): `server/src/routes/grievanceRoutes.js`

### Business approvals

- [Profile and approvals](https://github.com/jaivignesh-r/yhack-26/blob/main/server/src/controllers/complianceController.js): `server/src/controllers/complianceController.js`
- [Approval rules and risk](https://github.com/jaivignesh-r/yhack-26/blob/main/server/src/services/ruleEngine.js): `server/src/services/ruleEngine.js`
- [Dependency roadmap](https://github.com/jaivignesh-r/yhack-26/blob/main/server/src/services/dependencyEngine.js): `server/src/services/dependencyEngine.js`
- [Application filing](https://github.com/jaivignesh-r/yhack-26/blob/main/server/src/controllers/applicationController.js): `server/src/controllers/applicationController.js`
- [Document checks](https://github.com/jaivignesh-r/yhack-26/blob/main/server/src/services/documentValidator.js): `server/src/services/documentValidator.js`
- [Certificates and renewal](https://github.com/jaivignesh-r/yhack-26/blob/main/server/src/controllers/complianceController.js): `server/src/controllers/complianceController.js`

### Government operations

- [Review and inspections](https://github.com/jaivignesh-r/yhack-26/blob/main/server/src/controllers/officerController.js): `server/src/controllers/officerController.js`
- [Grievance handling](https://github.com/jaivignesh-r/yhack-26/blob/main/server/src/controllers/grievanceController.js): `server/src/controllers/grievanceController.js`
- [Configuration and analytics](https://github.com/jaivignesh-r/yhack-26/blob/main/server/src/controllers/adminController.js): `server/src/controllers/adminController.js`

### Platform data and logic

- [Platform data](https://github.com/jaivignesh-r/yhack-26/blob/main/server/src/config/db.js): `server/src/config/db.js`

### Other components

- **Business user**
- **Government officer**
- **Platform admin**

## Connections

- Business user → Web application: uses (evidence: `client/src/App.jsx`)
- Government officer → Web application: uses (evidence: `client/src/App.jsx`)
- Platform admin → Web application: uses (evidence: `client/src/App.jsx`)
- Web application → Session and identity: provides session (evidence: `client/src/App.jsx`)
- Session and identity → Authentication routes: requests login and session (evidence: `client/src/context/AuthContext.jsx`)
- Web application → Business services UI: routes business users (evidence: `client/src/App.jsx`)
- Web application → Officer desk: routes officers (evidence: `client/src/App.jsx`)
- Web application → Admin console: routes administrators (evidence: `client/src/App.jsx`)
- Business services UI → Compliance routes: calls compliance API
- Business services UI → Application routes: calls application API
- Officer desk → Officer routes: calls officer API
- Officer desk → Grievance routes: calls grievance API
- Admin console → Admin routes: calls admin API (evidence: `client/src/pages/admin/AdminRuleEnginePage.jsx`)
- HTTP API → Authentication routes: mounts (evidence: `server/src/index.js`)
- HTTP API → Compliance routes: mounts (evidence: `server/src/index.js`)
- HTTP API → Application routes: mounts (evidence: `server/src/index.js`)
- HTTP API → Officer routes: mounts (evidence: `server/src/index.js`)
- HTTP API → Grievance routes: mounts (evidence: `server/src/index.js`)
- HTTP API → Admin routes: mounts (evidence: `server/src/index.js`)
- Authentication routes → Authentication service: routes to (evidence: `server/src/routes/authRoutes.js`)
- Authentication routes → JWT and role access: applies authentication (evidence: `server/src/routes/authRoutes.js`)
- Compliance routes → Profile and approvals: routes to (evidence: `server/src/routes/complianceRoutes.js`)
- Compliance routes → JWT and role access: applies authentication (evidence: `server/src/routes/complianceRoutes.js`)
- Application routes → Application filing: routes to (evidence: `server/src/routes/applicationRoutes.js`)
- Application routes → JWT and role access: applies authentication (evidence: `server/src/routes/applicationRoutes.js`)
- Officer routes → Review and inspections: routes to (evidence: `server/src/routes/officerRoutes.js`)
- Officer routes → JWT and role access: applies access control (evidence: `server/src/routes/officerRoutes.js`)
- Admin routes → Configuration and analytics: routes to (evidence: `server/src/routes/adminRoutes.js`)
- Admin routes → JWT and role access: requires admin role (evidence: `server/src/routes/adminRoutes.js`)
- Grievance routes → Grievance handling: routes to (evidence: `server/src/routes/grievanceRoutes.js`)
- Grievance routes → JWT and role access: applies authentication (evidence: `server/src/routes/grievanceRoutes.js`)
- Profile and approvals → Approval rules and risk: evaluates approvals (evidence: `server/src/controllers/complianceController.js`)
- Profile and approvals → Dependency roadmap: builds roadmap (evidence: `server/src/controllers/complianceController.js`)
- Application filing → Approval rules and risk: uses approval rules (evidence: `server/src/controllers/applicationController.js`)
- Application filing → Document checks: validates evidence (evidence: `server/src/controllers/applicationController.js`)
- Review and inspections → Certificates and renewal: issues licences (evidence: `server/src/controllers/officerController.js`)
- Authentication service → Platform data: reads and writes (evidence: `server/src/controllers/authController.js`)
- Profile and approvals → Platform data: reads and writes (evidence: `server/src/controllers/complianceController.js`)
- Application filing → Platform data: reads and writes (evidence: `server/src/controllers/applicationController.js`)
- Review and inspections → Platform data: reads and writes (evidence: `server/src/controllers/officerController.js`)
- Grievance handling → Platform data: reads and writes (evidence: `server/src/controllers/grievanceController.js`)
- Configuration and analytics → Platform data: reads and writes (evidence: `server/src/controllers/adminController.js`)
