# sapirshenkor/employeemanagementsystem architecture

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

- Interactive diagram: https://gitdiagram.com/sapirshenkor/employeemanagementsystem
- Repository: https://github.com/sapirshenkor/employeemanagementsystem

## Overview

This is an employee-management product: employees submit absence requests, managers review them against department staffing needs, and administrators manage users, departments, and settings. The frontend exposes role-gated employee, manager, and admin routes; the backend has corresponding absence, administration, authentication, and availability services backed by a relational model. The excerpts show service-to-storage and service-to-service calls, plus application registration and frontend routing. The README is empty, and several pages, controllers, and API clients were not sampled, so their runtime connections are left unspecified.

Main entry points: [`backend/EmployeeManagement.Api/Data/ApplicationDbContext.cs`](https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Data/ApplicationDbContext.cs) (EF data context), [`backend/EmployeeManagement.Api/Program.cs`](https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Program.cs) (API host), [`frontend/src/App.tsx`](https://github.com/sapirshenkor/employeemanagementsystem/blob/main/frontend/src/App.tsx) (Role-based routes), [`backend/EmployeeManagement.Api/Services/Absence/AbsenceRequestService.cs`](https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Services/Absence/AbsenceRequestService.cs) (Absence workflow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_app["Role-based routes<br/>[App.tsx]"]
  node_authcontext["Auth context<br/>[AuthContext.tsx]"]
  node_authguard["Auth guards<br/>[RequireAuth.tsx]"]
  node_login["Login page<br/>[Login.tsx]"]
  node_employee["Employee panel"]
  node_requestform["Absence form"]
  node_manager["Manager dashboard"]
  node_inbox["Approval inbox<br/>[ApprovalInbox.tsx]"]
  node_calendar["Master calendar"]
  node_settingspage["Admin settings"]
  node_absenceapi["Absence API client<br/>[absenceApi.ts]"]
  node_adminapi["Admin API client<br/>[adminApi.ts]"]
end

subgraph group_api["API and security"]
  node_program["API host<br/>[Program.cs]"]
  node_absencecontroller["Absence endpoints"]
  node_admincontroller["Admin endpoints<br/>[AdminController.cs]"]
  node_authcontroller["Auth endpoints<br/>[AuthController.cs]"]
  node_jwtmapper["JWT claims mapper"]
  node_roles["Application roles<br/>[AppRoles.cs]"]
end

subgraph group_workflows["Workforce workflows"]
  node_absence["Absence workflow"]
  node_availability["Staffing validation"]
  node_availabilitycontract["Availability contract"]
  node_adminservice["Admin operations<br/>[AdminService.cs]"]
  node_provisioning["User provisioning"]
  node_authclient["Supabase auth client"]
end

subgraph group_data["Domain data"]
  node_profile_repo["Profile repository"]
  node_dbcontext["EF data context"]
  node_profile["Employee profiles<br/>[Profile.cs]"]
  node_department["Departments<br/>[Department.cs]"]
  node_deptsettings["Department settings"]
  node_absenceentity["Absence requests<br/>[AbsenceRequest.cs]"]
  node_absencestatus["Absence status<br/>[AbsenceStatus.cs]"]
  node_auditlog["Audit log<br/>[AuditLog.cs]"]
end

node_user(("User"))
node_supabase{{"Supabase Auth"}}

node_user -->|"uses"| node_app
node_app -->|"wraps routes"| node_authcontext
node_app -->|"routes to"| node_login
node_app -->|"guards pages"| node_authguard
node_app -->|"routes to"| node_employee
node_app -->|"routes to"| node_manager
node_app -->|"routes to"| node_settingspage
node_program -->|"registers"| node_dbcontext
node_program -->|"maps claims"| node_jwtmapper
node_program -->|"registers"| node_availability
node_program -->|"registers"| node_absence
node_program -->|"registers"| node_adminservice
node_program -->|"registers"| node_authclient
node_program -->|"registers"| node_provisioning
node_absence -->|"reads and writes"| node_dbcontext
node_absence -->|"validates staffing"| node_availability
node_absence -->|"looks up profile"| node_profile_repo
node_availability -->|"reads"| node_dbcontext
node_adminservice -->|"reads and writes"| node_dbcontext
node_provisioning -->|"writes profiles"| node_dbcontext
node_provisioning -->|"checks profiles"| node_profile_repo
node_provisioning -->|"creates accounts"| node_authclient
node_authclient -->|"calls Auth API"| node_supabase
node_profile_repo -->|"queries"| node_dbcontext
node_dbcontext -->|"maps entity"| node_profile
node_dbcontext -->|"maps entity"| node_department
node_dbcontext -->|"maps entity"| node_deptsettings
node_dbcontext -->|"maps entity"| node_absenceentity
node_dbcontext -->|"maps entity"| node_auditlog
node_absenceentity -->|"uses status"| node_absencestatus

click node_app "https://github.com/sapirshenkor/employeemanagementsystem/blob/main/frontend/src/App.tsx"
click node_authcontext "https://github.com/sapirshenkor/employeemanagementsystem/blob/main/frontend/src/context/AuthContext.tsx"
click node_authguard "https://github.com/sapirshenkor/employeemanagementsystem/blob/main/frontend/src/components/RequireAuth.tsx"
click node_login "https://github.com/sapirshenkor/employeemanagementsystem/blob/main/frontend/src/pages/Login.tsx"
click node_employee "https://github.com/sapirshenkor/employeemanagementsystem/blob/main/frontend/src/pages/EmployeePanelPage.tsx"
click node_requestform "https://github.com/sapirshenkor/employeemanagementsystem/blob/main/frontend/src/components/AbsenceRequestForm.tsx"
click node_manager "https://github.com/sapirshenkor/employeemanagementsystem/blob/main/frontend/src/pages/ManagerDashboardPage.tsx"
click node_inbox "https://github.com/sapirshenkor/employeemanagementsystem/blob/main/frontend/src/components/ApprovalInbox.tsx"
click node_calendar "https://github.com/sapirshenkor/employeemanagementsystem/blob/main/frontend/src/components/MasterCalendarView.tsx"
click node_settingspage "https://github.com/sapirshenkor/employeemanagementsystem/blob/main/frontend/src/pages/GlobalSettingsPage.tsx"
click node_absenceapi "https://github.com/sapirshenkor/employeemanagementsystem/blob/main/frontend/src/lib/absenceApi.ts"
click node_adminapi "https://github.com/sapirshenkor/employeemanagementsystem/blob/main/frontend/src/lib/adminApi.ts"
click node_program "https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Program.cs"
click node_absencecontroller "https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Controllers/AbsenceRequestsController.cs"
click node_admincontroller "https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Controllers/AdminController.cs"
click node_authcontroller "https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Controllers/AuthController.cs"
click node_jwtmapper "https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Security/SupabaseJwtClaimsMapper.cs"
click node_roles "https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Security/AppRoles.cs"
click node_absence "https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Services/Absence/AbsenceRequestService.cs"
click node_availability "https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Services/Availability/AvailabilityService.cs"
click node_availabilitycontract "https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Services/Availability/IAvailabilityService.cs"
click node_adminservice "https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Services/Admin/AdminService.cs"
click node_provisioning "https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Services/Auth/UserProvisioningService.cs"
click node_authclient "https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Services/Auth/SupabaseAuthClient.cs"
click node_profile_repo "https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Repositories/ProfileRepository.cs"
click node_dbcontext "https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Data/ApplicationDbContext.cs"
click node_profile "https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Data/Entities/Profile.cs"
click node_department "https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Data/Entities/Department.cs"
click node_deptsettings "https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Data/Entities/DepartmentSettings.cs"
click node_absenceentity "https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Data/Entities/AbsenceRequest.cs"
click node_absencestatus "https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Data/Entities/AbsenceStatus.cs"
click node_auditlog "https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Data/Entities/AuditLog.cs"

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_authcontext,node_authguard,node_login,node_employee,node_requestform,node_manager,node_inbox,node_calendar,node_settingspage,node_absenceapi,node_adminapi,node_user toneBlue
class node_program,node_absencecontroller,node_admincontroller,node_authcontroller,node_jwtmapper,node_roles toneAmber
class node_absence,node_availability,node_availabilitycontract,node_adminservice,node_provisioning,node_authclient toneMint
class node_profile_repo,node_dbcontext,node_profile,node_department,node_deptsettings,node_absenceentity,node_absencestatus,node_auditlog toneRose
class node_supabase toneIndigo
```

## Components

### Web application

- [Role-based routes](https://github.com/sapirshenkor/employeemanagementsystem/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Auth context](https://github.com/sapirshenkor/employeemanagementsystem/blob/main/frontend/src/context/AuthContext.tsx): `frontend/src/context/AuthContext.tsx`
- [Auth guards](https://github.com/sapirshenkor/employeemanagementsystem/blob/main/frontend/src/components/RequireAuth.tsx): `frontend/src/components/RequireAuth.tsx`
- [Login page](https://github.com/sapirshenkor/employeemanagementsystem/blob/main/frontend/src/pages/Login.tsx): `frontend/src/pages/Login.tsx`
- [Employee panel](https://github.com/sapirshenkor/employeemanagementsystem/blob/main/frontend/src/pages/EmployeePanelPage.tsx): `frontend/src/pages/EmployeePanelPage.tsx`
- [Absence form](https://github.com/sapirshenkor/employeemanagementsystem/blob/main/frontend/src/components/AbsenceRequestForm.tsx): `frontend/src/components/AbsenceRequestForm.tsx`
- [Manager dashboard](https://github.com/sapirshenkor/employeemanagementsystem/blob/main/frontend/src/pages/ManagerDashboardPage.tsx): `frontend/src/pages/ManagerDashboardPage.tsx`
- [Approval inbox](https://github.com/sapirshenkor/employeemanagementsystem/blob/main/frontend/src/components/ApprovalInbox.tsx): `frontend/src/components/ApprovalInbox.tsx`
- [Master calendar](https://github.com/sapirshenkor/employeemanagementsystem/blob/main/frontend/src/components/MasterCalendarView.tsx): `frontend/src/components/MasterCalendarView.tsx`
- [Admin settings](https://github.com/sapirshenkor/employeemanagementsystem/blob/main/frontend/src/pages/GlobalSettingsPage.tsx): `frontend/src/pages/GlobalSettingsPage.tsx`
- [Absence API client](https://github.com/sapirshenkor/employeemanagementsystem/blob/main/frontend/src/lib/absenceApi.ts): `frontend/src/lib/absenceApi.ts`
- [Admin API client](https://github.com/sapirshenkor/employeemanagementsystem/blob/main/frontend/src/lib/adminApi.ts): `frontend/src/lib/adminApi.ts`

### API and security

- [API host](https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Program.cs): `backend/EmployeeManagement.Api/Program.cs`
- [Absence endpoints](https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Controllers/AbsenceRequestsController.cs): `backend/EmployeeManagement.Api/Controllers/AbsenceRequestsController.cs`
- [Admin endpoints](https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Controllers/AdminController.cs): `backend/EmployeeManagement.Api/Controllers/AdminController.cs`
- [Auth endpoints](https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Controllers/AuthController.cs): `backend/EmployeeManagement.Api/Controllers/AuthController.cs`
- [JWT claims mapper](https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Security/SupabaseJwtClaimsMapper.cs): `backend/EmployeeManagement.Api/Security/SupabaseJwtClaimsMapper.cs`
- [Application roles](https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Security/AppRoles.cs): `backend/EmployeeManagement.Api/Security/AppRoles.cs`

### Workforce workflows

- [Absence workflow](https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Services/Absence/AbsenceRequestService.cs): `backend/EmployeeManagement.Api/Services/Absence/AbsenceRequestService.cs`
- [Staffing validation](https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Services/Availability/AvailabilityService.cs): `backend/EmployeeManagement.Api/Services/Availability/AvailabilityService.cs`
- [Availability contract](https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Services/Availability/IAvailabilityService.cs): `backend/EmployeeManagement.Api/Services/Availability/IAvailabilityService.cs`
- [Admin operations](https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Services/Admin/AdminService.cs): `backend/EmployeeManagement.Api/Services/Admin/AdminService.cs`
- [User provisioning](https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Services/Auth/UserProvisioningService.cs): `backend/EmployeeManagement.Api/Services/Auth/UserProvisioningService.cs`
- [Supabase auth client](https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Services/Auth/SupabaseAuthClient.cs): `backend/EmployeeManagement.Api/Services/Auth/SupabaseAuthClient.cs`

### Domain data

- [Profile repository](https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Repositories/ProfileRepository.cs): `backend/EmployeeManagement.Api/Repositories/ProfileRepository.cs`
- [EF data context](https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Data/ApplicationDbContext.cs): `backend/EmployeeManagement.Api/Data/ApplicationDbContext.cs`
- [Employee profiles](https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Data/Entities/Profile.cs): `backend/EmployeeManagement.Api/Data/Entities/Profile.cs`
- [Departments](https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Data/Entities/Department.cs): `backend/EmployeeManagement.Api/Data/Entities/Department.cs`
- [Department settings](https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Data/Entities/DepartmentSettings.cs): `backend/EmployeeManagement.Api/Data/Entities/DepartmentSettings.cs`
- [Absence requests](https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Data/Entities/AbsenceRequest.cs): `backend/EmployeeManagement.Api/Data/Entities/AbsenceRequest.cs`
- [Absence status](https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Data/Entities/AbsenceStatus.cs): `backend/EmployeeManagement.Api/Data/Entities/AbsenceStatus.cs`
- [Audit log](https://github.com/sapirshenkor/employeemanagementsystem/blob/main/backend/EmployeeManagement.Api/Data/Entities/AuditLog.cs): `backend/EmployeeManagement.Api/Data/Entities/AuditLog.cs`

### Other components

- **User**
- **Supabase Auth**

## Connections

- User → Role-based routes: uses
- Role-based routes → Auth context: wraps routes (evidence: `frontend/src/App.tsx`)
- Role-based routes → Login page: routes to (evidence: `frontend/src/App.tsx`)
- Role-based routes → Auth guards: guards pages (evidence: `frontend/src/App.tsx`)
- Role-based routes → Employee panel: routes to (evidence: `frontend/src/App.tsx`)
- Role-based routes → Manager dashboard: routes to (evidence: `frontend/src/App.tsx`)
- Role-based routes → Admin settings: routes to (evidence: `frontend/src/App.tsx`)
- API host → EF data context: registers (evidence: `backend/EmployeeManagement.Api/Program.cs`)
- API host → JWT claims mapper: maps claims (evidence: `backend/EmployeeManagement.Api/Program.cs`)
- API host → Staffing validation: registers (evidence: `backend/EmployeeManagement.Api/Program.cs`)
- API host → Absence workflow: registers (evidence: `backend/EmployeeManagement.Api/Program.cs`)
- API host → Admin operations: registers (evidence: `backend/EmployeeManagement.Api/Program.cs`)
- API host → Supabase auth client: registers (evidence: `backend/EmployeeManagement.Api/Program.cs`)
- API host → User provisioning: registers (evidence: `backend/EmployeeManagement.Api/Program.cs`)
- Absence workflow → EF data context: reads and writes (evidence: `backend/EmployeeManagement.Api/Services/Absence/AbsenceRequestService.cs`)
- Absence workflow → Staffing validation: validates staffing (evidence: `backend/EmployeeManagement.Api/Services/Absence/AbsenceRequestService.cs`)
- Absence workflow → Profile repository: looks up profile (evidence: `backend/EmployeeManagement.Api/Services/Absence/AbsenceRequestService.cs`)
- Staffing validation → EF data context: reads (evidence: `backend/EmployeeManagement.Api/Services/Availability/AvailabilityService.cs`)
- Admin operations → EF data context: reads and writes (evidence: `backend/EmployeeManagement.Api/Services/Admin/AdminService.cs`)
- User provisioning → EF data context: writes profiles (evidence: `backend/EmployeeManagement.Api/Services/Auth/UserProvisioningService.cs`)
- User provisioning → Profile repository: checks profiles (evidence: `backend/EmployeeManagement.Api/Services/Auth/UserProvisioningService.cs`)
- User provisioning → Supabase auth client: creates accounts (evidence: `backend/EmployeeManagement.Api/Services/Auth/UserProvisioningService.cs`)
- Supabase auth client → Supabase Auth: calls Auth API (evidence: `backend/EmployeeManagement.Api/Services/Auth/SupabaseAuthClient.cs`)
- Profile repository → EF data context: queries (evidence: `backend/EmployeeManagement.Api/Repositories/ProfileRepository.cs`)
- EF data context → Employee profiles: maps entity (evidence: `backend/EmployeeManagement.Api/Data/ApplicationDbContext.cs`)
- EF data context → Departments: maps entity (evidence: `backend/EmployeeManagement.Api/Data/ApplicationDbContext.cs`)
- EF data context → Department settings: maps entity (evidence: `backend/EmployeeManagement.Api/Data/ApplicationDbContext.cs`)
- EF data context → Absence requests: maps entity (evidence: `backend/EmployeeManagement.Api/Data/ApplicationDbContext.cs`)
- EF data context → Audit log: maps entity (evidence: `backend/EmployeeManagement.Api/Data/ApplicationDbContext.cs`)
- Absence requests → Absence status: uses status (evidence: `backend/EmployeeManagement.Api/Data/Entities/AbsenceRequest.cs`)
