# handikasinaga/project-ta-logbook-presensi architecture

> Architecture diagram of the GitHub repository handikasinaga/project-ta-logbook-presensi, 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/handikasinaga/project-ta-logbook-presensi
- Repository: https://github.com/handikasinaga/project-ta-logbook-presensi

## Overview

This is a role-based attendance, leave, and work-logbook management application. Users submit attendance, activity logs, and leave requests; supervisors review team activity and requests, while administrators manage users and divisions and monitor operations. The React application exposes role-specific screens backed by an Express API, whose controllers use Sequelize models for persistent data. Reporting and bulk user import/export are distinct administrative capabilities. The shown source establishes route dispatch and several controller dependencies; frontend-to-API calls and real-time notification implementation were not shown, so those links are omitted.

Main entry points: [`backend/routes/adminRoutes.js`](https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/backend/routes/adminRoutes.js) (Admin routes), [`backend/routes/userRoutes.js`](https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/backend/routes/userRoutes.js) (User routes), [`backend/models/index.js`](https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/backend/models/index.js) (Domain models), [`backend/routes/supervisorRoutes.js`](https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/backend/routes/supervisorRoutes.js) (Supervisor routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Role-based frontend"]
  node_app["React app<br/>[App.jsx]"]
  node_public["Public access<br/>[PublicRoutes.jsx]"]
  node_userui["User workspace"]
  node_supervisorui["Supervisor workspace"]
  node_adminui["Admin workspace"]
end

subgraph group_api["API and workflows"]
  node_authroutes["Authentication routes<br/>[authRoutes.js]"]
  node_useroutes["User routes<br/>[userRoutes.js]"]
  node_superroutes["Supervisor routes"]
  node_adminroutes["Admin routes<br/>[adminRoutes.js]"]
  node_auth["Authentication<br/>[AuthController.js]"]
  node_attendance["Attendance workflow"]
  node_logbook["Logbook review"]
  node_leave["Leave workflow<br/>[LeaveController.js]"]
  node_usersdivisions["Users and divisions<br/>[UserController.js]"]
  node_dashboard["Dashboards"]
  node_reports["Reports and exports"]
  node_settings["System settings"]
end

subgraph group_data["Domain data"]
  node_models["Domain models<br/>[index.js]"]
  node_mysql[("MySQL database")]
end

subgraph group_support["Operational support"]
  node_export["Excel export<br/>[ExportService.js]"]
  node_bulkusers["Bulk user transfer"]
  node_location["Location validation<br/>[locationHelper.js]"]
  node_uploads["File uploads<br/>[uploadHelper.js]"]
  node_scheduler["Auto checkout"]
end

node_person(("Staff and administrators"))

node_app -->|"mounts routes"| node_public
node_app -->|"mounts routes"| node_userui
node_app -->|"mounts routes"| node_supervisorui
node_app -->|"mounts routes"| node_adminui
node_userui -.->|"calls API"| node_useroutes
node_supervisorui -.->|"calls API"| node_superroutes
node_adminui -.->|"calls API"| node_adminroutes
node_person -->|"uses"| node_app
node_authroutes -->|"dispatches"| node_auth
node_useroutes -->|"dispatches"| node_attendance
node_useroutes -->|"dispatches"| node_logbook
node_useroutes -->|"dispatches"| node_leave
node_useroutes -->|"dispatches"| node_usersdivisions
node_useroutes -->|"dispatches"| node_dashboard
node_useroutes -->|"dispatches"| node_settings
node_superroutes -->|"dispatches"| node_attendance
node_superroutes -->|"dispatches"| node_logbook
node_superroutes -->|"dispatches"| node_leave
node_superroutes -->|"dispatches"| node_usersdivisions
node_superroutes -->|"dispatches"| node_dashboard
node_adminroutes -->|"dispatches"| node_attendance
node_adminroutes -->|"dispatches"| node_logbook
node_adminroutes -->|"dispatches"| node_leave
node_adminroutes -->|"dispatches"| node_usersdivisions
node_adminroutes -->|"dispatches"| node_dashboard
node_adminroutes -->|"dispatches"| node_reports
node_adminroutes -->|"dispatches"| node_settings
node_attendance -->|"queries"| node_models
node_logbook -->|"queries"| node_models
node_leave -->|"queries"| node_models
node_reports -->|"queries"| node_models
node_reports -->|"generates workbook"| node_export
node_usersdivisions -->|"queries"| node_models
node_usersdivisions -->|"delegates transfer"| node_bulkusers
node_attendance -->|"validates location"| node_location
node_attendance -->|"stores photos"| node_uploads
node_leave -->|"stores attachments"| node_uploads
node_models -->|"persists data"| node_mysql
node_scheduler -->|"updates attendance"| node_models

click node_app "https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/frontend/src/App.jsx"
click node_public "https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/frontend/src/roles/public/PublicRoutes.jsx"
click node_userui "https://github.com/handikasinaga/project-ta-logbook-presensi/tree/main/frontend/src/roles/user"
click node_supervisorui "https://github.com/handikasinaga/project-ta-logbook-presensi/tree/main/frontend/src/roles/supervisor"
click node_adminui "https://github.com/handikasinaga/project-ta-logbook-presensi/tree/main/frontend/src/roles/admin"
click node_authroutes "https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/backend/routes/authRoutes.js"
click node_useroutes "https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/backend/routes/userRoutes.js"
click node_superroutes "https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/backend/routes/supervisorRoutes.js"
click node_adminroutes "https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/backend/routes/adminRoutes.js"
click node_auth "https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/backend/controllers/AuthController.js"
click node_attendance "https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/backend/controllers/AttendanceController.js"
click node_logbook "https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/backend/controllers/LogbookController.js"
click node_leave "https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/backend/controllers/LeaveController.js"
click node_usersdivisions "https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/backend/controllers/UserController.js"
click node_dashboard "https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/backend/controllers/DashboardController.js"
click node_reports "https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/backend/controllers/ReportController.js"
click node_settings "https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/backend/controllers/SettingsController.js"
click node_models "https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/backend/models/index.js"
click node_export "https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/backend/services/ExportService.js"
click node_bulkusers "https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/backend/services/ImportExportUserService.js"
click node_location "https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/backend/utils/locationHelper.js"
click node_uploads "https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/backend/utils/uploadHelper.js"
click node_scheduler "https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/backend/utils/autoCheckoutScheduler.js"

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_app,node_public,node_userui,node_supervisorui,node_adminui toneBlue
class node_authroutes,node_useroutes,node_superroutes,node_adminroutes,node_auth,node_attendance,node_logbook,node_leave,node_usersdivisions,node_dashboard,node_reports,node_settings toneAmber
class node_models,node_mysql toneMint
class node_export,node_bulkusers,node_location,node_uploads,node_scheduler toneRose
class node_person toneIndigo
```

## Components

### Role-based frontend

- [React app](https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Public access](https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/frontend/src/roles/public/PublicRoutes.jsx): `frontend/src/roles/public/PublicRoutes.jsx`
- [User workspace](https://github.com/handikasinaga/project-ta-logbook-presensi/tree/main/frontend/src/roles/user): `frontend/src/roles/user`
- [Supervisor workspace](https://github.com/handikasinaga/project-ta-logbook-presensi/tree/main/frontend/src/roles/supervisor): `frontend/src/roles/supervisor`
- [Admin workspace](https://github.com/handikasinaga/project-ta-logbook-presensi/tree/main/frontend/src/roles/admin): `frontend/src/roles/admin`

### API and workflows

- [Authentication routes](https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/backend/routes/authRoutes.js): `backend/routes/authRoutes.js`
- [User routes](https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/backend/routes/userRoutes.js): `backend/routes/userRoutes.js`
- [Supervisor routes](https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/backend/routes/supervisorRoutes.js): `backend/routes/supervisorRoutes.js`
- [Admin routes](https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/backend/routes/adminRoutes.js): `backend/routes/adminRoutes.js`
- [Authentication](https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/backend/controllers/AuthController.js): `backend/controllers/AuthController.js`
- [Attendance workflow](https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/backend/controllers/AttendanceController.js): `backend/controllers/AttendanceController.js`
- [Logbook review](https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/backend/controllers/LogbookController.js): `backend/controllers/LogbookController.js`
- [Leave workflow](https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/backend/controllers/LeaveController.js): `backend/controllers/LeaveController.js`
- [Users and divisions](https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/backend/controllers/UserController.js): `backend/controllers/UserController.js`
- [Dashboards](https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/backend/controllers/DashboardController.js): `backend/controllers/DashboardController.js`
- [Reports and exports](https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/backend/controllers/ReportController.js): `backend/controllers/ReportController.js`
- [System settings](https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/backend/controllers/SettingsController.js): `backend/controllers/SettingsController.js`

### Domain data

- [Domain models](https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/backend/models/index.js): `backend/models/index.js`
- **MySQL database**

### Operational support

- [Excel export](https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/backend/services/ExportService.js): `backend/services/ExportService.js`
- [Bulk user transfer](https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/backend/services/ImportExportUserService.js): `backend/services/ImportExportUserService.js`
- [Location validation](https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/backend/utils/locationHelper.js): `backend/utils/locationHelper.js`
- [File uploads](https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/backend/utils/uploadHelper.js): `backend/utils/uploadHelper.js`
- [Auto checkout](https://github.com/handikasinaga/project-ta-logbook-presensi/blob/main/backend/utils/autoCheckoutScheduler.js): `backend/utils/autoCheckoutScheduler.js`

### Other components

- **Staff and administrators**

## Connections

- React app → Public access: mounts routes (evidence: `frontend/src/App.jsx`)
- React app → User workspace: mounts routes (evidence: `frontend/src/App.jsx`)
- React app → Supervisor workspace: mounts routes (evidence: `frontend/src/App.jsx`)
- React app → Admin workspace: mounts routes (evidence: `frontend/src/App.jsx`)
- User workspace → User routes: calls API
- Supervisor workspace → Supervisor routes: calls API
- Admin workspace → Admin routes: calls API
- Staff and administrators → React app: uses
- Authentication routes → Authentication: dispatches (evidence: `backend/routes/authRoutes.js`)
- User routes → Attendance workflow: dispatches (evidence: `backend/routes/userRoutes.js`)
- User routes → Logbook review: dispatches (evidence: `backend/routes/userRoutes.js`)
- User routes → Leave workflow: dispatches (evidence: `backend/routes/userRoutes.js`)
- User routes → Users and divisions: dispatches (evidence: `backend/routes/userRoutes.js`)
- User routes → Dashboards: dispatches (evidence: `backend/routes/userRoutes.js`)
- User routes → System settings: dispatches (evidence: `backend/routes/userRoutes.js`)
- Supervisor routes → Attendance workflow: dispatches (evidence: `backend/routes/supervisorRoutes.js`)
- Supervisor routes → Logbook review: dispatches (evidence: `backend/routes/supervisorRoutes.js`)
- Supervisor routes → Leave workflow: dispatches (evidence: `backend/routes/supervisorRoutes.js`)
- Supervisor routes → Users and divisions: dispatches (evidence: `backend/routes/supervisorRoutes.js`)
- Supervisor routes → Dashboards: dispatches (evidence: `backend/routes/supervisorRoutes.js`)
- Admin routes → Attendance workflow: dispatches (evidence: `backend/routes/adminRoutes.js`)
- Admin routes → Logbook review: dispatches (evidence: `backend/routes/adminRoutes.js`)
- Admin routes → Leave workflow: dispatches (evidence: `backend/routes/adminRoutes.js`)
- Admin routes → Users and divisions: dispatches (evidence: `backend/routes/adminRoutes.js`)
- Admin routes → Dashboards: dispatches (evidence: `backend/routes/adminRoutes.js`)
- Admin routes → Reports and exports: dispatches (evidence: `backend/routes/adminRoutes.js`)
- Admin routes → System settings: dispatches (evidence: `backend/routes/adminRoutes.js`)
- Attendance workflow → Domain models: queries (evidence: `backend/controllers/AttendanceController.js`)
- Logbook review → Domain models: queries (evidence: `backend/controllers/LogbookController.js`)
- Leave workflow → Domain models: queries (evidence: `backend/controllers/LeaveController.js`)
- Reports and exports → Domain models: queries (evidence: `backend/controllers/ReportController.js`)
- Reports and exports → Excel export: generates workbook (evidence: `backend/controllers/ReportController.js`)
- Users and divisions → Domain models: queries (evidence: `backend/controllers/UserController.js`)
- Users and divisions → Bulk user transfer: delegates transfer (evidence: `backend/controllers/UserController.js`)
- Attendance workflow → Location validation: validates location (evidence: `backend/controllers/AttendanceController.js`)
- Attendance workflow → File uploads: stores photos (evidence: `backend/controllers/AttendanceController.js`)
- Leave workflow → File uploads: stores attachments (evidence: `backend/controllers/LeaveController.js`)
- Domain models → MySQL database: persists data (evidence: `backend/models/index.js`)
- Auto checkout → Domain models: updates attendance (evidence: `backend/utils/autoCheckoutScheduler.js`)
