# pranjal1-1/eers architecture

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

- Interactive diagram: https://gitdiagram.com/pranjal1-1/eers
- Repository: https://github.com/pranjal1-1/eers

## Overview

EERS is an employee performance and recognition web application. Employees and managers use the web app to view workforce and attendance information, submit reviews and KPI results, and administer attendance; managers then finalize performance and manage awards and rewards. The repository also includes employee, department, access-control, audit, and management-dashboard capabilities. The sampled routes show direct PostgreSQL access, while scoring modules provide an internal calculation layer. Several listed capabilities have no sampled implementation, so their wiring is not inferred.

Main entry points: [`apps/web/src/lib/api-auth.ts`](https://github.com/pranjal1-1/eers/blob/main/apps/web/src/lib/api-auth.ts) (Request identity), [`apps/web/src/lib/authorization.ts`](https://github.com/pranjal1-1/eers/blob/main/apps/web/src/lib/authorization.ts) (Role rules), [`apps/web/src/app/api/attendance/route.ts`](https://github.com/pranjal1-1/eers/blob/main/apps/web/src/app/api/attendance/route.ts) (Attendance endpoints), [`apps/web/src/app/api/attendance/import/route.ts`](https://github.com/pranjal1-1/eers/blob/main/apps/web/src/app/api/attendance/import/route.ts) (CSV attendance import)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and workforce"]
  node_employee["Employee workspace<br/>[page.tsx]"]
  node_login["Login<br/>[page.tsx]"]
  node_employee_api["Employee endpoints<br/>[route.ts]"]
  node_auth["Request identity<br/>[api-auth.ts]"]
  node_authorization["Role rules<br/>[authorization.ts]"]
end

subgraph group_attendance["Attendance management"]
  node_attendance_ui["Attendance workspace<br/>[page.tsx]"]
  node_attendance_import_ui["Attendance import UI"]
  node_attendance_api["Attendance endpoints<br/>[route.ts]"]
  node_attendance_import["CSV attendance import<br/>[route.ts]"]
end

subgraph group_performance["Performance measurement"]
  node_attendance_score["Attendance scoring"]
  node_kpi_api["KPI endpoints<br/>[route.ts]"]
  node_kpi_assignments["KPI assignments<br/>[route.ts]"]
  node_kpi_results["KPI results<br/>[route.ts]"]
  node_kpi_scoring["KPI scoring<br/>[kpi.ts]"]
  node_performance_engine["Performance snapshot"]
  node_performance_cycle["Cycle configuration"]
  node_monthly_performance["Monthly performance"]
  node_monthly_calculator["Monthly calculator"]
  node_monthly_finalize["Cycle finalization<br/>[route.ts]"]
  node_reviews["Management reviews<br/>[route.ts]"]
  node_scoring["Weighted scoring<br/>[scoring.ts]"]
end

subgraph group_recognition["Recognition and oversight"]
  node_management_dashboard["Management dashboard<br/>[route.ts]"]
  node_awards["Monthly awards<br/>[route.ts]"]
  node_rewards["Certificate rewards<br/>[route.ts]"]
  node_rewards_service["Reward services<br/>[rewards-server.ts]"]
end

node_postgres[("PostgreSQL")]
node_user(("Employee or manager"))

node_user -->|"uploads CSV"| node_attendance_import_ui
node_attendance_import -->|"checks identity"| node_auth
node_attendance_import -->|"checks role"| node_authorization
node_attendance_import -->|"writes records"| node_postgres
node_attendance_api -->|"requires user"| node_auth
node_attendance_api -->|"checks role"| node_authorization
node_attendance_api -->|"reads and writes"| node_postgres
node_kpi_api -->|"checks role"| node_auth
node_kpi_api -->|"checks role"| node_authorization
node_kpi_api -->|"reads and writes"| node_postgres
node_kpi_assignments -->|"reads and writes"| node_postgres
node_kpi_results -->|"reads and writes"| node_postgres
node_performance_engine -->|"calculates attendance"| node_attendance_score
node_performance_engine -->|"calculates KPI"| node_kpi_scoring
node_performance_engine -->|"uses weights"| node_performance_cycle
node_performance_cycle -->|"uses score"| node_attendance_score
node_performance_cycle -->|"uses KPI definitions"| node_kpi_scoring
node_monthly_performance -->|"uses scoring"| node_scoring
node_monthly_finalize -->|"calculates cycle"| node_monthly_calculator
node_monthly_finalize -->|"checks identity"| node_auth
node_monthly_finalize -->|"checks role"| node_authorization
node_reviews -->|"checks identity"| node_auth
node_reviews -->|"stores reviews"| node_postgres
node_management_dashboard -->|"checks identity"| node_auth
node_management_dashboard -->|"checks role"| node_authorization
node_management_dashboard -->|"queries metrics"| node_postgres
node_awards -->|"checks identity"| node_auth
node_awards -->|"checks role"| node_authorization
node_awards -->|"reads and writes"| node_postgres
node_rewards -->|"checks identity"| node_auth
node_rewards -->|"uses service"| node_rewards_service

click node_employee "https://github.com/pranjal1-1/eers/blob/main/apps/web/src/app/employees/page.tsx"
click node_login "https://github.com/pranjal1-1/eers/blob/main/apps/web/src/app/login/page.tsx"
click node_employee_api "https://github.com/pranjal1-1/eers/blob/main/apps/web/src/app/api/employees/route.ts"
click node_auth "https://github.com/pranjal1-1/eers/blob/main/apps/web/src/lib/api-auth.ts"
click node_authorization "https://github.com/pranjal1-1/eers/blob/main/apps/web/src/lib/authorization.ts"
click node_attendance_ui "https://github.com/pranjal1-1/eers/blob/main/apps/web/src/app/attendance/page.tsx"
click node_attendance_import_ui "https://github.com/pranjal1-1/eers/blob/main/apps/web/src/app/management/attendance-import.tsx"
click node_attendance_api "https://github.com/pranjal1-1/eers/blob/main/apps/web/src/app/api/attendance/route.ts"
click node_attendance_import "https://github.com/pranjal1-1/eers/blob/main/apps/web/src/app/api/attendance/import/route.ts"
click node_attendance_score "https://github.com/pranjal1-1/eers/blob/main/apps/web/src/lib/attendance-score.ts"
click node_kpi_api "https://github.com/pranjal1-1/eers/blob/main/apps/web/src/app/api/kpis/route.ts"
click node_kpi_assignments "https://github.com/pranjal1-1/eers/blob/main/apps/web/src/app/api/kpi-assignments/route.ts"
click node_kpi_results "https://github.com/pranjal1-1/eers/blob/main/apps/web/src/app/api/kpi-results/route.ts"
click node_kpi_scoring "https://github.com/pranjal1-1/eers/blob/main/apps/web/src/lib/kpi.ts"
click node_performance_engine "https://github.com/pranjal1-1/eers/blob/main/apps/web/src/lib/performance-engine.ts"
click node_performance_cycle "https://github.com/pranjal1-1/eers/blob/main/apps/web/src/lib/performance-cycle.ts"
click node_monthly_performance "https://github.com/pranjal1-1/eers/blob/main/apps/web/src/lib/monthly-performance.ts"
click node_monthly_calculator "https://github.com/pranjal1-1/eers/blob/main/apps/web/src/lib/monthly-performance-calculator.ts"
click node_monthly_finalize "https://github.com/pranjal1-1/eers/blob/main/apps/web/src/app/api/performance/monthly/finalize/route.ts"
click node_reviews "https://github.com/pranjal1-1/eers/blob/main/apps/web/src/app/api/performance/reviews/route.ts"
click node_scoring "https://github.com/pranjal1-1/eers/blob/main/apps/web/src/lib/scoring.ts"
click node_management_dashboard "https://github.com/pranjal1-1/eers/blob/main/apps/web/src/app/api/dashboard/management/route.ts"
click node_awards "https://github.com/pranjal1-1/eers/blob/main/apps/web/src/app/api/awards/eom/route.ts"
click node_rewards "https://github.com/pranjal1-1/eers/blob/main/apps/web/src/app/api/rewards/certificate/route.ts"
click node_rewards_service "https://github.com/pranjal1-1/eers/blob/main/apps/web/src/lib/rewards-server.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_employee,node_login,node_employee_api,node_auth,node_authorization toneBlue
class node_attendance_ui,node_attendance_import_ui,node_attendance_api,node_attendance_import,node_postgres toneAmber
class node_attendance_score,node_kpi_api,node_kpi_assignments,node_kpi_results,node_kpi_scoring,node_performance_engine,node_performance_cycle,node_monthly_performance,node_monthly_calculator,node_monthly_finalize,node_reviews,node_scoring toneMint
class node_management_dashboard,node_awards,node_rewards,node_rewards_service toneRose
class node_user toneIndigo
```

## Components

### Access and workforce

- [Employee workspace](https://github.com/pranjal1-1/eers/blob/main/apps/web/src/app/employees/page.tsx): `apps/web/src/app/employees/page.tsx`
- [Login](https://github.com/pranjal1-1/eers/blob/main/apps/web/src/app/login/page.tsx): `apps/web/src/app/login/page.tsx`
- [Employee endpoints](https://github.com/pranjal1-1/eers/blob/main/apps/web/src/app/api/employees/route.ts): `apps/web/src/app/api/employees/route.ts`
- [Request identity](https://github.com/pranjal1-1/eers/blob/main/apps/web/src/lib/api-auth.ts): `apps/web/src/lib/api-auth.ts`
- [Role rules](https://github.com/pranjal1-1/eers/blob/main/apps/web/src/lib/authorization.ts): `apps/web/src/lib/authorization.ts`

### Attendance management

- [Attendance workspace](https://github.com/pranjal1-1/eers/blob/main/apps/web/src/app/attendance/page.tsx): `apps/web/src/app/attendance/page.tsx`
- [Attendance import UI](https://github.com/pranjal1-1/eers/blob/main/apps/web/src/app/management/attendance-import.tsx): `apps/web/src/app/management/attendance-import.tsx`
- [Attendance endpoints](https://github.com/pranjal1-1/eers/blob/main/apps/web/src/app/api/attendance/route.ts): `apps/web/src/app/api/attendance/route.ts`
- [CSV attendance import](https://github.com/pranjal1-1/eers/blob/main/apps/web/src/app/api/attendance/import/route.ts): `apps/web/src/app/api/attendance/import/route.ts`

### Performance measurement

- [Attendance scoring](https://github.com/pranjal1-1/eers/blob/main/apps/web/src/lib/attendance-score.ts): `apps/web/src/lib/attendance-score.ts`
- [KPI endpoints](https://github.com/pranjal1-1/eers/blob/main/apps/web/src/app/api/kpis/route.ts): `apps/web/src/app/api/kpis/route.ts`
- [KPI assignments](https://github.com/pranjal1-1/eers/blob/main/apps/web/src/app/api/kpi-assignments/route.ts): `apps/web/src/app/api/kpi-assignments/route.ts`
- [KPI results](https://github.com/pranjal1-1/eers/blob/main/apps/web/src/app/api/kpi-results/route.ts): `apps/web/src/app/api/kpi-results/route.ts`
- [KPI scoring](https://github.com/pranjal1-1/eers/blob/main/apps/web/src/lib/kpi.ts): `apps/web/src/lib/kpi.ts`
- [Performance snapshot](https://github.com/pranjal1-1/eers/blob/main/apps/web/src/lib/performance-engine.ts): `apps/web/src/lib/performance-engine.ts`
- [Cycle configuration](https://github.com/pranjal1-1/eers/blob/main/apps/web/src/lib/performance-cycle.ts): `apps/web/src/lib/performance-cycle.ts`
- [Monthly performance](https://github.com/pranjal1-1/eers/blob/main/apps/web/src/lib/monthly-performance.ts): `apps/web/src/lib/monthly-performance.ts`
- [Monthly calculator](https://github.com/pranjal1-1/eers/blob/main/apps/web/src/lib/monthly-performance-calculator.ts): `apps/web/src/lib/monthly-performance-calculator.ts`
- [Cycle finalization](https://github.com/pranjal1-1/eers/blob/main/apps/web/src/app/api/performance/monthly/finalize/route.ts): `apps/web/src/app/api/performance/monthly/finalize/route.ts`
- [Management reviews](https://github.com/pranjal1-1/eers/blob/main/apps/web/src/app/api/performance/reviews/route.ts): `apps/web/src/app/api/performance/reviews/route.ts`
- [Weighted scoring](https://github.com/pranjal1-1/eers/blob/main/apps/web/src/lib/scoring.ts): `apps/web/src/lib/scoring.ts`

### Recognition and oversight

- [Management dashboard](https://github.com/pranjal1-1/eers/blob/main/apps/web/src/app/api/dashboard/management/route.ts): `apps/web/src/app/api/dashboard/management/route.ts`
- [Monthly awards](https://github.com/pranjal1-1/eers/blob/main/apps/web/src/app/api/awards/eom/route.ts): `apps/web/src/app/api/awards/eom/route.ts`
- [Certificate rewards](https://github.com/pranjal1-1/eers/blob/main/apps/web/src/app/api/rewards/certificate/route.ts): `apps/web/src/app/api/rewards/certificate/route.ts`
- [Reward services](https://github.com/pranjal1-1/eers/blob/main/apps/web/src/lib/rewards-server.ts): `apps/web/src/lib/rewards-server.ts`

### Other components

- **PostgreSQL**
- **Employee or manager**

## Connections

- Employee or manager → Attendance import UI: uploads CSV
- CSV attendance import → Request identity: checks identity (evidence: `apps/web/src/app/api/attendance/import/route.ts`)
- CSV attendance import → Role rules: checks role (evidence: `apps/web/src/app/api/attendance/import/route.ts`)
- CSV attendance import → PostgreSQL: writes records (evidence: `apps/web/src/app/api/attendance/import/route.ts`)
- Attendance endpoints → Request identity: requires user (evidence: `apps/web/src/app/api/attendance/route.ts`)
- Attendance endpoints → Role rules: checks role (evidence: `apps/web/src/app/api/attendance/route.ts`)
- Attendance endpoints → PostgreSQL: reads and writes (evidence: `apps/web/src/app/api/attendance/route.ts`)
- KPI endpoints → Request identity: checks role (evidence: `apps/web/src/app/api/kpis/route.ts`)
- KPI endpoints → Role rules: checks role (evidence: `apps/web/src/app/api/kpis/route.ts`)
- KPI endpoints → PostgreSQL: reads and writes (evidence: `apps/web/src/app/api/kpis/route.ts`)
- KPI assignments → PostgreSQL: reads and writes (evidence: `apps/web/src/app/api/kpi-assignments/route.ts`)
- KPI results → PostgreSQL: reads and writes (evidence: `apps/web/src/app/api/kpi-results/route.ts`)
- Performance snapshot → Attendance scoring: calculates attendance (evidence: `apps/web/src/lib/performance-engine.ts`)
- Performance snapshot → KPI scoring: calculates KPI (evidence: `apps/web/src/lib/performance-engine.ts`)
- Performance snapshot → Cycle configuration: uses weights (evidence: `apps/web/src/lib/performance-engine.ts`)
- Cycle configuration → Attendance scoring: uses score (evidence: `apps/web/src/lib/performance-cycle.ts`)
- Cycle configuration → KPI scoring: uses KPI definitions (evidence: `apps/web/src/lib/performance-cycle.ts`)
- Monthly performance → Weighted scoring: uses scoring (evidence: `apps/web/src/lib/monthly-performance.ts`)
- Cycle finalization → Monthly calculator: calculates cycle (evidence: `apps/web/src/app/api/performance/monthly/finalize/route.ts`)
- Cycle finalization → Request identity: checks identity (evidence: `apps/web/src/app/api/performance/monthly/finalize/route.ts`)
- Cycle finalization → Role rules: checks role (evidence: `apps/web/src/app/api/performance/monthly/finalize/route.ts`)
- Management reviews → Request identity: checks identity (evidence: `apps/web/src/app/api/performance/reviews/route.ts`)
- Management reviews → PostgreSQL: stores reviews (evidence: `apps/web/src/app/api/performance/reviews/route.ts`)
- Management dashboard → Request identity: checks identity (evidence: `apps/web/src/app/api/dashboard/management/route.ts`)
- Management dashboard → Role rules: checks role (evidence: `apps/web/src/app/api/dashboard/management/route.ts`)
- Management dashboard → PostgreSQL: queries metrics (evidence: `apps/web/src/app/api/dashboard/management/route.ts`)
- Monthly awards → Request identity: checks identity (evidence: `apps/web/src/app/api/awards/eom/route.ts`)
- Monthly awards → Role rules: checks role (evidence: `apps/web/src/app/api/awards/eom/route.ts`)
- Monthly awards → PostgreSQL: reads and writes (evidence: `apps/web/src/app/api/awards/eom/route.ts`)
- Certificate rewards → Request identity: checks identity (evidence: `apps/web/src/app/api/rewards/certificate/route.ts`)
- Certificate rewards → Reward services: uses service (evidence: `apps/web/src/app/api/rewards/certificate/route.ts`)
