# Arquitectura — Multicotizador (implementada)

Documento alineado al scaffold de Instrucción 02. Independiente de BrokerOS.

## 1. Stack en uso

| Pieza | Elección |
|-------|----------|
| Backend | PHP 8.2+ (sin Laravel) |
| DB | MySQL / MariaDB |
| Frontend | Vistas PHP + CSS responsive |
| Config | `.env` vía `vlucas/phpdotenv` |
| HTTP local | `php -S` → `public/` + `router.php` |
| Deploy objetivo | VPS Apache/Nginx + PHP-FPM |

## 2. Capas

```text
routes/web.php
    → Controllers (Presentation)
        → Services (Application)
            → Repositories / Connectors
                → Domain data (arrays/entidades lean) + MySQL
```

| Carpeta | Rol |
|---------|-----|
| `app/Controllers` | HTTP, auth gates, CSRF |
| `app/Services` | Casos de uso (`QuoteService`) |
| `app/Repositories` | SQL PDO |
| `app/Connectors` | Adaptadores compañía |
| `app/Core` | Router, Auth, DB, Crypto, View, Logger |
| `app/Views` | HTML escapado |

## 3. Flujo actual

```text
LOGIN → DASHBOARD → NUEVA COTIZACIÓN → CLIENTE + RIESGO → COMPAÑÍAS
  → COTIZAR → ConnectorManager → MockCompanyConnector
  → quote_requests + quote_results → SHOW → LISTADO
```

Estados de `quotes.status`: `DRAFT | QUOTING | COMPLETED | ERROR | CANCELLED`.

## 4. Conectores

Contrato: `CompanyConnectorInterface::quote(array $data): QuoteResponse`.

| Clase | Estado |
|-------|--------|
| `MockCompanyConnector` | Implementado — DEMO/TEST ($100.000 / 3 UF) |
| `ApiCompanyConnector` | Stub |
| `PortalCompanyConnector` | Stub |
| `ManualCompanyConnector` | Stub |
| `ConnectorManager` | Resuelve por `type` + `config.driver` / `use_mock` |

**No hay APIs reales ni scraping.**

## 5. Modelo de datos

Tablas: `users`, `companies`, `company_connections`, `clients`, `quotes`, `quote_requests`, `quote_results`.

- `company_connections.config` JSON flexible; claves sensibles (`api_key`, `token`, …) cifradas con AES-256-GCM (`APP_KEY`) y prefijo `enc:`
- `quotes.risk_data` JSON (Automóvil: patente, marca, modelo, año, uso, comuna)
- Sin columnas fijas por compañía

Migración: `database/migrations/001_create_tables.sql` vía `php database/migrate.php`.

## 6. Seguridad

| Control | Implementación |
|---------|----------------|
| Passwords | `password_hash` / `password_verify` |
| CSRF | Token de sesión en formularios POST |
| SQLi | PDO prepared statements |
| XSS | `View::e()` / `htmlspecialchars` |
| Sesiones | regenerate en login; HttpOnly; SameSite |
| Secretos | `.env` fuera de webroot; cifrado en config de conexiones |
| Logs | `Logger` redacta password/token/secret |

## 7. Auth y roles

- Login email/password
- Roles: `admin`, `broker` (seed crea `admin`)
- `Auth::requireLogin()` / `requireRole('admin')` (Configuración)

## 8. PDF / comparador / compañías reales

Pendientes (ver `TODO.md`). `storage/pdf/` reservado.

## 9. Relación con BrokerOS

Solo referencia conceptual (capas, privacidad). Sin código, DB ni config compartidos.
