# nancygos/employee-management architecture

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

- Interactive diagram: https://gitdiagram.com/nancygos/employee-management
- Repository: https://github.com/nancygos/employee-management

## Overview

Employee Salary Records is an HR web app for searching a 10,000-person directory, viewing employee salary history, recording salary changes, and reviewing payroll summaries. The browser routes users to an overview, directory, or employee page; those pages call the Rails API, which exposes overview and employee endpoints. The backend also contains salary/pay analytics and persistent employee and salary records. The API routes and browser requests are visible, but controller-to-model and analytics wiring was not shown, so those internal links are omitted.

Main entry points: [`frontend/src/App.jsx`](https://github.com/nancygos/employee-management/blob/master/frontend/src/App.jsx) (Page routing), [`backend/config/routes.rb`](https://github.com/nancygos/employee-management/blob/master/backend/config/routes.rb) (API routing), [`frontend/src/EmployeePage.jsx`](https://github.com/nancygos/employee-management/blob/master/frontend/src/EmployeePage.jsx) (Employee record), [`backend/app/controllers/api/employees_controller.rb`](https://github.com/nancygos/employee-management/blob/master/backend/app/controllers/api/employees_controller.rb) (Employee endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web app"]
  node_web_entry["React entry<br/>[main.jsx]"]
  node_web_routes["Page routing<br/>[App.jsx]"]
  node_directory["Employee directory<br/>[Directory.jsx]"]
  node_employee_page["Employee record<br/>[EmployeePage.jsx]"]
  node_overview_page["Payroll overview<br/>[Overview.jsx]"]
  node_api_config["API URL config<br/>[api.js]"]
end

subgraph group_api["Rails API"]
  node_overview_api["Overview endpoint"]
  node_employees_api["Employee endpoints"]
  node_salaries_api["Salary endpoint"]
  node_api_routes["API routing<br/>[routes.rb]"]
end

subgraph group_domain["Pay domain"]
  node_employee_model["Employee records<br/>[employee.rb]"]
  node_salary_model["Salary history<br/>[salary.rb]"]
  node_pay_overview["Pay summaries<br/>[overview.rb]"]
  node_pay_rates["Currency rates<br/>[rates.rb]"]
  node_database[("SQLite database<br/>[schema.rb]")]
end

subgraph group_runtime["Application runtime"]
  node_rails_boot["Rails boot<br/>[boot.rb]"]
  node_rails_app["Rails application<br/>[application.rb]"]
  node_rails_environment["Rails environment<br/>[environment.rb]"]
end

node_user(("HR user"))

node_user -->|"opens app"| node_web_entry
node_web_entry -->|"renders"| node_web_routes
node_web_routes -->|"routes to"| node_directory
node_web_routes -->|"routes to"| node_employee_page
node_web_routes -->|"routes to"| node_overview_page
node_directory -->|"requests list"| node_employees_api
node_employee_page -->|"requests record"| node_employees_api
node_employee_page -->|"posts change"| node_salaries_api
node_overview_page -->|"requests summary"| node_overview_api
node_api_routes -->|"routes to"| node_overview_api
node_api_routes -->|"routes to"| node_employees_api
node_api_routes -->|"routes to"| node_salaries_api
node_rails_app -->|"requires"| node_rails_boot
node_rails_environment -->|"loads"| node_rails_app

click node_web_entry "https://github.com/nancygos/employee-management/blob/master/frontend/src/main.jsx"
click node_web_routes "https://github.com/nancygos/employee-management/blob/master/frontend/src/App.jsx"
click node_directory "https://github.com/nancygos/employee-management/blob/master/frontend/src/Directory.jsx"
click node_employee_page "https://github.com/nancygos/employee-management/blob/master/frontend/src/EmployeePage.jsx"
click node_overview_page "https://github.com/nancygos/employee-management/blob/master/frontend/src/Overview.jsx"
click node_api_config "https://github.com/nancygos/employee-management/blob/master/frontend/src/api.js"
click node_overview_api "https://github.com/nancygos/employee-management/blob/master/backend/app/controllers/api/overview_controller.rb"
click node_employees_api "https://github.com/nancygos/employee-management/blob/master/backend/app/controllers/api/employees_controller.rb"
click node_salaries_api "https://github.com/nancygos/employee-management/blob/master/backend/app/controllers/api/salaries_controller.rb"
click node_api_routes "https://github.com/nancygos/employee-management/blob/master/backend/config/routes.rb"
click node_employee_model "https://github.com/nancygos/employee-management/blob/master/backend/app/models/employee.rb"
click node_salary_model "https://github.com/nancygos/employee-management/blob/master/backend/app/models/salary.rb"
click node_pay_overview "https://github.com/nancygos/employee-management/blob/master/backend/lib/pay/overview.rb"
click node_pay_rates "https://github.com/nancygos/employee-management/blob/master/backend/lib/pay/rates.rb"
click node_database "https://github.com/nancygos/employee-management/blob/master/backend/db/schema.rb"
click node_rails_boot "https://github.com/nancygos/employee-management/blob/master/backend/config/boot.rb"
click node_rails_app "https://github.com/nancygos/employee-management/blob/master/backend/config/application.rb"
click node_rails_environment "https://github.com/nancygos/employee-management/blob/master/backend/config/environment.rb"

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_web_entry,node_web_routes,node_directory,node_employee_page,node_overview_page,node_api_config,node_user toneBlue
class node_overview_api,node_employees_api,node_salaries_api,node_api_routes toneAmber
class node_employee_model,node_salary_model,node_pay_overview,node_pay_rates,node_database toneMint
class node_rails_boot,node_rails_app,node_rails_environment toneRose
```

## Components

### Web app

- [React entry](https://github.com/nancygos/employee-management/blob/master/frontend/src/main.jsx): `frontend/src/main.jsx`
- [Page routing](https://github.com/nancygos/employee-management/blob/master/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Employee directory](https://github.com/nancygos/employee-management/blob/master/frontend/src/Directory.jsx): `frontend/src/Directory.jsx`
- [Employee record](https://github.com/nancygos/employee-management/blob/master/frontend/src/EmployeePage.jsx): `frontend/src/EmployeePage.jsx`
- [Payroll overview](https://github.com/nancygos/employee-management/blob/master/frontend/src/Overview.jsx): `frontend/src/Overview.jsx`
- [API URL config](https://github.com/nancygos/employee-management/blob/master/frontend/src/api.js): `frontend/src/api.js`

### Rails API

- [Overview endpoint](https://github.com/nancygos/employee-management/blob/master/backend/app/controllers/api/overview_controller.rb): `backend/app/controllers/api/overview_controller.rb`
- [Employee endpoints](https://github.com/nancygos/employee-management/blob/master/backend/app/controllers/api/employees_controller.rb): `backend/app/controllers/api/employees_controller.rb`
- [Salary endpoint](https://github.com/nancygos/employee-management/blob/master/backend/app/controllers/api/salaries_controller.rb): `backend/app/controllers/api/salaries_controller.rb`
- [API routing](https://github.com/nancygos/employee-management/blob/master/backend/config/routes.rb): `backend/config/routes.rb`

### Pay domain

- [Employee records](https://github.com/nancygos/employee-management/blob/master/backend/app/models/employee.rb): `backend/app/models/employee.rb`
- [Salary history](https://github.com/nancygos/employee-management/blob/master/backend/app/models/salary.rb): `backend/app/models/salary.rb`
- [Pay summaries](https://github.com/nancygos/employee-management/blob/master/backend/lib/pay/overview.rb): `backend/lib/pay/overview.rb`
- [Currency rates](https://github.com/nancygos/employee-management/blob/master/backend/lib/pay/rates.rb): `backend/lib/pay/rates.rb`
- [SQLite database](https://github.com/nancygos/employee-management/blob/master/backend/db/schema.rb): `backend/db/schema.rb`

### Application runtime

- [Rails boot](https://github.com/nancygos/employee-management/blob/master/backend/config/boot.rb): `backend/config/boot.rb`
- [Rails application](https://github.com/nancygos/employee-management/blob/master/backend/config/application.rb): `backend/config/application.rb`
- [Rails environment](https://github.com/nancygos/employee-management/blob/master/backend/config/environment.rb): `backend/config/environment.rb`

### Other components

- **HR user**

## Connections

- HR user → React entry: opens app (evidence: `README.md`)
- React entry → Page routing: renders (evidence: `frontend/src/main.jsx`)
- Page routing → Employee directory: routes to (evidence: `frontend/src/App.jsx`)
- Page routing → Employee record: routes to (evidence: `frontend/src/App.jsx`)
- Page routing → Payroll overview: routes to (evidence: `frontend/src/App.jsx`)
- Employee directory → Employee endpoints: requests list (evidence: `frontend/src/Directory.jsx`)
- Employee record → Employee endpoints: requests record (evidence: `frontend/src/EmployeePage.jsx`)
- Employee record → Salary endpoint: posts change (evidence: `frontend/src/EmployeePage.jsx`)
- Payroll overview → Overview endpoint: requests summary (evidence: `frontend/src/Overview.jsx`)
- API routing → Overview endpoint: routes to (evidence: `backend/config/routes.rb`)
- API routing → Employee endpoints: routes to (evidence: `backend/config/routes.rb`)
- API routing → Salary endpoint: routes to (evidence: `backend/config/routes.rb`)
- Rails application → Rails boot: requires (evidence: `backend/config/application.rb`)
- Rails environment → Rails application: loads (evidence: `backend/config/environment.rb`)
