# shashankponna/ncct-platform architecture

> Architecture diagram of the GitHub repository shashankponna/ncct-platform, 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/shashankponna/ncct-platform
- Repository: https://github.com/shashankponna/ncct-platform

## Overview

EduDisha is a cooperative training ERP and e-learning platform paired with a certification and employment exchange. Trainees and staff use the web UI (also packaged for mobile) to enrol in programmes, learn and attend sessions, complete assessments, and reach certificates; employers and trainees use job discovery and matching. The Express API routes these operations, enforcing authentication and role checks before accessing Supabase. Additional documented capabilities include offline lesson downloads/sync, AI counselling and chatbot, analytics, and public certificate verification. Edges cite shown calls or README architecture; broader capability links documented only in README are marked unverified.

Main entry points: [`apps/api/src/app.ts`](https://github.com/shashankponna/ncct-platform/blob/main/apps/api/src/app.ts) (Express API routing), [`apps/api/src/supabaseClient.ts`](https://github.com/shashankponna/ncct-platform/blob/main/apps/api/src/supabaseClient.ts) (Supabase access), [`apps/web/src`](https://github.com/shashankponna/ncct-platform/tree/main/apps/web/src) (Role-based web UI), [`apps/api/src/certificateService.ts`](https://github.com/shashankponna/ncct-platform/blob/main/apps/api/src/certificateService.ts) (Certificate issuance)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["User applications"]
  node_web["Role-based web UI"]
  node_mobile["Native app shell"]
end

subgraph group_training["Training lifecycle"]
  node_programme["Programme and nominations<br/>[nominations.ts]"]
  node_attendance["Attendance check-in<br/>[attendance.ts]"]
  node_learning["Courses and lessons<br/>[lessons.ts]"]
  node_offline["Offline lesson downloads<br/>[downloadManager.ts]"]
  node_offline_store["Offline metadata store<br/>[storage.ts]"]
  node_assessments["Assessment grading"]
  node_certificates["Certificate issuance"]
  node_public_verify["Public certificate and profile<br/>[publicProfile.ts]"]
end

subgraph group_career["Career services"]
  node_employment["Jobs and employer search<br/>[employerSearch.ts]"]
  node_matching["AI job matching"]
  node_skill_gap["Skill-gap analysis<br/>[skillGapService.ts]"]
  node_counsellor["Career counsellor"]
  node_chatbot["FAQ knowledge chatbot<br/>[chatbotService.ts]"]
end

subgraph group_platform["Platform services"]
  node_api["Express API routing<br/>[app.ts]"]
  node_auth["Authentication and roles<br/>[auth.ts]"]
  node_api_client["Typed API client<br/>[index.ts]"]
  node_analytics["Analytics and risk flags"]
  node_notifications["In-app notifications"]
  node_groq["Groq generation service<br/>[groqClient.ts]"]
end

subgraph group_data["Persistence"]
  node_supabase["Supabase access<br/>[supabaseClient.ts]"]
  node_database[("Postgres, Auth, Storage")]
  node_b2["Backblaze video storage"]
end

node_trainees(("Trainees"))
node_staff(("Institution staff"))
node_employers(("Employers"))

node_trainees -->|"use learning"| node_web
node_staff -->|"manage training"| node_web
node_employers -->|"search talent"| node_web
node_web -.->|"request services"| node_api_client
node_mobile -->|"package UI"| node_web
node_api_client -.->|"call API"| node_api
node_api -->|"dispatch routes"| node_programme
node_api -->|"dispatch routes"| node_attendance
node_api -->|"dispatch routes"| node_learning
node_api -.->|"dispatch routes"| node_assessments
node_api -.->|"dispatch routes"| node_certificates
node_api -->|"dispatch routes"| node_employment
node_api -.->|"dispatch routes"| node_chatbot
node_api -->|"dispatch routes"| node_analytics
node_programme -.->|"requires roles"| node_auth
node_attendance -->|"requires roles"| node_auth
node_auth -->|"creates user client"| node_supabase
node_attendance -->|"read and write"| node_supabase
node_learning -.->|"read and write"| node_supabase
node_assessments -->|"load course data"| node_supabase
node_certificates -->|"load completion"| node_assessments
node_certificates -->|"notify trainee"| node_notifications
node_certificates -->|"issue certificate"| node_supabase
node_public_verify -.->|"lookup public data"| node_supabase
node_employment -->|"include skill gaps"| node_skill_gap
node_skill_gap -->|"match jobs"| node_matching
node_matching -->|"read job data"| node_supabase
node_skill_gap -.->|"rank skills"| node_groq
node_counsellor -->|"generate guidance"| node_groq
node_chatbot -->|"generate answers"| node_groq
node_chatbot -->|"retrieve knowledge"| node_supabase
node_analytics -.->|"query metrics"| node_supabase
node_offline -->|"fetch lesson video"| node_api_client
node_offline -->|"save manifest"| node_offline_store
node_offline_store -.->|"persist preferences"| node_mobile
node_learning -.->|"serve uploaded video"| node_b2
node_supabase -->|"connect"| node_database

click node_web "https://github.com/shashankponna/ncct-platform/tree/main/apps/web/src"
click node_mobile "https://github.com/shashankponna/ncct-platform/tree/main/apps/mobile"
click node_api "https://github.com/shashankponna/ncct-platform/blob/main/apps/api/src/app.ts"
click node_auth "https://github.com/shashankponna/ncct-platform/blob/main/apps/api/src/middleware/auth.ts"
click node_api_client "https://github.com/shashankponna/ncct-platform/blob/main/packages/api-client/src/index.ts"
click node_supabase "https://github.com/shashankponna/ncct-platform/blob/main/apps/api/src/supabaseClient.ts"
click node_programme "https://github.com/shashankponna/ncct-platform/blob/main/apps/api/src/routes/nominations.ts"
click node_attendance "https://github.com/shashankponna/ncct-platform/blob/main/apps/api/src/routes/attendance.ts"
click node_learning "https://github.com/shashankponna/ncct-platform/blob/main/apps/api/src/routes/lessons.ts"
click node_offline "https://github.com/shashankponna/ncct-platform/blob/main/apps/web/src/offline/downloadManager.ts"
click node_offline_store "https://github.com/shashankponna/ncct-platform/blob/main/apps/web/src/offline/storage.ts"
click node_assessments "https://github.com/shashankponna/ncct-platform/blob/main/apps/api/src/assessmentScoring.ts"
click node_certificates "https://github.com/shashankponna/ncct-platform/blob/main/apps/api/src/certificateService.ts"
click node_public_verify "https://github.com/shashankponna/ncct-platform/blob/main/apps/api/src/routes/publicProfile.ts"
click node_employment "https://github.com/shashankponna/ncct-platform/blob/main/apps/api/src/routes/employerSearch.ts"
click node_matching "https://github.com/shashankponna/ncct-platform/blob/main/apps/api/src/jobMatchingService.ts"
click node_skill_gap "https://github.com/shashankponna/ncct-platform/blob/main/apps/api/src/skillGapService.ts"
click node_counsellor "https://github.com/shashankponna/ncct-platform/blob/main/apps/api/src/careerCounsellorService.ts"
click node_chatbot "https://github.com/shashankponna/ncct-platform/blob/main/apps/api/src/chatbotService.ts"
click node_analytics "https://github.com/shashankponna/ncct-platform/blob/main/apps/api/src/analyticsService.ts"
click node_notifications "https://github.com/shashankponna/ncct-platform/blob/main/apps/api/src/notificationService.ts"
click node_groq "https://github.com/shashankponna/ncct-platform/blob/main/apps/api/src/groqClient.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_web,node_mobile toneBlue
class node_programme,node_attendance,node_learning,node_offline,node_offline_store,node_assessments,node_certificates,node_public_verify toneAmber
class node_employment,node_matching,node_skill_gap,node_counsellor,node_chatbot toneMint
class node_api,node_auth,node_api_client,node_analytics,node_notifications,node_groq toneRose
class node_supabase,node_database,node_b2,node_trainees,node_staff,node_employers toneIndigo
```

## Components

### User applications

- [Role-based web UI](https://github.com/shashankponna/ncct-platform/tree/main/apps/web/src): `apps/web/src`
- [Native app shell](https://github.com/shashankponna/ncct-platform/tree/main/apps/mobile): `apps/mobile`

### Training lifecycle

- [Programme and nominations](https://github.com/shashankponna/ncct-platform/blob/main/apps/api/src/routes/nominations.ts): `apps/api/src/routes/nominations.ts`
- [Attendance check-in](https://github.com/shashankponna/ncct-platform/blob/main/apps/api/src/routes/attendance.ts): `apps/api/src/routes/attendance.ts`
- [Courses and lessons](https://github.com/shashankponna/ncct-platform/blob/main/apps/api/src/routes/lessons.ts): `apps/api/src/routes/lessons.ts`
- [Offline lesson downloads](https://github.com/shashankponna/ncct-platform/blob/main/apps/web/src/offline/downloadManager.ts): `apps/web/src/offline/downloadManager.ts`
- [Offline metadata store](https://github.com/shashankponna/ncct-platform/blob/main/apps/web/src/offline/storage.ts): `apps/web/src/offline/storage.ts`
- [Assessment grading](https://github.com/shashankponna/ncct-platform/blob/main/apps/api/src/assessmentScoring.ts): `apps/api/src/assessmentScoring.ts`
- [Certificate issuance](https://github.com/shashankponna/ncct-platform/blob/main/apps/api/src/certificateService.ts): `apps/api/src/certificateService.ts`
- [Public certificate and profile](https://github.com/shashankponna/ncct-platform/blob/main/apps/api/src/routes/publicProfile.ts): `apps/api/src/routes/publicProfile.ts`

### Career services

- [Jobs and employer search](https://github.com/shashankponna/ncct-platform/blob/main/apps/api/src/routes/employerSearch.ts): `apps/api/src/routes/employerSearch.ts`
- [AI job matching](https://github.com/shashankponna/ncct-platform/blob/main/apps/api/src/jobMatchingService.ts): `apps/api/src/jobMatchingService.ts`
- [Skill-gap analysis](https://github.com/shashankponna/ncct-platform/blob/main/apps/api/src/skillGapService.ts): `apps/api/src/skillGapService.ts`
- [Career counsellor](https://github.com/shashankponna/ncct-platform/blob/main/apps/api/src/careerCounsellorService.ts): `apps/api/src/careerCounsellorService.ts`
- [FAQ knowledge chatbot](https://github.com/shashankponna/ncct-platform/blob/main/apps/api/src/chatbotService.ts): `apps/api/src/chatbotService.ts`

### Platform services

- [Express API routing](https://github.com/shashankponna/ncct-platform/blob/main/apps/api/src/app.ts): `apps/api/src/app.ts`
- [Authentication and roles](https://github.com/shashankponna/ncct-platform/blob/main/apps/api/src/middleware/auth.ts): `apps/api/src/middleware/auth.ts`
- [Typed API client](https://github.com/shashankponna/ncct-platform/blob/main/packages/api-client/src/index.ts): `packages/api-client/src/index.ts`
- [Analytics and risk flags](https://github.com/shashankponna/ncct-platform/blob/main/apps/api/src/analyticsService.ts): `apps/api/src/analyticsService.ts`
- [In-app notifications](https://github.com/shashankponna/ncct-platform/blob/main/apps/api/src/notificationService.ts): `apps/api/src/notificationService.ts`
- [Groq generation service](https://github.com/shashankponna/ncct-platform/blob/main/apps/api/src/groqClient.ts): `apps/api/src/groqClient.ts`

### Persistence

- [Supabase access](https://github.com/shashankponna/ncct-platform/blob/main/apps/api/src/supabaseClient.ts): `apps/api/src/supabaseClient.ts`
- **Postgres, Auth, Storage**
- **Backblaze video storage**

### Other components

- **Trainees**
- **Institution staff**
- **Employers**

## Connections

- Trainees → Role-based web UI: use learning
- Institution staff → Role-based web UI: manage training
- Employers → Role-based web UI: search talent
- Role-based web UI → Typed API client: request services
- Native app shell → Role-based web UI: package UI
- Typed API client → Express API routing: call API
- Express API routing → Programme and nominations: dispatch routes (evidence: `apps/api/src/app.ts`)
- Express API routing → Attendance check-in: dispatch routes (evidence: `apps/api/src/app.ts`)
- Express API routing → Courses and lessons: dispatch routes (evidence: `apps/api/src/app.ts`)
- Express API routing → Assessment grading: dispatch routes (evidence: `apps/api/src/app.ts`)
- Express API routing → Certificate issuance: dispatch routes (evidence: `apps/api/src/app.ts`)
- Express API routing → Jobs and employer search: dispatch routes (evidence: `apps/api/src/app.ts`)
- Express API routing → FAQ knowledge chatbot: dispatch routes (evidence: `apps/api/src/app.ts`)
- Express API routing → Analytics and risk flags: dispatch routes (evidence: `apps/api/src/app.ts`)
- Programme and nominations → Authentication and roles: requires roles
- Attendance check-in → Authentication and roles: requires roles (evidence: `apps/api/src/routes/attendance.ts`)
- Authentication and roles → Supabase access: creates user client (evidence: `apps/api/src/middleware/auth.ts`)
- Attendance check-in → Supabase access: read and write (evidence: `apps/api/src/routes/attendance.ts`)
- Courses and lessons → Supabase access: read and write
- Assessment grading → Supabase access: load course data (evidence: `apps/api/src/assessmentScoring.ts`)
- Certificate issuance → Assessment grading: load completion (evidence: `apps/api/src/certificateService.ts`)
- Certificate issuance → In-app notifications: notify trainee (evidence: `apps/api/src/certificateService.ts`)
- Certificate issuance → Supabase access: issue certificate (evidence: `apps/api/src/certificateService.ts`)
- Public certificate and profile → Supabase access: lookup public data (evidence: `apps/api/src/routes/publicProfile.ts`)
- Jobs and employer search → Skill-gap analysis: include skill gaps (evidence: `apps/api/src/routes/employerSearch.ts`)
- Skill-gap analysis → AI job matching: match jobs (evidence: `apps/api/src/skillGapService.ts`)
- AI job matching → Supabase access: read job data (evidence: `apps/api/src/jobMatchingService.ts`)
- Skill-gap analysis → Groq generation service: rank skills (evidence: `apps/api/src/skillGapService.ts`)
- Career counsellor → Groq generation service: generate guidance (evidence: `apps/api/src/careerCounsellorService.ts`)
- FAQ knowledge chatbot → Groq generation service: generate answers (evidence: `apps/api/src/chatbotService.ts`)
- FAQ knowledge chatbot → Supabase access: retrieve knowledge (evidence: `apps/api/src/chatbotService.ts`)
- Analytics and risk flags → Supabase access: query metrics
- Offline lesson downloads → Typed API client: fetch lesson video (evidence: `apps/web/src/offline/downloadManager.ts`)
- Offline lesson downloads → Offline metadata store: save manifest (evidence: `apps/web/src/offline/downloadManager.ts`)
- Offline metadata store → Native app shell: persist preferences (evidence: `apps/web/src/offline/storage.ts`)
- Courses and lessons → Backblaze video storage: serve uploaded video
- Supabase access → Postgres, Auth, Storage: connect
