# avaldesv/smarthire architecture

> Architecture diagram of the GitHub repository avaldesv/smarthire, 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/avaldesv/smarthire
- Repository: https://github.com/avaldesv/smarthire

## Overview

Smart Hire is an Angular recruiter portal covering requisitions, candidate management, selection, pipeline tracking, reports, and administration. The documented user flow starts with sign-in, then moves through requisition creation and hiring stages to tracking and reporting; settings configure the surrounding catalogs and workflows. The README describes mock data, while sampled services make HTTP requests, so the implementation’s data mode may vary or the README may be stale. Edges reflect documented routes and sampled calls; unsampled feature internals are represented at their directory paths.

Main entry points: [`src/app/app.routes.ts`](https://github.com/avaldesv/smarthire/blob/main/src/app/app.routes.ts) (Route and guards), [`src/app/core/services/catalog-pipeline-stage.service.ts`](https://github.com/avaldesv/smarthire/blob/main/src/app/core/services/catalog-pipeline-stage.service.ts) (Stage catalog API), [`src/app/features/settings/pipeline-stages/pipeline-stages.component.ts`](https://github.com/avaldesv/smarthire/blob/main/src/app/features/settings/pipeline-stages/pipeline-stages.component.ts) (Pipeline stages), [`src/main.ts`](https://github.com/avaldesv/smarthire/blob/main/src/main.ts) (Application bootstrap)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and shell"]
  node_app["Application bootstrap<br/>[main.ts]"]
  node_routes["Route and guards<br/>[app.routes.ts]"]
  node_auth["Authentication<br/>[auth.service.ts]"]
  node_shell["Portal shell<br/>[shell.component.ts]"]
end

subgraph group_hiring["Hiring workflow"]
  node_dashboard["Dashboard"]
  node_positions["Requisitions"]
  node_wizard["Position wizard"]
  node_candidates["Candidate pool"]
  node_candidate_profile["Candidate profiles"]
end

subgraph group_evaluation["Evaluation and tracking"]
  node_selection["AI selection"]
  node_questionnaires["Questionnaires"]
  node_tracking["Pipeline tracking"]
end

subgraph group_admin["Administration and insights"]
  node_settings["Administration"]
  node_reports["Reports"]
  node_catalog_stages["Pipeline stages"]
end

subgraph group_platform["Shared platform"]
  node_applications_api["Application API client"]
  node_api{{"Backend API"}}
  node_stage_service["Stage catalog API"]
  node_api_client["API configuration"]
  node_feedback["Feedback dialogs"]
end

node_recruiter(("Recruiter"))

node_recruiter -->|"opens portal"| node_app
node_app -->|"bootstraps"| node_routes
node_routes -->|"guards access"| node_auth
node_routes -->|"loads shell"| node_shell
node_routes -->|"routes to"| node_dashboard
node_routes -->|"routes to"| node_positions
node_routes -->|"routes to"| node_wizard
node_routes -->|"routes to"| node_candidates
node_routes -->|"routes to"| node_candidate_profile
node_routes -->|"routes to"| node_selection
node_routes -->|"routes to"| node_questionnaires
node_routes -->|"routes to"| node_tracking
node_routes -->|"routes to"| node_reports
node_routes -->|"routes to"| node_settings
node_auth -->|"authenticates with"| node_api
node_wizard -.->|"loads and saves"| node_api
node_tracking -->|"loads applications"| node_applications_api
node_applications_api -.->|"requests data"| node_api
node_catalog_stages -->|"manages stages"| node_stage_service
node_stage_service -->|"reads and writes"| node_api
node_stage_service -->|"builds request URLs"| node_api_client
node_catalog_stages -->|"shows outcomes"| node_feedback

click node_app "https://github.com/avaldesv/smarthire/blob/main/src/main.ts"
click node_routes "https://github.com/avaldesv/smarthire/blob/main/src/app/app.routes.ts"
click node_auth "https://github.com/avaldesv/smarthire/blob/main/src/app/core/services/auth.service.ts"
click node_shell "https://github.com/avaldesv/smarthire/blob/main/src/app/core/layout/shell.component.ts"
click node_dashboard "https://github.com/avaldesv/smarthire/blob/main/src/app/features/home/dashboard/dashboard.component.ts"
click node_positions "https://github.com/avaldesv/smarthire/blob/main/src/app/features/positions/list/positions-list.component.ts"
click node_wizard "https://github.com/avaldesv/smarthire/blob/main/src/app/features/positions/wizard/position-wizard.component.ts"
click node_candidates "https://github.com/avaldesv/smarthire/blob/main/src/app/features/candidates/list/candidates-list.component.ts"
click node_candidate_profile "https://github.com/avaldesv/smarthire/blob/main/src/app/features/candidates/profile/candidate-profile.component.ts"
click node_selection "https://github.com/avaldesv/smarthire/tree/main/src/app/features/selection"
click node_questionnaires "https://github.com/avaldesv/smarthire/tree/main/src/app/features/questionnaires"
click node_tracking "https://github.com/avaldesv/smarthire/blob/main/src/app/features/tracking/pipeline/tracking-pipeline.component.ts"
click node_applications_api "https://github.com/avaldesv/smarthire/blob/main/src/app/core/services/candidate-application-api.service.ts"
click node_settings "https://github.com/avaldesv/smarthire/tree/main/src/app/features/settings"
click node_reports "https://github.com/avaldesv/smarthire/tree/main/src/app/features/reports"
click node_catalog_stages "https://github.com/avaldesv/smarthire/blob/main/src/app/features/settings/pipeline-stages/pipeline-stages.component.ts"
click node_stage_service "https://github.com/avaldesv/smarthire/blob/main/src/app/core/services/catalog-pipeline-stage.service.ts"
click node_api_client "https://github.com/avaldesv/smarthire/blob/main/src/app/core/services/api-client.service.ts"
click node_feedback "https://github.com/avaldesv/smarthire/blob/main/src/app/core/feedback/feedback-dialog.service.ts"

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_routes,node_auth,node_shell toneBlue
class node_dashboard,node_positions,node_wizard,node_candidates,node_candidate_profile toneAmber
class node_selection,node_questionnaires,node_tracking toneMint
class node_settings,node_reports,node_catalog_stages toneRose
class node_applications_api,node_api,node_stage_service,node_api_client,node_feedback,node_recruiter toneIndigo
```

## Components

### Access and shell

- [Application bootstrap](https://github.com/avaldesv/smarthire/blob/main/src/main.ts): `src/main.ts`
- [Route and guards](https://github.com/avaldesv/smarthire/blob/main/src/app/app.routes.ts): `src/app/app.routes.ts`
- [Authentication](https://github.com/avaldesv/smarthire/blob/main/src/app/core/services/auth.service.ts): `src/app/core/services/auth.service.ts`
- [Portal shell](https://github.com/avaldesv/smarthire/blob/main/src/app/core/layout/shell.component.ts): `src/app/core/layout/shell.component.ts`

### Hiring workflow

- [Dashboard](https://github.com/avaldesv/smarthire/blob/main/src/app/features/home/dashboard/dashboard.component.ts): `src/app/features/home/dashboard/dashboard.component.ts`
- [Requisitions](https://github.com/avaldesv/smarthire/blob/main/src/app/features/positions/list/positions-list.component.ts): `src/app/features/positions/list/positions-list.component.ts`
- [Position wizard](https://github.com/avaldesv/smarthire/blob/main/src/app/features/positions/wizard/position-wizard.component.ts): `src/app/features/positions/wizard/position-wizard.component.ts`
- [Candidate pool](https://github.com/avaldesv/smarthire/blob/main/src/app/features/candidates/list/candidates-list.component.ts): `src/app/features/candidates/list/candidates-list.component.ts`
- [Candidate profiles](https://github.com/avaldesv/smarthire/blob/main/src/app/features/candidates/profile/candidate-profile.component.ts): `src/app/features/candidates/profile/candidate-profile.component.ts`

### Evaluation and tracking

- [AI selection](https://github.com/avaldesv/smarthire/tree/main/src/app/features/selection): `src/app/features/selection`
- [Questionnaires](https://github.com/avaldesv/smarthire/tree/main/src/app/features/questionnaires): `src/app/features/questionnaires`
- [Pipeline tracking](https://github.com/avaldesv/smarthire/blob/main/src/app/features/tracking/pipeline/tracking-pipeline.component.ts): `src/app/features/tracking/pipeline/tracking-pipeline.component.ts`

### Administration and insights

- [Administration](https://github.com/avaldesv/smarthire/tree/main/src/app/features/settings): `src/app/features/settings`
- [Reports](https://github.com/avaldesv/smarthire/tree/main/src/app/features/reports): `src/app/features/reports`
- [Pipeline stages](https://github.com/avaldesv/smarthire/blob/main/src/app/features/settings/pipeline-stages/pipeline-stages.component.ts): `src/app/features/settings/pipeline-stages/pipeline-stages.component.ts`

### Shared platform

- [Application API client](https://github.com/avaldesv/smarthire/blob/main/src/app/core/services/candidate-application-api.service.ts): `src/app/core/services/candidate-application-api.service.ts`
- **Backend API**
- [Stage catalog API](https://github.com/avaldesv/smarthire/blob/main/src/app/core/services/catalog-pipeline-stage.service.ts): `src/app/core/services/catalog-pipeline-stage.service.ts`
- [API configuration](https://github.com/avaldesv/smarthire/blob/main/src/app/core/services/api-client.service.ts): `src/app/core/services/api-client.service.ts`
- [Feedback dialogs](https://github.com/avaldesv/smarthire/blob/main/src/app/core/feedback/feedback-dialog.service.ts): `src/app/core/feedback/feedback-dialog.service.ts`

### Other components

- **Recruiter**

## Connections

- Recruiter → Application bootstrap: opens portal (evidence: `README.md`)
- Application bootstrap → Route and guards: bootstraps (evidence: `src/main.ts`)
- Route and guards → Authentication: guards access (evidence: `src/app/app.routes.ts`)
- Route and guards → Portal shell: loads shell (evidence: `src/app/app.routes.ts`)
- Route and guards → Dashboard: routes to (evidence: `src/app/app.routes.ts`)
- Route and guards → Requisitions: routes to (evidence: `src/app/app.routes.ts`)
- Route and guards → Position wizard: routes to (evidence: `src/app/app.routes.ts`)
- Route and guards → Candidate pool: routes to (evidence: `src/app/app.routes.ts`)
- Route and guards → Candidate profiles: routes to (evidence: `src/app/app.routes.ts`)
- Route and guards → AI selection: routes to (evidence: `README.md`)
- Route and guards → Questionnaires: routes to (evidence: `src/app/app.routes.ts`)
- Route and guards → Pipeline tracking: routes to (evidence: `src/app/app.routes.ts`)
- Route and guards → Reports: routes to (evidence: `src/app/app.routes.ts`)
- Route and guards → Administration: routes to (evidence: `README.md`)
- Authentication → Backend API: authenticates with (evidence: `src/app/core/services/auth.service.ts`)
- Position wizard → Backend API: loads and saves
- Pipeline tracking → Application API client: loads applications (evidence: `src/app/features/tracking/pipeline/tracking-pipeline.component.ts`)
- Application API client → Backend API: requests data
- Pipeline stages → Stage catalog API: manages stages (evidence: `src/app/features/settings/pipeline-stages/pipeline-stages.component.ts`)
- Stage catalog API → Backend API: reads and writes (evidence: `src/app/core/services/catalog-pipeline-stage.service.ts`)
- Stage catalog API → API configuration: builds request URLs (evidence: `src/app/core/services/catalog-pipeline-stage.service.ts`)
- Pipeline stages → Feedback dialogs: shows outcomes (evidence: `src/app/features/settings/pipeline-stages/pipeline-stages.component.ts`)
