# sathyamaragani/26087-erp architecture

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

- Interactive diagram: https://gitdiagram.com/sathyamaragani/26087-erp
- Repository: https://github.com/sathyamaragani/26087-erp

## Overview

NCCT is a multi-tenant institutional ERP and learning platform for cooperative training institutes. A user enters through a role-specific web workspace, where tenant-scoped screens use the API for academic setup, nominations, learning, attendance, credentials and employment; the platform also reports analytics and campus operations. The graph preserves the README’s major capability branches, including offline learning and public certificate lookup. API controller-to-service links are supported by the source index or excerpts; several unsampled feature integrations are documented capabilities rather than inspected call paths.

Main entry points: [`apps/web/src/api/client.ts`](https://github.com/sathyamaragani/26087-erp/blob/main/apps/web/src/api/client.ts) (API client), [`apps/api/src/modules/academics/academics.controller.ts`](https://github.com/sathyamaragani/26087-erp/blob/main/apps/api/src/modules/academics/academics.controller.ts) (Academic core), [`apps/api/src/prisma/prisma.service.ts`](https://github.com/sathyamaragani/26087-erp/blob/main/apps/api/src/prisma/prisma.service.ts) (PostgreSQL store), [`apps/api/src/modules/lms/lms.controller.ts`](https://github.com/sathyamaragani/26087-erp/blob/main/apps/api/src/modules/lms/lms.controller.ts) (Learning platform)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Web experience"]
  node_webapp["Web application<br/>[App.tsx]"]
  node_webclient["API client<br/>[client.ts]"]
  node_offline[("Offline learning<br/>[offlineStore.ts]")]
  node_authui["Session state<br/>[auth.tsx]"]
end

subgraph group_identity["Identity and tenancy"]
  node_auth["Authentication<br/>[auth.service.ts]"]
  node_orgs["Organizations"]
  node_security["Tenant access controls"]
end

subgraph group_learning["Training lifecycle"]
  node_academics["Academic core"]
  node_nominations["Nominations"]
  node_students["Student records"]
  node_timetable["Timetable"]
  node_attendance["Smart attendance"]
  node_lms["Learning platform<br/>[lms.controller.ts]"]
end

subgraph group_outcomes["Campus and outcomes"]
  node_skills["Skills"]
  node_certs["Credentials"]
  node_verify["Public verification"]
  node_employment["Employment exchange"]
  node_counselling["Career counselor"]
  node_campus["Campus logistics"]
end

subgraph group_platform["Platform services"]
  node_analytics["Analytics"]
  node_audit["Audit records<br/>[audit.service.ts]"]
  node_database[("PostgreSQL store<br/>[prisma.service.ts]")]
end

node_user(("Institute user"))

node_user -->|"uses"| node_webapp
node_webapp -->|"restores session"| node_authui
node_authui -->|"calls API"| node_webclient
node_webapp -.->|"loads records"| node_webclient
node_webclient -.->|"sends requests"| node_auth
node_webclient -.->|"requests"| node_academics
node_webclient -.->|"requests"| node_nominations
node_webclient -.->|"requests"| node_attendance
node_webclient -.->|"requests"| node_lms
node_webclient -.->|"requests"| node_certs
node_webclient -.->|"requests"| node_employment
node_offline -->|"syncs progress"| node_lms
node_auth -->|"reads and writes"| node_database
node_auth -->|"logs events"| node_audit
node_security -->|"checks membership"| node_database
node_academics -.->|"supports records"| node_students
node_academics -.->|"enables training intake"| node_nominations
node_academics -.->|"schedules training"| node_timetable
node_academics -.->|"supports sessions"| node_attendance
node_lms -.->|"builds competencies"| node_skills
node_skills -.->|"evidences skills"| node_certs
node_certs -.->|"looks up status"| node_verify
node_skills -.->|"matches candidates"| node_employment
node_lms -.->|"grounds advice"| node_counselling
node_campus -.->|"reports operations"| node_analytics
node_academics -.->|"reports measures"| node_analytics
node_nominations -.->|"persists workflow"| node_database
node_attendance -.->|"persists attendance"| node_database
node_lms -.->|"persists learning"| node_database
node_certs -.->|"checks registry"| node_database

click node_webapp "https://github.com/sathyamaragani/26087-erp/blob/main/apps/web/src/App.tsx"
click node_webclient "https://github.com/sathyamaragani/26087-erp/blob/main/apps/web/src/api/client.ts"
click node_offline "https://github.com/sathyamaragani/26087-erp/blob/main/apps/web/src/lib/offlineStore.ts"
click node_authui "https://github.com/sathyamaragani/26087-erp/blob/main/apps/web/src/state/auth.tsx"
click node_auth "https://github.com/sathyamaragani/26087-erp/blob/main/apps/api/src/modules/auth/auth.service.ts"
click node_orgs "https://github.com/sathyamaragani/26087-erp/tree/main/apps/api/src/modules/organizations"
click node_security "https://github.com/sathyamaragani/26087-erp/blob/main/apps/api/src/common/guards/tenant-isolation.guard.ts"
click node_academics "https://github.com/sathyamaragani/26087-erp/blob/main/apps/api/src/modules/academics/academics.controller.ts"
click node_nominations "https://github.com/sathyamaragani/26087-erp/tree/main/apps/api/src/modules/nominations"
click node_students "https://github.com/sathyamaragani/26087-erp/blob/main/apps/api/src/modules/students/students.service.ts"
click node_timetable "https://github.com/sathyamaragani/26087-erp/tree/main/apps/api/src/modules/timetable"
click node_attendance "https://github.com/sathyamaragani/26087-erp/blob/main/apps/api/src/modules/attendance/attendance.controller.ts"
click node_lms "https://github.com/sathyamaragani/26087-erp/blob/main/apps/api/src/modules/lms/lms.controller.ts"
click node_skills "https://github.com/sathyamaragani/26087-erp/tree/main/apps/api/src/modules/skills"
click node_certs "https://github.com/sathyamaragani/26087-erp/blob/main/apps/api/src/modules/certifications/certifications.controller.ts"
click node_verify "https://github.com/sathyamaragani/26087-erp/blob/main/apps/web/src/components/PublicVerifyModal.tsx"
click node_employment "https://github.com/sathyamaragani/26087-erp/blob/main/apps/api/src/modules/employment/employment.controller.ts"
click node_counselling "https://github.com/sathyamaragani/26087-erp/tree/main/apps/api/src/modules/counselling"
click node_campus "https://github.com/sathyamaragani/26087-erp/tree/main/apps/api/src/modules/hostel"
click node_analytics "https://github.com/sathyamaragani/26087-erp/tree/main/apps/api/src/modules/analytics"
click node_audit "https://github.com/sathyamaragani/26087-erp/blob/main/apps/api/src/modules/audit/audit.service.ts"
click node_database "https://github.com/sathyamaragani/26087-erp/blob/main/apps/api/src/prisma/prisma.service.ts"

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_webclient,node_offline,node_authui,node_user toneBlue
class node_auth,node_orgs,node_security toneAmber
class node_academics,node_nominations,node_students,node_timetable,node_attendance,node_lms toneMint
class node_skills,node_certs,node_verify,node_employment,node_counselling,node_campus toneRose
class node_analytics,node_audit,node_database toneIndigo
```

## Components

### Web experience

- [Web application](https://github.com/sathyamaragani/26087-erp/blob/main/apps/web/src/App.tsx): `apps/web/src/App.tsx`
- [API client](https://github.com/sathyamaragani/26087-erp/blob/main/apps/web/src/api/client.ts): `apps/web/src/api/client.ts`
- [Offline learning](https://github.com/sathyamaragani/26087-erp/blob/main/apps/web/src/lib/offlineStore.ts): `apps/web/src/lib/offlineStore.ts`
- [Session state](https://github.com/sathyamaragani/26087-erp/blob/main/apps/web/src/state/auth.tsx): `apps/web/src/state/auth.tsx`

### Identity and tenancy

- [Authentication](https://github.com/sathyamaragani/26087-erp/blob/main/apps/api/src/modules/auth/auth.service.ts): `apps/api/src/modules/auth/auth.service.ts`
- [Organizations](https://github.com/sathyamaragani/26087-erp/tree/main/apps/api/src/modules/organizations): `apps/api/src/modules/organizations`
- [Tenant access controls](https://github.com/sathyamaragani/26087-erp/blob/main/apps/api/src/common/guards/tenant-isolation.guard.ts): `apps/api/src/common/guards/tenant-isolation.guard.ts`

### Training lifecycle

- [Academic core](https://github.com/sathyamaragani/26087-erp/blob/main/apps/api/src/modules/academics/academics.controller.ts): `apps/api/src/modules/academics/academics.controller.ts`
- [Nominations](https://github.com/sathyamaragani/26087-erp/tree/main/apps/api/src/modules/nominations): `apps/api/src/modules/nominations`
- [Student records](https://github.com/sathyamaragani/26087-erp/blob/main/apps/api/src/modules/students/students.service.ts): `apps/api/src/modules/students/students.service.ts`
- [Timetable](https://github.com/sathyamaragani/26087-erp/tree/main/apps/api/src/modules/timetable): `apps/api/src/modules/timetable`
- [Smart attendance](https://github.com/sathyamaragani/26087-erp/blob/main/apps/api/src/modules/attendance/attendance.controller.ts): `apps/api/src/modules/attendance/attendance.controller.ts`
- [Learning platform](https://github.com/sathyamaragani/26087-erp/blob/main/apps/api/src/modules/lms/lms.controller.ts): `apps/api/src/modules/lms/lms.controller.ts`

### Campus and outcomes

- [Skills](https://github.com/sathyamaragani/26087-erp/tree/main/apps/api/src/modules/skills): `apps/api/src/modules/skills`
- [Credentials](https://github.com/sathyamaragani/26087-erp/blob/main/apps/api/src/modules/certifications/certifications.controller.ts): `apps/api/src/modules/certifications/certifications.controller.ts`
- [Public verification](https://github.com/sathyamaragani/26087-erp/blob/main/apps/web/src/components/PublicVerifyModal.tsx): `apps/web/src/components/PublicVerifyModal.tsx`
- [Employment exchange](https://github.com/sathyamaragani/26087-erp/blob/main/apps/api/src/modules/employment/employment.controller.ts): `apps/api/src/modules/employment/employment.controller.ts`
- [Career counselor](https://github.com/sathyamaragani/26087-erp/tree/main/apps/api/src/modules/counselling): `apps/api/src/modules/counselling`
- [Campus logistics](https://github.com/sathyamaragani/26087-erp/tree/main/apps/api/src/modules/hostel): `apps/api/src/modules/hostel`

### Platform services

- [Analytics](https://github.com/sathyamaragani/26087-erp/tree/main/apps/api/src/modules/analytics): `apps/api/src/modules/analytics`
- [Audit records](https://github.com/sathyamaragani/26087-erp/blob/main/apps/api/src/modules/audit/audit.service.ts): `apps/api/src/modules/audit/audit.service.ts`
- [PostgreSQL store](https://github.com/sathyamaragani/26087-erp/blob/main/apps/api/src/prisma/prisma.service.ts): `apps/api/src/prisma/prisma.service.ts`

### Other components

- **Institute user**

## Connections

- Institute user → Web application: uses (evidence: `apps/web/src/App.tsx`)
- Web application → Session state: restores session (evidence: `apps/web/src/App.tsx`)
- Session state → API client: calls API (evidence: `apps/web/src/state/auth.tsx`)
- Web application → API client: loads records
- API client → Authentication: sends requests (evidence: `README.md`)
- API client → Academic core: requests (evidence: `README.md`)
- API client → Nominations: requests (evidence: `README.md`)
- API client → Smart attendance: requests (evidence: `README.md`)
- API client → Learning platform: requests (evidence: `README.md`)
- API client → Credentials: requests (evidence: `README.md`)
- API client → Employment exchange: requests (evidence: `README.md`)
- Offline learning → Learning platform: syncs progress (evidence: `apps/api/src/modules/lms/lms.controller.ts`)
- Authentication → PostgreSQL store: reads and writes (evidence: `apps/api/src/modules/auth/auth.service.ts`)
- Authentication → Audit records: logs events (evidence: `apps/api/src/modules/auth/auth.service.ts`)
- Tenant access controls → PostgreSQL store: checks membership (evidence: `apps/api/src/common/guards/tenant-isolation.guard.ts`)
- Academic core → Student records: supports records
- Academic core → Nominations: enables training intake (evidence: `README.md`)
- Academic core → Timetable: schedules training (evidence: `README.md`)
- Academic core → Smart attendance: supports sessions (evidence: `README.md`)
- Learning platform → Skills: builds competencies (evidence: `README.md`)
- Skills → Credentials: evidences skills (evidence: `README.md`)
- Credentials → Public verification: looks up status (evidence: `README.md`)
- Skills → Employment exchange: matches candidates (evidence: `README.md`)
- Learning platform → Career counselor: grounds advice (evidence: `README.md`)
- Campus logistics → Analytics: reports operations (evidence: `README.md`)
- Academic core → Analytics: reports measures (evidence: `README.md`)
- Nominations → PostgreSQL store: persists workflow
- Smart attendance → PostgreSQL store: persists attendance
- Learning platform → PostgreSQL store: persists learning
- Credentials → PostgreSQL store: checks registry (evidence: `README.md`)
