# tadegmor/tp-disenio architecture

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

## Overview

Capital Humano is a candidate evaluation and question-management application: HR users find candidates and a job, check eligibility, prepare access keys, then finalize an evaluation that creates active questionnaires. It also supports question search and logical deactivation, while the backend exposes job competency/evaluability data. The graph connects only relationships visible in the supplied excerpts, source index, or README; unsampled integrations and evaluation stages are not inferred.

Main entry points: [`capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/service/EvaluacionService.java`](https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/service/EvaluacionService.java) (Evaluation orchestration), [`capital-humano/frontend/app/components/EvaluarCandidato.tsx`](https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/frontend/app/components/EvaluarCandidato.tsx) (Evaluation workflow), [`capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/model/Cuestionario.java`](https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/model/Cuestionario.java) (Questionnaire lifecycle), [`capital-humano/frontend/app/components/GestionPreguntas.tsx`](https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/frontend/app/components/GestionPreguntas.tsx) (Question management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["HR web app"]
  node_evaluation_ui["Evaluation workflow"]
  node_evaluation_page["Evaluation page<br/>[page.tsx]"]
  node_evaluation_types["Evaluation contracts<br/>[evaluacion.ts]"]
  node_question_ui["Question management"]
  node_question_hook["Question workflow state"]
  node_question_pages["Question pages<br/>[page.tsx]"]
  node_evaluation_api["Evaluation API client<br/>[evaluacionesApi.ts]"]
  node_question_api["Question API client<br/>[preguntasApi.ts]"]
end

subgraph group_api["Backend API"]
  node_evaluation_controller["Evaluation endpoints"]
  node_question_controller["Question endpoints"]
  node_exception_handler["API error mapping"]
end

subgraph group_domain["Evaluation domain"]
  node_evaluation_service["Evaluation orchestration"]
  node_questionnaire["Questionnaire lifecycle<br/>[Cuestionario.java]"]
  node_evaluation_model["Evaluation records<br/>[Evaluacion.java]"]
  node_candidate_model["Candidates<br/>[Candidato.java]"]
end

subgraph group_catalog["Question and job catalog"]
  node_job_service["Job competency checks<br/>[PuestoService.java]"]
  node_question_service["Question search"]
  node_question_model["Question catalog<br/>[Pregunta.java]"]
  node_job_model["Job requirements"]
end

subgraph group_persistence["Persistence"]
  node_candidate_store[("Candidate repository")]
  node_questionnaire_store[("Questionnaire repository")]
  node_evaluation_store[("Evaluation repository")]
  node_question_store[("Question repository")]
  node_job_store[("Job repository")]
end

node_hr(("HR user"))

node_hr -->|"uses"| node_evaluation_ui
node_evaluation_page -->|"renders"| node_evaluation_ui
node_evaluation_ui -->|"requests"| node_evaluation_api
node_evaluation_ui -->|"uses types"| node_evaluation_types
node_evaluation_api -.->|"HTTP calls"| node_evaluation_controller
node_evaluation_controller -->|"delegates"| node_evaluation_service
node_evaluation_service -->|"queries"| node_candidate_store
node_evaluation_service -->|"checks and saves"| node_questionnaire_store
node_evaluation_service -.->|"saves"| node_evaluation_store
node_evaluation_service -->|"creates active"| node_questionnaire
node_evaluation_service -.->|"builds"| node_evaluation_model
node_questionnaire -->|"references"| node_evaluation_model
node_questionnaire -->|"references"| node_candidate_model
node_hr -.->|"uses"| node_question_ui
node_question_pages -->|"renders"| node_question_ui
node_question_ui -.->|"manages via"| node_question_hook
node_question_hook -->|"calls"| node_question_api
node_question_api -.->|"HTTP calls"| node_question_controller
node_question_controller -->|"delegates"| node_question_service
node_question_service -->|"queries and deletes"| node_question_store
node_question_store -->|"persists"| node_question_model
node_job_service -->|"queries"| node_job_store
node_job_service -->|"checks evaluability"| node_question_store
node_exception_handler -.->|"formats errors"| node_evaluation_controller
node_exception_handler -.->|"formats errors"| node_question_controller

click node_evaluation_ui "https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/frontend/app/components/EvaluarCandidato.tsx"
click node_evaluation_page "https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/frontend/app/evaluaciones/nuevo/page.tsx"
click node_evaluation_types "https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/frontend/app/types/evaluacion.ts"
click node_question_ui "https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/frontend/app/components/GestionPreguntas.tsx"
click node_question_hook "https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/frontend/app/hooks/useGestionPreguntas.ts"
click node_question_pages "https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/frontend/app/preguntas/page.tsx"
click node_evaluation_api "https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/frontend/app/services/evaluacionesApi.ts"
click node_question_api "https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/frontend/app/services/preguntasApi.ts"
click node_evaluation_controller "https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/controller/EvaluacionController.java"
click node_question_controller "https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/controller/PreguntaController.java"
click node_exception_handler "https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/exception/ApiExceptionHandler.java"
click node_evaluation_service "https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/service/EvaluacionService.java"
click node_questionnaire "https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/model/Cuestionario.java"
click node_evaluation_model "https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/model/Evaluacion.java"
click node_candidate_model "https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/model/Candidato.java"
click node_job_service "https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/service/PuestoService.java"
click node_question_service "https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/service/PreguntaService.java"
click node_question_model "https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/model/Pregunta.java"
click node_job_model "https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/model/PuestoCompetencia.java"
click node_candidate_store "https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/repository/CandidatoRepository.java"
click node_questionnaire_store "https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/repository/CuestionarioRepository.java"
click node_evaluation_store "https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/repository/EvaluacionRepository.java"
click node_question_store "https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/repository/PreguntaRepository.java"
click node_job_store "https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/repository/PuestoRepository.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_evaluation_ui,node_evaluation_page,node_evaluation_types,node_question_ui,node_question_hook,node_question_pages,node_evaluation_api,node_question_api,node_hr toneBlue
class node_evaluation_controller,node_question_controller,node_exception_handler toneAmber
class node_evaluation_service,node_questionnaire,node_evaluation_model,node_candidate_model toneMint
class node_job_service,node_question_service,node_question_model,node_job_model toneRose
class node_candidate_store,node_questionnaire_store,node_evaluation_store,node_question_store,node_job_store toneIndigo
```

## Components

### HR web app

- [Evaluation workflow](https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/frontend/app/components/EvaluarCandidato.tsx): `capital-humano/frontend/app/components/EvaluarCandidato.tsx`
- [Evaluation page](https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/frontend/app/evaluaciones/nuevo/page.tsx): `capital-humano/frontend/app/evaluaciones/nuevo/page.tsx`
- [Evaluation contracts](https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/frontend/app/types/evaluacion.ts): `capital-humano/frontend/app/types/evaluacion.ts`
- [Question management](https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/frontend/app/components/GestionPreguntas.tsx): `capital-humano/frontend/app/components/GestionPreguntas.tsx`
- [Question workflow state](https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/frontend/app/hooks/useGestionPreguntas.ts): `capital-humano/frontend/app/hooks/useGestionPreguntas.ts`
- [Question pages](https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/frontend/app/preguntas/page.tsx): `capital-humano/frontend/app/preguntas/page.tsx`
- [Evaluation API client](https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/frontend/app/services/evaluacionesApi.ts): `capital-humano/frontend/app/services/evaluacionesApi.ts`
- [Question API client](https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/frontend/app/services/preguntasApi.ts): `capital-humano/frontend/app/services/preguntasApi.ts`

### Backend API

- [Evaluation endpoints](https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/controller/EvaluacionController.java): `capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/controller/EvaluacionController.java`
- [Question endpoints](https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/controller/PreguntaController.java): `capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/controller/PreguntaController.java`
- [API error mapping](https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/exception/ApiExceptionHandler.java): `capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/exception/ApiExceptionHandler.java`

### Evaluation domain

- [Evaluation orchestration](https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/service/EvaluacionService.java): `capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/service/EvaluacionService.java`
- [Questionnaire lifecycle](https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/model/Cuestionario.java): `capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/model/Cuestionario.java`
- [Evaluation records](https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/model/Evaluacion.java): `capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/model/Evaluacion.java`
- [Candidates](https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/model/Candidato.java): `capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/model/Candidato.java`

### Question and job catalog

- [Job competency checks](https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/service/PuestoService.java): `capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/service/PuestoService.java`
- [Question search](https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/service/PreguntaService.java): `capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/service/PreguntaService.java`
- [Question catalog](https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/model/Pregunta.java): `capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/model/Pregunta.java`
- [Job requirements](https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/model/PuestoCompetencia.java): `capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/model/PuestoCompetencia.java`

### Persistence

- [Candidate repository](https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/repository/CandidatoRepository.java): `capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/repository/CandidatoRepository.java`
- [Questionnaire repository](https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/repository/CuestionarioRepository.java): `capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/repository/CuestionarioRepository.java`
- [Evaluation repository](https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/repository/EvaluacionRepository.java): `capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/repository/EvaluacionRepository.java`
- [Question repository](https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/repository/PreguntaRepository.java): `capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/repository/PreguntaRepository.java`
- [Job repository](https://github.com/tadegmor/tp-disenio/blob/main/capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/repository/PuestoRepository.java): `capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/repository/PuestoRepository.java`

### Other components

- **HR user**

## Connections

- HR user → Evaluation workflow: uses
- Evaluation page → Evaluation workflow: renders (evidence: `capital-humano/frontend/app/evaluaciones/nuevo/page.tsx`)
- Evaluation workflow → Evaluation API client: requests (evidence: `capital-humano/frontend/app/components/EvaluarCandidato.tsx`)
- Evaluation workflow → Evaluation contracts: uses types (evidence: `capital-humano/frontend/app/types/evaluacion.ts`)
- Evaluation API client → Evaluation endpoints: HTTP calls
- Evaluation endpoints → Evaluation orchestration: delegates (evidence: `capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/controller/EvaluacionController.java`)
- Evaluation orchestration → Candidate repository: queries (evidence: `capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/service/EvaluacionService.java`)
- Evaluation orchestration → Questionnaire repository: checks and saves (evidence: `capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/service/EvaluacionService.java`)
- Evaluation orchestration → Evaluation repository: saves (evidence: `capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/service/EvaluacionService.java`)
- Evaluation orchestration → Questionnaire lifecycle: creates active (evidence: `capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/service/EvaluacionService.java`)
- Evaluation orchestration → Evaluation records: builds (evidence: `capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/service/EvaluacionService.java`)
- Questionnaire lifecycle → Evaluation records: references (evidence: `capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/model/Cuestionario.java`)
- Questionnaire lifecycle → Candidates: references (evidence: `capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/model/Cuestionario.java`)
- HR user → Question management: uses
- Question pages → Question management: renders (evidence: `capital-humano/frontend/app/preguntas/page.tsx`)
- Question management → Question workflow state: manages via
- Question workflow state → Question API client: calls (evidence: `capital-humano/frontend/app/hooks/useGestionPreguntas.ts`)
- Question API client → Question endpoints: HTTP calls
- Question endpoints → Question search: delegates (evidence: `capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/controller/PreguntaController.java`)
- Question search → Question repository: queries and deletes (evidence: `capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/service/PreguntaService.java`)
- Question repository → Question catalog: persists (evidence: `capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/repository/PreguntaRepository.java`)
- Job competency checks → Job repository: queries (evidence: `capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/service/PuestoService.java`)
- Job competency checks → Question repository: checks evaluability (evidence: `capital-humano/backend/src/main/java/ar/utn/frsf/disenio/capital_humano/service/PuestoService.java`)
- API error mapping → Evaluation endpoints: formats errors
- API error mapping → Question endpoints: formats errors
