# datcc004/ltm architecture

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

- Interactive diagram: https://gitdiagram.com/datcc004/ltm
- Repository: https://github.com/datcc004/ltm

## Overview

KIDS PARK combines a Streamlit attendance-and-shift application with a separate Node.js HRMS. The documented main workflow serves managers managing staff, weekly shifts and attendance exports, and employees registering/checking in by camera and viewing schedules or attendance history. The HRMS adds web-based personnel, leave, overtime, payroll, reporting and self-service domains. Python internals were not sampled, so its documented capabilities are represented without speculative calls; HRMS links use only visible imports or app wiring.

Main entry points: [`app_streamlit.py`](https://github.com/datcc004/ltm/blob/dev/app_streamlit.py) (Attendance interface), [`hrms/config/db.js`](https://github.com/datcc004/ltm/blob/dev/hrms/config/db.js) (HRMS database), [`hrms/controllers/employee.controller.js`](https://github.com/datcc004/ltm/blob/dev/hrms/controllers/employee.controller.js) (Employee records), [`hrms/controllers/leave.controller.js`](https://github.com/datcc004/ltm/blob/dev/hrms/controllers/leave.controller.js) (Leave requests)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_attendance["Attendance app"]
  node_streamlit["Attendance interface<br/>[app_streamlit.py]"]
  node_face["Face check-in<br/>[app_streamlit.py]"]
  node_weekly["Weekly shifts<br/>[app_streamlit.py]"]
  node_attendancehistory["Attendance history<br/>[app_streamlit.py]"]
  node_excel["Excel timesheets<br/>[app_streamlit.py]"]
  node_pydb[("Attendance database<br/>[database.py]")]
end

subgraph group_hrmsweb["HRMS web"]
  node_hrmsapp["HRMS web app<br/>[app.js]"]
  node_routes["HRMS routes"]
end

subgraph group_peopleops["People operations"]
  node_employeeops["Employee records"]
  node_contracts["Contracts"]
  node_attendanceops["Attendance management"]
  node_leaveops["Leave requests"]
  node_leaveservice["Leave rules<br/>[leave.service.js]"]
  node_overtimeops["Overtime requests"]
  node_shiftschedules["Shifts and schedules"]
  node_selfservice["Employee self-service"]
end

subgraph group_payrollinsights["Payroll and insights"]
  node_payrollops["Payroll management"]
  node_payrollservice["Payroll rules<br/>[payroll.service.js]"]
  node_payrollgeneration["Payroll generation"]
  node_reports["Reports and exports"]
end

subgraph group_platform["Shared platform"]
  node_employeesmodel["Employee data access<br/>[employee.model.js]"]
  node_leavemodel["Leave data access"]
  node_attendance_model["Attendance data access"]
  node_contractmodel["Contract data access<br/>[contract.model.js]"]
  node_hrmsdb[("HRMS database<br/>[db.js]")]
  node_audit["Audit logging<br/>[audit.js]"]
  node_rbac["Role permissions<br/>[role.js]"]
  node_validation["Request validation<br/>[validate.js]"]
  node_config["Environment config<br/>[env.js]"]
end

node_manager(("Manager"))
node_employee(("Employee"))

node_manager -->|"manages staff"| node_streamlit
node_employee -->|"uses attendance"| node_streamlit
node_streamlit -->|"offers check-in"| node_face
node_streamlit -->|"manages shifts"| node_weekly
node_streamlit -->|"shows history"| node_attendancehistory
node_streamlit -->|"exports timesheets"| node_excel
node_streamlit -.->|"uses database"| node_pydb
node_hrmsapp -->|"mounts routes"| node_routes
node_employeeops -->|"reads and updates"| node_employeesmodel
node_employeeops -->|"loads contracts"| node_contracts
node_contracts -->|"accesses contracts"| node_contractmodel
node_attendanceops -->|"accesses records"| node_attendance_model
node_leaveops -->|"manages requests"| node_leavemodel
node_leaveops -->|"checks leave rules"| node_leaveservice
node_overtimeops -->|"uses leave rules"| node_leaveservice
node_payrollops -->|"uses payroll rules"| node_payrollservice
node_payrollops -->|"generates payroll"| node_payrollgeneration
node_employeesmodel -->|"queries database"| node_hrmsdb
node_leavemodel -->|"queries database"| node_hrmsdb
node_attendance_model -->|"queries database"| node_hrmsdb
node_contractmodel -->|"queries database"| node_hrmsdb
node_audit -->|"writes audit logs"| node_hrmsdb
node_hrmsdb -->|"gets settings"| node_config
node_leaveops -->|"records changes"| node_audit
node_employeeops -->|"records changes"| node_audit

click node_streamlit "https://github.com/datcc004/ltm/blob/dev/app_streamlit.py"
click node_face "https://github.com/datcc004/ltm/blob/dev/app_streamlit.py"
click node_weekly "https://github.com/datcc004/ltm/blob/dev/app_streamlit.py"
click node_attendancehistory "https://github.com/datcc004/ltm/blob/dev/app_streamlit.py"
click node_excel "https://github.com/datcc004/ltm/blob/dev/app_streamlit.py"
click node_pydb "https://github.com/datcc004/ltm/blob/dev/database.py"
click node_hrmsapp "https://github.com/datcc004/ltm/blob/dev/hrms/app.js"
click node_routes "https://github.com/datcc004/ltm/tree/dev/hrms/routes"
click node_employeeops "https://github.com/datcc004/ltm/blob/dev/hrms/controllers/employee.controller.js"
click node_contracts "https://github.com/datcc004/ltm/blob/dev/hrms/controllers/contract.controller.js"
click node_attendanceops "https://github.com/datcc004/ltm/blob/dev/hrms/controllers/attendance.controller.js"
click node_leaveops "https://github.com/datcc004/ltm/blob/dev/hrms/controllers/leave.controller.js"
click node_leaveservice "https://github.com/datcc004/ltm/blob/dev/hrms/services/leave.service.js"
click node_overtimeops "https://github.com/datcc004/ltm/blob/dev/hrms/controllers/overtime.controller.js"
click node_shiftschedules "https://github.com/datcc004/ltm/tree/dev/hrms/controllers"
click node_selfservice "https://github.com/datcc004/ltm/blob/dev/hrms/services/selfService.service.js"
click node_payrollops "https://github.com/datcc004/ltm/blob/dev/hrms/controllers/payroll.controller.js"
click node_payrollservice "https://github.com/datcc004/ltm/blob/dev/hrms/services/payroll.service.js"
click node_payrollgeneration "https://github.com/datcc004/ltm/blob/dev/hrms/services/payrollGeneration.service.js"
click node_reports "https://github.com/datcc004/ltm/tree/dev/hrms/services"
click node_employeesmodel "https://github.com/datcc004/ltm/blob/dev/hrms/models/employee.model.js"
click node_leavemodel "https://github.com/datcc004/ltm/blob/dev/hrms/models/leaveRequest.model.js"
click node_attendance_model "https://github.com/datcc004/ltm/blob/dev/hrms/models/attendance.model.js"
click node_contractmodel "https://github.com/datcc004/ltm/blob/dev/hrms/models/contract.model.js"
click node_hrmsdb "https://github.com/datcc004/ltm/blob/dev/hrms/config/db.js"
click node_audit "https://github.com/datcc004/ltm/blob/dev/hrms/middlewares/audit.js"
click node_rbac "https://github.com/datcc004/ltm/blob/dev/hrms/middlewares/role.js"
click node_validation "https://github.com/datcc004/ltm/blob/dev/hrms/middlewares/validate.js"
click node_config "https://github.com/datcc004/ltm/blob/dev/hrms/config/env.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_streamlit,node_face,node_weekly,node_attendancehistory,node_excel,node_pydb toneBlue
class node_hrmsapp,node_routes toneAmber
class node_employeeops,node_contracts,node_attendanceops,node_leaveops,node_leaveservice,node_overtimeops,node_shiftschedules,node_selfservice toneMint
class node_payrollops,node_payrollservice,node_payrollgeneration,node_reports toneRose
class node_employeesmodel,node_leavemodel,node_attendance_model,node_contractmodel,node_hrmsdb,node_audit,node_rbac,node_validation,node_config,node_manager,node_employee toneIndigo
```

## Components

### Attendance app

- [Attendance interface](https://github.com/datcc004/ltm/blob/dev/app_streamlit.py): `app_streamlit.py`
- [Face check-in](https://github.com/datcc004/ltm/blob/dev/app_streamlit.py): `app_streamlit.py`
- [Weekly shifts](https://github.com/datcc004/ltm/blob/dev/app_streamlit.py): `app_streamlit.py`
- [Attendance history](https://github.com/datcc004/ltm/blob/dev/app_streamlit.py): `app_streamlit.py`
- [Excel timesheets](https://github.com/datcc004/ltm/blob/dev/app_streamlit.py): `app_streamlit.py`
- [Attendance database](https://github.com/datcc004/ltm/blob/dev/database.py): `database.py`

### HRMS web

- [HRMS web app](https://github.com/datcc004/ltm/blob/dev/hrms/app.js): `hrms/app.js`
- [HRMS routes](https://github.com/datcc004/ltm/tree/dev/hrms/routes): `hrms/routes`

### People operations

- [Employee records](https://github.com/datcc004/ltm/blob/dev/hrms/controllers/employee.controller.js): `hrms/controllers/employee.controller.js`
- [Contracts](https://github.com/datcc004/ltm/blob/dev/hrms/controllers/contract.controller.js): `hrms/controllers/contract.controller.js`
- [Attendance management](https://github.com/datcc004/ltm/blob/dev/hrms/controllers/attendance.controller.js): `hrms/controllers/attendance.controller.js`
- [Leave requests](https://github.com/datcc004/ltm/blob/dev/hrms/controllers/leave.controller.js): `hrms/controllers/leave.controller.js`
- [Leave rules](https://github.com/datcc004/ltm/blob/dev/hrms/services/leave.service.js): `hrms/services/leave.service.js`
- [Overtime requests](https://github.com/datcc004/ltm/blob/dev/hrms/controllers/overtime.controller.js): `hrms/controllers/overtime.controller.js`
- [Shifts and schedules](https://github.com/datcc004/ltm/tree/dev/hrms/controllers): `hrms/controllers`
- [Employee self-service](https://github.com/datcc004/ltm/blob/dev/hrms/services/selfService.service.js): `hrms/services/selfService.service.js`

### Payroll and insights

- [Payroll management](https://github.com/datcc004/ltm/blob/dev/hrms/controllers/payroll.controller.js): `hrms/controllers/payroll.controller.js`
- [Payroll rules](https://github.com/datcc004/ltm/blob/dev/hrms/services/payroll.service.js): `hrms/services/payroll.service.js`
- [Payroll generation](https://github.com/datcc004/ltm/blob/dev/hrms/services/payrollGeneration.service.js): `hrms/services/payrollGeneration.service.js`
- [Reports and exports](https://github.com/datcc004/ltm/tree/dev/hrms/services): `hrms/services`

### Shared platform

- [Employee data access](https://github.com/datcc004/ltm/blob/dev/hrms/models/employee.model.js): `hrms/models/employee.model.js`
- [Leave data access](https://github.com/datcc004/ltm/blob/dev/hrms/models/leaveRequest.model.js): `hrms/models/leaveRequest.model.js`
- [Attendance data access](https://github.com/datcc004/ltm/blob/dev/hrms/models/attendance.model.js): `hrms/models/attendance.model.js`
- [Contract data access](https://github.com/datcc004/ltm/blob/dev/hrms/models/contract.model.js): `hrms/models/contract.model.js`
- [HRMS database](https://github.com/datcc004/ltm/blob/dev/hrms/config/db.js): `hrms/config/db.js`
- [Audit logging](https://github.com/datcc004/ltm/blob/dev/hrms/middlewares/audit.js): `hrms/middlewares/audit.js`
- [Role permissions](https://github.com/datcc004/ltm/blob/dev/hrms/middlewares/role.js): `hrms/middlewares/role.js`
- [Request validation](https://github.com/datcc004/ltm/blob/dev/hrms/middlewares/validate.js): `hrms/middlewares/validate.js`
- [Environment config](https://github.com/datcc004/ltm/blob/dev/hrms/config/env.js): `hrms/config/env.js`

### Other components

- **Manager**
- **Employee**

## Connections

- Manager → Attendance interface: manages staff (evidence: `README.md`)
- Employee → Attendance interface: uses attendance (evidence: `README.md`)
- Attendance interface → Face check-in: offers check-in (evidence: `README.md`)
- Attendance interface → Weekly shifts: manages shifts (evidence: `README.md`)
- Attendance interface → Attendance history: shows history (evidence: `README.md`)
- Attendance interface → Excel timesheets: exports timesheets (evidence: `README.md`)
- Attendance interface → Attendance database: uses database (evidence: `README.md`)
- HRMS web app → HRMS routes: mounts routes (evidence: `hrms/app.js`)
- Employee records → Employee data access: reads and updates (evidence: `hrms/controllers/employee.controller.js`)
- Employee records → Contracts: loads contracts (evidence: `hrms/controllers/employee.controller.js`)
- Contracts → Contract data access: accesses contracts (evidence: `hrms/controllers/contract.controller.js`)
- Attendance management → Attendance data access: accesses records (evidence: `hrms/controllers/attendance.controller.js`)
- Leave requests → Leave data access: manages requests (evidence: `hrms/controllers/leave.controller.js`)
- Leave requests → Leave rules: checks leave rules (evidence: `hrms/controllers/leave.controller.js`)
- Overtime requests → Leave rules: uses leave rules (evidence: `hrms/controllers/overtime.controller.js`)
- Payroll management → Payroll rules: uses payroll rules (evidence: `hrms/controllers/payroll.controller.js`)
- Payroll management → Payroll generation: generates payroll (evidence: `hrms/controllers/payroll.controller.js`)
- Employee data access → HRMS database: queries database (evidence: `hrms/models/employee.model.js`)
- Leave data access → HRMS database: queries database (evidence: `hrms/models/leaveRequest.model.js`)
- Attendance data access → HRMS database: queries database (evidence: `hrms/models/attendance.model.js`)
- Contract data access → HRMS database: queries database (evidence: `hrms/models/contract.model.js`)
- Audit logging → HRMS database: writes audit logs (evidence: `hrms/middlewares/audit.js`)
- HRMS database → Environment config: gets settings (evidence: `hrms/config/db.js`)
- Leave requests → Audit logging: records changes (evidence: `hrms/controllers/leave.controller.js`)
- Employee records → Audit logging: records changes (evidence: `hrms/controllers/employee.controller.js`)
