# daraja-africa/daraja-netizens architecture

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

- Interactive diagram: https://gitdiagram.com/daraja-africa/daraja-netizens
- Repository: https://github.com/daraja-africa/daraja-netizens

## Overview

Daraja Netizens combines staff workspaces, a student learning and support portal, and Jitsi-based training meetings. Users enter through the web app, choose or authenticate into a role-specific surface, and use it to launch meetings, record attendance, manage programme data, or access learning and wellness support. The API owns protected workflows and connects them to Supabase and optional integrations. The README documents broader features such as QR check-in and scanning whose individual implementations were not sampled; edges to those features are therefore limited to documented links.

Main entry points: [`apps/api/src/app.ts`](https://github.com/daraja-africa/daraja-netizens/blob/main/apps/api/src/app.ts) (API service), [`apps/web/src/App.tsx`](https://github.com/daraja-africa/daraja-netizens/blob/main/apps/web/src/App.tsx) (Web application), [`apps/web/src/api.ts`](https://github.com/daraja-africa/daraja-netizens/blob/main/apps/web/src/api.ts) (HTTP client), [`apps/api/src/supabase.ts`](https://github.com/daraja-africa/daraja-netizens/blob/main/apps/api/src/supabase.ts) (Supabase data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web workspaces"]
  node_webapp["Web application<br/>[App.tsx]"]
  node_routing["Role routing<br/>[router.ts]"]
  node_adminui["Admin workspace"]
  node_facui["Facilitator workspace"]
  node_staffui["Staff check-in"]
  node_studentui["Student portal"]
  node_discordui["Discord verification<br/>[VerifyUserPage.tsx]"]
  node_webapi["HTTP client<br/>[api.ts]"]
end

subgraph group_api["API workflows"]
  node_service["API service<br/>[app.ts]"]
  node_auth["Identity and roles<br/>[auth.ts]"]
  node_adminops["Programme administration<br/>[admin.ts]"]
  node_imports["Roster imports<br/>[memberImport.ts]"]
  node_content["Student content<br/>[studentContent.ts]"]
  node_reachout["Reach-out triage<br/>[reachOut.ts]"]
  node_discordops["Discord integration<br/>[discord.ts]"]
end

subgraph group_data["Persistence and rules"]
  node_eligibility["Eligibility rules<br/>[eligibility.ts]"]
  node_store[("Supabase data<br/>[supabase.ts]")]
end

subgraph group_integrations["External services"]
  node_jitsi["Jitsi conferencing"]
  node_alert["Wellness alert relay"]
  node_discord["Discord"]
  node_redis[("Redis buffer")]
end

node_visitor(("Portal user"))

node_visitor -->|"opens"| node_webapp
node_webapp -->|"parses routes"| node_routing
node_webapp -->|"renders"| node_adminui
node_webapp -->|"renders"| node_facui
node_webapp -->|"renders"| node_staffui
node_webapp -->|"renders"| node_studentui
node_webapp -->|"renders"| node_discordui
node_webapp -->|"requests"| node_webapi
node_webapi -->|"HTTP calls"| node_service
node_service -->|"guards routes"| node_auth
node_service -->|"calls"| node_adminops
node_service -->|"applies imports"| node_imports
node_service -->|"calls"| node_store
node_service -->|"serves"| node_content
node_service -->|"triages"| node_reachout
node_service -->|"dispatches"| node_discordops
node_adminops -->|"reads and writes"| node_store
node_imports -->|"imports records"| node_store
node_store -->|"calculates eligibility"| node_eligibility
node_studentui -->|"requests content"| node_webapi
node_facui -->|"requests data"| node_webapi
node_discordui -->|"links account"| node_webapi
node_service -->|"issues room access"| node_jitsi
node_webapp -->|"launches conference"| node_jitsi
node_reachout -->|"pages team"| node_alert
node_discordops -->|"writes role link"| node_discord
node_service -.->|"buffers telemetry"| node_redis

click node_webapp "https://github.com/daraja-africa/daraja-netizens/blob/main/apps/web/src/App.tsx"
click node_routing "https://github.com/daraja-africa/daraja-netizens/blob/main/apps/web/src/router.ts"
click node_adminui "https://github.com/daraja-africa/daraja-netizens/tree/main/apps/web/src/admin"
click node_facui "https://github.com/daraja-africa/daraja-netizens/tree/main/apps/web/src/facilitator"
click node_staffui "https://github.com/daraja-africa/daraja-netizens/tree/main/apps/web/src/staff"
click node_studentui "https://github.com/daraja-africa/daraja-netizens/tree/main/apps/web/src/student"
click node_discordui "https://github.com/daraja-africa/daraja-netizens/blob/main/apps/web/src/discord/VerifyUserPage.tsx"
click node_webapi "https://github.com/daraja-africa/daraja-netizens/blob/main/apps/web/src/api.ts"
click node_service "https://github.com/daraja-africa/daraja-netizens/blob/main/apps/api/src/app.ts"
click node_auth "https://github.com/daraja-africa/daraja-netizens/blob/main/apps/api/src/auth.ts"
click node_adminops "https://github.com/daraja-africa/daraja-netizens/blob/main/apps/api/src/admin.ts"
click node_imports "https://github.com/daraja-africa/daraja-netizens/blob/main/apps/api/src/memberImport.ts"
click node_eligibility "https://github.com/daraja-africa/daraja-netizens/blob/main/apps/api/src/eligibility.ts"
click node_content "https://github.com/daraja-africa/daraja-netizens/blob/main/apps/api/src/studentContent.ts"
click node_reachout "https://github.com/daraja-africa/daraja-netizens/blob/main/apps/api/src/reachOut.ts"
click node_discordops "https://github.com/daraja-africa/daraja-netizens/blob/main/apps/api/src/discord.ts"
click node_store "https://github.com/daraja-africa/daraja-netizens/blob/main/apps/api/src/supabase.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_routing,node_adminui,node_facui,node_staffui,node_studentui,node_discordui,node_webapi,node_visitor toneBlue
class node_service,node_auth,node_adminops,node_imports,node_content,node_reachout,node_discordops toneAmber
class node_eligibility,node_store toneMint
class node_jitsi,node_alert,node_discord,node_redis toneRose
```

## Components

### Web workspaces

- [Web application](https://github.com/daraja-africa/daraja-netizens/blob/main/apps/web/src/App.tsx): `apps/web/src/App.tsx`
- [Role routing](https://github.com/daraja-africa/daraja-netizens/blob/main/apps/web/src/router.ts): `apps/web/src/router.ts`
- [Admin workspace](https://github.com/daraja-africa/daraja-netizens/tree/main/apps/web/src/admin): `apps/web/src/admin`
- [Facilitator workspace](https://github.com/daraja-africa/daraja-netizens/tree/main/apps/web/src/facilitator): `apps/web/src/facilitator`
- [Staff check-in](https://github.com/daraja-africa/daraja-netizens/tree/main/apps/web/src/staff): `apps/web/src/staff`
- [Student portal](https://github.com/daraja-africa/daraja-netizens/tree/main/apps/web/src/student): `apps/web/src/student`
- [Discord verification](https://github.com/daraja-africa/daraja-netizens/blob/main/apps/web/src/discord/VerifyUserPage.tsx): `apps/web/src/discord/VerifyUserPage.tsx`
- [HTTP client](https://github.com/daraja-africa/daraja-netizens/blob/main/apps/web/src/api.ts): `apps/web/src/api.ts`

### API workflows

- [API service](https://github.com/daraja-africa/daraja-netizens/blob/main/apps/api/src/app.ts): `apps/api/src/app.ts`
- [Identity and roles](https://github.com/daraja-africa/daraja-netizens/blob/main/apps/api/src/auth.ts): `apps/api/src/auth.ts`
- [Programme administration](https://github.com/daraja-africa/daraja-netizens/blob/main/apps/api/src/admin.ts): `apps/api/src/admin.ts`
- [Roster imports](https://github.com/daraja-africa/daraja-netizens/blob/main/apps/api/src/memberImport.ts): `apps/api/src/memberImport.ts`
- [Student content](https://github.com/daraja-africa/daraja-netizens/blob/main/apps/api/src/studentContent.ts): `apps/api/src/studentContent.ts`
- [Reach-out triage](https://github.com/daraja-africa/daraja-netizens/blob/main/apps/api/src/reachOut.ts): `apps/api/src/reachOut.ts`
- [Discord integration](https://github.com/daraja-africa/daraja-netizens/blob/main/apps/api/src/discord.ts): `apps/api/src/discord.ts`

### Persistence and rules

- [Eligibility rules](https://github.com/daraja-africa/daraja-netizens/blob/main/apps/api/src/eligibility.ts): `apps/api/src/eligibility.ts`
- [Supabase data](https://github.com/daraja-africa/daraja-netizens/blob/main/apps/api/src/supabase.ts): `apps/api/src/supabase.ts`

### External services

- **Jitsi conferencing**
- **Wellness alert relay**
- **Discord**
- **Redis buffer**

### Other components

- **Portal user**

## Connections

- Portal user → Web application: opens (evidence: `README.md`)
- Web application → Role routing: parses routes (evidence: `apps/web/src/App.tsx`)
- Web application → Admin workspace: renders (evidence: `README.md`)
- Web application → Facilitator workspace: renders (evidence: `apps/web/src/App.tsx`)
- Web application → Staff check-in: renders (evidence: `README.md`)
- Web application → Student portal: renders (evidence: `apps/web/src/App.tsx`)
- Web application → Discord verification: renders (evidence: `apps/web/src/App.tsx`)
- Web application → HTTP client: requests (evidence: `apps/web/src/App.tsx`)
- HTTP client → API service: HTTP calls (evidence: `README.md`)
- API service → Identity and roles: guards routes (evidence: `apps/api/src/auth.ts`)
- API service → Programme administration: calls (evidence: `apps/api/src/app.ts`)
- API service → Roster imports: applies imports (evidence: `apps/api/src/app.ts`)
- API service → Supabase data: calls (evidence: `apps/api/src/app.ts`)
- API service → Student content: serves (evidence: `apps/api/src/app.ts`)
- API service → Reach-out triage: triages (evidence: `README.md`)
- API service → Discord integration: dispatches (evidence: `apps/api/src/app.ts`)
- Programme administration → Supabase data: reads and writes (evidence: `apps/api/src/admin.ts`)
- Roster imports → Supabase data: imports records (evidence: `apps/api/src/memberImport.ts`)
- Supabase data → Eligibility rules: calculates eligibility (evidence: `apps/api/src/supabase.ts`)
- Student portal → HTTP client: requests content (evidence: `apps/web/src/student/ReachOut.tsx`)
- Facilitator workspace → HTTP client: requests data (evidence: `apps/web/src/facilitator/ReachOutInbox.tsx`)
- Discord verification → HTTP client: links account (evidence: `apps/web/src/discord/VerifyUserPage.tsx`)
- API service → Jitsi conferencing: issues room access (evidence: `README.md`)
- Web application → Jitsi conferencing: launches conference (evidence: `README.md`)
- Reach-out triage → Wellness alert relay: pages team (evidence: `README.md`)
- Discord integration → Discord: writes role link (evidence: `README.md`)
- API service → Redis buffer: buffers telemetry (evidence: `README.md`)
