# hoobier/kidsecure-backend architecture

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

- Interactive diagram: https://gitdiagram.com/hoobier/kidsecure-backend
- Repository: https://github.com/hoobier/kidsecure-backend

## Overview

This Laravel application appears to support school administration, including enrollment, student and parent records, attendance, teacher-entered grades, report cards, and school-year settings. The main workflow is staff or guest requests entering through API routes, being handled by domain controllers and services, and updating MongoDB-backed records; selected data is mirrored to Firebase. The README is the default Laravel template and documents no product capabilities. Edges reflect the supplied excerpts and source index; unsampled controller behavior and external integrations are not asserted beyond those references.

Main entry points: [`routes/api.php`](https://github.com/hoobier/kidsecure-backend/blob/main/routes/api.php) (API routes), [`app/Http/Controllers/StudentController.php`](https://github.com/hoobier/kidsecure-backend/blob/main/app/Http/Controllers/StudentController.php) (Student management), [`app/Services/AttendanceDeriveService.php`](https://github.com/hoobier/kidsecure-backend/blob/main/app/Services/AttendanceDeriveService.php) (Attendance derivation), [`app/Services/EnrollmentService.php`](https://github.com/hoobier/kidsecure-backend/blob/main/app/Services/EnrollmentService.php) (Enrollment service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["API entry"]
  node_api["API routes<br/>[api.php]"]
end

subgraph group_enrollment["Enrollment"]
  node_enrollctl["Enrollment applications"]
  node_draftctl["Draft documents"]
  node_enrollsvc["Enrollment service"]
  node_uploadsvc["Document uploads"]
end

subgraph group_school["School operations"]
  node_studentctl["Student management"]
  node_teacherctl["Teacher management"]
  node_teachstudent["Teacher student tools"]
  node_attendance["Attendance derivation"]
  node_gradesub["Grade subjects"]
  node_parentctl["Parent management"]
  node_termctl["Term settings"]
  node_rollover["School-year rollover"]
end

subgraph group_domain["Domain records"]
  node_student[("Student records<br/>[Student.php]")]
  node_parent[("Parent records<br/>[ParentAccount.php]")]
  node_attendance_log[("Attendance logs<br/>[AttendanceLog.php]")]
  node_term[("Term settings<br/>[TermSetting.php]")]
end

subgraph group_integrations["External services"]
  node_firebase["Firebase sync"]
  node_mailer["Parent email"]
end

node_staff(("Staff / guest"))
node_firebase_ext["Firebase services"]

node_staff -->|"sends requests"| node_api
node_api -->|"routes requests"| node_enrollctl
node_api -->|"routes requests"| node_draftctl
node_api -->|"routes requests"| node_studentctl
node_api -->|"routes requests"| node_teacherctl
node_api -->|"routes requests"| node_teachstudent
node_api -->|"routes requests"| node_parentctl
node_api -->|"routes requests"| node_termctl
node_api -->|"routes requests"| node_rollover
node_enrollctl -->|"creates enrollment"| node_enrollsvc
node_enrollctl -.->|"uploads documents"| node_uploadsvc
node_draftctl -->|"uploads / signs"| node_uploadsvc
node_enrollsvc -->|"creates student"| node_student
node_enrollsvc -->|"creates or links parent"| node_parent
node_enrollsvc -->|"sends credentials"| node_mailer
node_studentctl -->|"manages records"| node_student
node_studentctl -->|"manages links"| node_parent
node_studentctl -->|"derives attendance"| node_attendance
node_studentctl -->|"syncs student"| node_firebase
node_teacherctl -->|"uses grade subjects"| node_gradesub
node_teachstudent -->|"reads student data"| node_student
node_teachstudent -->|"derives attendance"| node_attendance
node_teachstudent -->|"uses grade subjects"| node_gradesub
node_attendance -->|"reads scans"| node_attendance_log
node_attendance -->|"reads student"| node_student
node_attendance -->|"reads term settings"| node_term
node_parentctl -->|"manages accounts"| node_parent
node_parentctl -->|"syncs parent data"| node_firebase
node_firebase -.->|"mirrors records"| node_firebase_ext
node_termctl -.->|"manages settings"| node_term
node_rollover -.->|"updates school year"| node_term

click node_api "https://github.com/hoobier/kidsecure-backend/blob/main/routes/api.php"
click node_enrollctl "https://github.com/hoobier/kidsecure-backend/blob/main/app/Http/Controllers/EnrollmentApplicationController.php"
click node_draftctl "https://github.com/hoobier/kidsecure-backend/blob/main/app/Http/Controllers/EnrollmentDraftDocumentController.php"
click node_enrollsvc "https://github.com/hoobier/kidsecure-backend/blob/main/app/Services/EnrollmentService.php"
click node_uploadsvc "https://github.com/hoobier/kidsecure-backend/blob/main/app/Services/DocumentUploadService.php"
click node_studentctl "https://github.com/hoobier/kidsecure-backend/blob/main/app/Http/Controllers/StudentController.php"
click node_teacherctl "https://github.com/hoobier/kidsecure-backend/blob/main/app/Http/Controllers/TeacherController.php"
click node_teachstudent "https://github.com/hoobier/kidsecure-backend/blob/main/app/Http/Controllers/TeacherStudentController.php"
click node_attendance "https://github.com/hoobier/kidsecure-backend/blob/main/app/Services/AttendanceDeriveService.php"
click node_gradesub "https://github.com/hoobier/kidsecure-backend/blob/main/app/Services/GradeSubjectService.php"
click node_parentctl "https://github.com/hoobier/kidsecure-backend/blob/main/app/Http/Controllers/ParentController.php"
click node_termctl "https://github.com/hoobier/kidsecure-backend/blob/main/app/Http/Controllers/TermSettingController.php"
click node_rollover "https://github.com/hoobier/kidsecure-backend/blob/main/app/Http/Controllers/SchoolYearRolloverController.php"
click node_student "https://github.com/hoobier/kidsecure-backend/blob/main/app/Models/Student.php"
click node_parent "https://github.com/hoobier/kidsecure-backend/blob/main/app/Models/ParentAccount.php"
click node_attendance_log "https://github.com/hoobier/kidsecure-backend/blob/main/app/Models/AttendanceLog.php"
click node_term "https://github.com/hoobier/kidsecure-backend/blob/main/app/Models/TermSetting.php"
click node_firebase "https://github.com/hoobier/kidsecure-backend/blob/main/app/Services/FirebaseRealtimeService.php"
click node_mailer "https://github.com/hoobier/kidsecure-backend/blob/main/app/Mail/ParentAccountCreated.php"

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_api toneBlue
class node_enrollctl,node_draftctl,node_enrollsvc,node_uploadsvc toneAmber
class node_studentctl,node_teacherctl,node_teachstudent,node_attendance,node_gradesub,node_parentctl,node_termctl,node_rollover toneMint
class node_student,node_parent,node_attendance_log,node_term toneRose
class node_firebase,node_mailer,node_staff,node_firebase_ext toneIndigo
```

## Components

### API entry

- [API routes](https://github.com/hoobier/kidsecure-backend/blob/main/routes/api.php): `routes/api.php`

### Enrollment

- [Enrollment applications](https://github.com/hoobier/kidsecure-backend/blob/main/app/Http/Controllers/EnrollmentApplicationController.php): `app/Http/Controllers/EnrollmentApplicationController.php`
- [Draft documents](https://github.com/hoobier/kidsecure-backend/blob/main/app/Http/Controllers/EnrollmentDraftDocumentController.php): `app/Http/Controllers/EnrollmentDraftDocumentController.php`
- [Enrollment service](https://github.com/hoobier/kidsecure-backend/blob/main/app/Services/EnrollmentService.php): `app/Services/EnrollmentService.php`
- [Document uploads](https://github.com/hoobier/kidsecure-backend/blob/main/app/Services/DocumentUploadService.php): `app/Services/DocumentUploadService.php`

### School operations

- [Student management](https://github.com/hoobier/kidsecure-backend/blob/main/app/Http/Controllers/StudentController.php): `app/Http/Controllers/StudentController.php`
- [Teacher management](https://github.com/hoobier/kidsecure-backend/blob/main/app/Http/Controllers/TeacherController.php): `app/Http/Controllers/TeacherController.php`
- [Teacher student tools](https://github.com/hoobier/kidsecure-backend/blob/main/app/Http/Controllers/TeacherStudentController.php): `app/Http/Controllers/TeacherStudentController.php`
- [Attendance derivation](https://github.com/hoobier/kidsecure-backend/blob/main/app/Services/AttendanceDeriveService.php): `app/Services/AttendanceDeriveService.php`
- [Grade subjects](https://github.com/hoobier/kidsecure-backend/blob/main/app/Services/GradeSubjectService.php): `app/Services/GradeSubjectService.php`
- [Parent management](https://github.com/hoobier/kidsecure-backend/blob/main/app/Http/Controllers/ParentController.php): `app/Http/Controllers/ParentController.php`
- [Term settings](https://github.com/hoobier/kidsecure-backend/blob/main/app/Http/Controllers/TermSettingController.php): `app/Http/Controllers/TermSettingController.php`
- [School-year rollover](https://github.com/hoobier/kidsecure-backend/blob/main/app/Http/Controllers/SchoolYearRolloverController.php): `app/Http/Controllers/SchoolYearRolloverController.php`

### Domain records

- [Student records](https://github.com/hoobier/kidsecure-backend/blob/main/app/Models/Student.php): `app/Models/Student.php`
- [Parent records](https://github.com/hoobier/kidsecure-backend/blob/main/app/Models/ParentAccount.php): `app/Models/ParentAccount.php`
- [Attendance logs](https://github.com/hoobier/kidsecure-backend/blob/main/app/Models/AttendanceLog.php): `app/Models/AttendanceLog.php`
- [Term settings](https://github.com/hoobier/kidsecure-backend/blob/main/app/Models/TermSetting.php): `app/Models/TermSetting.php`

### External services

- [Firebase sync](https://github.com/hoobier/kidsecure-backend/blob/main/app/Services/FirebaseRealtimeService.php): `app/Services/FirebaseRealtimeService.php`
- [Parent email](https://github.com/hoobier/kidsecure-backend/blob/main/app/Mail/ParentAccountCreated.php): `app/Mail/ParentAccountCreated.php`

### Other components

- **Staff / guest**
- **Firebase services**

## Connections

- Staff / guest → API routes: sends requests (evidence: `routes/api.php`)
- API routes → Enrollment applications: routes requests (evidence: `routes/api.php`)
- API routes → Draft documents: routes requests (evidence: `routes/api.php`)
- API routes → Student management: routes requests (evidence: `routes/api.php`)
- API routes → Teacher management: routes requests (evidence: `routes/api.php`)
- API routes → Teacher student tools: routes requests (evidence: `routes/api.php`)
- API routes → Parent management: routes requests (evidence: `routes/api.php`)
- API routes → Term settings: routes requests (evidence: `routes/api.php`)
- API routes → School-year rollover: routes requests (evidence: `routes/api.php`)
- Enrollment applications → Enrollment service: creates enrollment (evidence: `app/Http/Controllers/EnrollmentApplicationController.php`)
- Enrollment applications → Document uploads: uploads documents (evidence: `app/Http/Controllers/EnrollmentApplicationController.php`)
- Draft documents → Document uploads: uploads / signs (evidence: `app/Http/Controllers/EnrollmentDraftDocumentController.php`)
- Enrollment service → Student records: creates student (evidence: `app/Services/EnrollmentService.php`)
- Enrollment service → Parent records: creates or links parent (evidence: `app/Services/EnrollmentService.php`)
- Enrollment service → Parent email: sends credentials (evidence: `app/Services/EnrollmentService.php`)
- Student management → Student records: manages records (evidence: `app/Http/Controllers/StudentController.php`)
- Student management → Parent records: manages links (evidence: `app/Http/Controllers/StudentController.php`)
- Student management → Attendance derivation: derives attendance (evidence: `app/Http/Controllers/StudentController.php`)
- Student management → Firebase sync: syncs student (evidence: `app/Http/Controllers/StudentController.php`)
- Teacher management → Grade subjects: uses grade subjects (evidence: `app/Http/Controllers/TeacherController.php`)
- Teacher student tools → Student records: reads student data (evidence: `app/Http/Controllers/TeacherStudentController.php`)
- Teacher student tools → Attendance derivation: derives attendance (evidence: `app/Http/Controllers/TeacherStudentController.php`)
- Teacher student tools → Grade subjects: uses grade subjects (evidence: `app/Http/Controllers/TeacherStudentController.php`)
- Attendance derivation → Attendance logs: reads scans (evidence: `app/Services/AttendanceDeriveService.php`)
- Attendance derivation → Student records: reads student (evidence: `app/Services/AttendanceDeriveService.php`)
- Attendance derivation → Term settings: reads term settings (evidence: `app/Services/AttendanceDeriveService.php`)
- Parent management → Parent records: manages accounts (evidence: `app/Http/Controllers/ParentController.php`)
- Parent management → Firebase sync: syncs parent data (evidence: `app/Http/Controllers/ParentController.php`)
- Firebase sync → Firebase services: mirrors records
- Term settings → Term settings: manages settings
- School-year rollover → Term settings: updates school year
