How kiarie-ke/sms works
School System is a Kenyan school-management platform with a Next.js role-based interface and a NestJS API backed by Prisma/PostgreSQL. The built user workflow is: sign in, access role-scoped school records, and manage people/structure or record and review daily attendance. Student import and photo upload support administration; attendance absence notices are in-app. Exams, CBC assessment, fees, report cards, audit, and SMS have repository modules, but the README says several remain unfinished. Edges rely on the README and shown source; unsampled module internals are not inferred.
Main entry points: prisma.service.ts Prisma access · attendance.service.ts Attendance · auth.controller.ts Auth endpoints · students.service.ts Student management
Components 24
Web experience
- Role dashboards
apps/web/src/app/(dashboard) - Login form
apps/web/src/components/auth/login-form.tsx - Session routes
apps/web/src/app/api/session - API client
apps/web/src/lib/api/http-client.ts
Identity and access
- Auth endpoints
apps/api/src/auth/auth.controller.ts - Authentication
apps/api/src/auth/auth.service.ts - Auth cookies
apps/api/src/auth/auth-cookie.service.ts
People and structure
- Student management
apps/api/src/people/students/students.service.ts - Student endpoints
apps/api/src/people/students/students.controller.ts - Photo storage
apps/api/src/people/students/photo-storage.service.ts - Role scoping
apps/api/src/scoping/scoping.service.ts - School structure
apps/api/src/structure
School operations
- Attendance
apps/api/src/attendance/attendance.service.ts - Exams and marks
apps/api/src/exams - CBC assessment
apps/api/src/cbc - Report cards
apps/api/src/report-cards/report-card.service.ts - Fees
apps/api/src/fees - Notifications
apps/api/src/notifications - Audit logs
apps/api/src/audit - SMS integration
apps/api/src/sms
Persistence
- Prisma access
apps/api/src/prisma/prisma.service.ts - PostgreSQL
Other components
- School user
- Cloudinary
Connections 26
- School user → Login form: signs in
README.md - Login form → Session routes: starts session
README.md - Session routes → Auth endpoints: authenticates
README.md - Auth endpoints → Authentication: delegates to
apps/api/src/auth/auth.controller.ts - Auth endpoints → Auth cookies: sets cookies
apps/api/src/auth/auth.controller.ts - School user → Role dashboards: uses role view
README.md - Role dashboards → API client: requests records
README.md - API client → Student endpoints: calls API
README.md - Student endpoints → Student management: delegates to
apps/api/src/people/students/students.controller.ts - Student management → Role scoping: checks access
README.md - Student endpoints → Photo storage: uploads photo
README.md - Photo storage → Cloudinary: uploads image
apps/api/src/people/students/photo-storage.service.ts - School user → Attendance: records or views
README.md - Attendance → Role scoping: enforces scope
README.md - Attendance → Notifications: notifies absence
README.md - Student management → Prisma access: persists records
- Attendance → Prisma access: reads and writes
- Prisma access → PostgreSQL: stores data
README.md - School structure → Prisma access: persists structure
- Exams and marks → Prisma access: stores exam data
apps/api/src/exams/exam.repository.ts - CBC assessment → Prisma access: stores assessment data
apps/api/src/cbc/cbc.repository.ts - Report cards → Exams and marks: uses exam marks
apps/api/src/report-cards/report-card.service.ts - Report cards → CBC assessment: uses CBC results
apps/api/src/report-cards/report-card.service.ts - Fees → Prisma access: stores fee data
apps/api/src/fees/fee.repository.ts - Audit logs → Prisma access: stores audit data
- SMS integration → School user: sends messages