# juanherrerap/proyecto-miso-solventa-grupo-11 architecture

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

- Interactive diagram: https://gitdiagram.com/juanherrerap/proyecto-miso-solventa-grupo-11
- Repository: https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11

## Overview

Solventa is an embedded-insurance platform with a web portal and FastAPI backend. Its principal customer workflow is to register or sign in, obtain a risk-priced quote, accept and pay for it, then manage the resulting policy; claims and related servicing form major follow-on workflows. The backend also supports identity/KYC, partner integrations, assistance, notifications, and automated claim payouts. Some subsystem links are documented capabilities rather than inspected call paths, so those edges cite the README; unsampled implementation details are represented only at their existing directory paths.

Main entry points: [`backend/app/siniestros/servicio.py`](https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/backend/app/siniestros/servicio.py) (Claim handling), [`backend/app/main.py`](https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/backend/app/main.py) (Backend API), [`web/src/App.tsx`](https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/web/src/App.tsx) (Web routes), [`web/src/pages/CotizarPage.tsx`](https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/web/src/pages/CotizarPage.tsx) (Quote journey)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web portal"]
  node_webapp["Web routes<br/>[App.tsx]"]
  node_auth["Web authentication<br/>[session.ts]"]
  node_quoteui["Quote journey<br/>[CotizarPage.tsx]"]
  node_quoteclient["Quote API client"]
end

subgraph group_core["Insurance services"]
  node_api["Backend API<br/>[main.py]"]
  node_quoteapi["Quote endpoints<br/>[cotizaciones.py]"]
  node_pricing["Quote pricing<br/>[rating.py]"]
  node_risk["Risk profiling<br/>[servicio.py]"]
  node_enrichment["Profile enrichment"]
  node_payment["Premium payments<br/>[servicio.py]"]
  node_signature["Electronic signing<br/>[servicio.py]"]
  node_policies["Policy lifecycle"]
  node_wallet["Policy wallet<br/>[billetera.py]"]
end

subgraph group_claims["Claims and service"]
  node_claims["Claim handling<br/>[servicio.py]"]
  node_telemetry["Parametric telemetry<br/>[telemetria.py]"]
  node_evidence["Claim evidence<br/>[evidencias.py]"]
  node_payout["Claim disbursement<br/>[servicio.py]"]
  node_assistance["Provider assistance<br/>[servicio.py]"]
  node_notifications["Notifications<br/>[servicio.py]"]
end

subgraph group_identity["Identity and partners"]
  node_identity["Identity and KYC<br/>[servicio.py]"]
  node_kycproviders["KYC adapters"]
  node_partners["Partner access<br/>[oauth_socios.py]"]
end

subgraph group_platform["Platform data"]
  node_db[("Relational database<br/>[database.py]")]
end

node_customer(("Customer"))

node_customer -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_quoteui
node_webapp -->|"restores session"| node_auth
node_quoteui -->|"requests quotes"| node_quoteclient
node_quoteui -.->|"initiates payment"| node_payment
node_quoteclient -.->|"HTTP requests"| node_api
node_api -->|"registers router"| node_quoteapi
node_quoteapi -.->|"prices quotes"| node_pricing
node_pricing -.->|"uses risk profile"| node_risk
node_risk -.->|"enriches profile"| node_enrichment
node_identity -.->|"verifies identity"| node_kycproviders
node_payment -.->|"supports purchase"| node_signature
node_signature -.->|"enables issuance"| node_policies
node_policies -.->|"lists policies"| node_wallet
node_api -.->|"serves identity routes"| node_identity
node_customer -.->|"registers claim"| node_claims
node_telemetry -.->|"reports event"| node_claims
node_claims -.->|"collects evidence"| node_evidence
node_claims -.->|"triggers indemnity"| node_payout
node_claims -.->|"notifies users"| node_notifications
node_customer -.->|"requests assistance"| node_assistance
node_partners -.->|"authenticates partners"| node_api
node_payment -.->|"persists payment data"| node_db
node_policies -->|"persists policies"| node_db

click node_webapp "https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/web/src/App.tsx"
click node_auth "https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/web/src/services/session.ts"
click node_quoteui "https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/web/src/pages/CotizarPage.tsx"
click node_quoteclient "https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/web/src/services/cotizaciones.service.ts"
click node_api "https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/backend/app/main.py"
click node_quoteapi "https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/backend/app/api/cotizaciones.py"
click node_pricing "https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/backend/app/cotizaciones/dominio/rating.py"
click node_risk "https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/backend/app/perfilamiento/servicio.py"
click node_enrichment "https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/tree/main/backend/app/perfilamiento/enriquecimiento"
click node_payment "https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/backend/app/pagos/servicio.py"
click node_signature "https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/backend/app/firmas/servicio.py"
click node_policies "https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/tree/main/backend/app/polizas"
click node_wallet "https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/backend/app/api/billetera.py"
click node_identity "https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/backend/app/identidad/servicio.py"
click node_kycproviders "https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/tree/main/backend/app/identidad/adaptadores"
click node_partners "https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/backend/app/api/oauth_socios.py"
click node_claims "https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/backend/app/siniestros/servicio.py"
click node_telemetry "https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/backend/app/api/telemetria.py"
click node_evidence "https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/backend/app/siniestros/evidencias.py"
click node_payout "https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/backend/app/desembolsos/servicio.py"
click node_assistance "https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/backend/app/asistencias/servicio.py"
click node_notifications "https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/backend/app/notificaciones/servicio.py"
click node_db "https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/backend/app/infraestructura/database.py"

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_webapp,node_auth,node_quoteui,node_quoteclient toneBlue
class node_api,node_quoteapi,node_pricing,node_risk,node_enrichment,node_payment,node_signature,node_policies,node_wallet toneAmber
class node_claims,node_telemetry,node_evidence,node_payout,node_assistance,node_notifications toneMint
class node_identity,node_kycproviders,node_partners toneRose
class node_db,node_customer toneIndigo
```

## Components

### Web portal

- [Web routes](https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/web/src/App.tsx): `web/src/App.tsx`
- [Web authentication](https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/web/src/services/session.ts): `web/src/services/session.ts`
- [Quote journey](https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/web/src/pages/CotizarPage.tsx): `web/src/pages/CotizarPage.tsx`
- [Quote API client](https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/web/src/services/cotizaciones.service.ts): `web/src/services/cotizaciones.service.ts`

### Insurance services

- [Backend API](https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/backend/app/main.py): `backend/app/main.py`
- [Quote endpoints](https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/backend/app/api/cotizaciones.py): `backend/app/api/cotizaciones.py`
- [Quote pricing](https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/backend/app/cotizaciones/dominio/rating.py): `backend/app/cotizaciones/dominio/rating.py`
- [Risk profiling](https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/backend/app/perfilamiento/servicio.py): `backend/app/perfilamiento/servicio.py`
- [Profile enrichment](https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/tree/main/backend/app/perfilamiento/enriquecimiento): `backend/app/perfilamiento/enriquecimiento`
- [Premium payments](https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/backend/app/pagos/servicio.py): `backend/app/pagos/servicio.py`
- [Electronic signing](https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/backend/app/firmas/servicio.py): `backend/app/firmas/servicio.py`
- [Policy lifecycle](https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/tree/main/backend/app/polizas): `backend/app/polizas`
- [Policy wallet](https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/backend/app/api/billetera.py): `backend/app/api/billetera.py`

### Claims and service

- [Claim handling](https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/backend/app/siniestros/servicio.py): `backend/app/siniestros/servicio.py`
- [Parametric telemetry](https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/backend/app/api/telemetria.py): `backend/app/api/telemetria.py`
- [Claim evidence](https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/backend/app/siniestros/evidencias.py): `backend/app/siniestros/evidencias.py`
- [Claim disbursement](https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/backend/app/desembolsos/servicio.py): `backend/app/desembolsos/servicio.py`
- [Provider assistance](https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/backend/app/asistencias/servicio.py): `backend/app/asistencias/servicio.py`
- [Notifications](https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/backend/app/notificaciones/servicio.py): `backend/app/notificaciones/servicio.py`

### Identity and partners

- [Identity and KYC](https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/backend/app/identidad/servicio.py): `backend/app/identidad/servicio.py`
- [KYC adapters](https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/tree/main/backend/app/identidad/adaptadores): `backend/app/identidad/adaptadores`
- [Partner access](https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/backend/app/api/oauth_socios.py): `backend/app/api/oauth_socios.py`

### Platform data

- [Relational database](https://github.com/juanherrerap/proyecto-miso-solventa-grupo-11/blob/main/backend/app/infraestructura/database.py): `backend/app/infraestructura/database.py`

### Other components

- **Customer**

## Connections

- Customer → Web routes: uses (evidence: `README.md`)
- Web routes → Quote journey: routes to (evidence: `web/src/App.tsx`)
- Web routes → Web authentication: restores session (evidence: `web/src/App.tsx`)
- Quote journey → Quote API client: requests quotes (evidence: `web/src/pages/CotizarPage.tsx`)
- Quote journey → Premium payments: initiates payment (evidence: `README.md`)
- Quote API client → Backend API: HTTP requests (evidence: `README.md`)
- Backend API → Quote endpoints: registers router (evidence: `backend/app/main.py`)
- Quote endpoints → Quote pricing: prices quotes (evidence: `README.md`)
- Quote pricing → Risk profiling: uses risk profile (evidence: `README.md`)
- Risk profiling → Profile enrichment: enriches profile (evidence: `README.md`)
- Identity and KYC → KYC adapters: verifies identity (evidence: `README.md`)
- Premium payments → Electronic signing: supports purchase (evidence: `README.md`)
- Electronic signing → Policy lifecycle: enables issuance (evidence: `README.md`)
- Policy lifecycle → Policy wallet: lists policies (evidence: `README.md`)
- Backend API → Identity and KYC: serves identity routes (evidence: `backend/app/main.py`)
- Customer → Claim handling: registers claim (evidence: `README.md`)
- Parametric telemetry → Claim handling: reports event (evidence: `README.md`)
- Claim handling → Claim evidence: collects evidence (evidence: `README.md`)
- Claim handling → Claim disbursement: triggers indemnity (evidence: `README.md`)
- Claim handling → Notifications: notifies users (evidence: `README.md`)
- Customer → Provider assistance: requests assistance (evidence: `README.md`)
- Partner access → Backend API: authenticates partners (evidence: `README.md`)
- Premium payments → Relational database: persists payment data (evidence: `README.md`)
- Policy lifecycle → Relational database: persists policies (evidence: `backend/app/infraestructura/database.py`)
