# edumanageteam/edu_api architecture

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

- Interactive diagram: https://gitdiagram.com/edumanageteam/edu_api
- Repository: https://github.com/edumanageteam/edu_api

## Overview

Edu API is a Laravel/Sanctum school-management backend. A client sends API requests through Laravel’s HTTP entry point and API routes to authentication or school-domain controllers, which return JSON and operate on user, role, attendance, class, parent, student, subject, and teacher records. The README documents token-based authentication and a welcome-page route; the tree also shows role-aware middleware and resource/validation modules. Relationships among unsampled route or resource details are not expanded beyond references in the provided index.

Main entry points: [`routes/api.php`](https://github.com/edumanageteam/edu_api/blob/main/routes/api.php) (API Routes), [`app/Models/User.php`](https://github.com/edumanageteam/edu_api/blob/main/app/Models/User.php) (User Accounts), [`app/Models/Role.php`](https://github.com/edumanageteam/edu_api/blob/main/app/Models/Role.php) (Roles), [`app/Http/Controllers/Api/ParentController.php`](https://github.com/edumanageteam/edu_api/blob/main/app/Http/Controllers/Api/ParentController.php) (Parent API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["HTTP Runtime"]
  node_entry["HTTP Entry<br/>[index.php]"]
  node_bootstrap["App Bootstrap<br/>[app.php]"]
  node_httpkernel["HTTP Kernel<br/>[Kernel.php]"]
  node_routeprovider["Route Provider"]
  node_apiroutes["API Routes<br/>[api.php]"]
end

subgraph group_identity["Identity &amp; Access"]
  node_auth["Authentication<br/>[AuthController.php]"]
  node_userapi["User API<br/>[UserController.php]"]
  node_roleapi["Role API<br/>[RoleController.php]"]
end

subgraph group_school["School Management"]
  node_attendanceapi["Attendance API"]
  node_studentapi["Student API"]
  node_parentapi["Parent API"]
  node_teacherapi["Teacher API"]
  node_classapi["Class API"]
  node_subjectapi["Subject API"]
end

subgraph group_records["Domain Records"]
  node_users["User Accounts<br/>[User.php]"]
  node_roles["Roles<br/>[Role.php]"]
  node_attendance["Attendance Records<br/>[Attendance.php]"]
  node_students["Student Records<br/>[Student.php]"]
  node_parents["Parent Records<br/>[ParentModel.php]"]
  node_teachers["Teacher Records<br/>[Teacher.php]"]
  node_classes["Class Records<br/>[ClassRoom.php]"]
  node_subjects["Subject Records<br/>[Subject.php]"]
  node_seedusers["User Seed Data<br/>[UserSeeder.php]"]
end

node_client(("API Client"))

node_client -->|"sends request"| node_entry
node_entry -->|"loads app"| node_bootstrap
node_bootstrap -->|"binds kernel"| node_httpkernel
node_routeprovider -->|"registers routes"| node_apiroutes
node_apiroutes -->|"routes to"| node_auth
node_apiroutes -->|"routes to"| node_userapi
node_apiroutes -->|"routes to"| node_roleapi
node_apiroutes -->|"routes to"| node_attendanceapi
node_apiroutes -->|"routes to"| node_studentapi
node_apiroutes -->|"routes to"| node_parentapi
node_apiroutes -->|"routes to"| node_teacherapi
node_apiroutes -->|"routes to"| node_classapi
node_apiroutes -->|"routes to"| node_subjectapi
node_auth -->|"reads/writes"| node_users
node_auth -->|"looks up"| node_roles
node_userapi -->|"reads/writes"| node_users
node_userapi -->|"uses"| node_roles
node_roleapi -->|"reads/writes"| node_roles
node_attendanceapi -->|"reads/writes"| node_attendance
node_studentapi -->|"reads/writes"| node_students
node_parentapi -->|"reads/writes"| node_parents
node_parentapi -->|"creates/updates"| node_users
node_parentapi -->|"looks up"| node_roles
node_teacherapi -->|"reads/writes"| node_teachers
node_teacherapi -->|"creates/updates"| node_users
node_teacherapi -->|"looks up"| node_roles
node_classapi -->|"reads/writes"| node_classes
node_subjectapi -->|"reads/writes"| node_subjects
node_users -->|"belongs to"| node_roles
node_teachers -->|"belongs to"| node_users
node_teachers -->|"has many"| node_classes
node_students -->|"belongs to"| node_classes
node_attendance -->|"references"| node_students
node_attendance -->|"references"| node_classes

click node_entry "https://github.com/edumanageteam/edu_api/blob/main/public/index.php"
click node_bootstrap "https://github.com/edumanageteam/edu_api/blob/main/bootstrap/app.php"
click node_httpkernel "https://github.com/edumanageteam/edu_api/blob/main/app/Http/Kernel.php"
click node_routeprovider "https://github.com/edumanageteam/edu_api/blob/main/app/Providers/RouteServiceProvider.php"
click node_apiroutes "https://github.com/edumanageteam/edu_api/blob/main/routes/api.php"
click node_auth "https://github.com/edumanageteam/edu_api/blob/main/app/Http/Controllers/Api/AuthController.php"
click node_userapi "https://github.com/edumanageteam/edu_api/blob/main/app/Http/Controllers/Api/UserController.php"
click node_roleapi "https://github.com/edumanageteam/edu_api/blob/main/app/Http/Controllers/Api/RoleController.php"
click node_users "https://github.com/edumanageteam/edu_api/blob/main/app/Models/User.php"
click node_roles "https://github.com/edumanageteam/edu_api/blob/main/app/Models/Role.php"
click node_attendanceapi "https://github.com/edumanageteam/edu_api/blob/main/app/Http/Controllers/Api/AttendanceController.php"
click node_studentapi "https://github.com/edumanageteam/edu_api/blob/main/app/Http/Controllers/Api/StudentController.php"
click node_parentapi "https://github.com/edumanageteam/edu_api/blob/main/app/Http/Controllers/Api/ParentController.php"
click node_teacherapi "https://github.com/edumanageteam/edu_api/blob/main/app/Http/Controllers/Api/TeacherController.php"
click node_classapi "https://github.com/edumanageteam/edu_api/blob/main/app/Http/Controllers/Api/ClassController.php"
click node_subjectapi "https://github.com/edumanageteam/edu_api/blob/main/app/Http/Controllers/Api/SubjectController.php"
click node_attendance "https://github.com/edumanageteam/edu_api/blob/main/app/Models/Attendance.php"
click node_students "https://github.com/edumanageteam/edu_api/blob/main/app/Models/Student.php"
click node_parents "https://github.com/edumanageteam/edu_api/blob/main/app/Models/ParentModel.php"
click node_teachers "https://github.com/edumanageteam/edu_api/blob/main/app/Models/Teacher.php"
click node_classes "https://github.com/edumanageteam/edu_api/blob/main/app/Models/ClassRoom.php"
click node_subjects "https://github.com/edumanageteam/edu_api/blob/main/app/Models/Subject.php"
click node_seedusers "https://github.com/edumanageteam/edu_api/blob/main/database/seeders/UserSeeder.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_entry,node_bootstrap,node_httpkernel,node_routeprovider,node_apiroutes,node_client toneBlue
class node_auth,node_userapi,node_roleapi toneAmber
class node_attendanceapi,node_studentapi,node_parentapi,node_teacherapi,node_classapi,node_subjectapi toneMint
class node_users,node_roles,node_attendance,node_students,node_parents,node_teachers,node_classes,node_subjects,node_seedusers toneRose
```

## Components

### HTTP Runtime

- [HTTP Entry](https://github.com/edumanageteam/edu_api/blob/main/public/index.php): `public/index.php`
- [App Bootstrap](https://github.com/edumanageteam/edu_api/blob/main/bootstrap/app.php): `bootstrap/app.php`
- [HTTP Kernel](https://github.com/edumanageteam/edu_api/blob/main/app/Http/Kernel.php): `app/Http/Kernel.php`
- [Route Provider](https://github.com/edumanageteam/edu_api/blob/main/app/Providers/RouteServiceProvider.php): `app/Providers/RouteServiceProvider.php`
- [API Routes](https://github.com/edumanageteam/edu_api/blob/main/routes/api.php): `routes/api.php`

### Identity & Access

- [Authentication](https://github.com/edumanageteam/edu_api/blob/main/app/Http/Controllers/Api/AuthController.php): `app/Http/Controllers/Api/AuthController.php`
- [User API](https://github.com/edumanageteam/edu_api/blob/main/app/Http/Controllers/Api/UserController.php): `app/Http/Controllers/Api/UserController.php`
- [Role API](https://github.com/edumanageteam/edu_api/blob/main/app/Http/Controllers/Api/RoleController.php): `app/Http/Controllers/Api/RoleController.php`

### School Management

- [Attendance API](https://github.com/edumanageteam/edu_api/blob/main/app/Http/Controllers/Api/AttendanceController.php): `app/Http/Controllers/Api/AttendanceController.php`
- [Student API](https://github.com/edumanageteam/edu_api/blob/main/app/Http/Controllers/Api/StudentController.php): `app/Http/Controllers/Api/StudentController.php`
- [Parent API](https://github.com/edumanageteam/edu_api/blob/main/app/Http/Controllers/Api/ParentController.php): `app/Http/Controllers/Api/ParentController.php`
- [Teacher API](https://github.com/edumanageteam/edu_api/blob/main/app/Http/Controllers/Api/TeacherController.php): `app/Http/Controllers/Api/TeacherController.php`
- [Class API](https://github.com/edumanageteam/edu_api/blob/main/app/Http/Controllers/Api/ClassController.php): `app/Http/Controllers/Api/ClassController.php`
- [Subject API](https://github.com/edumanageteam/edu_api/blob/main/app/Http/Controllers/Api/SubjectController.php): `app/Http/Controllers/Api/SubjectController.php`

### Domain Records

- [User Accounts](https://github.com/edumanageteam/edu_api/blob/main/app/Models/User.php): `app/Models/User.php`
- [Roles](https://github.com/edumanageteam/edu_api/blob/main/app/Models/Role.php): `app/Models/Role.php`
- [Attendance Records](https://github.com/edumanageteam/edu_api/blob/main/app/Models/Attendance.php): `app/Models/Attendance.php`
- [Student Records](https://github.com/edumanageteam/edu_api/blob/main/app/Models/Student.php): `app/Models/Student.php`
- [Parent Records](https://github.com/edumanageteam/edu_api/blob/main/app/Models/ParentModel.php): `app/Models/ParentModel.php`
- [Teacher Records](https://github.com/edumanageteam/edu_api/blob/main/app/Models/Teacher.php): `app/Models/Teacher.php`
- [Class Records](https://github.com/edumanageteam/edu_api/blob/main/app/Models/ClassRoom.php): `app/Models/ClassRoom.php`
- [Subject Records](https://github.com/edumanageteam/edu_api/blob/main/app/Models/Subject.php): `app/Models/Subject.php`
- [User Seed Data](https://github.com/edumanageteam/edu_api/blob/main/database/seeders/UserSeeder.php): `database/seeders/UserSeeder.php`

### Other components

- **API Client**

## Connections

- API Client → HTTP Entry: sends request (evidence: `README.md`)
- HTTP Entry → App Bootstrap: loads app (evidence: `public/index.php`)
- App Bootstrap → HTTP Kernel: binds kernel (evidence: `bootstrap/app.php`)
- Route Provider → API Routes: registers routes (evidence: `app/Providers/RouteServiceProvider.php`)
- API Routes → Authentication: routes to (evidence: `routes/api.php`)
- API Routes → User API: routes to (evidence: `routes/api.php`)
- API Routes → Role API: routes to (evidence: `routes/api.php`)
- API Routes → Attendance API: routes to (evidence: `routes/api.php`)
- API Routes → Student API: routes to (evidence: `routes/api.php`)
- API Routes → Parent API: routes to (evidence: `routes/api.php`)
- API Routes → Teacher API: routes to (evidence: `routes/api.php`)
- API Routes → Class API: routes to (evidence: `routes/api.php`)
- API Routes → Subject API: routes to (evidence: `routes/api.php`)
- Authentication → User Accounts: reads/writes (evidence: `app/Http/Controllers/Api/AuthController.php`)
- Authentication → Roles: looks up (evidence: `app/Http/Controllers/Api/AuthController.php`)
- User API → User Accounts: reads/writes (evidence: `app/Http/Controllers/Api/UserController.php`)
- User API → Roles: uses (evidence: `app/Http/Controllers/Api/UserController.php`)
- Role API → Roles: reads/writes (evidence: `app/Http/Controllers/Api/RoleController.php`)
- Attendance API → Attendance Records: reads/writes (evidence: `app/Http/Controllers/Api/AttendanceController.php`)
- Student API → Student Records: reads/writes (evidence: `app/Http/Controllers/Api/StudentController.php`)
- Parent API → Parent Records: reads/writes (evidence: `app/Http/Controllers/Api/ParentController.php`)
- Parent API → User Accounts: creates/updates (evidence: `app/Http/Controllers/Api/ParentController.php`)
- Parent API → Roles: looks up (evidence: `app/Http/Controllers/Api/ParentController.php`)
- Teacher API → Teacher Records: reads/writes (evidence: `app/Http/Controllers/Api/TeacherController.php`)
- Teacher API → User Accounts: creates/updates (evidence: `app/Http/Controllers/Api/TeacherController.php`)
- Teacher API → Roles: looks up (evidence: `app/Http/Controllers/Api/TeacherController.php`)
- Class API → Class Records: reads/writes (evidence: `app/Http/Controllers/Api/ClassController.php`)
- Subject API → Subject Records: reads/writes (evidence: `app/Http/Controllers/Api/SubjectController.php`)
- User Accounts → Roles: belongs to (evidence: `app/Models/User.php`)
- Teacher Records → User Accounts: belongs to (evidence: `app/Models/Teacher.php`)
- Teacher Records → Class Records: has many (evidence: `app/Models/Teacher.php`)
- Student Records → Class Records: belongs to (evidence: `app/Models/Student.php`)
- Attendance Records → Student Records: references (evidence: `app/Models/Attendance.php`)
- Attendance Records → Class Records: references (evidence: `app/Models/Attendance.php`)
