# quisethecoder/capstone-md architecture

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

- Interactive diagram: https://gitdiagram.com/quisethecoder/capstone-md
- Repository: https://github.com/quisethecoder/capstone-md

## Overview

MD Scheduler is a role-based employee scheduling application: employees and managers use a React interface to sign in and manage or review schedules, while a Spring backend exposes employee, manager, schedule, and seat operations over HTTP. The backend validates scheduling rules and delegates persistence through repository interfaces to JDBC implementations. The README also describes capacity limits, date restrictions, schedule overviews, manager oversight, and huddle-leader displays. Some client-to-server links are not shown in sampled source, so only the explicitly visible HTTP requests are connected.

Main entry points: [`client/src/App.jsx`](https://github.com/quisethecoder/capstone-md/blob/main/client/src/App.jsx) (Routes and session), [`client/src/components/ManagerProfile.jsx`](https://github.com/quisethecoder/capstone-md/blob/main/client/src/components/ManagerProfile.jsx) (Manager profile), [`server/src/main/java/learn/domain/ScheduleService.java`](https://github.com/quisethecoder/capstone-md/blob/main/server/src/main/java/learn/domain/ScheduleService.java) (Schedule validation), [`client/src/components/Home.jsx`](https://github.com/quisethecoder/capstone-md/blob/main/client/src/components/Home.jsx) (Schedule overview)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["React client"]
  node_app["Routes and session<br/>[App.jsx]"]
  node_employee_access["Employee access<br/>[EmployeeForm.jsx]"]
  node_manager_access["Manager access<br/>[ManagerForm.jsx]"]
  node_home["Schedule overview<br/>[Home.jsx]"]
  node_huddle["Huddle leaders<br/>[HuddleLeader.jsx]"]
  node_today["Today and tomorrow"]
  node_weekly["Weekly schedule"]
  node_schedule_ui["Schedule management<br/>[Schedule.jsx]"]
  node_employee_profile["Employee profile"]
  node_employee_days["Onsite days"]
  node_employee_schedule_form["Schedule editor"]
  node_manager_profile["Manager profile<br/>[ManagerProfile.jsx]"]
  node_manager_check["Monthly oversight"]
  node_manager_list["Employee management"]
  node_seats_ui["Seat overview<br/>[SeatsList.jsx]"]
end

subgraph group_api["HTTP API"]
  node_employee_api["Employee API"]
  node_manager_api["Manager API"]
  node_schedule_api["Schedule API"]
  node_seat_api["Seat API"]
end

subgraph group_domain["Domain services"]
  node_employee_service["Employee rules"]
  node_manager_service["Manager rules"]
  node_schedule_service["Schedule validation"]
  node_seat_service["Seat operations<br/>[SeatService.java]"]
  node_result["Operation results<br/>[Result.java]"]
end

subgraph group_storage["Persistence"]
  node_employee_repo["Employee repository"]
  node_manager_repo["Manager repository"]
  node_schedule_repo["Schedule repository"]
  node_seat_repo["Seat repository"]
  node_employee_jdbc["Employee JDBC"]
  node_manager_jdbc["Manager JDBC"]
  node_schedule_jdbc["Schedule JDBC"]
  node_seat_jdbc["Seat JDBC"]
end

subgraph group_models["Domain data"]
end

node_employee(("Employee"))
node_manager(("Manager"))

node_employee -.->|"uses"| node_app
node_manager -.->|"uses"| node_app
node_app -->|"routes to"| node_employee_access
node_app -->|"routes to"| node_manager_access
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_schedule_ui
node_app -->|"routes to"| node_employee_profile
node_app -->|"routes to"| node_manager_profile
node_home -->|"renders"| node_huddle
node_home -->|"renders"| node_today
node_home -->|"renders"| node_weekly
node_employee_profile -->|"renders"| node_employee_days
node_employee_profile -->|"renders"| node_employee_schedule_form
node_manager_profile -->|"renders"| node_manager_check
node_manager_profile -->|"renders"| node_manager_list
node_manager_profile -->|"renders"| node_schedule_ui
node_manager_profile -->|"renders"| node_seats_ui
node_manager_check -->|"fetches employees"| node_employee_api
node_manager_check -->|"fetches schedules"| node_schedule_api
node_employee_api -->|"delegates"| node_employee_service
node_manager_api -->|"delegates"| node_manager_service
node_schedule_api -->|"delegates"| node_schedule_service
node_seat_api -->|"delegates"| node_seat_service
node_employee_service -->|"calls"| node_employee_repo
node_employee_service -->|"calls"| node_manager_repo
node_manager_service -->|"calls"| node_manager_repo
node_schedule_service -->|"calls"| node_schedule_repo
node_schedule_service -->|"checks employee"| node_employee_repo
node_schedule_service -->|"checks seat"| node_seat_repo
node_schedule_service -->|"uses"| node_manager_repo
node_seat_service -->|"calls"| node_seat_repo
node_employee_repo -.->|"implemented by"| node_employee_jdbc
node_manager_repo -->|"implemented by"| node_manager_jdbc
node_schedule_repo -->|"implemented by"| node_schedule_jdbc
node_seat_repo -.->|"implemented by"| node_seat_jdbc

click node_app "https://github.com/quisethecoder/capstone-md/blob/main/client/src/App.jsx"
click node_employee_access "https://github.com/quisethecoder/capstone-md/blob/main/client/src/components/EmployeeForm.jsx"
click node_manager_access "https://github.com/quisethecoder/capstone-md/blob/main/client/src/components/ManagerForm.jsx"
click node_home "https://github.com/quisethecoder/capstone-md/blob/main/client/src/components/Home.jsx"
click node_huddle "https://github.com/quisethecoder/capstone-md/blob/main/client/src/components/HuddleLeader.jsx"
click node_today "https://github.com/quisethecoder/capstone-md/blob/main/client/src/components/TodayTomorTable.jsx"
click node_weekly "https://github.com/quisethecoder/capstone-md/blob/main/client/src/components/WeeklyScheduleTable.jsx"
click node_schedule_ui "https://github.com/quisethecoder/capstone-md/blob/main/client/src/components/Schedule.jsx"
click node_employee_profile "https://github.com/quisethecoder/capstone-md/blob/main/client/src/components/EmployeeProfile.jsx"
click node_employee_days "https://github.com/quisethecoder/capstone-md/blob/main/client/src/components/EmployeeDaysOnsite.jsx"
click node_employee_schedule_form "https://github.com/quisethecoder/capstone-md/blob/main/client/src/components/EmployeeScheduleForm.jsx"
click node_manager_profile "https://github.com/quisethecoder/capstone-md/blob/main/client/src/components/ManagerProfile.jsx"
click node_manager_check "https://github.com/quisethecoder/capstone-md/blob/main/client/src/components/ManagerCheckEmployeeOnSchedule.jsx"
click node_manager_list "https://github.com/quisethecoder/capstone-md/blob/main/client/src/components/ManagerListOfEmployees.jsx"
click node_seats_ui "https://github.com/quisethecoder/capstone-md/blob/main/client/src/components/SeatsList.jsx"
click node_employee_api "https://github.com/quisethecoder/capstone-md/blob/main/server/src/main/java/learn/controller/EmployeeController.java"
click node_manager_api "https://github.com/quisethecoder/capstone-md/blob/main/server/src/main/java/learn/controller/ManagerController.java"
click node_schedule_api "https://github.com/quisethecoder/capstone-md/blob/main/server/src/main/java/learn/controller/ScheduleController.java"
click node_seat_api "https://github.com/quisethecoder/capstone-md/blob/main/server/src/main/java/learn/controller/SeatController.java"
click node_employee_service "https://github.com/quisethecoder/capstone-md/blob/main/server/src/main/java/learn/domain/EmployeeService.java"
click node_manager_service "https://github.com/quisethecoder/capstone-md/blob/main/server/src/main/java/learn/domain/ManagerService.java"
click node_schedule_service "https://github.com/quisethecoder/capstone-md/blob/main/server/src/main/java/learn/domain/ScheduleService.java"
click node_seat_service "https://github.com/quisethecoder/capstone-md/blob/main/server/src/main/java/learn/domain/SeatService.java"
click node_result "https://github.com/quisethecoder/capstone-md/blob/main/server/src/main/java/learn/domain/Result.java"
click node_employee_repo "https://github.com/quisethecoder/capstone-md/blob/main/server/src/main/java/learn/data/EmployeeRepository.java"
click node_manager_repo "https://github.com/quisethecoder/capstone-md/blob/main/server/src/main/java/learn/data/ManagerRepository.java"
click node_schedule_repo "https://github.com/quisethecoder/capstone-md/blob/main/server/src/main/java/learn/data/ScheduleRepository.java"
click node_seat_repo "https://github.com/quisethecoder/capstone-md/blob/main/server/src/main/java/learn/data/SeatRepository.java"
click node_employee_jdbc "https://github.com/quisethecoder/capstone-md/blob/main/server/src/main/java/learn/data/EmployeeJdbcClientRepository.java"
click node_manager_jdbc "https://github.com/quisethecoder/capstone-md/blob/main/server/src/main/java/learn/data/ManagerJdbcClientRepository.java"
click node_schedule_jdbc "https://github.com/quisethecoder/capstone-md/blob/main/server/src/main/java/learn/data/ScheduleJdbcClientRepository.java"
click node_seat_jdbc "https://github.com/quisethecoder/capstone-md/blob/main/server/src/main/java/learn/data/SeatJdbcClientRepository.java"

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_employee_access,node_manager_access,node_home,node_huddle,node_today,node_weekly,node_schedule_ui,node_employee_profile,node_employee_days,node_employee_schedule_form,node_manager_profile,node_manager_check,node_manager_list,node_seats_ui toneBlue
class node_employee_api,node_manager_api,node_schedule_api,node_seat_api toneAmber
class node_employee_service,node_manager_service,node_schedule_service,node_seat_service,node_result toneMint
class node_employee_repo,node_manager_repo,node_schedule_repo,node_seat_repo,node_employee_jdbc,node_manager_jdbc,node_schedule_jdbc,node_seat_jdbc toneRose
class node_employee,node_manager toneIndigo
```

## Components

### React client

- [Routes and session](https://github.com/quisethecoder/capstone-md/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Employee access](https://github.com/quisethecoder/capstone-md/blob/main/client/src/components/EmployeeForm.jsx): `client/src/components/EmployeeForm.jsx`
- [Manager access](https://github.com/quisethecoder/capstone-md/blob/main/client/src/components/ManagerForm.jsx): `client/src/components/ManagerForm.jsx`
- [Schedule overview](https://github.com/quisethecoder/capstone-md/blob/main/client/src/components/Home.jsx): `client/src/components/Home.jsx`
- [Huddle leaders](https://github.com/quisethecoder/capstone-md/blob/main/client/src/components/HuddleLeader.jsx): `client/src/components/HuddleLeader.jsx`
- [Today and tomorrow](https://github.com/quisethecoder/capstone-md/blob/main/client/src/components/TodayTomorTable.jsx): `client/src/components/TodayTomorTable.jsx`
- [Weekly schedule](https://github.com/quisethecoder/capstone-md/blob/main/client/src/components/WeeklyScheduleTable.jsx): `client/src/components/WeeklyScheduleTable.jsx`
- [Schedule management](https://github.com/quisethecoder/capstone-md/blob/main/client/src/components/Schedule.jsx): `client/src/components/Schedule.jsx`
- [Employee profile](https://github.com/quisethecoder/capstone-md/blob/main/client/src/components/EmployeeProfile.jsx): `client/src/components/EmployeeProfile.jsx`
- [Onsite days](https://github.com/quisethecoder/capstone-md/blob/main/client/src/components/EmployeeDaysOnsite.jsx): `client/src/components/EmployeeDaysOnsite.jsx`
- [Schedule editor](https://github.com/quisethecoder/capstone-md/blob/main/client/src/components/EmployeeScheduleForm.jsx): `client/src/components/EmployeeScheduleForm.jsx`
- [Manager profile](https://github.com/quisethecoder/capstone-md/blob/main/client/src/components/ManagerProfile.jsx): `client/src/components/ManagerProfile.jsx`
- [Monthly oversight](https://github.com/quisethecoder/capstone-md/blob/main/client/src/components/ManagerCheckEmployeeOnSchedule.jsx): `client/src/components/ManagerCheckEmployeeOnSchedule.jsx`
- [Employee management](https://github.com/quisethecoder/capstone-md/blob/main/client/src/components/ManagerListOfEmployees.jsx): `client/src/components/ManagerListOfEmployees.jsx`
- [Seat overview](https://github.com/quisethecoder/capstone-md/blob/main/client/src/components/SeatsList.jsx): `client/src/components/SeatsList.jsx`

### HTTP API

- [Employee API](https://github.com/quisethecoder/capstone-md/blob/main/server/src/main/java/learn/controller/EmployeeController.java): `server/src/main/java/learn/controller/EmployeeController.java`
- [Manager API](https://github.com/quisethecoder/capstone-md/blob/main/server/src/main/java/learn/controller/ManagerController.java): `server/src/main/java/learn/controller/ManagerController.java`
- [Schedule API](https://github.com/quisethecoder/capstone-md/blob/main/server/src/main/java/learn/controller/ScheduleController.java): `server/src/main/java/learn/controller/ScheduleController.java`
- [Seat API](https://github.com/quisethecoder/capstone-md/blob/main/server/src/main/java/learn/controller/SeatController.java): `server/src/main/java/learn/controller/SeatController.java`

### Domain services

- [Employee rules](https://github.com/quisethecoder/capstone-md/blob/main/server/src/main/java/learn/domain/EmployeeService.java): `server/src/main/java/learn/domain/EmployeeService.java`
- [Manager rules](https://github.com/quisethecoder/capstone-md/blob/main/server/src/main/java/learn/domain/ManagerService.java): `server/src/main/java/learn/domain/ManagerService.java`
- [Schedule validation](https://github.com/quisethecoder/capstone-md/blob/main/server/src/main/java/learn/domain/ScheduleService.java): `server/src/main/java/learn/domain/ScheduleService.java`
- [Seat operations](https://github.com/quisethecoder/capstone-md/blob/main/server/src/main/java/learn/domain/SeatService.java): `server/src/main/java/learn/domain/SeatService.java`
- [Operation results](https://github.com/quisethecoder/capstone-md/blob/main/server/src/main/java/learn/domain/Result.java): `server/src/main/java/learn/domain/Result.java`

### Persistence

- [Employee repository](https://github.com/quisethecoder/capstone-md/blob/main/server/src/main/java/learn/data/EmployeeRepository.java): `server/src/main/java/learn/data/EmployeeRepository.java`
- [Manager repository](https://github.com/quisethecoder/capstone-md/blob/main/server/src/main/java/learn/data/ManagerRepository.java): `server/src/main/java/learn/data/ManagerRepository.java`
- [Schedule repository](https://github.com/quisethecoder/capstone-md/blob/main/server/src/main/java/learn/data/ScheduleRepository.java): `server/src/main/java/learn/data/ScheduleRepository.java`
- [Seat repository](https://github.com/quisethecoder/capstone-md/blob/main/server/src/main/java/learn/data/SeatRepository.java): `server/src/main/java/learn/data/SeatRepository.java`
- [Employee JDBC](https://github.com/quisethecoder/capstone-md/blob/main/server/src/main/java/learn/data/EmployeeJdbcClientRepository.java): `server/src/main/java/learn/data/EmployeeJdbcClientRepository.java`
- [Manager JDBC](https://github.com/quisethecoder/capstone-md/blob/main/server/src/main/java/learn/data/ManagerJdbcClientRepository.java): `server/src/main/java/learn/data/ManagerJdbcClientRepository.java`
- [Schedule JDBC](https://github.com/quisethecoder/capstone-md/blob/main/server/src/main/java/learn/data/ScheduleJdbcClientRepository.java): `server/src/main/java/learn/data/ScheduleJdbcClientRepository.java`
- [Seat JDBC](https://github.com/quisethecoder/capstone-md/blob/main/server/src/main/java/learn/data/SeatJdbcClientRepository.java): `server/src/main/java/learn/data/SeatJdbcClientRepository.java`

### Other components

- **Employee**
- **Manager**

## Connections

- Employee → Routes and session: uses
- Manager → Routes and session: uses
- Routes and session → Employee access: routes to (evidence: `client/src/App.jsx`)
- Routes and session → Manager access: routes to (evidence: `client/src/App.jsx`)
- Routes and session → Schedule overview: routes to (evidence: `client/src/App.jsx`)
- Routes and session → Schedule management: routes to (evidence: `client/src/App.jsx`)
- Routes and session → Employee profile: routes to (evidence: `client/src/App.jsx`)
- Routes and session → Manager profile: routes to (evidence: `client/src/App.jsx`)
- Schedule overview → Huddle leaders: renders (evidence: `client/src/components/Home.jsx`)
- Schedule overview → Today and tomorrow: renders (evidence: `client/src/components/Home.jsx`)
- Schedule overview → Weekly schedule: renders (evidence: `client/src/components/Home.jsx`)
- Employee profile → Onsite days: renders (evidence: `client/src/components/EmployeeProfile.jsx`)
- Employee profile → Schedule editor: renders (evidence: `client/src/components/EmployeeProfile.jsx`)
- Manager profile → Monthly oversight: renders (evidence: `client/src/components/ManagerProfile.jsx`)
- Manager profile → Employee management: renders (evidence: `client/src/components/ManagerProfile.jsx`)
- Manager profile → Schedule management: renders (evidence: `client/src/components/ManagerProfile.jsx`)
- Manager profile → Seat overview: renders (evidence: `client/src/components/ManagerProfile.jsx`)
- Monthly oversight → Employee API: fetches employees (evidence: `client/src/components/ManagerCheckEmployeeOnSchedule.jsx`)
- Monthly oversight → Schedule API: fetches schedules (evidence: `client/src/components/ManagerCheckEmployeeOnSchedule.jsx`)
- Employee API → Employee rules: delegates (evidence: `server/src/main/java/learn/controller/EmployeeController.java`)
- Manager API → Manager rules: delegates (evidence: `server/src/main/java/learn/controller/ManagerController.java`)
- Schedule API → Schedule validation: delegates (evidence: `server/src/main/java/learn/controller/ScheduleController.java`)
- Seat API → Seat operations: delegates (evidence: `server/src/main/java/learn/controller/SeatController.java`)
- Employee rules → Employee repository: calls (evidence: `server/src/main/java/learn/domain/EmployeeService.java`)
- Employee rules → Manager repository: calls (evidence: `server/src/main/java/learn/domain/EmployeeService.java`)
- Manager rules → Manager repository: calls (evidence: `server/src/main/java/learn/domain/ManagerService.java`)
- Schedule validation → Schedule repository: calls (evidence: `server/src/main/java/learn/domain/ScheduleService.java`)
- Schedule validation → Employee repository: checks employee (evidence: `server/src/main/java/learn/domain/ScheduleService.java`)
- Schedule validation → Seat repository: checks seat (evidence: `server/src/main/java/learn/domain/ScheduleService.java`)
- Schedule validation → Manager repository: uses (evidence: `server/src/main/java/learn/domain/ScheduleService.java`)
- Seat operations → Seat repository: calls (evidence: `server/src/main/java/learn/domain/SeatService.java`)
- Employee repository → Employee JDBC: implemented by
- Manager repository → Manager JDBC: implemented by (evidence: `server/src/main/java/learn/data/ManagerJdbcClientRepository.java`)
- Schedule repository → Schedule JDBC: implemented by (evidence: `server/src/main/java/learn/data/ScheduleJdbcClientRepository.java`)
- Seat repository → Seat JDBC: implemented by
