# fares556259/school_management_app architecture

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

- Interactive diagram: https://gitdiagram.com/fares556259/school_management_app
- Repository: https://github.com/fares556259/school_management_app

## Overview

SnapSchool is a multi-tenant school-management dashboard for administrators, teachers, students, and parents. Its principal workflow is role-based access to school operations: staff record attendance, manage enrollment and billing, and enter academic results; parents and students access school information, while administrators review finances and audit changes. Separate branches cover the Telegram AI assistant and external-portal automation. The graph uses documented capabilities and indexed or excerpted imports; several unsampled feature links are intentionally omitted rather than inferred.

Main entry points: [`src/lib/prisma.ts`](https://github.com/fares556259/school_management_app/blob/completed/src/lib/prisma.ts) (School records), [`src/app/(dashboard)/layout.tsx`](https://github.com/fares556259/school_management_app/blob/completed/src/app/(dashboard)/layout.tsx) (Role dashboards), [`src/app/api/admin/student-charges/route.ts`](https://github.com/fares556259/school_management_app/blob/completed/src/app/api/admin/student-charges/route.ts) (Student charges API), [`src/lib/school.ts`](https://github.com/fares556259/school_management_app/blob/completed/src/lib/school.ts) (Tenant resolution)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and roles"]
  node_dashboard["Role dashboards<br/>[layout.tsx]"]
  node_auth["Web authentication<br/>[server.ts]"]
  node_mobileauthroute["Mobile sign-in<br/>[route.ts]"]
  node_enrollment["Parent enrollment<br/>[route.ts]"]
end

subgraph group_academics["Academic operations"]
  node_attendance["Attendance<br/>[route.ts]"]
  node_grades["Grades and reports<br/>[route.ts]"]
end

subgraph group_finance["Finance and oversight"]
  node_chargesroute["Student charges API<br/>[route.ts]"]
  node_charges["Billing engine<br/>[studentCharges.ts]"]
  node_audit["Audit logs<br/>[audit.ts]"]
end

subgraph group_assistant["AI and integrations"]
  node_telegramwebhook["Telegram webhook<br/>[route.ts]"]
  node_telegramagent["Telegram AI agent<br/>[agent.ts]"]
  node_telegram["Telegram messaging<br/>[telegram.ts]"]
  node_excel["Spreadsheet tools<br/>[excelEngine.ts]"]
  node_portal["External portal automation"]
  node_browser["Browser automation<br/>[browserService.ts]"]
end

subgraph group_platform["Shared platform"]
  node_mobileauth["Mobile identity<br/>[mobileAuth.ts]"]
  node_database[("School records<br/>[prisma.ts]")]
  node_school["Tenant resolution<br/>[school.ts]"]
  node_notifications["Notifications<br/>[notifications.ts]"]
end

node_admin(("Administrator"))
node_teacher(("Teacher"))
node_parent(("Parent"))
node_student(("Student"))

node_admin -->|"uses role view"| node_dashboard
node_teacher -->|"uses role view"| node_dashboard
node_parent -->|"uses role view"| node_dashboard
node_student -->|"uses role view"| node_dashboard
node_dashboard -.->|"authenticates through"| node_auth
node_mobileauthroute -->|"issues tokens"| node_mobileauth
node_mobileauthroute -->|"reads and writes"| node_database
node_mobileauthroute -->|"checks rate limits"| node_auth
node_attendance -->|"reads and writes"| node_database
node_attendance -->|"resolves tenant"| node_school
node_attendance -->|"creates alerts"| node_notifications
node_grades -->|"reads results"| node_database
node_grades -->|"resolves tenant"| node_school
node_enrollment -->|"reads and writes"| node_database
node_enrollment -->|"syncs billing"| node_charges
node_enrollment -->|"records changes"| node_audit
node_chargesroute -->|"authenticates mobile"| node_mobileauth
node_chargesroute -->|"authenticates web"| node_auth
node_chargesroute -->|"synchronizes charges"| node_charges
node_chargesroute -->|"reads and writes"| node_database
node_telegramwebhook -->|"sends messages"| node_telegram
node_telegramwebhook -->|"dispatches requests"| node_telegramagent
node_telegramwebhook -->|"uses spreadsheet tools"| node_excel
node_portal -->|"automates browsing"| node_browser
node_school -->|"verifies identity"| node_auth
node_school -->|"resolves membership"| node_database

click node_dashboard "https://github.com/fares556259/school_management_app/blob/completed/src/app/(dashboard)/layout.tsx"
click node_auth "https://github.com/fares556259/school_management_app/blob/completed/src/utils/supabase/server.ts"
click node_mobileauthroute "https://github.com/fares556259/school_management_app/blob/completed/src/app/api/mobile/auth/route.ts"
click node_mobileauth "https://github.com/fares556259/school_management_app/blob/completed/src/lib/mobileAuth.ts"
click node_attendance "https://github.com/fares556259/school_management_app/blob/completed/src/app/api/attendance/route.ts"
click node_grades "https://github.com/fares556259/school_management_app/blob/completed/src/app/api/report-card/route.ts"
click node_enrollment "https://github.com/fares556259/school_management_app/blob/completed/src/app/api/parent-requests/route.ts"
click node_chargesroute "https://github.com/fares556259/school_management_app/blob/completed/src/app/api/admin/student-charges/route.ts"
click node_charges "https://github.com/fares556259/school_management_app/blob/completed/src/lib/studentCharges.ts"
click node_audit "https://github.com/fares556259/school_management_app/blob/completed/src/lib/audit.ts"
click node_telegramwebhook "https://github.com/fares556259/school_management_app/blob/completed/src/app/api/telegram/webhook/route.ts"
click node_telegramagent "https://github.com/fares556259/school_management_app/blob/completed/src/lib/telegram/agent.ts"
click node_telegram "https://github.com/fares556259/school_management_app/blob/completed/src/lib/telegram/telegram.ts"
click node_excel "https://github.com/fares556259/school_management_app/blob/completed/src/lib/excel/excelEngine.ts"
click node_portal "https://github.com/fares556259/school_management_app/blob/completed/src/lib/externalPortals/externalPortalService.ts"
click node_browser "https://github.com/fares556259/school_management_app/blob/completed/src/lib/browser/browserService.ts"
click node_database "https://github.com/fares556259/school_management_app/blob/completed/src/lib/prisma.ts"
click node_school "https://github.com/fares556259/school_management_app/blob/completed/src/lib/school.ts"
click node_notifications "https://github.com/fares556259/school_management_app/blob/completed/src/lib/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_dashboard,node_auth,node_mobileauthroute,node_enrollment toneBlue
class node_attendance,node_grades toneAmber
class node_chargesroute,node_charges,node_audit toneMint
class node_telegramwebhook,node_telegramagent,node_telegram,node_excel,node_portal,node_browser toneRose
class node_mobileauth,node_database,node_school,node_notifications,node_admin,node_teacher,node_parent,node_student toneIndigo
```

## Components

### Access and roles

- [Role dashboards](https://github.com/fares556259/school_management_app/blob/completed/src/app/(dashboard)/layout.tsx): `src/app/(dashboard)/layout.tsx`
- [Web authentication](https://github.com/fares556259/school_management_app/blob/completed/src/utils/supabase/server.ts): `src/utils/supabase/server.ts`
- [Mobile sign-in](https://github.com/fares556259/school_management_app/blob/completed/src/app/api/mobile/auth/route.ts): `src/app/api/mobile/auth/route.ts`
- [Parent enrollment](https://github.com/fares556259/school_management_app/blob/completed/src/app/api/parent-requests/route.ts): `src/app/api/parent-requests/route.ts`

### Academic operations

- [Attendance](https://github.com/fares556259/school_management_app/blob/completed/src/app/api/attendance/route.ts): `src/app/api/attendance/route.ts`
- [Grades and reports](https://github.com/fares556259/school_management_app/blob/completed/src/app/api/report-card/route.ts): `src/app/api/report-card/route.ts`

### Finance and oversight

- [Student charges API](https://github.com/fares556259/school_management_app/blob/completed/src/app/api/admin/student-charges/route.ts): `src/app/api/admin/student-charges/route.ts`
- [Billing engine](https://github.com/fares556259/school_management_app/blob/completed/src/lib/studentCharges.ts): `src/lib/studentCharges.ts`
- [Audit logs](https://github.com/fares556259/school_management_app/blob/completed/src/lib/audit.ts): `src/lib/audit.ts`

### AI and integrations

- [Telegram webhook](https://github.com/fares556259/school_management_app/blob/completed/src/app/api/telegram/webhook/route.ts): `src/app/api/telegram/webhook/route.ts`
- [Telegram AI agent](https://github.com/fares556259/school_management_app/blob/completed/src/lib/telegram/agent.ts): `src/lib/telegram/agent.ts`
- [Telegram messaging](https://github.com/fares556259/school_management_app/blob/completed/src/lib/telegram/telegram.ts): `src/lib/telegram/telegram.ts`
- [Spreadsheet tools](https://github.com/fares556259/school_management_app/blob/completed/src/lib/excel/excelEngine.ts): `src/lib/excel/excelEngine.ts`
- [External portal automation](https://github.com/fares556259/school_management_app/blob/completed/src/lib/externalPortals/externalPortalService.ts): `src/lib/externalPortals/externalPortalService.ts`
- [Browser automation](https://github.com/fares556259/school_management_app/blob/completed/src/lib/browser/browserService.ts): `src/lib/browser/browserService.ts`

### Shared platform

- [Mobile identity](https://github.com/fares556259/school_management_app/blob/completed/src/lib/mobileAuth.ts): `src/lib/mobileAuth.ts`
- [School records](https://github.com/fares556259/school_management_app/blob/completed/src/lib/prisma.ts): `src/lib/prisma.ts`
- [Tenant resolution](https://github.com/fares556259/school_management_app/blob/completed/src/lib/school.ts): `src/lib/school.ts`
- [Notifications](https://github.com/fares556259/school_management_app/blob/completed/src/lib/notifications.ts): `src/lib/notifications.ts`

### Other components

- **Administrator**
- **Teacher**
- **Parent**
- **Student**

## Connections

- Administrator → Role dashboards: uses role view (evidence: `README.md`)
- Teacher → Role dashboards: uses role view (evidence: `README.md`)
- Parent → Role dashboards: uses role view (evidence: `README.md`)
- Student → Role dashboards: uses role view (evidence: `README.md`)
- Role dashboards → Web authentication: authenticates through
- Mobile sign-in → Mobile identity: issues tokens (evidence: `src/app/api/mobile/auth/route.ts`)
- Mobile sign-in → School records: reads and writes (evidence: `src/app/api/mobile/auth/route.ts`)
- Mobile sign-in → Web authentication: checks rate limits (evidence: `src/app/api/mobile/auth/route.ts`)
- Attendance → School records: reads and writes (evidence: `src/app/api/attendance/route.ts`)
- Attendance → Tenant resolution: resolves tenant (evidence: `src/app/api/attendance/route.ts`)
- Attendance → Notifications: creates alerts (evidence: `src/app/api/attendance/route.ts`)
- Grades and reports → School records: reads results (evidence: `src/app/api/report-card/route.ts`)
- Grades and reports → Tenant resolution: resolves tenant (evidence: `src/app/api/report-card/route.ts`)
- Parent enrollment → School records: reads and writes (evidence: `src/app/api/parent-requests/route.ts`)
- Parent enrollment → Billing engine: syncs billing (evidence: `src/app/api/parent-requests/route.ts`)
- Parent enrollment → Audit logs: records changes (evidence: `src/app/api/parent-requests/route.ts`)
- Student charges API → Mobile identity: authenticates mobile (evidence: `src/app/api/admin/student-charges/route.ts`)
- Student charges API → Web authentication: authenticates web (evidence: `src/app/api/admin/student-charges/route.ts`)
- Student charges API → Billing engine: synchronizes charges (evidence: `src/app/api/admin/student-charges/route.ts`)
- Student charges API → School records: reads and writes (evidence: `src/app/api/admin/student-charges/route.ts`)
- Telegram webhook → Telegram messaging: sends messages (evidence: `src/app/api/telegram/webhook/route.ts`)
- Telegram webhook → Telegram AI agent: dispatches requests (evidence: `src/app/api/telegram/webhook/route.ts`)
- Telegram webhook → Spreadsheet tools: uses spreadsheet tools (evidence: `src/app/api/telegram/webhook/route.ts`)
- External portal automation → Browser automation: automates browsing (evidence: `src/lib/externalPortals/externalPortalService.ts`)
- Tenant resolution → Web authentication: verifies identity (evidence: `src/lib/school.ts`)
- Tenant resolution → School records: resolves membership (evidence: `src/lib/school.ts`)
