# melgrattia/trabajopracticodisenio architecture

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

- Interactive diagram: https://gitdiagram.com/melgrattia/trabajopracticodisenio
- Repository: https://github.com/melgrattia/trabajopracticodisenio

## Overview

This is a Spring/JPA domain model for an HR candidate questionnaire and competency evaluation. Its apparent domain stages are job/competency definition, questionnaire and question construction, candidate response capture, and competency-result recording. The sampled sources show entity relationships and constraints, not the application’s service or user-facing flow; the README adds no workflow detail. Accordingly, this map represents the documented persistence model rather than asserting runtime calls or a specific database deployment.

Main entry points: [`src/main/java/com/CapitalHumano/trabajointegrador/entity/Cuestionario.java`](https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/Cuestionario.java) (Questionnaire), [`src/main/java/com/CapitalHumano/trabajointegrador/entity/Pregunta.java`](https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/Pregunta.java) (Question), [`src/main/java/com/CapitalHumano/trabajointegrador/entity/PreguntaBloque.java`](https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/PreguntaBloque.java) (Block question order), [`src/main/java/com/CapitalHumano/trabajointegrador/entity/CaracteristicaPuesto.java`](https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/CaracteristicaPuesto.java) (Position competency)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_jobs["Jobs and competencies"]
  node_puesto["Job position<br/>[Puesto.java]"]
  node_competencia["Competency<br/>[Competencia.java]"]
  node_caracteristica["Position competency"]
  node_caracteristica_id["Position competency key"]
  node_factor["Competency factor<br/>[Factor.java]"]
end

subgraph group_questionnaire["Questionnaire design"]
  node_cuestionario["Questionnaire<br/>[Cuestionario.java]"]
  node_estado["Questionnaire state"]
  node_bloque["Question block"]
  node_pregunta_bloque["Block question order"]
  node_pregunta["Question<br/>[Pregunta.java]"]
  node_opcion["Response option type"]
  node_item["Option item<br/>[ItemOpcion.java]"]
  node_ponderacion["Item weighting"]
end

subgraph group_candidate["Candidate evaluation"]
  node_candidato["Candidate<br/>[Candidato.java]"]
  node_resultado["Competency result"]
  node_resultado_id["Result key"]
end

subgraph group_identity["Users and audit"]
  node_usuario["User<br/>[Usuario.java]"]
  node_estado_log["State change log"]
  node_eliminacion_log["Deletion log"]
end

node_app["Spring application"]

node_caracteristica -->|"references"| node_puesto
node_caracteristica -->|"references"| node_competencia
node_factor -->|"belongs to"| node_competencia
node_pregunta -->|"belongs to"| node_factor
node_pregunta -->|"uses type"| node_opcion
node_item -->|"belongs to"| node_opcion
node_ponderacion -->|"weights"| node_pregunta
node_ponderacion -->|"weights"| node_item
node_cuestionario -->|"assigned to"| node_candidato
node_cuestionario -->|"for position"| node_puesto
node_cuestionario -->|"has state"| node_estado
node_bloque -->|"belongs to"| node_cuestionario
node_pregunta_bloque -->|"orders within"| node_bloque
node_pregunta_bloque -->|"selects"| node_pregunta
node_pregunta_bloque -->|"records selected"| node_item
node_resultado -->|"for questionnaire"| node_cuestionario
node_resultado -->|"for competency"| node_caracteristica

click node_app "https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/TrabajointegradorApplication.java"
click node_puesto "https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/Puesto.java"
click node_competencia "https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/Competencia.java"
click node_caracteristica "https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/CaracteristicaPuesto.java"
click node_caracteristica_id "https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/CaracteristicaPuestoId.java"
click node_factor "https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/Factor.java"
click node_cuestionario "https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/Cuestionario.java"
click node_estado "https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/EstadoCuestionario.java"
click node_bloque "https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/BloquePregunta.java"
click node_pregunta_bloque "https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/PreguntaBloque.java"
click node_pregunta "https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/Pregunta.java"
click node_opcion "https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/OpcionRespuesta.java"
click node_item "https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/ItemOpcion.java"
click node_ponderacion "https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/PonderacionItem.java"
click node_candidato "https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/Candidato.java"
click node_resultado "https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/ResultadoCompetencia.java"
click node_resultado_id "https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/ResultadoCompetenciaId.java"
click node_usuario "https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/Usuario.java"
click node_estado_log "https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/RegistroActualizacionDeEstado.java"
click node_eliminacion_log "https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/RegistroEliminacion.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_puesto,node_competencia,node_caracteristica,node_caracteristica_id,node_factor toneBlue
class node_cuestionario,node_estado,node_bloque,node_pregunta_bloque,node_pregunta,node_opcion,node_item,node_ponderacion toneAmber
class node_candidato,node_resultado,node_resultado_id toneMint
class node_usuario,node_estado_log,node_eliminacion_log toneRose
class node_app toneTeal
```

## Components

### Jobs and competencies

- [Job position](https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/Puesto.java): `src/main/java/com/CapitalHumano/trabajointegrador/entity/Puesto.java`
- [Competency](https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/Competencia.java): `src/main/java/com/CapitalHumano/trabajointegrador/entity/Competencia.java`
- [Position competency](https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/CaracteristicaPuesto.java): `src/main/java/com/CapitalHumano/trabajointegrador/entity/CaracteristicaPuesto.java`
- [Position competency key](https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/CaracteristicaPuestoId.java): `src/main/java/com/CapitalHumano/trabajointegrador/entity/CaracteristicaPuestoId.java`
- [Competency factor](https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/Factor.java): `src/main/java/com/CapitalHumano/trabajointegrador/entity/Factor.java`

### Questionnaire design

- [Questionnaire](https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/Cuestionario.java): `src/main/java/com/CapitalHumano/trabajointegrador/entity/Cuestionario.java`
- [Questionnaire state](https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/EstadoCuestionario.java): `src/main/java/com/CapitalHumano/trabajointegrador/entity/EstadoCuestionario.java`
- [Question block](https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/BloquePregunta.java): `src/main/java/com/CapitalHumano/trabajointegrador/entity/BloquePregunta.java`
- [Block question order](https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/PreguntaBloque.java): `src/main/java/com/CapitalHumano/trabajointegrador/entity/PreguntaBloque.java`
- [Question](https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/Pregunta.java): `src/main/java/com/CapitalHumano/trabajointegrador/entity/Pregunta.java`
- [Response option type](https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/OpcionRespuesta.java): `src/main/java/com/CapitalHumano/trabajointegrador/entity/OpcionRespuesta.java`
- [Option item](https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/ItemOpcion.java): `src/main/java/com/CapitalHumano/trabajointegrador/entity/ItemOpcion.java`
- [Item weighting](https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/PonderacionItem.java): `src/main/java/com/CapitalHumano/trabajointegrador/entity/PonderacionItem.java`

### Candidate evaluation

- [Candidate](https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/Candidato.java): `src/main/java/com/CapitalHumano/trabajointegrador/entity/Candidato.java`
- [Competency result](https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/ResultadoCompetencia.java): `src/main/java/com/CapitalHumano/trabajointegrador/entity/ResultadoCompetencia.java`
- [Result key](https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/ResultadoCompetenciaId.java): `src/main/java/com/CapitalHumano/trabajointegrador/entity/ResultadoCompetenciaId.java`

### Users and audit

- [User](https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/Usuario.java): `src/main/java/com/CapitalHumano/trabajointegrador/entity/Usuario.java`
- [State change log](https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/RegistroActualizacionDeEstado.java): `src/main/java/com/CapitalHumano/trabajointegrador/entity/RegistroActualizacionDeEstado.java`
- [Deletion log](https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/entity/RegistroEliminacion.java): `src/main/java/com/CapitalHumano/trabajointegrador/entity/RegistroEliminacion.java`

### Other components

- [Spring application](https://github.com/melgrattia/trabajopracticodisenio/blob/main/src/main/java/com/CapitalHumano/trabajointegrador/TrabajointegradorApplication.java): `src/main/java/com/CapitalHumano/trabajointegrador/TrabajointegradorApplication.java`

## Connections

- Position competency → Job position: references (evidence: `src/main/java/com/CapitalHumano/trabajointegrador/entity/CaracteristicaPuesto.java`)
- Position competency → Competency: references (evidence: `src/main/java/com/CapitalHumano/trabajointegrador/entity/CaracteristicaPuesto.java`)
- Competency factor → Competency: belongs to (evidence: `src/main/java/com/CapitalHumano/trabajointegrador/entity/Factor.java`)
- Question → Competency factor: belongs to (evidence: `src/main/java/com/CapitalHumano/trabajointegrador/entity/Pregunta.java`)
- Question → Response option type: uses type (evidence: `src/main/java/com/CapitalHumano/trabajointegrador/entity/Pregunta.java`)
- Option item → Response option type: belongs to (evidence: `src/main/java/com/CapitalHumano/trabajointegrador/entity/ItemOpcion.java`)
- Item weighting → Question: weights (evidence: `src/main/java/com/CapitalHumano/trabajointegrador/entity/PonderacionItem.java`)
- Item weighting → Option item: weights (evidence: `src/main/java/com/CapitalHumano/trabajointegrador/entity/PonderacionItem.java`)
- Questionnaire → Candidate: assigned to (evidence: `src/main/java/com/CapitalHumano/trabajointegrador/entity/Cuestionario.java`)
- Questionnaire → Job position: for position (evidence: `src/main/java/com/CapitalHumano/trabajointegrador/entity/Cuestionario.java`)
- Questionnaire → Questionnaire state: has state (evidence: `src/main/java/com/CapitalHumano/trabajointegrador/entity/Cuestionario.java`)
- Question block → Questionnaire: belongs to (evidence: `src/main/java/com/CapitalHumano/trabajointegrador/entity/BloquePregunta.java`)
- Block question order → Question block: orders within (evidence: `src/main/java/com/CapitalHumano/trabajointegrador/entity/PreguntaBloque.java`)
- Block question order → Question: selects (evidence: `src/main/java/com/CapitalHumano/trabajointegrador/entity/PreguntaBloque.java`)
- Block question order → Option item: records selected (evidence: `src/main/java/com/CapitalHumano/trabajointegrador/entity/PreguntaBloque.java`)
- Competency result → Questionnaire: for questionnaire (evidence: `src/main/java/com/CapitalHumano/trabajointegrador/entity/ResultadoCompetencia.java`)
- Competency result → Position competency: for competency (evidence: `src/main/java/com/CapitalHumano/trabajointegrador/entity/ResultadoCompetencia.java`)
