How triplet19/nts-sms works
NTS-SMS is a school management system with an admin-configurable identity, branding, and mail layer. Its main user-facing workflow spans student and grade entry, grade approval, and report-card viewing or design; role and workflow administration support that process. The sampled code confirms the frontend auth client and backend auth/settings routes, but most school-domain implementations were not excerpted. Those capabilities are represented from the repository tree, without asserting unverified calls between them.
Main entry points: MailSettingsController.php Mail settings API · api.php API routes · GeneralSettingsController.php General settings API · page.tsx Login screen
Components 29
Access and navigation
- Login screen
frontend/app/(auth)/login/page.tsx - Auth client
frontend/lib/auth.ts - API client
frontend/lib/api.ts - Dashboard
frontend/app/(dashboard)/dashboard/page.tsx - Branding display
frontend/components/layout/AppLogo.tsx
School records and grading
- Student records
frontend/app/(dashboard)/students/page.tsx - Student detail
frontend/app/(dashboard)/students/[id]/page.tsx - Grade submission
frontend/app/(dashboard)/grades/submit/page.tsx - Grade approvals
frontend/app/(dashboard)/grades/approvals/page.tsx
Report cards
- Report cards
frontend/app/(dashboard)/report-cards/page.tsx - Student report card
frontend/app/(dashboard)/report-cards/[studentId]/page.tsx - Template designer
frontend/app/(dashboard)/admin/report-card-designer/page.tsx
Administration
- Roles and permissions
frontend/app/(dashboard)/admin/roles/page.tsx - Approval workflows
frontend/app/(dashboard)/admin/workflows/page.tsx - General settings
frontend/app/(dashboard)/admin/settings/general/page.tsx - Mail settings
frontend/app/(dashboard)/admin/settings/mail/page.tsx
Backend services
- Authentication API
backend/app/Http/Controllers/Api/AuthController.php - API routes
backend/routes/api.php - Grade submission API
backend/app/Http/Controllers/Api/GradeController.php - Approval API
backend/app/Http/Controllers/Api/ApprovalController.php - Report-card PDF
backend/app/Http/Controllers/Api/ReportCardPdfController.php - Template management
backend/app/Http/Controllers/Api/ReportCardTemplateController.php - General settings API
backend/app/Http/Controllers/Api/GeneralSettingsController.php - General settings store
backend/app/Settings/GeneralSettings.php - Public settings API
backend/app/Http/Controllers/Api/PublicSettingsController.php - Mail settings API
backend/app/Http/Controllers/Api/MailSettingsController.php - Mail settings store
backend/app/Settings/MailSettings.php - Test email
backend/app/Mail/TestMail.php
Other components
- School staff
Connections 20
- School staff → Login screen: signs in
- Auth client → API client: uses
frontend/lib/auth.ts - API routes → Authentication API: routes auth
backend/routes/api.php - API routes → General settings API: routes settings
backend/routes/api.php - API routes → Mail settings API: routes settings
backend/routes/api.php - General settings API → General settings store: reads and saves
backend/app/Http/Controllers/Api/GeneralSettingsController.php - Public settings API → General settings store: reads
backend/app/Http/Controllers/Api/PublicSettingsController.php - Mail settings API → Mail settings store: reads and saves
backend/app/Http/Controllers/Api/MailSettingsController.php - Mail settings API → Test email: sends
backend/app/Http/Controllers/Api/MailSettingsController.php - Login screen → Auth client: authenticates via
- Dashboard → Student records: offers records
- Student records → Student detail: opens
- Grade submission → Grade submission API: submits to
- Grade approvals → Approval API: reviews via
- Report cards → Student report card: opens
- Student report card → Report-card PDF: requests PDF
- Template designer → Template management: edits templates via
- General settings → General settings API: updates via
- Mail settings → Mail settings API: updates via
- Branding display → Public settings API: loads branding