# njsai/attendance-manager architecture

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

- Interactive diagram: https://gitdiagram.com/njsai/attendance-manager
- Repository: https://github.com/njsai/attendance-manager

## Overview

This is a multi-tenant attendance and HR SaaS: users sign in and work through role-specific dashboards for attendance, employee records, leave, payroll, and related company operations; super-admins manage subscriptions and platform security. The React application routes users to those experiences, while an Express API exposes the domain routes and uses PostgreSQL-backed session and application data. The README documents additional HR and administration capabilities. Some route modules and frontend pages were not sampled, so their internal behavior and specific API calls are not asserted.

Main entry points: [`artifacts/api-server/src/routes/index.ts`](https://github.com/njsai/attendance-manager/blob/master/artifacts/api-server/src/routes/index.ts) (Route registry), [`artifacts/attendance-system/src/App.tsx`](https://github.com/njsai/attendance-manager/blob/master/artifacts/attendance-system/src/App.tsx) (Role-based router), [`artifacts/api-server/src/app.ts`](https://github.com/njsai/attendance-manager/blob/master/artifacts/api-server/src/app.ts) (Express application), [`lib/db/src/schema/payroll.ts`](https://github.com/njsai/attendance-manager/blob/master/lib/db/src/schema/payroll.ts) (Payroll schema)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_app["Role-based router<br/>[App.tsx]"]
  node_login["Login<br/>[Login.tsx]"]
  node_employee_ui["Employee pages"]
  node_admin_ui["Admin pages"]
  node_super_ui["Super-admin pages"]
end

subgraph group_api["API and security"]
  node_api_app["Express application<br/>[app.ts]"]
  node_route_registry["Route registry<br/>[index.ts]"]
  node_auth_routes["Authentication routes<br/>[auth.ts]"]
  node_auth_core["Auth utilities<br/>[auth.ts]"]
  node_security_mw["Security middleware<br/>[security.ts]"]
  node_security_core["Security services<br/>[security.ts]"]
end

subgraph group_hr["Workforce operations"]
  node_attendance["Attendance<br/>[attendance.ts]"]
  node_employees["Employee management<br/>[employees.ts]"]
  node_payroll["Payroll<br/>[payroll.ts]"]
  node_hr_routes["Other HR routes"]
end

subgraph group_platform["Platform administration"]
  node_setup["Company setup<br/>[setup.ts]"]
  node_subscriptions["Subscriptions<br/>[subscriptions.ts]"]
  node_super_admin["Super-admin operations<br/>[super-admin.ts]"]
end

subgraph group_data["Persistent data"]
  node_companies_schema["Company schema<br/>[companies.ts]"]
  node_employees_schema["Employee schema<br/>[employees.ts]"]
  node_attendance_schema["Attendance schema<br/>[attendance.ts]"]
  node_payroll_schema["Payroll schema<br/>[payroll.ts]"]
  node_postgres[("PostgreSQL")]
end

node_user(("Staff and admins"))

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_employee_ui
node_app -->|"routes to"| node_admin_ui
node_app -->|"routes to"| node_super_ui
node_app -.->|"calls API"| node_api_app
node_api_app -->|"mounts routes"| node_route_registry
node_api_app -->|"applies"| node_security_mw
node_api_app -->|"migrates passwords"| node_security_core
node_route_registry -->|"registers"| node_auth_routes
node_route_registry -->|"registers"| node_attendance
node_route_registry -->|"registers"| node_employees
node_route_registry -->|"registers"| node_payroll
node_route_registry -->|"registers"| node_hr_routes
node_route_registry -->|"registers"| node_setup
node_route_registry -->|"registers"| node_subscriptions
node_route_registry -->|"registers"| node_super_admin
node_auth_routes -->|"uses"| node_auth_core
node_auth_routes -->|"uses"| node_security_core
node_security_mw -->|"uses"| node_security_core
node_attendance -->|"uses"| node_auth_core
node_payroll -->|"uses"| node_auth_core
node_payroll -.->|"reads and writes"| node_postgres
node_companies_schema -.->|"defines tables"| node_postgres
node_employees_schema -->|"references"| node_companies_schema
node_employees_schema -.->|"defines tables"| node_postgres
node_attendance_schema -.->|"defines tables"| node_postgres
node_payroll_schema -->|"references"| node_companies_schema
node_payroll_schema -->|"references"| node_employees_schema
node_payroll_schema -.->|"defines tables"| node_postgres

click node_app "https://github.com/njsai/attendance-manager/blob/master/artifacts/attendance-system/src/App.tsx"
click node_login "https://github.com/njsai/attendance-manager/blob/master/artifacts/attendance-system/src/pages/Login.tsx"
click node_employee_ui "https://github.com/njsai/attendance-manager/tree/master/artifacts/attendance-system/src/pages/employee"
click node_admin_ui "https://github.com/njsai/attendance-manager/tree/master/artifacts/attendance-system/src/pages/admin"
click node_super_ui "https://github.com/njsai/attendance-manager/tree/master/artifacts/attendance-system/src/pages/super-admin"
click node_api_app "https://github.com/njsai/attendance-manager/blob/master/artifacts/api-server/src/app.ts"
click node_route_registry "https://github.com/njsai/attendance-manager/blob/master/artifacts/api-server/src/routes/index.ts"
click node_auth_routes "https://github.com/njsai/attendance-manager/blob/master/artifacts/api-server/src/routes/auth.ts"
click node_auth_core "https://github.com/njsai/attendance-manager/blob/master/artifacts/api-server/src/lib/auth.ts"
click node_security_mw "https://github.com/njsai/attendance-manager/blob/master/artifacts/api-server/src/middleware/security.ts"
click node_security_core "https://github.com/njsai/attendance-manager/blob/master/artifacts/api-server/src/lib/security.ts"
click node_attendance "https://github.com/njsai/attendance-manager/blob/master/artifacts/api-server/src/routes/attendance.ts"
click node_employees "https://github.com/njsai/attendance-manager/blob/master/artifacts/api-server/src/routes/employees.ts"
click node_payroll "https://github.com/njsai/attendance-manager/blob/master/artifacts/api-server/src/routes/payroll.ts"
click node_hr_routes "https://github.com/njsai/attendance-manager/tree/master/artifacts/api-server/src/routes"
click node_setup "https://github.com/njsai/attendance-manager/blob/master/artifacts/api-server/src/routes/setup.ts"
click node_subscriptions "https://github.com/njsai/attendance-manager/blob/master/artifacts/api-server/src/routes/subscriptions.ts"
click node_super_admin "https://github.com/njsai/attendance-manager/blob/master/artifacts/api-server/src/routes/super-admin.ts"
click node_companies_schema "https://github.com/njsai/attendance-manager/blob/master/lib/db/src/schema/companies.ts"
click node_employees_schema "https://github.com/njsai/attendance-manager/blob/master/lib/db/src/schema/employees.ts"
click node_attendance_schema "https://github.com/njsai/attendance-manager/blob/master/lib/db/src/schema/attendance.ts"
click node_payroll_schema "https://github.com/njsai/attendance-manager/blob/master/lib/db/src/schema/payroll.ts"

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_login,node_employee_ui,node_admin_ui,node_super_ui toneBlue
class node_api_app,node_route_registry,node_auth_routes,node_auth_core,node_security_mw,node_security_core toneAmber
class node_attendance,node_employees,node_payroll,node_hr_routes toneMint
class node_setup,node_subscriptions,node_super_admin toneRose
class node_companies_schema,node_employees_schema,node_attendance_schema,node_payroll_schema,node_postgres,node_user toneIndigo
```

## Components

### Web application

- [Role-based router](https://github.com/njsai/attendance-manager/blob/master/artifacts/attendance-system/src/App.tsx): `artifacts/attendance-system/src/App.tsx`
- [Login](https://github.com/njsai/attendance-manager/blob/master/artifacts/attendance-system/src/pages/Login.tsx): `artifacts/attendance-system/src/pages/Login.tsx`
- [Employee pages](https://github.com/njsai/attendance-manager/tree/master/artifacts/attendance-system/src/pages/employee): `artifacts/attendance-system/src/pages/employee`
- [Admin pages](https://github.com/njsai/attendance-manager/tree/master/artifacts/attendance-system/src/pages/admin): `artifacts/attendance-system/src/pages/admin`
- [Super-admin pages](https://github.com/njsai/attendance-manager/tree/master/artifacts/attendance-system/src/pages/super-admin): `artifacts/attendance-system/src/pages/super-admin`

### API and security

- [Express application](https://github.com/njsai/attendance-manager/blob/master/artifacts/api-server/src/app.ts): `artifacts/api-server/src/app.ts`
- [Route registry](https://github.com/njsai/attendance-manager/blob/master/artifacts/api-server/src/routes/index.ts): `artifacts/api-server/src/routes/index.ts`
- [Authentication routes](https://github.com/njsai/attendance-manager/blob/master/artifacts/api-server/src/routes/auth.ts): `artifacts/api-server/src/routes/auth.ts`
- [Auth utilities](https://github.com/njsai/attendance-manager/blob/master/artifacts/api-server/src/lib/auth.ts): `artifacts/api-server/src/lib/auth.ts`
- [Security middleware](https://github.com/njsai/attendance-manager/blob/master/artifacts/api-server/src/middleware/security.ts): `artifacts/api-server/src/middleware/security.ts`
- [Security services](https://github.com/njsai/attendance-manager/blob/master/artifacts/api-server/src/lib/security.ts): `artifacts/api-server/src/lib/security.ts`

### Workforce operations

- [Attendance](https://github.com/njsai/attendance-manager/blob/master/artifacts/api-server/src/routes/attendance.ts): `artifacts/api-server/src/routes/attendance.ts`
- [Employee management](https://github.com/njsai/attendance-manager/blob/master/artifacts/api-server/src/routes/employees.ts): `artifacts/api-server/src/routes/employees.ts`
- [Payroll](https://github.com/njsai/attendance-manager/blob/master/artifacts/api-server/src/routes/payroll.ts): `artifacts/api-server/src/routes/payroll.ts`
- [Other HR routes](https://github.com/njsai/attendance-manager/tree/master/artifacts/api-server/src/routes): `artifacts/api-server/src/routes`

### Platform administration

- [Company setup](https://github.com/njsai/attendance-manager/blob/master/artifacts/api-server/src/routes/setup.ts): `artifacts/api-server/src/routes/setup.ts`
- [Subscriptions](https://github.com/njsai/attendance-manager/blob/master/artifacts/api-server/src/routes/subscriptions.ts): `artifacts/api-server/src/routes/subscriptions.ts`
- [Super-admin operations](https://github.com/njsai/attendance-manager/blob/master/artifacts/api-server/src/routes/super-admin.ts): `artifacts/api-server/src/routes/super-admin.ts`

### Persistent data

- [Company schema](https://github.com/njsai/attendance-manager/blob/master/lib/db/src/schema/companies.ts): `lib/db/src/schema/companies.ts`
- [Employee schema](https://github.com/njsai/attendance-manager/blob/master/lib/db/src/schema/employees.ts): `lib/db/src/schema/employees.ts`
- [Attendance schema](https://github.com/njsai/attendance-manager/blob/master/lib/db/src/schema/attendance.ts): `lib/db/src/schema/attendance.ts`
- [Payroll schema](https://github.com/njsai/attendance-manager/blob/master/lib/db/src/schema/payroll.ts): `lib/db/src/schema/payroll.ts`
- **PostgreSQL**

### Other components

- **Staff and admins**

## Connections

- Staff and admins → Role-based router: uses (evidence: `artifacts/attendance-system/src/App.tsx`)
- Role-based router → Login: routes to (evidence: `artifacts/attendance-system/src/App.tsx`)
- Role-based router → Employee pages: routes to (evidence: `artifacts/attendance-system/src/App.tsx`)
- Role-based router → Admin pages: routes to (evidence: `artifacts/attendance-system/src/App.tsx`)
- Role-based router → Super-admin pages: routes to (evidence: `artifacts/attendance-system/src/App.tsx`)
- Role-based router → Express application: calls API
- Express application → Route registry: mounts routes (evidence: `artifacts/api-server/src/app.ts`)
- Express application → Security middleware: applies (evidence: `artifacts/api-server/src/app.ts`)
- Express application → Security services: migrates passwords (evidence: `artifacts/api-server/src/app.ts`)
- Route registry → Authentication routes: registers (evidence: `artifacts/api-server/src/routes/index.ts`)
- Route registry → Attendance: registers (evidence: `artifacts/api-server/src/routes/index.ts`)
- Route registry → Employee management: registers (evidence: `artifacts/api-server/src/routes/index.ts`)
- Route registry → Payroll: registers (evidence: `artifacts/api-server/src/routes/index.ts`)
- Route registry → Other HR routes: registers (evidence: `artifacts/api-server/src/routes/index.ts`)
- Route registry → Company setup: registers (evidence: `artifacts/api-server/src/routes/index.ts`)
- Route registry → Subscriptions: registers (evidence: `artifacts/api-server/src/routes/index.ts`)
- Route registry → Super-admin operations: registers (evidence: `artifacts/api-server/src/routes/index.ts`)
- Authentication routes → Auth utilities: uses (evidence: `artifacts/api-server/src/routes/auth.ts`)
- Authentication routes → Security services: uses (evidence: `artifacts/api-server/src/routes/auth.ts`)
- Security middleware → Security services: uses (evidence: `artifacts/api-server/src/middleware/security.ts`)
- Attendance → Auth utilities: uses (evidence: `artifacts/api-server/src/routes/attendance.ts`)
- Payroll → Auth utilities: uses (evidence: `artifacts/api-server/src/routes/payroll.ts`)
- Payroll → PostgreSQL: reads and writes
- Company schema → PostgreSQL: defines tables
- Employee schema → Company schema: references (evidence: `lib/db/src/schema/employees.ts`)
- Employee schema → PostgreSQL: defines tables
- Attendance schema → PostgreSQL: defines tables
- Payroll schema → Company schema: references (evidence: `lib/db/src/schema/payroll.ts`)
- Payroll schema → Employee schema: references (evidence: `lib/db/src/schema/payroll.ts`)
- Payroll schema → PostgreSQL: defines tables
