How camilo180601/polizas-api works
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: PolizaService.java Policy operations · RiesgoService.java Risk operations · RiesgoRepository.java Risk repository · PolizaController.java Policy routes
Components 17
API and access
- Policy routes
src/main/java/com/camilolopez/polizas/controller/PolizaController.java - Risk routes
src/main/java/com/camilolopez/polizas/controller/RiesgoController.java - API-key filter
src/main/java/com/camilolopez/polizas/security/ApiKeyFilter.java - Error mapping
src/main/java/com/camilolopez/polizas/exception/GlobalExceptionHandler.java
Policy domain
- Policy operations
src/main/java/com/camilolopez/polizas/service/PolizaService.java - Risk operations
src/main/java/com/camilolopez/polizas/service/RiesgoService.java - Policy model
src/main/java/com/camilolopez/polizas/entity/Poliza.java - Risk model
src/main/java/com/camilolopez/polizas/entity/Riesgo.java - Response and cursor DTOs
src/main/java/com/camilolopez/polizas/dto/PolizaResponse.java
Persistence
- Policy repository
src/main/java/com/camilolopez/polizas/repository/PolizaRepository.java - Risk repository
src/main/java/com/camilolopez/polizas/repository/RiesgoRepository.java - H2 database
- Demo seed
src/main/java/com/camilolopez/polizas/config/SeedData.java
CORE integration
- CORE client
src/main/java/com/camilolopez/polizas/integration/HttpCoreClient.java - CORE mock endpoint
src/main/java/com/camilolopez/polizas/controller/CoreMockController.java - External CORE
Other components
- API client
Connections 17
- API client → Policy routes: calls routes
README.md - API client → Risk routes: calls routes
README.md - Policy routes → Policy operations: delegates to
src/main/java/com/camilolopez/polizas/controller/PolizaController.java - Policy routes → Risk operations: delegates to
src/main/java/com/camilolopez/polizas/controller/PolizaController.java - Risk routes → Risk operations: delegates to
src/main/java/com/camilolopez/polizas/controller/RiesgoController.java - Policy operations → Policy repository: queries and saves
src/main/java/com/camilolopez/polizas/service/PolizaService.java - Policy operations → Risk repository: reads and cancels
src/main/java/com/camilolopez/polizas/service/PolizaService.java - Risk operations → Policy operations: locks policy
src/main/java/com/camilolopez/polizas/service/RiesgoService.java - Risk operations → Risk repository: reads and saves
src/main/java/com/camilolopez/polizas/service/RiesgoService.java - Policy operations → CORE client: sends update
src/main/java/com/camilolopez/polizas/service/PolizaService.java - Risk operations → CORE client: sends update
src/main/java/com/camilolopez/polizas/service/RiesgoService.java - Policy repository → H2 database: persists policies
README.md - Risk repository → H2 database: persists risks
README.md - Demo seed → Policy repository: seeds policies
src/main/java/com/camilolopez/polizas/config/SeedData.java - Demo seed → Risk repository: seeds risks
src/main/java/com/camilolopez/polizas/config/SeedData.java - CORE client → CORE mock endpoint: notifies by HTTP
README.md - External CORE → CORE mock endpoint: hosts mock