# gauravkh-sys/hrms_mvcdotnet architecture

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

- Interactive diagram: https://gitdiagram.com/gauravkh-sys/hrms_mvcdotnet
- Repository: https://github.com/gauravkh-sys/hrms_mvcdotnet

## Overview

Enterprise HRMS is an ASP.NET Core MVC application for HR staff and employees. Its principal workflow routes employee, leave, attendance, or payroll requests through web controllers to application services and persisted HR data; payroll and reporting can produce downloadable exports. The README also describes department assignments, leave approvals and balances, shifts, and overtime, though those details are not fully visible in the sampled source. Arrows reflect documented or indexed references; unsampled features are shown without speculative call paths.

Main entry points: [`HRMS.Infrastructure/Data/HRMSDbContext.cs`](https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS.Infrastructure/Data/HRMSDbContext.cs) (HRMS database), [`HRMS.Application/Services/EmployeeService.cs`](https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS.Application/Services/EmployeeService.cs) (Employee service), [`HRMS/Program.cs`](https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS/Program.cs) (Application startup), [`HRMS.Application/Services/PayrollService.cs`](https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS.Application/Services/PayrollService.cs) (Payroll service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web and identity"]
  node_employee_controller["Employee controller"]
  node_attendance_controller["Attendance controller"]
  node_leave_controller["Leave controller"]
  node_payroll_controller["Payroll controller"]
  node_account_controller["Account controller"]
  node_identity["Identity user<br/>[ApplicationUser.cs]"]
  node_startup["Application startup<br/>[Program.cs]"]
end

subgraph group_employee["Employee domain"]
  node_employee_service["Employee service<br/>[EmployeeService.cs]"]
  node_employee_model["Employee aggregate<br/>[Employee.cs]"]
  node_department["Department<br/>[Department.cs]"]
  node_email["Email value object<br/>[Email.cs]"]
end

subgraph group_timeoff["Leave and attendance"]
  node_attendance_service["Attendance service"]
  node_attendance_record["Attendance record"]
  node_leave_service["Leave service<br/>[LeaveService.cs]"]
  node_leave_request["Leave request<br/>[LeaveRequest.cs]"]
end

subgraph group_payroll["Payroll and reports"]
  node_payroll_service["Payroll service<br/>[PayrollService.cs]"]
  node_payslip["Payslip<br/>[PaySlip.cs]"]
  node_salary_structure["Salary structure<br/>[SalaryStructure.cs]"]
  node_excel_report["Excel reporting"]
end

subgraph group_storage["Persistence"]
  node_employee_repository["Employee repository"]
  node_db[("HRMS database<br/>[HRMSDbContext.cs]")]
end

node_hr_user(("HR user"))
node_employee_actor(("Employee"))
node_sql_server[("SQL Server")]

node_hr_user -->|"manages employees"| node_employee_controller
node_employee_actor -->|"records time"| node_attendance_controller
node_employee_actor -->|"requests leave"| node_leave_controller
node_hr_user -->|"manages payroll"| node_payroll_controller
node_employee_controller -->|"calls"| node_employee_service
node_employee_controller -->|"requests exports"| node_excel_report
node_attendance_controller -->|"calls"| node_attendance_service
node_leave_controller -->|"queries"| node_db
node_payroll_controller -->|"calls"| node_payroll_service
node_account_controller -->|"manages accounts"| node_identity
node_employee_service -->|"loads and adds"| node_employee_repository
node_employee_service -->|"saves changes"| node_db
node_employee_service -->|"provisions accounts"| node_identity
node_employee_service -->|"validates address"| node_email
node_employee_service -->|"creates"| node_employee_model
node_employee_repository -->|"reads and writes"| node_db
node_attendance_service -->|"reads and writes"| node_db
node_leave_service -->|"reads and writes"| node_db
node_payroll_service -->|"reads and writes"| node_db
node_payroll_service -->|"creates and exports"| node_payslip
node_excel_report -->|"reads records"| node_db
node_db -->|"persists data"| node_sql_server
node_startup -->|"configures"| node_db
node_startup -->|"registers"| node_employee_service
node_startup -->|"registers"| node_attendance_service
node_startup -->|"registers"| node_leave_service
node_startup -->|"registers"| node_payroll_service
node_startup -->|"registers"| node_excel_report

click node_employee_controller "https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS/Controllers/EmployeesController.cs"
click node_attendance_controller "https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS/Controllers/AttendanceController.cs"
click node_leave_controller "https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS/Controllers/LeavesController.cs"
click node_payroll_controller "https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS/Controllers/PayrollController.cs"
click node_account_controller "https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS/Controllers/AccountController.cs"
click node_identity "https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS.Infrastructure/Identity/ApplicationUser.cs"
click node_employee_service "https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS.Application/Services/EmployeeService.cs"
click node_employee_model "https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS.Domain/Entities/Employee.cs"
click node_department "https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS.Domain/Entities/Department.cs"
click node_email "https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS.Domain/ValueObjects/Email.cs"
click node_employee_repository "https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS.Infrastructure/Repositories/EmployeeRepository.cs"
click node_attendance_service "https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS.Application/Services/AttendanceService.cs"
click node_attendance_record "https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS.Domain/Entities/AttendanceRecord.cs"
click node_leave_service "https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS.Application/Services/LeaveService.cs"
click node_leave_request "https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS.Domain/Entities/LeaveRequest.cs"
click node_payroll_service "https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS.Application/Services/PayrollService.cs"
click node_payslip "https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS.Domain/Entities/PaySlip.cs"
click node_salary_structure "https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS.Domain/Entities/SalaryStructure.cs"
click node_excel_report "https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS.Application/Services/ExcelReportService.cs"
click node_db "https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS.Infrastructure/Data/HRMSDbContext.cs"
click node_startup "https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS/Program.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_employee_controller,node_attendance_controller,node_leave_controller,node_payroll_controller,node_account_controller,node_identity,node_startup,node_hr_user toneBlue
class node_employee_service,node_employee_model,node_department,node_email,node_sql_server toneAmber
class node_attendance_service,node_attendance_record,node_leave_service,node_leave_request toneMint
class node_payroll_service,node_payslip,node_salary_structure,node_excel_report toneRose
class node_employee_repository,node_db,node_employee_actor toneIndigo
```

## Components

### Web and identity

- [Employee controller](https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS/Controllers/EmployeesController.cs): `HRMS/Controllers/EmployeesController.cs`
- [Attendance controller](https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS/Controllers/AttendanceController.cs): `HRMS/Controllers/AttendanceController.cs`
- [Leave controller](https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS/Controllers/LeavesController.cs): `HRMS/Controllers/LeavesController.cs`
- [Payroll controller](https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS/Controllers/PayrollController.cs): `HRMS/Controllers/PayrollController.cs`
- [Account controller](https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS/Controllers/AccountController.cs): `HRMS/Controllers/AccountController.cs`
- [Identity user](https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS.Infrastructure/Identity/ApplicationUser.cs): `HRMS.Infrastructure/Identity/ApplicationUser.cs`
- [Application startup](https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS/Program.cs): `HRMS/Program.cs`

### Employee domain

- [Employee service](https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS.Application/Services/EmployeeService.cs): `HRMS.Application/Services/EmployeeService.cs`
- [Employee aggregate](https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS.Domain/Entities/Employee.cs): `HRMS.Domain/Entities/Employee.cs`
- [Department](https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS.Domain/Entities/Department.cs): `HRMS.Domain/Entities/Department.cs`
- [Email value object](https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS.Domain/ValueObjects/Email.cs): `HRMS.Domain/ValueObjects/Email.cs`

### Leave and attendance

- [Attendance service](https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS.Application/Services/AttendanceService.cs): `HRMS.Application/Services/AttendanceService.cs`
- [Attendance record](https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS.Domain/Entities/AttendanceRecord.cs): `HRMS.Domain/Entities/AttendanceRecord.cs`
- [Leave service](https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS.Application/Services/LeaveService.cs): `HRMS.Application/Services/LeaveService.cs`
- [Leave request](https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS.Domain/Entities/LeaveRequest.cs): `HRMS.Domain/Entities/LeaveRequest.cs`

### Payroll and reports

- [Payroll service](https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS.Application/Services/PayrollService.cs): `HRMS.Application/Services/PayrollService.cs`
- [Payslip](https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS.Domain/Entities/PaySlip.cs): `HRMS.Domain/Entities/PaySlip.cs`
- [Salary structure](https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS.Domain/Entities/SalaryStructure.cs): `HRMS.Domain/Entities/SalaryStructure.cs`
- [Excel reporting](https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS.Application/Services/ExcelReportService.cs): `HRMS.Application/Services/ExcelReportService.cs`

### Persistence

- [Employee repository](https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS.Infrastructure/Repositories/EmployeeRepository.cs): `HRMS.Infrastructure/Repositories/EmployeeRepository.cs`
- [HRMS database](https://github.com/gauravkh-sys/hrms_mvcdotnet/blob/main/HRMS.Infrastructure/Data/HRMSDbContext.cs): `HRMS.Infrastructure/Data/HRMSDbContext.cs`

### Other components

- **HR user**
- **Employee**
- **SQL Server**

## Connections

- HR user → Employee controller: manages employees (evidence: `HRMS/Controllers/EmployeesController.cs`)
- Employee → Attendance controller: records time (evidence: `HRMS/Controllers/AttendanceController.cs`)
- Employee → Leave controller: requests leave (evidence: `HRMS/Controllers/LeavesController.cs`)
- HR user → Payroll controller: manages payroll (evidence: `HRMS/Controllers/PayrollController.cs`)
- Employee controller → Employee service: calls (evidence: `HRMS/Controllers/EmployeesController.cs`)
- Employee controller → Excel reporting: requests exports (evidence: `HRMS/Controllers/EmployeesController.cs`)
- Attendance controller → Attendance service: calls (evidence: `HRMS/Controllers/AttendanceController.cs`)
- Leave controller → HRMS database: queries (evidence: `HRMS/Controllers/LeavesController.cs`)
- Payroll controller → Payroll service: calls (evidence: `HRMS/Controllers/PayrollController.cs`)
- Account controller → Identity user: manages accounts (evidence: `HRMS/Controllers/AccountController.cs`)
- Employee service → Employee repository: loads and adds (evidence: `HRMS.Application/Services/EmployeeService.cs`)
- Employee service → HRMS database: saves changes (evidence: `HRMS.Application/Services/EmployeeService.cs`)
- Employee service → Identity user: provisions accounts (evidence: `HRMS.Application/Services/EmployeeService.cs`)
- Employee service → Email value object: validates address (evidence: `HRMS.Application/Services/EmployeeService.cs`)
- Employee service → Employee aggregate: creates (evidence: `HRMS.Application/Services/EmployeeService.cs`)
- Employee repository → HRMS database: reads and writes (evidence: `HRMS.Infrastructure/Repositories/EmployeeRepository.cs`)
- Attendance service → HRMS database: reads and writes (evidence: `HRMS.Application/Services/AttendanceService.cs`)
- Leave service → HRMS database: reads and writes (evidence: `HRMS.Application/Services/LeaveService.cs`)
- Payroll service → HRMS database: reads and writes (evidence: `HRMS.Application/Services/PayrollService.cs`)
- Payroll service → Payslip: creates and exports (evidence: `HRMS.Application/Services/PayrollService.cs`)
- Excel reporting → HRMS database: reads records (evidence: `HRMS.Application/Services/ExcelReportService.cs`)
- HRMS database → SQL Server: persists data
- Application startup → HRMS database: configures (evidence: `HRMS/Program.cs`)
- Application startup → Employee service: registers (evidence: `HRMS/Program.cs`)
- Application startup → Attendance service: registers (evidence: `HRMS/Program.cs`)
- Application startup → Leave service: registers (evidence: `HRMS/Program.cs`)
- Application startup → Payroll service: registers (evidence: `HRMS/Program.cs`)
- Application startup → Excel reporting: registers (evidence: `HRMS/Program.cs`)
