# edumahmoud/migo architecture

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

## Overview

Attendo is a role-based learning platform for students, teachers, registration agents, and administrators. Its user-facing workflow spans authentication and role-aware portals, course learning and assessment, AI-assisted study, and operational services such as chat, storage, and payments. The tree also shows teacher payouts and administrator financial controls as distinct product areas. Relationships below are limited to calls visible in excerpts or references recorded in the SOURCE INDEX; many listed subsystems were not sampled, so their internal links are omitted.

Main entry points: [`src/lib/supabase-server.ts`](https://github.com/edumahmoud/migo/blob/main/src/lib/supabase-server.ts) (Supabase access), [`src/lib/auth-helpers.ts`](https://github.com/edumahmoud/migo/blob/main/src/lib/auth-helpers.ts) (Request authorization), [`src/app/api/summaries/route.ts`](https://github.com/edumahmoud/migo/blob/main/src/app/api/summaries/route.ts) (Study summaries), [`src/app/api/quizzes/route.ts`](https://github.com/edumahmoud/migo/blob/main/src/app/api/quizzes/route.ts) (Quiz assessment)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and portals"]
  node_auth_ui["Login and registration<br/>[login-form.tsx]"]
  node_auth_state["Auth state<br/>[auth-store.ts]"]
  node_auth_helpers["Request authorization<br/>[auth-helpers.ts]"]
  node_student_portal["Student portal"]
  node_teacher_portal["Teacher portal"]
  node_agent_portal["Agent portal<br/>[agent-portal.tsx]"]
  node_admin_portal["Admin portal"]
end

subgraph group_learning["Learning and content"]
  node_course["Course learning<br/>[course-page.tsx]"]
  node_lessons_api["Lessons and progress<br/>[route.ts]"]
  node_question_bank["Question bank<br/>[route.ts]"]
  node_scorm["SCORM packages<br/>[route.ts]"]
  node_summaries["Study summaries<br/>[route.ts]"]
end

subgraph group_ai["AI and study"]
  node_quiz_api["Quiz assessment<br/>[route.ts]"]
  node_ai_manager["AI provider manager"]
  node_ai_capabilities["AI prompts and providers<br/>[prompts.ts]"]
end

subgraph group_operations["Platform operations"]
  node_chat_api["Conversations and chat<br/>[route.ts]"]
  node_chat_store["Conversation persistence"]
  node_storage["Storage plans"]
  node_notifications["Notifications"]
  node_database[("Supabase access<br/>[supabase-server.ts]")]
end

subgraph group_finance["Payments and finance"]
  node_teacher_payouts["Teacher payout service<br/>[service.ts]"]
  node_payout_methods["Payout methods"]
  node_payout_data["Payout method data"]
  node_gateway["Payment gateways<br/>[client.ts]"]
  node_payment_webhook["Payment webhook<br/>[route.ts]"]
end

node_actor(("Platform users"))

node_actor -->|"signs in"| node_auth_ui
node_auth_ui -.->|"updates session"| node_auth_state
node_auth_state -->|"uses client auth"| node_database
node_auth_helpers -->|"creates session client"| node_database
node_student_portal -.->|"serves students"| node_actor
node_teacher_portal -.->|"serves teachers"| node_actor
node_agent_portal -.->|"serves agents"| node_actor
node_admin_portal -.->|"serves admins"| node_actor
node_question_bank -->|"reads questions"| node_database
node_quiz_api -->|"checks access"| node_auth_helpers
node_quiz_api -->|"uses database"| node_database
node_quiz_api -->|"requests AI"| node_ai_manager
node_summaries -->|"checks access"| node_auth_helpers
node_summaries -->|"uses database"| node_database
node_summaries -->|"requests AI"| node_ai_manager
node_ai_manager -->|"uses prompts"| node_ai_capabilities
node_chat_api -->|"authenticates requests"| node_auth_helpers
node_chat_api -->|"uses conversation store"| node_chat_store
node_chat_api -->|"reads messages"| node_database
node_storage -.->|"checks usage"| node_database
node_storage -->|"shows quota"| node_actor
node_teacher_payouts -->|"uses repository"| node_payout_methods
node_teacher_payouts -->|"sends notifications"| node_notifications
node_teacher_payouts -->|"uses database"| node_database
node_payout_methods -->|"validates details"| node_payout_data
node_payment_webhook -.->|"handles gateway events"| node_gateway

click node_auth_ui "https://github.com/edumahmoud/migo/blob/main/src/components/auth/login-form.tsx"
click node_auth_state "https://github.com/edumahmoud/migo/blob/main/src/stores/auth-store.ts"
click node_auth_helpers "https://github.com/edumahmoud/migo/blob/main/src/lib/auth-helpers.ts"
click node_student_portal "https://github.com/edumahmoud/migo/blob/main/src/components/student/student-dashboard.tsx"
click node_teacher_portal "https://github.com/edumahmoud/migo/blob/main/src/components/teacher/teacher-dashboard.tsx"
click node_agent_portal "https://github.com/edumahmoud/migo/blob/main/src/components/agent/agent-portal.tsx"
click node_admin_portal "https://github.com/edumahmoud/migo/blob/main/src/components/admin/admin-dashboard.tsx"
click node_course "https://github.com/edumahmoud/migo/blob/main/src/components/course/course-page.tsx"
click node_lessons_api "https://github.com/edumahmoud/migo/blob/main/src/app/api/lessons/route.ts"
click node_question_bank "https://github.com/edumahmoud/migo/blob/main/src/app/api/question-bank/route.ts"
click node_scorm "https://github.com/edumahmoud/migo/blob/main/src/app/api/scorm/export/route.ts"
click node_summaries "https://github.com/edumahmoud/migo/blob/main/src/app/api/summaries/route.ts"
click node_quiz_api "https://github.com/edumahmoud/migo/blob/main/src/app/api/quizzes/route.ts"
click node_ai_manager "https://github.com/edumahmoud/migo/blob/main/src/lib/ai/provider-manager.ts"
click node_ai_capabilities "https://github.com/edumahmoud/migo/blob/main/src/lib/ai/prompts.ts"
click node_chat_api "https://github.com/edumahmoud/migo/blob/main/src/app/api/chat/route.ts"
click node_chat_store "https://github.com/edumahmoud/migo/blob/main/src/app/api/chat/conversation-store.ts"
click node_storage "https://github.com/edumahmoud/migo/blob/main/src/components/shared/storage-plans-view.tsx"
click node_notifications "https://github.com/edumahmoud/migo/blob/main/src/lib/notifications-service.ts"
click node_database "https://github.com/edumahmoud/migo/blob/main/src/lib/supabase-server.ts"
click node_teacher_payouts "https://github.com/edumahmoud/migo/blob/main/src/lib/payment/payout-domain/service.ts"
click node_payout_methods "https://github.com/edumahmoud/migo/blob/main/src/lib/payment/payout-methods-repository.ts"
click node_payout_data "https://github.com/edumahmoud/migo/blob/main/src/lib/payment/payout-method-schemas.ts"
click node_gateway "https://github.com/edumahmoud/migo/blob/main/src/lib/payment/providers/paymob/client.ts"
click node_payment_webhook "https://github.com/edumahmoud/migo/blob/main/src/app/api/payment/webhook/route.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_auth_ui,node_auth_state,node_auth_helpers,node_student_portal,node_teacher_portal,node_agent_portal,node_admin_portal,node_actor toneBlue
class node_course,node_lessons_api,node_question_bank,node_scorm,node_summaries toneAmber
class node_quiz_api,node_ai_manager,node_ai_capabilities toneMint
class node_chat_api,node_chat_store,node_storage,node_notifications,node_database toneRose
class node_teacher_payouts,node_payout_methods,node_payout_data,node_gateway,node_payment_webhook toneIndigo
```

## Components

### Identity and portals

- [Login and registration](https://github.com/edumahmoud/migo/blob/main/src/components/auth/login-form.tsx): `src/components/auth/login-form.tsx`
- [Auth state](https://github.com/edumahmoud/migo/blob/main/src/stores/auth-store.ts): `src/stores/auth-store.ts`
- [Request authorization](https://github.com/edumahmoud/migo/blob/main/src/lib/auth-helpers.ts): `src/lib/auth-helpers.ts`
- [Student portal](https://github.com/edumahmoud/migo/blob/main/src/components/student/student-dashboard.tsx): `src/components/student/student-dashboard.tsx`
- [Teacher portal](https://github.com/edumahmoud/migo/blob/main/src/components/teacher/teacher-dashboard.tsx): `src/components/teacher/teacher-dashboard.tsx`
- [Agent portal](https://github.com/edumahmoud/migo/blob/main/src/components/agent/agent-portal.tsx): `src/components/agent/agent-portal.tsx`
- [Admin portal](https://github.com/edumahmoud/migo/blob/main/src/components/admin/admin-dashboard.tsx): `src/components/admin/admin-dashboard.tsx`

### Learning and content

- [Course learning](https://github.com/edumahmoud/migo/blob/main/src/components/course/course-page.tsx): `src/components/course/course-page.tsx`
- [Lessons and progress](https://github.com/edumahmoud/migo/blob/main/src/app/api/lessons/route.ts): `src/app/api/lessons/route.ts`
- [Question bank](https://github.com/edumahmoud/migo/blob/main/src/app/api/question-bank/route.ts): `src/app/api/question-bank/route.ts`
- [SCORM packages](https://github.com/edumahmoud/migo/blob/main/src/app/api/scorm/export/route.ts): `src/app/api/scorm/export/route.ts`
- [Study summaries](https://github.com/edumahmoud/migo/blob/main/src/app/api/summaries/route.ts): `src/app/api/summaries/route.ts`

### AI and study

- [Quiz assessment](https://github.com/edumahmoud/migo/blob/main/src/app/api/quizzes/route.ts): `src/app/api/quizzes/route.ts`
- [AI provider manager](https://github.com/edumahmoud/migo/blob/main/src/lib/ai/provider-manager.ts): `src/lib/ai/provider-manager.ts`
- [AI prompts and providers](https://github.com/edumahmoud/migo/blob/main/src/lib/ai/prompts.ts): `src/lib/ai/prompts.ts`

### Platform operations

- [Conversations and chat](https://github.com/edumahmoud/migo/blob/main/src/app/api/chat/route.ts): `src/app/api/chat/route.ts`
- [Conversation persistence](https://github.com/edumahmoud/migo/blob/main/src/app/api/chat/conversation-store.ts): `src/app/api/chat/conversation-store.ts`
- [Storage plans](https://github.com/edumahmoud/migo/blob/main/src/components/shared/storage-plans-view.tsx): `src/components/shared/storage-plans-view.tsx`
- [Notifications](https://github.com/edumahmoud/migo/blob/main/src/lib/notifications-service.ts): `src/lib/notifications-service.ts`
- [Supabase access](https://github.com/edumahmoud/migo/blob/main/src/lib/supabase-server.ts): `src/lib/supabase-server.ts`

### Payments and finance

- [Teacher payout service](https://github.com/edumahmoud/migo/blob/main/src/lib/payment/payout-domain/service.ts): `src/lib/payment/payout-domain/service.ts`
- [Payout methods](https://github.com/edumahmoud/migo/blob/main/src/lib/payment/payout-methods-repository.ts): `src/lib/payment/payout-methods-repository.ts`
- [Payout method data](https://github.com/edumahmoud/migo/blob/main/src/lib/payment/payout-method-schemas.ts): `src/lib/payment/payout-method-schemas.ts`
- [Payment gateways](https://github.com/edumahmoud/migo/blob/main/src/lib/payment/providers/paymob/client.ts): `src/lib/payment/providers/paymob/client.ts`
- [Payment webhook](https://github.com/edumahmoud/migo/blob/main/src/app/api/payment/webhook/route.ts): `src/app/api/payment/webhook/route.ts`

### Other components

- **Platform users**

## Connections

- Platform users → Login and registration: signs in
- Login and registration → Auth state: updates session
- Auth state → Supabase access: uses client auth (evidence: `src/stores/auth-store.ts`)
- Request authorization → Supabase access: creates session client (evidence: `src/lib/auth-helpers.ts`)
- Student portal → Platform users: serves students
- Teacher portal → Platform users: serves teachers
- Agent portal → Platform users: serves agents
- Admin portal → Platform users: serves admins
- Question bank → Supabase access: reads questions (evidence: `src/app/api/question-bank/route.ts`)
- Quiz assessment → Request authorization: checks access (evidence: `src/app/api/quizzes/route.ts`)
- Quiz assessment → Supabase access: uses database (evidence: `src/app/api/quizzes/route.ts`)
- Quiz assessment → AI provider manager: requests AI (evidence: `src/app/api/quizzes/route.ts`)
- Study summaries → Request authorization: checks access (evidence: `src/app/api/summaries/route.ts`)
- Study summaries → Supabase access: uses database (evidence: `src/app/api/summaries/route.ts`)
- Study summaries → AI provider manager: requests AI (evidence: `src/app/api/summaries/route.ts`)
- AI provider manager → AI prompts and providers: uses prompts (evidence: `src/lib/ai/provider-manager.ts`)
- Conversations and chat → Request authorization: authenticates requests (evidence: `src/app/api/chat/route.ts`)
- Conversations and chat → Conversation persistence: uses conversation store (evidence: `src/app/api/chat/route.ts`)
- Conversations and chat → Supabase access: reads messages (evidence: `src/app/api/chat/route.ts`)
- Storage plans → Supabase access: checks usage
- Storage plans → Platform users: shows quota (evidence: `src/components/shared/storage-plans-view.tsx`)
- Teacher payout service → Payout methods: uses repository (evidence: `src/lib/payment/payout-domain/service.ts`)
- Teacher payout service → Notifications: sends notifications (evidence: `src/lib/payment/payout-domain/service.ts`)
- Teacher payout service → Supabase access: uses database (evidence: `src/lib/payment/payout-domain/service.ts`)
- Payout methods → Payout method data: validates details (evidence: `src/lib/payment/payout-methods-repository.ts`)
- Payment webhook → Payment gateways: handles gateway events
