# konnarak1234/tamdan-kon-general-api architecture

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

- Interactive diagram: https://gitdiagram.com/konnarak1234/tamdan-kon-general-api
- Repository: https://github.com/konnarak1234/tamdan-kon-general-api

## Overview

Tamdan-Kon API is a Laravel backend for collecting and serving school-bus, student, attendance, and account data to mobile clients and IoT devices. Requests enter through the API routes and dispatch to feature controllers, which read or update domain models backed by the database. The documented workflow includes device location submission and later retrieval for monitoring; other API branches manage student and bus assignments, attendance requests, chat, and authentication. Several controller-to-model links are supported by the source index; implementation details for unsampled controllers are not inferred beyond those references.

Main entry points: [`routes/api.php`](https://github.com/konnarak1234/tamdan-kon-general-api/blob/main/routes/api.php) (API routes), [`app/Http/Controllers/Api/StudentController.php`](https://github.com/konnarak1234/tamdan-kon-general-api/blob/main/app/Http/Controllers/Api/StudentController.php) (Student API), [`app/Models/User.php`](https://github.com/konnarak1234/tamdan-kon-general-api/blob/main/app/Models/User.php) (User model), [`app/Http/Controllers/Api/BusController.php`](https://github.com/konnarak1234/tamdan-kon-general-api/blob/main/app/Http/Controllers/Api/BusController.php) (Bus API)

## Diagram (Mermaid)

```mermaid
flowchart TD

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

subgraph group_fleet["Bus tracking"]
  node_bus_api["Bus API<br/>[BusController.php]"]
  node_bus_model["Bus model<br/>[Bus.php]"]
  node_location_tables[("Bus location tables")]
end

subgraph group_people["Accounts and students"]
  node_student_api["Student API"]
  node_student_model["Student model<br/>[Student.php]"]
  node_user_api["User API<br/>[UserController.php]"]
  node_auth_api["Authentication API<br/>[AuthController.php]"]
  node_user_model["User model<br/>[User.php]"]
end

subgraph group_attendance["Attendance"]
  node_attendance_api["Attendance API"]
  node_attendance_model["Attendance model<br/>[Attendance.php]"]
  node_request_model["Attendance requests"]
end

subgraph group_messaging["Coordinates and chat"]
  node_coordinate_api["Coordinate API"]
  node_coordinate_model["Coordinate model<br/>[Coordinate.php]"]
  node_chat_api["Chat API<br/>[ChatController.php]"]
end

node_mobile(("Mobile clients"))
node_devices(("IoT devices"))
node_mysql[("MySQL database")]

node_mobile -->|"sends requests"| node_api_routes
node_devices -->|"posts coordinates"| node_api_routes
node_api_routes -->|"dispatches bus"| node_bus_api
node_api_routes -->|"dispatches student"| node_student_api
node_api_routes -->|"dispatches users"| node_user_api
node_api_routes -->|"dispatches login"| node_auth_api
node_api_routes -->|"dispatches attendance"| node_attendance_api
node_api_routes -->|"dispatches coordinates"| node_coordinate_api
node_api_routes -->|"dispatches chat"| node_chat_api
node_bus_api -->|"queries and updates"| node_bus_model
node_bus_api -->|"looks up drivers"| node_user_model
node_bus_api -->|"reads and writes"| node_location_tables
node_bus_api -->|"creates chat tables"| node_mysql
node_student_api -->|"queries and updates"| node_student_model
node_student_api -->|"checks attendance"| node_attendance_model
node_student_api -->|"checks requests"| node_request_model
node_student_api -->|"looks up buses"| node_bus_model
node_student_api -->|"looks up parents"| node_user_model
node_user_api -->|"creates and updates"| node_user_model
node_user_api -->|"creates and queries"| node_student_model
node_user_api -->|"assigns drivers"| node_bus_model
node_auth_api -->|"authenticates users"| node_user_model
node_attendance_api -->|"reads and records"| node_attendance_model
node_attendance_api -->|"reads and updates"| node_request_model
node_attendance_api -->|"resolves students"| node_student_model
node_attendance_api -->|"resolves parents"| node_user_model
node_coordinate_api -->|"stores and retrieves"| node_coordinate_model
node_chat_api -->|"uses bus records"| node_bus_model
node_chat_api -->|"uses student records"| node_student_model
node_chat_api -->|"uses user records"| node_user_model
node_coordinate_api -.->|"persists coordinates"| node_mysql

click node_api_routes "https://github.com/konnarak1234/tamdan-kon-general-api/blob/main/routes/api.php"
click node_bus_api "https://github.com/konnarak1234/tamdan-kon-general-api/blob/main/app/Http/Controllers/Api/BusController.php"
click node_bus_model "https://github.com/konnarak1234/tamdan-kon-general-api/blob/main/app/Models/Bus.php"
click node_student_api "https://github.com/konnarak1234/tamdan-kon-general-api/blob/main/app/Http/Controllers/Api/StudentController.php"
click node_student_model "https://github.com/konnarak1234/tamdan-kon-general-api/blob/main/app/Models/Student.php"
click node_user_api "https://github.com/konnarak1234/tamdan-kon-general-api/blob/main/app/Http/Controllers/Api/UserController.php"
click node_auth_api "https://github.com/konnarak1234/tamdan-kon-general-api/blob/main/app/Http/Controllers/Api/AuthController.php"
click node_user_model "https://github.com/konnarak1234/tamdan-kon-general-api/blob/main/app/Models/User.php"
click node_attendance_api "https://github.com/konnarak1234/tamdan-kon-general-api/blob/main/app/Http/Controllers/Api/AttendanceController.php"
click node_attendance_model "https://github.com/konnarak1234/tamdan-kon-general-api/blob/main/app/Models/Attendance.php"
click node_request_model "https://github.com/konnarak1234/tamdan-kon-general-api/blob/main/app/Models/AttendanceRequest.php"
click node_coordinate_api "https://github.com/konnarak1234/tamdan-kon-general-api/blob/main/app/Http/Controllers/Api/CoordinateController.php"
click node_coordinate_model "https://github.com/konnarak1234/tamdan-kon-general-api/blob/main/app/Models/Coordinate.php"
click node_chat_api "https://github.com/konnarak1234/tamdan-kon-general-api/blob/main/app/Http/Controllers/Api/ChatController.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_routes,node_mobile toneBlue
class node_bus_api,node_bus_model,node_location_tables,node_mysql toneAmber
class node_student_api,node_student_model,node_user_api,node_auth_api,node_user_model toneMint
class node_attendance_api,node_attendance_model,node_request_model toneRose
class node_coordinate_api,node_coordinate_model,node_chat_api,node_devices toneIndigo
```

## Components

### API entry

- [API routes](https://github.com/konnarak1234/tamdan-kon-general-api/blob/main/routes/api.php): `routes/api.php`

### Bus tracking

- [Bus API](https://github.com/konnarak1234/tamdan-kon-general-api/blob/main/app/Http/Controllers/Api/BusController.php): `app/Http/Controllers/Api/BusController.php`
- [Bus model](https://github.com/konnarak1234/tamdan-kon-general-api/blob/main/app/Models/Bus.php): `app/Models/Bus.php`
- **Bus location tables**

### Accounts and students

- [Student API](https://github.com/konnarak1234/tamdan-kon-general-api/blob/main/app/Http/Controllers/Api/StudentController.php): `app/Http/Controllers/Api/StudentController.php`
- [Student model](https://github.com/konnarak1234/tamdan-kon-general-api/blob/main/app/Models/Student.php): `app/Models/Student.php`
- [User API](https://github.com/konnarak1234/tamdan-kon-general-api/blob/main/app/Http/Controllers/Api/UserController.php): `app/Http/Controllers/Api/UserController.php`
- [Authentication API](https://github.com/konnarak1234/tamdan-kon-general-api/blob/main/app/Http/Controllers/Api/AuthController.php): `app/Http/Controllers/Api/AuthController.php`
- [User model](https://github.com/konnarak1234/tamdan-kon-general-api/blob/main/app/Models/User.php): `app/Models/User.php`

### Attendance

- [Attendance API](https://github.com/konnarak1234/tamdan-kon-general-api/blob/main/app/Http/Controllers/Api/AttendanceController.php): `app/Http/Controllers/Api/AttendanceController.php`
- [Attendance model](https://github.com/konnarak1234/tamdan-kon-general-api/blob/main/app/Models/Attendance.php): `app/Models/Attendance.php`
- [Attendance requests](https://github.com/konnarak1234/tamdan-kon-general-api/blob/main/app/Models/AttendanceRequest.php): `app/Models/AttendanceRequest.php`

### Coordinates and chat

- [Coordinate API](https://github.com/konnarak1234/tamdan-kon-general-api/blob/main/app/Http/Controllers/Api/CoordinateController.php): `app/Http/Controllers/Api/CoordinateController.php`
- [Coordinate model](https://github.com/konnarak1234/tamdan-kon-general-api/blob/main/app/Models/Coordinate.php): `app/Models/Coordinate.php`
- [Chat API](https://github.com/konnarak1234/tamdan-kon-general-api/blob/main/app/Http/Controllers/Api/ChatController.php): `app/Http/Controllers/Api/ChatController.php`

### Other components

- **Mobile clients**
- **IoT devices**
- **MySQL database**

## Connections

- Mobile clients → API routes: sends requests (evidence: `routes/api.php`)
- IoT devices → API routes: posts coordinates (evidence: `routes/api.php`)
- API routes → Bus API: dispatches bus (evidence: `routes/api.php`)
- API routes → Student API: dispatches student (evidence: `routes/api.php`)
- API routes → User API: dispatches users (evidence: `routes/api.php`)
- API routes → Authentication API: dispatches login (evidence: `routes/api.php`)
- API routes → Attendance API: dispatches attendance (evidence: `routes/api.php`)
- API routes → Coordinate API: dispatches coordinates (evidence: `routes/api.php`)
- API routes → Chat API: dispatches chat (evidence: `routes/api.php`)
- Bus API → Bus model: queries and updates (evidence: `app/Http/Controllers/Api/BusController.php`)
- Bus API → User model: looks up drivers (evidence: `app/Http/Controllers/Api/BusController.php`)
- Bus API → Bus location tables: reads and writes (evidence: `app/Http/Controllers/Api/BusController.php`)
- Bus API → MySQL database: creates chat tables (evidence: `app/Http/Controllers/Api/BusController.php`)
- Student API → Student model: queries and updates (evidence: `app/Http/Controllers/Api/StudentController.php`)
- Student API → Attendance model: checks attendance (evidence: `app/Http/Controllers/Api/StudentController.php`)
- Student API → Attendance requests: checks requests (evidence: `app/Http/Controllers/Api/StudentController.php`)
- Student API → Bus model: looks up buses (evidence: `app/Http/Controllers/Api/StudentController.php`)
- Student API → User model: looks up parents (evidence: `app/Http/Controllers/Api/StudentController.php`)
- User API → User model: creates and updates (evidence: `app/Http/Controllers/Api/UserController.php`)
- User API → Student model: creates and queries (evidence: `app/Http/Controllers/Api/UserController.php`)
- User API → Bus model: assigns drivers (evidence: `app/Http/Controllers/Api/UserController.php`)
- Authentication API → User model: authenticates users (evidence: `app/Http/Controllers/Api/AuthController.php`)
- Attendance API → Attendance model: reads and records (evidence: `app/Http/Controllers/Api/AttendanceController.php`)
- Attendance API → Attendance requests: reads and updates (evidence: `app/Http/Controllers/Api/AttendanceController.php`)
- Attendance API → Student model: resolves students (evidence: `app/Http/Controllers/Api/AttendanceController.php`)
- Attendance API → User model: resolves parents (evidence: `app/Http/Controllers/Api/AttendanceController.php`)
- Coordinate API → Coordinate model: stores and retrieves (evidence: `app/Http/Controllers/Api/CoordinateController.php`)
- Chat API → Bus model: uses bus records (evidence: `app/Http/Controllers/Api/ChatController.php`)
- Chat API → Student model: uses student records (evidence: `app/Http/Controllers/Api/ChatController.php`)
- Chat API → User model: uses user records (evidence: `app/Http/Controllers/Api/ChatController.php`)
- Coordinate API → MySQL database: persists coordinates
