# jmscljt/baylum1---classroom-attendance-management-system architecture

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

- Interactive diagram: https://gitdiagram.com/jmscljt/baylum1---classroom-attendance-management-system
- Repository: https://github.com/jmscljt/baylum1---classroom-attendance-management-system

## Overview

BayLum1 is a web-based classroom attendance and school-management system for teachers and administrators, with AS608 fingerprint attendance. The main teacher workflow runs through the PHP front controller: teachers manage students and attendance sessions, record attendance manually or by fingerprint, then review attendance logs; student absences and assignments for other sections are also managed. Administrators have account, section, teacher, student, log, and settings screens. The graph reflects documented routing and sampled calls; unsampled admin-screen internals and database operations are not expanded.

Main entry points: [`index.php`](https://github.com/jmscljt/baylum1---classroom-attendance-management-system/blob/main/index.php) (Page router), [`app/Controllers/Teachers/FingerprintAttendanceController.php`](https://github.com/jmscljt/baylum1---classroom-attendance-management-system/blob/main/app/Controllers/Teachers/FingerprintAttendanceController.php) (Fingerprint attendance), [`app/Models/Teachers/TeachersModel.php`](https://github.com/jmscljt/baylum1---classroom-attendance-management-system/blob/main/app/Models/Teachers/TeachersModel.php) (Teacher data model), [`app/Controllers/Teachers/AuthController.php`](https://github.com/jmscljt/baylum1---classroom-attendance-management-system/blob/main/app/Controllers/Teachers/AuthController.php) (Teacher authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Web entry"]
  node_router["Page router<br/>[index.php]"]
end

subgraph group_teacher["Teacher attendance"]
  node_teacher_auth["Teacher authentication<br/>[AuthController.php]"]
  node_teacher_base["Teacher controller base"]
  node_dashboard["Teacher dashboard"]
  node_attendance["Manual attendance"]
  node_fingerprint["Fingerprint attendance"]
  node_attendance_logs["Attendance logs"]
  node_attendance_settings["Attendance settings"]
  node_teacher_views["Teacher screens"]
end

subgraph group_school["School management"]
  node_students["Student roster"]
  node_other_sections["Other-section assignments"]
  node_assignment_model["Assignment model"]
  node_teacher_model["Teacher data model<br/>[TeachersModel.php]"]
end

subgraph group_admin["Administration"]
  node_admin_auth["Admin authentication"]
  node_admin_views["Admin screens"]
end

subgraph group_infra["Persistence"]
  node_db_config["Database connection<br/>[database.php]"]
  node_mysql[("MySQL database")]
end

node_teacher(("Teacher"))
node_admin_actor(("Administrator"))
node_browser(("Browser / AS608"))

node_teacher -->|"uses"| node_browser
node_admin_actor -->|"uses"| node_browser
node_browser -->|"requests pages"| node_router
node_router -->|"loads"| node_db_config
node_router -->|"dispatches"| node_teacher_auth
node_router -->|"dispatches"| node_dashboard
node_router -->|"dispatches"| node_attendance
node_router -->|"dispatches"| node_fingerprint
node_router -->|"dispatches"| node_attendance_logs
node_router -->|"dispatches"| node_attendance_settings
node_router -->|"dispatches"| node_students
node_router -->|"dispatches"| node_other_sections
node_router -->|"dispatches"| node_admin_auth
node_router -->|"renders"| node_teacher_views
node_router -->|"renders"| node_admin_views
node_teacher_auth -->|"extends"| node_teacher_base
node_teacher_base -->|"extends"| node_teacher_model
node_students -->|"queries"| node_teacher_model
node_fingerprint -->|"records enrollment"| node_teacher_model
node_other_sections -->|"queries"| node_assignment_model
node_browser -->|"sends scans"| node_fingerprint
node_db_config -->|"connects"| node_mysql

click node_router "https://github.com/jmscljt/baylum1---classroom-attendance-management-system/blob/main/index.php"
click node_teacher_auth "https://github.com/jmscljt/baylum1---classroom-attendance-management-system/blob/main/app/Controllers/Teachers/AuthController.php"
click node_teacher_base "https://github.com/jmscljt/baylum1---classroom-attendance-management-system/blob/main/app/Controllers/Teachers/TeachersController.php"
click node_dashboard "https://github.com/jmscljt/baylum1---classroom-attendance-management-system/blob/main/app/Controllers/Teachers/DashboardController.php"
click node_attendance "https://github.com/jmscljt/baylum1---classroom-attendance-management-system/blob/main/app/Controllers/Teachers/ManualAttendanceController.php"
click node_fingerprint "https://github.com/jmscljt/baylum1---classroom-attendance-management-system/blob/main/app/Controllers/Teachers/FingerprintAttendanceController.php"
click node_attendance_logs "https://github.com/jmscljt/baylum1---classroom-attendance-management-system/blob/main/app/Controllers/Teachers/AttendanceLogsController.php"
click node_attendance_settings "https://github.com/jmscljt/baylum1---classroom-attendance-management-system/blob/main/app/Controllers/Teachers/AttendanceSettingsController.php"
click node_students "https://github.com/jmscljt/baylum1---classroom-attendance-management-system/blob/main/app/Controllers/Teachers/StudentsController.php"
click node_other_sections "https://github.com/jmscljt/baylum1---classroom-attendance-management-system/blob/main/app/Controllers/Teachers/OtherSectionHandledController.php"
click node_assignment_model "https://github.com/jmscljt/baylum1---classroom-attendance-management-system/blob/main/app/Models/Teachers/OtherSectionHandledModel.php"
click node_teacher_model "https://github.com/jmscljt/baylum1---classroom-attendance-management-system/blob/main/app/Models/Teachers/TeachersModel.php"
click node_teacher_views "https://github.com/jmscljt/baylum1---classroom-attendance-management-system/tree/main/app/Views/Teachers"
click node_admin_auth "https://github.com/jmscljt/baylum1---classroom-attendance-management-system/blob/main/app/Controllers/Admin/AdminAuthController.php"
click node_admin_views "https://github.com/jmscljt/baylum1---classroom-attendance-management-system/tree/main/app/Views/Admin"
click node_db_config "https://github.com/jmscljt/baylum1---classroom-attendance-management-system/blob/main/config/database.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_router,node_browser toneBlue
class node_teacher_auth,node_teacher_base,node_dashboard,node_attendance,node_fingerprint,node_attendance_logs,node_attendance_settings,node_teacher_views toneAmber
class node_students,node_other_sections,node_assignment_model,node_teacher_model toneMint
class node_admin_auth,node_admin_views toneRose
class node_db_config,node_mysql,node_teacher,node_admin_actor toneIndigo
```

## Components

### Web entry

- [Page router](https://github.com/jmscljt/baylum1---classroom-attendance-management-system/blob/main/index.php): `index.php`

### Teacher attendance

- [Teacher authentication](https://github.com/jmscljt/baylum1---classroom-attendance-management-system/blob/main/app/Controllers/Teachers/AuthController.php): `app/Controllers/Teachers/AuthController.php`
- [Teacher controller base](https://github.com/jmscljt/baylum1---classroom-attendance-management-system/blob/main/app/Controllers/Teachers/TeachersController.php): `app/Controllers/Teachers/TeachersController.php`
- [Teacher dashboard](https://github.com/jmscljt/baylum1---classroom-attendance-management-system/blob/main/app/Controllers/Teachers/DashboardController.php): `app/Controllers/Teachers/DashboardController.php`
- [Manual attendance](https://github.com/jmscljt/baylum1---classroom-attendance-management-system/blob/main/app/Controllers/Teachers/ManualAttendanceController.php): `app/Controllers/Teachers/ManualAttendanceController.php`
- [Fingerprint attendance](https://github.com/jmscljt/baylum1---classroom-attendance-management-system/blob/main/app/Controllers/Teachers/FingerprintAttendanceController.php): `app/Controllers/Teachers/FingerprintAttendanceController.php`
- [Attendance logs](https://github.com/jmscljt/baylum1---classroom-attendance-management-system/blob/main/app/Controllers/Teachers/AttendanceLogsController.php): `app/Controllers/Teachers/AttendanceLogsController.php`
- [Attendance settings](https://github.com/jmscljt/baylum1---classroom-attendance-management-system/blob/main/app/Controllers/Teachers/AttendanceSettingsController.php): `app/Controllers/Teachers/AttendanceSettingsController.php`
- [Teacher screens](https://github.com/jmscljt/baylum1---classroom-attendance-management-system/tree/main/app/Views/Teachers): `app/Views/Teachers`

### School management

- [Student roster](https://github.com/jmscljt/baylum1---classroom-attendance-management-system/blob/main/app/Controllers/Teachers/StudentsController.php): `app/Controllers/Teachers/StudentsController.php`
- [Other-section assignments](https://github.com/jmscljt/baylum1---classroom-attendance-management-system/blob/main/app/Controllers/Teachers/OtherSectionHandledController.php): `app/Controllers/Teachers/OtherSectionHandledController.php`
- [Assignment model](https://github.com/jmscljt/baylum1---classroom-attendance-management-system/blob/main/app/Models/Teachers/OtherSectionHandledModel.php): `app/Models/Teachers/OtherSectionHandledModel.php`
- [Teacher data model](https://github.com/jmscljt/baylum1---classroom-attendance-management-system/blob/main/app/Models/Teachers/TeachersModel.php): `app/Models/Teachers/TeachersModel.php`

### Administration

- [Admin authentication](https://github.com/jmscljt/baylum1---classroom-attendance-management-system/blob/main/app/Controllers/Admin/AdminAuthController.php): `app/Controllers/Admin/AdminAuthController.php`
- [Admin screens](https://github.com/jmscljt/baylum1---classroom-attendance-management-system/tree/main/app/Views/Admin): `app/Views/Admin`

### Persistence

- [Database connection](https://github.com/jmscljt/baylum1---classroom-attendance-management-system/blob/main/config/database.php): `config/database.php`
- **MySQL database**

### Other components

- **Teacher**
- **Administrator**
- **Browser / AS608**

## Connections

- Teacher → Browser / AS608: uses (evidence: `README.md`)
- Administrator → Browser / AS608: uses (evidence: `README.md`)
- Browser / AS608 → Page router: requests pages (evidence: `index.php`)
- Page router → Database connection: loads (evidence: `index.php`)
- Page router → Teacher authentication: dispatches (evidence: `index.php`)
- Page router → Teacher dashboard: dispatches (evidence: `index.php`)
- Page router → Manual attendance: dispatches (evidence: `index.php`)
- Page router → Fingerprint attendance: dispatches (evidence: `index.php`)
- Page router → Attendance logs: dispatches (evidence: `index.php`)
- Page router → Attendance settings: dispatches (evidence: `index.php`)
- Page router → Student roster: dispatches (evidence: `index.php`)
- Page router → Other-section assignments: dispatches (evidence: `index.php`)
- Page router → Admin authentication: dispatches (evidence: `index.php`)
- Page router → Teacher screens: renders (evidence: `index.php`)
- Page router → Admin screens: renders (evidence: `index.php`)
- Teacher authentication → Teacher controller base: extends (evidence: `app/Controllers/Teachers/AuthController.php`)
- Teacher controller base → Teacher data model: extends (evidence: `app/Controllers/Teachers/TeachersController.php`)
- Student roster → Teacher data model: queries (evidence: `app/Controllers/Teachers/StudentsController.php`)
- Fingerprint attendance → Teacher data model: records enrollment (evidence: `app/Controllers/Teachers/FingerprintAttendanceController.php`)
- Other-section assignments → Assignment model: queries (evidence: `app/Controllers/Teachers/OtherSectionHandledController.php`)
- Browser / AS608 → Fingerprint attendance: sends scans (evidence: `README.md`)
- Database connection → MySQL database: connects (evidence: `config/database.php`)
