How fares556259/school_management_app works
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: prisma.ts School records · layout.tsx Role dashboards · route.ts Student charges API · school.ts Tenant resolution
Components 23
Access and roles
- Role dashboards
src/app/(dashboard)/layout.tsx - Web authentication
src/utils/supabase/server.ts - Mobile sign-in
src/app/api/mobile/auth/route.ts - Parent enrollment
src/app/api/parent-requests/route.ts
Academic operations
- Attendance
src/app/api/attendance/route.ts - Grades and reports
src/app/api/report-card/route.ts
Finance and oversight
- Student charges API
src/app/api/admin/student-charges/route.ts - Billing engine
src/lib/studentCharges.ts - Audit logs
src/lib/audit.ts
AI and integrations
- Telegram webhook
src/app/api/telegram/webhook/route.ts - Telegram AI agent
src/lib/telegram/agent.ts - Telegram messaging
src/lib/telegram/telegram.ts - Spreadsheet tools
src/lib/excel/excelEngine.ts - External portal automation
src/lib/externalPortals/externalPortalService.ts - Browser automation
src/lib/browser/browserService.ts
Shared platform
- Mobile identity
src/lib/mobileAuth.ts - School records
src/lib/prisma.ts - Tenant resolution
src/lib/school.ts - Notifications
src/lib/notifications.ts
Other components
- Administrator
- Teacher
- Parent
- Student
Connections 26
- Administrator → Role dashboards: uses role view
README.md - Teacher → Role dashboards: uses role view
README.md - Parent → Role dashboards: uses role view
README.md - Student → Role dashboards: uses role view
README.md - Role dashboards → Web authentication: authenticates through
- Mobile sign-in → Mobile identity: issues tokens
src/app/api/mobile/auth/route.ts - Mobile sign-in → School records: reads and writes
src/app/api/mobile/auth/route.ts - Mobile sign-in → Web authentication: checks rate limits
src/app/api/mobile/auth/route.ts - Attendance → School records: reads and writes
src/app/api/attendance/route.ts - Attendance → Tenant resolution: resolves tenant
src/app/api/attendance/route.ts - Attendance → Notifications: creates alerts
src/app/api/attendance/route.ts - Grades and reports → School records: reads results
src/app/api/report-card/route.ts - Grades and reports → Tenant resolution: resolves tenant
src/app/api/report-card/route.ts - Parent enrollment → School records: reads and writes
src/app/api/parent-requests/route.ts - Parent enrollment → Billing engine: syncs billing
src/app/api/parent-requests/route.ts - Parent enrollment → Audit logs: records changes
src/app/api/parent-requests/route.ts - Student charges API → Mobile identity: authenticates mobile
src/app/api/admin/student-charges/route.ts - Student charges API → Web authentication: authenticates web
src/app/api/admin/student-charges/route.ts - Student charges API → Billing engine: synchronizes charges
src/app/api/admin/student-charges/route.ts - Student charges API → School records: reads and writes
src/app/api/admin/student-charges/route.ts - Telegram webhook → Telegram messaging: sends messages
src/app/api/telegram/webhook/route.ts - Telegram webhook → Telegram AI agent: dispatches requests
src/app/api/telegram/webhook/route.ts - Telegram webhook → Spreadsheet tools: uses spreadsheet tools
src/app/api/telegram/webhook/route.ts - External portal automation → Browser automation: automates browsing
src/lib/externalPortals/externalPortalService.ts - Tenant resolution → Web authentication: verifies identity
src/lib/school.ts - Tenant resolution → School records: resolves membership
src/lib/school.ts