# hiptran24/smart-recruitment-platform architecture

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

- Interactive diagram: https://gitdiagram.com/hiptran24/smart-recruitment-platform
- Repository: https://github.com/hiptran24/smart-recruitment-platform

## Overview

Smart Recruitment is a recruitment-platform foundation: its backend defines persisted identity, candidate, company, job, and application domains with lifecycle rules, while the frontend is an admin-console UI currently backed by mock data. The visible user workflow is navigation through recruiter and administrative views to inspect recruiting operations and manage platform domains. The README describes a secure-by-default HTTP boundary, but authenticated business APIs are not yet implemented. Backend coverage is therefore modeled as domain persistence and security configuration, not as an end-to-end recruitment API; unsampled capabilities are shown only where documented.

Main entry points: [`frontend/src/App.tsx`](https://github.com/hiptran24/smart-recruitment-platform/blob/main/frontend/src/App.tsx) (Console router), [`frontend/src/data/mock.ts`](https://github.com/hiptran24/smart-recruitment-platform/blob/main/frontend/src/data/mock.ts) (Mock domain data), [`src/main/java/com/recruitment/app/common/infrastructure/persistence/BaseEntity.java`](https://github.com/hiptran24/smart-recruitment-platform/blob/main/src/main/java/com/recruitment/app/common/infrastructure/persistence/BaseEntity.java) (Persistence base), [`src/main/java/com/recruitment/app/modules/applications/infrastructure/persistence/entity/JobApplication.java`](https://github.com/hiptran24/smart-recruitment-platform/blob/main/src/main/java/com/recruitment/app/modules/applications/infrastructure/persistence/entity/JobApplication.java) (Application lifecycle)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Admin console"]
  node_admin["Console router<br/>[App.tsx]"]
  node_layout["Admin shell<br/>[AdminLayout.tsx]"]
  node_dashboard["Recruiter dashboard"]
  node_admin_console["Platform console<br/>[AdminConsole.tsx]"]
  node_jobs_ui["Job management<br/>[JobManagement.tsx]"]
  node_applications_ui["Application management"]
  node_candidates_ui["Candidate directory"]
  node_users_ui["User directory<br/>[UserDirectory.tsx]"]
  node_roles_ui["Role management"]
  node_skills_ui["Skill taxonomy<br/>[SkillTaxonomy.tsx]"]
  node_audit_ui["Audit explorer"]
  node_settings_ui["Settings"]
  node_mock_data[("Mock domain data<br/>[mock.ts]")]
  node_types["UI domain types<br/>[index.ts]"]
end

subgraph group_backend["Backend foundation"]
  node_app_runtime["Spring Boot runtime<br/>[Application.java]"]
  node_http_security["HTTP security boundary"]
end

subgraph group_domains["Recruitment domains"]
  node_identity[("Identity records<br/>[User.java]")]
  node_candidate[("Candidate profile")]
  node_candidate_details[("Candidate details")]
  node_company[("Company records<br/>[Company.java]")]
  node_jobs[("Job records<br/>[Job.java]")]
  node_applications[("Application lifecycle")]
  node_screening[("Application screening")]
  node_status_history[("Status history")]
end

subgraph group_shared["Shared infrastructure"]
  node_base_entity["Persistence base<br/>[BaseEntity.java]"]
end

node_operator(("Console user"))
node_http_client(("HTTP client"))
node_mysql[("MySQL")]

node_operator -->|"opens console"| node_admin
node_admin -->|"wraps routes"| node_layout
node_admin -->|"routes to"| node_dashboard
node_admin -->|"routes to"| node_admin_console
node_admin -->|"routes to"| node_jobs_ui
node_admin -->|"routes to"| node_applications_ui
node_admin -->|"routes to"| node_candidates_ui
node_admin -->|"routes to"| node_users_ui
node_admin -->|"routes to"| node_roles_ui
node_admin -->|"routes to"| node_skills_ui
node_admin -->|"routes to"| node_audit_ui
node_admin -->|"routes to"| node_settings_ui
node_layout -.->|"presents UI"| node_operator
node_dashboard -->|"reads"| node_mock_data
node_admin_console -->|"reads"| node_mock_data
node_users_ui -->|"reads"| node_mock_data
node_applications_ui -->|"reads"| node_mock_data
node_audit_ui -->|"reads"| node_mock_data
node_mock_data -->|"uses types"| node_types
node_app_runtime -.->|"configures boundary"| node_http_security
node_http_client -->|"meets boundary"| node_http_security
node_identity -->|"extends"| node_base_entity
node_candidate -->|"extends"| node_base_entity
node_candidate -->|"owns details"| node_candidate_details
node_company -->|"extends"| node_base_entity
node_jobs -->|"extends"| node_base_entity
node_applications -->|"extends"| node_base_entity
node_applications -->|"records transitions"| node_status_history
node_applications -->|"has screenings"| node_screening
node_mysql -.->|"persists schema"| node_identity
node_mysql -.->|"persists schema"| node_candidate
node_mysql -.->|"persists schema"| node_company
node_mysql -.->|"persists schema"| node_jobs
node_mysql -.->|"persists schema"| node_applications

click node_admin "https://github.com/hiptran24/smart-recruitment-platform/blob/main/frontend/src/App.tsx"
click node_layout "https://github.com/hiptran24/smart-recruitment-platform/blob/main/frontend/src/components/layout/AdminLayout.tsx"
click node_dashboard "https://github.com/hiptran24/smart-recruitment-platform/blob/main/frontend/src/pages/RecruiterDashboard.tsx"
click node_admin_console "https://github.com/hiptran24/smart-recruitment-platform/blob/main/frontend/src/pages/AdminConsole.tsx"
click node_jobs_ui "https://github.com/hiptran24/smart-recruitment-platform/blob/main/frontend/src/pages/JobManagement.tsx"
click node_applications_ui "https://github.com/hiptran24/smart-recruitment-platform/blob/main/frontend/src/pages/ApplicationManagement.tsx"
click node_candidates_ui "https://github.com/hiptran24/smart-recruitment-platform/blob/main/frontend/src/pages/CandidateDirectory.tsx"
click node_users_ui "https://github.com/hiptran24/smart-recruitment-platform/blob/main/frontend/src/pages/UserDirectory.tsx"
click node_roles_ui "https://github.com/hiptran24/smart-recruitment-platform/blob/main/frontend/src/pages/UserRoleManagement.tsx"
click node_skills_ui "https://github.com/hiptran24/smart-recruitment-platform/blob/main/frontend/src/pages/SkillTaxonomy.tsx"
click node_audit_ui "https://github.com/hiptran24/smart-recruitment-platform/blob/main/frontend/src/pages/AuditEventExplorer.tsx"
click node_settings_ui "https://github.com/hiptran24/smart-recruitment-platform/blob/main/frontend/src/pages/SettingsConfiguration.tsx"
click node_mock_data "https://github.com/hiptran24/smart-recruitment-platform/blob/main/frontend/src/data/mock.ts"
click node_types "https://github.com/hiptran24/smart-recruitment-platform/blob/main/frontend/src/types/index.ts"
click node_app_runtime "https://github.com/hiptran24/smart-recruitment-platform/blob/main/src/main/java/com/recruitment/app/Application.java"
click node_http_security "https://github.com/hiptran24/smart-recruitment-platform/blob/main/src/main/java/com/recruitment/app/common/security/SecurityConfiguration.java"
click node_identity "https://github.com/hiptran24/smart-recruitment-platform/blob/main/src/main/java/com/recruitment/app/modules/identity/infrastructure/persistence/entity/User.java"
click node_candidate "https://github.com/hiptran24/smart-recruitment-platform/blob/main/src/main/java/com/recruitment/app/modules/candidates/infrastructure/persistence/entity/CandidateProfile.java"
click node_candidate_details "https://github.com/hiptran24/smart-recruitment-platform/blob/main/src/main/java/com/recruitment/app/modules/candidates/infrastructure/persistence/entity/CandidateEducation.java"
click node_company "https://github.com/hiptran24/smart-recruitment-platform/blob/main/src/main/java/com/recruitment/app/modules/companies/infrastructure/persistence/entity/Company.java"
click node_jobs "https://github.com/hiptran24/smart-recruitment-platform/blob/main/src/main/java/com/recruitment/app/modules/jobs/infrastructure/persistence/entity/Job.java"
click node_applications "https://github.com/hiptran24/smart-recruitment-platform/blob/main/src/main/java/com/recruitment/app/modules/applications/infrastructure/persistence/entity/JobApplication.java"
click node_screening "https://github.com/hiptran24/smart-recruitment-platform/blob/main/src/main/java/com/recruitment/app/modules/applications/infrastructure/persistence/entity/ApplicationScreening.java"
click node_status_history "https://github.com/hiptran24/smart-recruitment-platform/blob/main/src/main/java/com/recruitment/app/modules/applications/infrastructure/persistence/entity/ApplicationStatusHistory.java"
click node_base_entity "https://github.com/hiptran24/smart-recruitment-platform/blob/main/src/main/java/com/recruitment/app/common/infrastructure/persistence/BaseEntity.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_admin,node_layout,node_dashboard,node_admin_console,node_jobs_ui,node_applications_ui,node_candidates_ui,node_users_ui,node_roles_ui,node_skills_ui,node_audit_ui,node_settings_ui,node_mock_data,node_types,node_operator,node_http_client toneBlue
class node_app_runtime,node_http_security,node_mysql toneAmber
class node_identity,node_candidate,node_candidate_details,node_company,node_jobs,node_applications,node_screening,node_status_history toneMint
class node_base_entity toneRose
```

## Components

### Admin console

- [Console router](https://github.com/hiptran24/smart-recruitment-platform/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Admin shell](https://github.com/hiptran24/smart-recruitment-platform/blob/main/frontend/src/components/layout/AdminLayout.tsx): `frontend/src/components/layout/AdminLayout.tsx`
- [Recruiter dashboard](https://github.com/hiptran24/smart-recruitment-platform/blob/main/frontend/src/pages/RecruiterDashboard.tsx): `frontend/src/pages/RecruiterDashboard.tsx`
- [Platform console](https://github.com/hiptran24/smart-recruitment-platform/blob/main/frontend/src/pages/AdminConsole.tsx): `frontend/src/pages/AdminConsole.tsx`
- [Job management](https://github.com/hiptran24/smart-recruitment-platform/blob/main/frontend/src/pages/JobManagement.tsx): `frontend/src/pages/JobManagement.tsx`
- [Application management](https://github.com/hiptran24/smart-recruitment-platform/blob/main/frontend/src/pages/ApplicationManagement.tsx): `frontend/src/pages/ApplicationManagement.tsx`
- [Candidate directory](https://github.com/hiptran24/smart-recruitment-platform/blob/main/frontend/src/pages/CandidateDirectory.tsx): `frontend/src/pages/CandidateDirectory.tsx`
- [User directory](https://github.com/hiptran24/smart-recruitment-platform/blob/main/frontend/src/pages/UserDirectory.tsx): `frontend/src/pages/UserDirectory.tsx`
- [Role management](https://github.com/hiptran24/smart-recruitment-platform/blob/main/frontend/src/pages/UserRoleManagement.tsx): `frontend/src/pages/UserRoleManagement.tsx`
- [Skill taxonomy](https://github.com/hiptran24/smart-recruitment-platform/blob/main/frontend/src/pages/SkillTaxonomy.tsx): `frontend/src/pages/SkillTaxonomy.tsx`
- [Audit explorer](https://github.com/hiptran24/smart-recruitment-platform/blob/main/frontend/src/pages/AuditEventExplorer.tsx): `frontend/src/pages/AuditEventExplorer.tsx`
- [Settings](https://github.com/hiptran24/smart-recruitment-platform/blob/main/frontend/src/pages/SettingsConfiguration.tsx): `frontend/src/pages/SettingsConfiguration.tsx`
- [Mock domain data](https://github.com/hiptran24/smart-recruitment-platform/blob/main/frontend/src/data/mock.ts): `frontend/src/data/mock.ts`
- [UI domain types](https://github.com/hiptran24/smart-recruitment-platform/blob/main/frontend/src/types/index.ts): `frontend/src/types/index.ts`

### Backend foundation

- [Spring Boot runtime](https://github.com/hiptran24/smart-recruitment-platform/blob/main/src/main/java/com/recruitment/app/Application.java): `src/main/java/com/recruitment/app/Application.java`
- [HTTP security boundary](https://github.com/hiptran24/smart-recruitment-platform/blob/main/src/main/java/com/recruitment/app/common/security/SecurityConfiguration.java): `src/main/java/com/recruitment/app/common/security/SecurityConfiguration.java`

### Recruitment domains

- [Identity records](https://github.com/hiptran24/smart-recruitment-platform/blob/main/src/main/java/com/recruitment/app/modules/identity/infrastructure/persistence/entity/User.java): `src/main/java/com/recruitment/app/modules/identity/infrastructure/persistence/entity/User.java`
- [Candidate profile](https://github.com/hiptran24/smart-recruitment-platform/blob/main/src/main/java/com/recruitment/app/modules/candidates/infrastructure/persistence/entity/CandidateProfile.java): `src/main/java/com/recruitment/app/modules/candidates/infrastructure/persistence/entity/CandidateProfile.java`
- [Candidate details](https://github.com/hiptran24/smart-recruitment-platform/blob/main/src/main/java/com/recruitment/app/modules/candidates/infrastructure/persistence/entity/CandidateEducation.java): `src/main/java/com/recruitment/app/modules/candidates/infrastructure/persistence/entity/CandidateEducation.java`
- [Company records](https://github.com/hiptran24/smart-recruitment-platform/blob/main/src/main/java/com/recruitment/app/modules/companies/infrastructure/persistence/entity/Company.java): `src/main/java/com/recruitment/app/modules/companies/infrastructure/persistence/entity/Company.java`
- [Job records](https://github.com/hiptran24/smart-recruitment-platform/blob/main/src/main/java/com/recruitment/app/modules/jobs/infrastructure/persistence/entity/Job.java): `src/main/java/com/recruitment/app/modules/jobs/infrastructure/persistence/entity/Job.java`
- [Application lifecycle](https://github.com/hiptran24/smart-recruitment-platform/blob/main/src/main/java/com/recruitment/app/modules/applications/infrastructure/persistence/entity/JobApplication.java): `src/main/java/com/recruitment/app/modules/applications/infrastructure/persistence/entity/JobApplication.java`
- [Application screening](https://github.com/hiptran24/smart-recruitment-platform/blob/main/src/main/java/com/recruitment/app/modules/applications/infrastructure/persistence/entity/ApplicationScreening.java): `src/main/java/com/recruitment/app/modules/applications/infrastructure/persistence/entity/ApplicationScreening.java`
- [Status history](https://github.com/hiptran24/smart-recruitment-platform/blob/main/src/main/java/com/recruitment/app/modules/applications/infrastructure/persistence/entity/ApplicationStatusHistory.java): `src/main/java/com/recruitment/app/modules/applications/infrastructure/persistence/entity/ApplicationStatusHistory.java`

### Shared infrastructure

- [Persistence base](https://github.com/hiptran24/smart-recruitment-platform/blob/main/src/main/java/com/recruitment/app/common/infrastructure/persistence/BaseEntity.java): `src/main/java/com/recruitment/app/common/infrastructure/persistence/BaseEntity.java`

### Other components

- **Console user**
- **HTTP client**
- **MySQL**

## Connections

- Console user → Console router: opens console (evidence: `frontend/src/App.tsx`)
- Console router → Admin shell: wraps routes (evidence: `frontend/src/App.tsx`)
- Console router → Recruiter dashboard: routes to (evidence: `frontend/src/App.tsx`)
- Console router → Platform console: routes to (evidence: `frontend/src/App.tsx`)
- Console router → Job management: routes to (evidence: `frontend/src/App.tsx`)
- Console router → Application management: routes to (evidence: `frontend/src/App.tsx`)
- Console router → Candidate directory: routes to (evidence: `frontend/src/App.tsx`)
- Console router → User directory: routes to (evidence: `frontend/src/App.tsx`)
- Console router → Role management: routes to (evidence: `frontend/src/App.tsx`)
- Console router → Skill taxonomy: routes to (evidence: `frontend/src/App.tsx`)
- Console router → Audit explorer: routes to (evidence: `frontend/src/App.tsx`)
- Console router → Settings: routes to (evidence: `frontend/src/App.tsx`)
- Admin shell → Console user: presents UI (evidence: `frontend/src/components/layout/AdminLayout.tsx`)
- Recruiter dashboard → Mock domain data: reads (evidence: `frontend/src/pages/RecruiterDashboard.tsx`)
- Platform console → Mock domain data: reads (evidence: `frontend/src/pages/AdminConsole.tsx`)
- User directory → Mock domain data: reads (evidence: `frontend/src/pages/UserDirectory.tsx`)
- Application management → Mock domain data: reads (evidence: `frontend/src/pages/ApplicationManagement.tsx`)
- Audit explorer → Mock domain data: reads (evidence: `frontend/src/pages/AuditEventExplorer.tsx`)
- Mock domain data → UI domain types: uses types (evidence: `frontend/src/data/mock.ts`)
- Spring Boot runtime → HTTP security boundary: configures boundary
- HTTP client → HTTP security boundary: meets boundary (evidence: `README.md`)
- Identity records → Persistence base: extends (evidence: `src/main/java/com/recruitment/app/modules/identity/infrastructure/persistence/entity/User.java`)
- Candidate profile → Persistence base: extends (evidence: `src/main/java/com/recruitment/app/modules/candidates/infrastructure/persistence/entity/CandidateProfile.java`)
- Candidate profile → Candidate details: owns details (evidence: `src/main/java/com/recruitment/app/modules/candidates/infrastructure/persistence/entity/CandidateProfile.java`)
- Company records → Persistence base: extends (evidence: `src/main/java/com/recruitment/app/modules/companies/infrastructure/persistence/entity/Company.java`)
- Job records → Persistence base: extends (evidence: `src/main/java/com/recruitment/app/modules/jobs/infrastructure/persistence/entity/Job.java`)
- Application lifecycle → Persistence base: extends (evidence: `src/main/java/com/recruitment/app/modules/applications/infrastructure/persistence/entity/JobApplication.java`)
- Application lifecycle → Status history: records transitions (evidence: `src/main/java/com/recruitment/app/modules/applications/infrastructure/persistence/entity/JobApplication.java`)
- Application lifecycle → Application screening: has screenings (evidence: `src/main/java/com/recruitment/app/modules/applications/infrastructure/persistence/entity/ApplicationScreening.java`)
- MySQL → Identity records: persists schema (evidence: `README.md`)
- MySQL → Candidate profile: persists schema (evidence: `README.md`)
- MySQL → Company records: persists schema (evidence: `README.md`)
- MySQL → Job records: persists schema (evidence: `README.md`)
- MySQL → Application lifecycle: persists schema (evidence: `README.md`)
