# pluskydive/satyapan architecture

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

- Interactive diagram: https://gitdiagram.com/pluskydive/satyapan
- Repository: https://github.com/pluskydive/satyapan

## Overview

SATYAPAN is an enrolment-integrity platform for institution record intake, oversight of enrolment and seat reconciliation, and consent-gated APAAR verification. Its principal workflow is institution staff submitting student records, which are validated and sanitized before demo-memory or authenticated Supabase handling; reviewers and administrators inspect summaries, flags, dossiers, and audit events. The graph also includes authentication and account administration. Unsampled page and API wiring is represented only where documented, and dashed, unverified links are marked accordingly; no unsampled source was inspected.

Main entry points: [`src/lib/supabase.ts`](https://github.com/pluskydive/satyapan/blob/main/src/lib/supabase.ts) (Data provider), [`src/app/api/admin/users/route.ts`](https://github.com/pluskydive/satyapan/blob/main/src/app/api/admin/users/route.ts) (User administration), [`src/app/login/LoginClient.tsx`](https://github.com/pluskydive/satyapan/blob/main/src/app/login/LoginClient.tsx) (Sign-in), [`src/app/api/students/upload/route.ts`](https://github.com/pluskydive/satyapan/blob/main/src/app/api/students/upload/route.ts) (Upload validation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and administration"]
  node_login["Sign-in<br/>[LoginClient.tsx]"]
  node_authorization["Role authorization<br/>[authz.ts]"]
  node_account_admin["User administration<br/>[route.ts]"]
  node_supabase_auth["Supabase Auth"]
end

subgraph group_records["Institution records"]
  node_institution_portal["Institution portal"]
  node_upload_ui["Record upload<br/>[UploadClient.tsx]"]
  node_upload_api["Upload validation<br/>[route.ts]"]
  node_data_provider["Data provider<br/>[supabase.ts]"]
  node_demo_store[("Demo records<br/>[mockData.ts]")]
  node_supabase_db[("Supabase database")]
end

subgraph group_oversight["Integrity oversight"]
  node_control_tower["Control tower"]
  node_reports["Regulatory reports<br/>[ReportsClient.tsx]"]
  node_student_dossier["Student dossier"]
  node_integrity_api["Integrity checks<br/>[route.ts]"]
  node_audit["Audit events<br/>[route.ts]"]
end

subgraph group_verification["Consent verification"]
  node_verification_ui["Verification portal<br/>[VerifyClient.tsx]"]
  node_verification_api["Consent verification<br/>[route.ts]"]
  node_disclosure["Selective disclosure<br/>[security.ts]"]
  node_certificate["Verification certificate"]
end

node_institution_user(("Institution user"))
node_reviewer_admin(("Reviewer or admin"))

node_institution_user -.->|"signs in"| node_login
node_login -->|"authenticates"| node_supabase_auth
node_login -->|"checks roles"| node_authorization
node_reviewer_admin -.->|"manages accounts"| node_account_admin
node_account_admin -->|"requires role"| node_authorization
node_account_admin -->|"updates accounts"| node_supabase_db
node_account_admin -->|"invites users"| node_supabase_auth
node_institution_user -.->|"views records"| node_institution_portal
node_institution_user -.->|"submits records"| node_upload_ui
node_upload_ui -.->|"posts rows"| node_upload_api
node_upload_api -->|"uploads rows"| node_data_provider
node_upload_api -->|"sanitizes rows"| node_disclosure
node_data_provider -->|"reads or writes"| node_demo_store
node_data_provider -->|"queries records"| node_supabase_db
node_reviewer_admin -.->|"reviews integrity"| node_control_tower
node_reviewer_admin -.->|"exports summaries"| node_reports
node_reviewer_admin -.->|"reviews records"| node_student_dossier
node_control_tower -.->|"loads summaries"| node_data_provider
node_integrity_api -->|"reads integrity data"| node_data_provider
node_reviewer_admin -.->|"reads audit events"| node_audit
node_audit -->|"loads audit events"| node_data_provider
node_institution_user -.->|"reviews request"| node_verification_ui
node_verification_ui -.->|"checks consent"| node_verification_api
node_verification_api -->|"reads requests"| node_demo_store
node_verification_api -->|"filters disclosure"| node_disclosure
node_verification_ui -.->|"views proof"| node_certificate

click node_login "https://github.com/pluskydive/satyapan/blob/main/src/app/login/LoginClient.tsx"
click node_authorization "https://github.com/pluskydive/satyapan/blob/main/src/lib/authz.ts"
click node_account_admin "https://github.com/pluskydive/satyapan/blob/main/src/app/api/admin/users/route.ts"
click node_institution_portal "https://github.com/pluskydive/satyapan/blob/main/src/app/institution/InstitutionClient.tsx"
click node_upload_ui "https://github.com/pluskydive/satyapan/blob/main/src/app/institution/upload/UploadClient.tsx"
click node_upload_api "https://github.com/pluskydive/satyapan/blob/main/src/app/api/students/upload/route.ts"
click node_data_provider "https://github.com/pluskydive/satyapan/blob/main/src/lib/supabase.ts"
click node_demo_store "https://github.com/pluskydive/satyapan/blob/main/src/lib/mockData.ts"
click node_control_tower "https://github.com/pluskydive/satyapan/blob/main/src/app/aicte/AICTEControlTowerClient.tsx"
click node_reports "https://github.com/pluskydive/satyapan/blob/main/src/app/aicte/reports/ReportsClient.tsx"
click node_student_dossier "https://github.com/pluskydive/satyapan/blob/main/src/app/aicte/students/%5Bid%5D/StudentDossierClient.tsx"
click node_integrity_api "https://github.com/pluskydive/satyapan/blob/main/src/app/api/integrity/run/route.ts"
click node_audit "https://github.com/pluskydive/satyapan/blob/main/src/app/api/audit/route.ts"
click node_verification_ui "https://github.com/pluskydive/satyapan/blob/main/src/app/verify/VerifyClient.tsx"
click node_verification_api "https://github.com/pluskydive/satyapan/blob/main/src/app/api/verify/route.ts"
click node_disclosure "https://github.com/pluskydive/satyapan/blob/main/src/lib/security.ts"
click node_certificate "https://github.com/pluskydive/satyapan/blob/main/src/app/verify/certificate/%5Bid%5D/CertificateClient.tsx"

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_login,node_authorization,node_account_admin,node_supabase_auth,node_institution_user,node_reviewer_admin toneBlue
class node_institution_portal,node_upload_ui,node_upload_api,node_data_provider,node_demo_store,node_supabase_db toneAmber
class node_control_tower,node_reports,node_student_dossier,node_integrity_api,node_audit toneMint
class node_verification_ui,node_verification_api,node_disclosure,node_certificate toneRose
```

## Components

### Access and administration

- [Sign-in](https://github.com/pluskydive/satyapan/blob/main/src/app/login/LoginClient.tsx): `src/app/login/LoginClient.tsx`
- [Role authorization](https://github.com/pluskydive/satyapan/blob/main/src/lib/authz.ts): `src/lib/authz.ts`
- [User administration](https://github.com/pluskydive/satyapan/blob/main/src/app/api/admin/users/route.ts): `src/app/api/admin/users/route.ts`
- **Supabase Auth**

### Institution records

- [Institution portal](https://github.com/pluskydive/satyapan/blob/main/src/app/institution/InstitutionClient.tsx): `src/app/institution/InstitutionClient.tsx`
- [Record upload](https://github.com/pluskydive/satyapan/blob/main/src/app/institution/upload/UploadClient.tsx): `src/app/institution/upload/UploadClient.tsx`
- [Upload validation](https://github.com/pluskydive/satyapan/blob/main/src/app/api/students/upload/route.ts): `src/app/api/students/upload/route.ts`
- [Data provider](https://github.com/pluskydive/satyapan/blob/main/src/lib/supabase.ts): `src/lib/supabase.ts`
- [Demo records](https://github.com/pluskydive/satyapan/blob/main/src/lib/mockData.ts): `src/lib/mockData.ts`
- **Supabase database**

### Integrity oversight

- [Control tower](https://github.com/pluskydive/satyapan/blob/main/src/app/aicte/AICTEControlTowerClient.tsx): `src/app/aicte/AICTEControlTowerClient.tsx`
- [Regulatory reports](https://github.com/pluskydive/satyapan/blob/main/src/app/aicte/reports/ReportsClient.tsx): `src/app/aicte/reports/ReportsClient.tsx`
- [Student dossier](https://github.com/pluskydive/satyapan/blob/main/src/app/aicte/students/%5Bid%5D/StudentDossierClient.tsx): `src/app/aicte/students/[id]/StudentDossierClient.tsx`
- [Integrity checks](https://github.com/pluskydive/satyapan/blob/main/src/app/api/integrity/run/route.ts): `src/app/api/integrity/run/route.ts`
- [Audit events](https://github.com/pluskydive/satyapan/blob/main/src/app/api/audit/route.ts): `src/app/api/audit/route.ts`

### Consent verification

- [Verification portal](https://github.com/pluskydive/satyapan/blob/main/src/app/verify/VerifyClient.tsx): `src/app/verify/VerifyClient.tsx`
- [Consent verification](https://github.com/pluskydive/satyapan/blob/main/src/app/api/verify/route.ts): `src/app/api/verify/route.ts`
- [Selective disclosure](https://github.com/pluskydive/satyapan/blob/main/src/lib/security.ts): `src/lib/security.ts`
- [Verification certificate](https://github.com/pluskydive/satyapan/blob/main/src/app/verify/certificate/%5Bid%5D/CertificateClient.tsx): `src/app/verify/certificate/[id]/CertificateClient.tsx`

### Other components

- **Institution user**
- **Reviewer or admin**

## Connections

- Institution user → Sign-in: signs in (evidence: `README.md`)
- Sign-in → Supabase Auth: authenticates (evidence: `src/app/login/LoginClient.tsx`)
- Sign-in → Role authorization: checks roles (evidence: `src/app/login/LoginClient.tsx`)
- Reviewer or admin → User administration: manages accounts (evidence: `README.md`)
- User administration → Role authorization: requires role (evidence: `src/app/api/admin/users/route.ts`)
- User administration → Supabase database: updates accounts (evidence: `src/app/api/admin/users/route.ts`)
- User administration → Supabase Auth: invites users (evidence: `src/app/api/admin/users/route.ts`)
- Institution user → Institution portal: views records (evidence: `README.md`)
- Institution user → Record upload: submits records (evidence: `README.md`)
- Record upload → Upload validation: posts rows
- Upload validation → Data provider: uploads rows (evidence: `src/app/api/students/upload/route.ts`)
- Upload validation → Selective disclosure: sanitizes rows (evidence: `src/app/api/students/upload/route.ts`)
- Data provider → Demo records: reads or writes (evidence: `src/lib/supabase.ts`)
- Data provider → Supabase database: queries records (evidence: `src/lib/supabase.ts`)
- Reviewer or admin → Control tower: reviews integrity (evidence: `README.md`)
- Reviewer or admin → Regulatory reports: exports summaries (evidence: `README.md`)
- Reviewer or admin → Student dossier: reviews records (evidence: `README.md`)
- Control tower → Data provider: loads summaries
- Integrity checks → Data provider: reads integrity data (evidence: `src/app/api/integrity/run/route.ts`)
- Reviewer or admin → Audit events: reads audit events (evidence: `README.md`)
- Audit events → Data provider: loads audit events (evidence: `src/app/api/audit/route.ts`)
- Institution user → Verification portal: reviews request (evidence: `README.md`)
- Verification portal → Consent verification: checks consent
- Consent verification → Demo records: reads requests (evidence: `src/app/api/verify/route.ts`)
- Consent verification → Selective disclosure: filters disclosure (evidence: `src/app/api/verify/route.ts`)
- Verification portal → Verification certificate: views proof
