# karthik-kurup/sahakaar-setu architecture

> Architecture diagram of the GitHub repository karthik-kurup/sahakaar-setu, 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/karthik-kurup/sahakaar-setu
- Repository: https://github.com/karthik-kurup/sahakaar-setu

## Overview

Sahakaar Setu is a role-based cooperative training and careers platform. Users enter through public pages or sign in, then use administrator, institute staff, trainer, trainee, or employer portals for programme administration, learning, attendance, certification, skills, and jobs. The React client calls an Express API; authentication and domain routes use Prisma-backed data. The README documents these product capabilities, while the sampled files show routing, auth, and offline quiz syncing. Some domain-route details are unsampled, so their links are limited to documented mounts and indexed references.

Main entry points: [`server/src/index.ts`](https://github.com/karthik-kurup/sahakaar-setu/blob/main/server/src/index.ts) (Express API), [`client/src/App.tsx`](https://github.com/karthik-kurup/sahakaar-setu/blob/main/client/src/App.tsx) (Route selection), [`client/src/lib/api.ts`](https://github.com/karthik-kurup/sahakaar-setu/blob/main/client/src/lib/api.ts) (API client), [`server/src/lib/prisma.ts`](https://github.com/karthik-kurup/sahakaar-setu/blob/main/server/src/lib/prisma.ts) (Prisma client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client experience"]
  node_app["Route selection<br/>[App.tsx]"]
  node_home["Public home<br/>[HomePage.tsx]"]
  node_login["Sign in<br/>[LoginPage.tsx]"]
  node_register["Registration<br/>[RegisterPage.tsx]"]
  node_admin["Admin portal<br/>[AdminDashboard.tsx]"]
  node_staff["Staff portal<br/>[StaffDashboard.tsx]"]
  node_trainer["Trainer portal"]
  node_trainee["Trainee portal"]
  node_employer["Employer portal"]
  node_demo["Demo workflow<br/>[DemoWorkflow.tsx]"]
  node_section["Portal sections"]
  node_language["Translations<br/>[i18n.ts]"]
end

subgraph group_identity["Identity and connectivity"]
  node_authctx["Session context<br/>[AuthContext.tsx]"]
  node_connectivity["Connectivity context"]
  node_offline[("Offline records<br/>[offlineStorage.ts]")]
end

subgraph group_learning["Training and attendance"]
  node_programmes["Programmes and institutes<br/>[programmes.ts]"]
  node_attendance["Attendance<br/>[attendance.ts]"]
  node_modules["Learning modules<br/>[modules.ts]"]
  node_quizzes["Quizzes<br/>[quizzes.ts]"]
  node_trainerroute["Trainer services<br/>[trainer.ts]"]
  node_nominations["Nominations<br/>[nominations.ts]"]
end

subgraph group_career["Careers and credentials"]
  node_certificates["Certificates<br/>[certificates.ts]"]
  node_skills["Skills profiles<br/>[skills.ts]"]
  node_jobs["Employment<br/>[jobs.ts]"]
end

subgraph group_platform["API and persistence"]
  node_api["API client<br/>[api.ts]"]
  node_server["Express API<br/>[index.ts]"]
  node_authroute["Auth routes<br/>[auth.ts]"]
  node_middleware["JWT authorization<br/>[auth.ts]"]
  node_config["Runtime config<br/>[config.ts]"]
  node_dbclient["Prisma client<br/>[prisma.ts]"]
  node_analytics["Analytics<br/>[analytics.ts]"]
  node_usersroute["User management<br/>[users.ts]"]
  node_notifications["Notifications<br/>[notifications.ts]"]
end

node_users(("Platform users"))

node_users -->|"opens portal"| node_app
node_app -->|"routes public"| node_home
node_app -->|"routes sign-in"| node_login
node_app -->|"routes registration"| node_register
node_app -->|"routes admin"| node_admin
node_app -->|"routes staff"| node_staff
node_app -->|"routes trainer"| node_trainer
node_app -->|"routes trainee"| node_trainee
node_app -->|"routes employer"| node_employer
node_app -->|"provides session"| node_authctx
node_login -->|"signs in"| node_authctx
node_register -->|"registers account"| node_authctx
node_authctx -->|"requests session"| node_api
node_connectivity -->|"reads pending"| node_offline
node_connectivity -->|"syncs attempts"| node_api
node_admin -->|"requests data"| node_api
node_staff -->|"requests data"| node_api
node_trainer -->|"requests data"| node_api
node_trainee -->|"requests data"| node_api
node_employer -->|"requests data"| node_api
node_api -->|"sends API requests"| node_server
node_server -->|"mounts auth"| node_authroute
node_server -->|"mounts routes"| node_programmes
node_server -->|"mounts routes"| node_attendance
node_server -->|"mounts routes"| node_modules
node_server -->|"mounts routes"| node_quizzes
node_server -->|"mounts routes"| node_trainerroute
node_server -->|"mounts routes"| node_certificates
node_server -->|"mounts routes"| node_skills
node_server -->|"mounts routes"| node_jobs
node_server -->|"mounts routes"| node_analytics
node_server -->|"mounts routes"| node_nominations
node_server -->|"mounts routes"| node_usersroute
node_server -->|"mounts routes"| node_notifications
node_authroute -->|"reads users"| node_dbclient
node_authroute -->|"protects profile"| node_middleware
node_middleware -->|"verifies with secret"| node_config
node_programmes -->|"queries data"| node_dbclient
node_attendance -->|"queries data"| node_dbclient
node_trainerroute -->|"queries data"| node_dbclient
node_skills -->|"queries data"| node_dbclient
node_jobs -->|"queries data"| node_dbclient
node_analytics -->|"queries data"| node_dbclient
node_app -.->|"launches workflow"| node_demo

click node_app "https://github.com/karthik-kurup/sahakaar-setu/blob/main/client/src/App.tsx"
click node_home "https://github.com/karthik-kurup/sahakaar-setu/blob/main/client/src/pages/HomePage.tsx"
click node_login "https://github.com/karthik-kurup/sahakaar-setu/blob/main/client/src/pages/LoginPage.tsx"
click node_register "https://github.com/karthik-kurup/sahakaar-setu/blob/main/client/src/pages/RegisterPage.tsx"
click node_admin "https://github.com/karthik-kurup/sahakaar-setu/blob/main/client/src/pages/admin/AdminDashboard.tsx"
click node_staff "https://github.com/karthik-kurup/sahakaar-setu/blob/main/client/src/pages/staff/StaffDashboard.tsx"
click node_trainer "https://github.com/karthik-kurup/sahakaar-setu/blob/main/client/src/pages/trainer/TrainerDashboard.tsx"
click node_trainee "https://github.com/karthik-kurup/sahakaar-setu/blob/main/client/src/pages/trainee/TraineeDashboard.tsx"
click node_employer "https://github.com/karthik-kurup/sahakaar-setu/blob/main/client/src/pages/employer/EmployerDashboard.tsx"
click node_demo "https://github.com/karthik-kurup/sahakaar-setu/blob/main/client/src/pages/admin/DemoWorkflow.tsx"
click node_authctx "https://github.com/karthik-kurup/sahakaar-setu/blob/main/client/src/context/AuthContext.tsx"
click node_connectivity "https://github.com/karthik-kurup/sahakaar-setu/blob/main/client/src/context/ConnectivityContext.tsx"
click node_offline "https://github.com/karthik-kurup/sahakaar-setu/blob/main/client/src/lib/offlineStorage.ts"
click node_api "https://github.com/karthik-kurup/sahakaar-setu/blob/main/client/src/lib/api.ts"
click node_section "https://github.com/karthik-kurup/sahakaar-setu/blob/main/client/src/hooks/usePortalSection.ts"
click node_language "https://github.com/karthik-kurup/sahakaar-setu/blob/main/client/src/i18n.ts"
click node_server "https://github.com/karthik-kurup/sahakaar-setu/blob/main/server/src/index.ts"
click node_authroute "https://github.com/karthik-kurup/sahakaar-setu/blob/main/server/src/routes/auth.ts"
click node_middleware "https://github.com/karthik-kurup/sahakaar-setu/blob/main/server/src/middleware/auth.ts"
click node_config "https://github.com/karthik-kurup/sahakaar-setu/blob/main/server/src/lib/config.ts"
click node_dbclient "https://github.com/karthik-kurup/sahakaar-setu/blob/main/server/src/lib/prisma.ts"
click node_programmes "https://github.com/karthik-kurup/sahakaar-setu/blob/main/server/src/routes/programmes.ts"
click node_attendance "https://github.com/karthik-kurup/sahakaar-setu/blob/main/server/src/routes/attendance.ts"
click node_modules "https://github.com/karthik-kurup/sahakaar-setu/blob/main/server/src/routes/modules.ts"
click node_quizzes "https://github.com/karthik-kurup/sahakaar-setu/blob/main/server/src/routes/quizzes.ts"
click node_trainerroute "https://github.com/karthik-kurup/sahakaar-setu/blob/main/server/src/routes/trainer.ts"
click node_certificates "https://github.com/karthik-kurup/sahakaar-setu/blob/main/server/src/routes/certificates.ts"
click node_skills "https://github.com/karthik-kurup/sahakaar-setu/blob/main/server/src/routes/skills.ts"
click node_jobs "https://github.com/karthik-kurup/sahakaar-setu/blob/main/server/src/routes/jobs.ts"
click node_analytics "https://github.com/karthik-kurup/sahakaar-setu/blob/main/server/src/routes/analytics.ts"
click node_nominations "https://github.com/karthik-kurup/sahakaar-setu/blob/main/server/src/routes/nominations.ts"
click node_usersroute "https://github.com/karthik-kurup/sahakaar-setu/blob/main/server/src/routes/users.ts"
click node_notifications "https://github.com/karthik-kurup/sahakaar-setu/blob/main/server/src/routes/notifications.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_app,node_home,node_login,node_register,node_admin,node_staff,node_trainer,node_trainee,node_employer,node_demo,node_section,node_language,node_users toneBlue
class node_authctx,node_connectivity,node_offline toneAmber
class node_programmes,node_attendance,node_modules,node_quizzes,node_trainerroute,node_nominations toneMint
class node_certificates,node_skills,node_jobs toneRose
class node_api,node_server,node_authroute,node_middleware,node_config,node_dbclient,node_analytics,node_usersroute,node_notifications toneIndigo
```

## Components

### Client experience

- [Route selection](https://github.com/karthik-kurup/sahakaar-setu/blob/main/client/src/App.tsx): `client/src/App.tsx`
- [Public home](https://github.com/karthik-kurup/sahakaar-setu/blob/main/client/src/pages/HomePage.tsx): `client/src/pages/HomePage.tsx`
- [Sign in](https://github.com/karthik-kurup/sahakaar-setu/blob/main/client/src/pages/LoginPage.tsx): `client/src/pages/LoginPage.tsx`
- [Registration](https://github.com/karthik-kurup/sahakaar-setu/blob/main/client/src/pages/RegisterPage.tsx): `client/src/pages/RegisterPage.tsx`
- [Admin portal](https://github.com/karthik-kurup/sahakaar-setu/blob/main/client/src/pages/admin/AdminDashboard.tsx): `client/src/pages/admin/AdminDashboard.tsx`
- [Staff portal](https://github.com/karthik-kurup/sahakaar-setu/blob/main/client/src/pages/staff/StaffDashboard.tsx): `client/src/pages/staff/StaffDashboard.tsx`
- [Trainer portal](https://github.com/karthik-kurup/sahakaar-setu/blob/main/client/src/pages/trainer/TrainerDashboard.tsx): `client/src/pages/trainer/TrainerDashboard.tsx`
- [Trainee portal](https://github.com/karthik-kurup/sahakaar-setu/blob/main/client/src/pages/trainee/TraineeDashboard.tsx): `client/src/pages/trainee/TraineeDashboard.tsx`
- [Employer portal](https://github.com/karthik-kurup/sahakaar-setu/blob/main/client/src/pages/employer/EmployerDashboard.tsx): `client/src/pages/employer/EmployerDashboard.tsx`
- [Demo workflow](https://github.com/karthik-kurup/sahakaar-setu/blob/main/client/src/pages/admin/DemoWorkflow.tsx): `client/src/pages/admin/DemoWorkflow.tsx`
- [Portal sections](https://github.com/karthik-kurup/sahakaar-setu/blob/main/client/src/hooks/usePortalSection.ts): `client/src/hooks/usePortalSection.ts`
- [Translations](https://github.com/karthik-kurup/sahakaar-setu/blob/main/client/src/i18n.ts): `client/src/i18n.ts`

### Identity and connectivity

- [Session context](https://github.com/karthik-kurup/sahakaar-setu/blob/main/client/src/context/AuthContext.tsx): `client/src/context/AuthContext.tsx`
- [Connectivity context](https://github.com/karthik-kurup/sahakaar-setu/blob/main/client/src/context/ConnectivityContext.tsx): `client/src/context/ConnectivityContext.tsx`
- [Offline records](https://github.com/karthik-kurup/sahakaar-setu/blob/main/client/src/lib/offlineStorage.ts): `client/src/lib/offlineStorage.ts`

### Training and attendance

- [Programmes and institutes](https://github.com/karthik-kurup/sahakaar-setu/blob/main/server/src/routes/programmes.ts): `server/src/routes/programmes.ts`
- [Attendance](https://github.com/karthik-kurup/sahakaar-setu/blob/main/server/src/routes/attendance.ts): `server/src/routes/attendance.ts`
- [Learning modules](https://github.com/karthik-kurup/sahakaar-setu/blob/main/server/src/routes/modules.ts): `server/src/routes/modules.ts`
- [Quizzes](https://github.com/karthik-kurup/sahakaar-setu/blob/main/server/src/routes/quizzes.ts): `server/src/routes/quizzes.ts`
- [Trainer services](https://github.com/karthik-kurup/sahakaar-setu/blob/main/server/src/routes/trainer.ts): `server/src/routes/trainer.ts`
- [Nominations](https://github.com/karthik-kurup/sahakaar-setu/blob/main/server/src/routes/nominations.ts): `server/src/routes/nominations.ts`

### Careers and credentials

- [Certificates](https://github.com/karthik-kurup/sahakaar-setu/blob/main/server/src/routes/certificates.ts): `server/src/routes/certificates.ts`
- [Skills profiles](https://github.com/karthik-kurup/sahakaar-setu/blob/main/server/src/routes/skills.ts): `server/src/routes/skills.ts`
- [Employment](https://github.com/karthik-kurup/sahakaar-setu/blob/main/server/src/routes/jobs.ts): `server/src/routes/jobs.ts`

### API and persistence

- [API client](https://github.com/karthik-kurup/sahakaar-setu/blob/main/client/src/lib/api.ts): `client/src/lib/api.ts`
- [Express API](https://github.com/karthik-kurup/sahakaar-setu/blob/main/server/src/index.ts): `server/src/index.ts`
- [Auth routes](https://github.com/karthik-kurup/sahakaar-setu/blob/main/server/src/routes/auth.ts): `server/src/routes/auth.ts`
- [JWT authorization](https://github.com/karthik-kurup/sahakaar-setu/blob/main/server/src/middleware/auth.ts): `server/src/middleware/auth.ts`
- [Runtime config](https://github.com/karthik-kurup/sahakaar-setu/blob/main/server/src/lib/config.ts): `server/src/lib/config.ts`
- [Prisma client](https://github.com/karthik-kurup/sahakaar-setu/blob/main/server/src/lib/prisma.ts): `server/src/lib/prisma.ts`
- [Analytics](https://github.com/karthik-kurup/sahakaar-setu/blob/main/server/src/routes/analytics.ts): `server/src/routes/analytics.ts`
- [User management](https://github.com/karthik-kurup/sahakaar-setu/blob/main/server/src/routes/users.ts): `server/src/routes/users.ts`
- [Notifications](https://github.com/karthik-kurup/sahakaar-setu/blob/main/server/src/routes/notifications.ts): `server/src/routes/notifications.ts`

### Other components

- **Platform users**

## Connections

- Platform users → Route selection: opens portal (evidence: `client/src/App.tsx`)
- Route selection → Public home: routes public (evidence: `client/src/App.tsx`)
- Route selection → Sign in: routes sign-in (evidence: `client/src/App.tsx`)
- Route selection → Registration: routes registration (evidence: `client/src/App.tsx`)
- Route selection → Admin portal: routes admin (evidence: `client/src/App.tsx`)
- Route selection → Staff portal: routes staff (evidence: `client/src/App.tsx`)
- Route selection → Trainer portal: routes trainer (evidence: `client/src/App.tsx`)
- Route selection → Trainee portal: routes trainee (evidence: `client/src/App.tsx`)
- Route selection → Employer portal: routes employer (evidence: `client/src/App.tsx`)
- Route selection → Session context: provides session (evidence: `client/src/App.tsx`)
- Sign in → Session context: signs in (evidence: `client/src/context/AuthContext.tsx`)
- Registration → Session context: registers account (evidence: `client/src/context/AuthContext.tsx`)
- Session context → API client: requests session (evidence: `client/src/context/AuthContext.tsx`)
- Connectivity context → Offline records: reads pending (evidence: `client/src/context/ConnectivityContext.tsx`)
- Connectivity context → API client: syncs attempts (evidence: `client/src/context/ConnectivityContext.tsx`)
- Admin portal → API client: requests data (evidence: `client/src/pages/admin/AdminDashboard.tsx`)
- Staff portal → API client: requests data (evidence: `client/src/pages/staff/StaffDashboard.tsx`)
- Trainer portal → API client: requests data (evidence: `client/src/pages/trainer/TrainerDashboard.tsx`)
- Trainee portal → API client: requests data (evidence: `client/src/pages/trainee/TraineeDashboard.tsx`)
- Employer portal → API client: requests data (evidence: `client/src/pages/employer/EmployerDashboard.tsx`)
- API client → Express API: sends API requests (evidence: `client/src/lib/api.ts`)
- Express API → Auth routes: mounts auth (evidence: `server/src/index.ts`)
- Express API → Programmes and institutes: mounts routes (evidence: `server/src/index.ts`)
- Express API → Attendance: mounts routes (evidence: `server/src/index.ts`)
- Express API → Learning modules: mounts routes (evidence: `server/src/index.ts`)
- Express API → Quizzes: mounts routes (evidence: `server/src/index.ts`)
- Express API → Trainer services: mounts routes (evidence: `server/src/index.ts`)
- Express API → Certificates: mounts routes (evidence: `server/src/index.ts`)
- Express API → Skills profiles: mounts routes (evidence: `server/src/index.ts`)
- Express API → Employment: mounts routes (evidence: `server/src/index.ts`)
- Express API → Analytics: mounts routes (evidence: `server/src/index.ts`)
- Express API → Nominations: mounts routes (evidence: `server/src/index.ts`)
- Express API → User management: mounts routes (evidence: `server/src/index.ts`)
- Express API → Notifications: mounts routes (evidence: `server/src/index.ts`)
- Auth routes → Prisma client: reads users (evidence: `server/src/routes/auth.ts`)
- Auth routes → JWT authorization: protects profile (evidence: `server/src/routes/auth.ts`)
- JWT authorization → Runtime config: verifies with secret (evidence: `server/src/middleware/auth.ts`)
- Programmes and institutes → Prisma client: queries data (evidence: `server/src/routes/programmes.ts`)
- Attendance → Prisma client: queries data (evidence: `server/src/routes/attendance.ts`)
- Trainer services → Prisma client: queries data (evidence: `server/src/routes/trainer.ts`)
- Skills profiles → Prisma client: queries data (evidence: `server/src/routes/skills.ts`)
- Employment → Prisma client: queries data (evidence: `server/src/routes/jobs.ts`)
- Analytics → Prisma client: queries data (evidence: `server/src/routes/analytics.ts`)
- Route selection → Demo workflow: launches workflow
