# camilo180601/polizas-api architecture

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

## Overview

This is a Spring MVC policy-management API. Clients authenticate with an API key, then list and paginate policies, inspect risks, or request policy renewal/cancellation and risk changes. Services enforce domain rules, persist changes, and notify the CORE mock; CORE failures can roll back local mutations. The README also documents cursor filtering, logical cancellation, seeded demo data, and structured errors. Service and controller calls are visible in excerpts; several integrations and initialization details are documented in the README, while some wiring is not shown.

Main entry points: [`src/main/java/com/camilolopez/polizas/service/PolizaService.java`](https://github.com/camilo180601/polizas-api/blob/main/src/main/java/com/camilolopez/polizas/service/PolizaService.java) (Policy operations), [`src/main/java/com/camilolopez/polizas/service/RiesgoService.java`](https://github.com/camilo180601/polizas-api/blob/main/src/main/java/com/camilolopez/polizas/service/RiesgoService.java) (Risk operations), [`src/main/java/com/camilolopez/polizas/repository/RiesgoRepository.java`](https://github.com/camilo180601/polizas-api/blob/main/src/main/java/com/camilolopez/polizas/repository/RiesgoRepository.java) (Risk repository), [`src/main/java/com/camilolopez/polizas/controller/PolizaController.java`](https://github.com/camilo180601/polizas-api/blob/main/src/main/java/com/camilolopez/polizas/controller/PolizaController.java) (Policy routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and access"]
  node_poliza_controller["Policy routes"]
  node_riesgo_controller["Risk routes"]
  node_api_key["API-key filter<br/>[ApiKeyFilter.java]"]
  node_errors["Error mapping"]
end

subgraph group_domain["Policy domain"]
  node_poliza_service["Policy operations<br/>[PolizaService.java]"]
  node_riesgo_service["Risk operations<br/>[RiesgoService.java]"]
  node_policy_model["Policy model<br/>[Poliza.java]"]
  node_risk_model["Risk model<br/>[Riesgo.java]"]
  node_response_dtos["Response and cursor DTOs"]
end

subgraph group_persistence["Persistence"]
  node_policy_repo["Policy repository"]
  node_risk_repo["Risk repository"]
  node_h2[("H2 database")]
  node_seed["Demo seed<br/>[SeedData.java]"]
end

subgraph group_core["CORE integration"]
  node_core_client["CORE client"]
  node_core_mock["CORE mock endpoint"]
  node_core_service{{"External CORE"}}
end

node_client(("API client"))

node_client -->|"calls routes"| node_poliza_controller
node_client -->|"calls routes"| node_riesgo_controller
node_poliza_controller -->|"delegates to"| node_poliza_service
node_poliza_controller -->|"delegates to"| node_riesgo_service
node_riesgo_controller -->|"delegates to"| node_riesgo_service
node_poliza_service -->|"queries and saves"| node_policy_repo
node_poliza_service -->|"reads and cancels"| node_risk_repo
node_riesgo_service -->|"locks policy"| node_poliza_service
node_riesgo_service -->|"reads and saves"| node_risk_repo
node_poliza_service -->|"sends update"| node_core_client
node_riesgo_service -->|"sends update"| node_core_client
node_policy_repo -->|"persists policies"| node_h2
node_risk_repo -->|"persists risks"| node_h2
node_seed -->|"seeds policies"| node_policy_repo
node_seed -->|"seeds risks"| node_risk_repo
node_core_client -->|"notifies by HTTP"| node_core_mock
node_core_service -.->|"hosts mock"| node_core_mock

click node_poliza_controller "https://github.com/camilo180601/polizas-api/blob/main/src/main/java/com/camilolopez/polizas/controller/PolizaController.java"
click node_riesgo_controller "https://github.com/camilo180601/polizas-api/blob/main/src/main/java/com/camilolopez/polizas/controller/RiesgoController.java"
click node_api_key "https://github.com/camilo180601/polizas-api/blob/main/src/main/java/com/camilolopez/polizas/security/ApiKeyFilter.java"
click node_errors "https://github.com/camilo180601/polizas-api/blob/main/src/main/java/com/camilolopez/polizas/exception/GlobalExceptionHandler.java"
click node_poliza_service "https://github.com/camilo180601/polizas-api/blob/main/src/main/java/com/camilolopez/polizas/service/PolizaService.java"
click node_riesgo_service "https://github.com/camilo180601/polizas-api/blob/main/src/main/java/com/camilolopez/polizas/service/RiesgoService.java"
click node_policy_model "https://github.com/camilo180601/polizas-api/blob/main/src/main/java/com/camilolopez/polizas/entity/Poliza.java"
click node_risk_model "https://github.com/camilo180601/polizas-api/blob/main/src/main/java/com/camilolopez/polizas/entity/Riesgo.java"
click node_response_dtos "https://github.com/camilo180601/polizas-api/blob/main/src/main/java/com/camilolopez/polizas/dto/PolizaResponse.java"
click node_policy_repo "https://github.com/camilo180601/polizas-api/blob/main/src/main/java/com/camilolopez/polizas/repository/PolizaRepository.java"
click node_risk_repo "https://github.com/camilo180601/polizas-api/blob/main/src/main/java/com/camilolopez/polizas/repository/RiesgoRepository.java"
click node_seed "https://github.com/camilo180601/polizas-api/blob/main/src/main/java/com/camilolopez/polizas/config/SeedData.java"
click node_core_client "https://github.com/camilo180601/polizas-api/blob/main/src/main/java/com/camilolopez/polizas/integration/HttpCoreClient.java"
click node_core_mock "https://github.com/camilo180601/polizas-api/blob/main/src/main/java/com/camilolopez/polizas/controller/CoreMockController.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_poliza_controller,node_riesgo_controller,node_api_key,node_errors,node_client toneBlue
class node_poliza_service,node_riesgo_service,node_policy_model,node_risk_model,node_response_dtos toneAmber
class node_policy_repo,node_risk_repo,node_h2,node_seed toneMint
class node_core_client,node_core_mock,node_core_service toneRose
```

## Components

### API and access

- [Policy routes](https://github.com/camilo180601/polizas-api/blob/main/src/main/java/com/camilolopez/polizas/controller/PolizaController.java): `src/main/java/com/camilolopez/polizas/controller/PolizaController.java`
- [Risk routes](https://github.com/camilo180601/polizas-api/blob/main/src/main/java/com/camilolopez/polizas/controller/RiesgoController.java): `src/main/java/com/camilolopez/polizas/controller/RiesgoController.java`
- [API-key filter](https://github.com/camilo180601/polizas-api/blob/main/src/main/java/com/camilolopez/polizas/security/ApiKeyFilter.java): `src/main/java/com/camilolopez/polizas/security/ApiKeyFilter.java`
- [Error mapping](https://github.com/camilo180601/polizas-api/blob/main/src/main/java/com/camilolopez/polizas/exception/GlobalExceptionHandler.java): `src/main/java/com/camilolopez/polizas/exception/GlobalExceptionHandler.java`

### Policy domain

- [Policy operations](https://github.com/camilo180601/polizas-api/blob/main/src/main/java/com/camilolopez/polizas/service/PolizaService.java): `src/main/java/com/camilolopez/polizas/service/PolizaService.java`
- [Risk operations](https://github.com/camilo180601/polizas-api/blob/main/src/main/java/com/camilolopez/polizas/service/RiesgoService.java): `src/main/java/com/camilolopez/polizas/service/RiesgoService.java`
- [Policy model](https://github.com/camilo180601/polizas-api/blob/main/src/main/java/com/camilolopez/polizas/entity/Poliza.java): `src/main/java/com/camilolopez/polizas/entity/Poliza.java`
- [Risk model](https://github.com/camilo180601/polizas-api/blob/main/src/main/java/com/camilolopez/polizas/entity/Riesgo.java): `src/main/java/com/camilolopez/polizas/entity/Riesgo.java`
- [Response and cursor DTOs](https://github.com/camilo180601/polizas-api/blob/main/src/main/java/com/camilolopez/polizas/dto/PolizaResponse.java): `src/main/java/com/camilolopez/polizas/dto/PolizaResponse.java`

### Persistence

- [Policy repository](https://github.com/camilo180601/polizas-api/blob/main/src/main/java/com/camilolopez/polizas/repository/PolizaRepository.java): `src/main/java/com/camilolopez/polizas/repository/PolizaRepository.java`
- [Risk repository](https://github.com/camilo180601/polizas-api/blob/main/src/main/java/com/camilolopez/polizas/repository/RiesgoRepository.java): `src/main/java/com/camilolopez/polizas/repository/RiesgoRepository.java`
- **H2 database**
- [Demo seed](https://github.com/camilo180601/polizas-api/blob/main/src/main/java/com/camilolopez/polizas/config/SeedData.java): `src/main/java/com/camilolopez/polizas/config/SeedData.java`

### CORE integration

- [CORE client](https://github.com/camilo180601/polizas-api/blob/main/src/main/java/com/camilolopez/polizas/integration/HttpCoreClient.java): `src/main/java/com/camilolopez/polizas/integration/HttpCoreClient.java`
- [CORE mock endpoint](https://github.com/camilo180601/polizas-api/blob/main/src/main/java/com/camilolopez/polizas/controller/CoreMockController.java): `src/main/java/com/camilolopez/polizas/controller/CoreMockController.java`
- **External CORE**

### Other components

- **API client**

## Connections

- API client → Policy routes: calls routes (evidence: `README.md`)
- API client → Risk routes: calls routes (evidence: `README.md`)
- Policy routes → Policy operations: delegates to (evidence: `src/main/java/com/camilolopez/polizas/controller/PolizaController.java`)
- Policy routes → Risk operations: delegates to (evidence: `src/main/java/com/camilolopez/polizas/controller/PolizaController.java`)
- Risk routes → Risk operations: delegates to (evidence: `src/main/java/com/camilolopez/polizas/controller/RiesgoController.java`)
- Policy operations → Policy repository: queries and saves (evidence: `src/main/java/com/camilolopez/polizas/service/PolizaService.java`)
- Policy operations → Risk repository: reads and cancels (evidence: `src/main/java/com/camilolopez/polizas/service/PolizaService.java`)
- Risk operations → Policy operations: locks policy (evidence: `src/main/java/com/camilolopez/polizas/service/RiesgoService.java`)
- Risk operations → Risk repository: reads and saves (evidence: `src/main/java/com/camilolopez/polizas/service/RiesgoService.java`)
- Policy operations → CORE client: sends update (evidence: `src/main/java/com/camilolopez/polizas/service/PolizaService.java`)
- Risk operations → CORE client: sends update (evidence: `src/main/java/com/camilolopez/polizas/service/RiesgoService.java`)
- Policy repository → H2 database: persists policies (evidence: `README.md`)
- Risk repository → H2 database: persists risks (evidence: `README.md`)
- Demo seed → Policy repository: seeds policies (evidence: `src/main/java/com/camilolopez/polizas/config/SeedData.java`)
- Demo seed → Risk repository: seeds risks (evidence: `src/main/java/com/camilolopez/polizas/config/SeedData.java`)
- CORE client → CORE mock endpoint: notifies by HTTP (evidence: `README.md`)
- External CORE → CORE mock endpoint: hosts mock
