# VMS-Sailor — Arquitectura (vista general)

> One-pager con links a las partes del brief. Para detalles ir a los
> documentos originales (`VMS_Sailor_v2_Parte_*.md`).

## Producto vertical completo

```
                            ┌──────────────────────────┐
                            │   VMS-Sailor Studio      │
                            │  (PC de Álvaro)          │
                            │                          │
                            │  · Biblioteca curada IP  │
                            │  · Wizard 8 pasos        │
                            │  · Editor mímicos/tags   │
                            │  · Compilador .vmspack   │
                            └─────────────┬────────────┘
                                          │  .vmspack firmado
                                          │  .vmsdelta firmado
                                          ▼
   ┌─────────────────────────────────────────────────────────────┐
   │   PC INDUSTRIAL DEL BUQUE                                   │
   │                                                             │
   │   ┌──────────────────────┐         ┌──────────────────────┐ │
   │   │  Runtime servidor    │  WS     │  Runtime cliente     │ │
   │   │  · servicio Windows  │ ◄────► │  desktop (PySide6)   │ │
   │   │  · drivers Modbus    │  REST   │  puente + máquinas   │ │
   │   │  · drivers NMEA 2000 │         └──────────────────────┘ │
   │   │  · alarm engine      │                                  │
   │   │  · permissive engine │         ┌──────────────────────┐ │
   │   │  · authority manager │ ◄────► │ VMS-Sailor Mobile    │ │
   │   │  · stability monitor │  WSS    │  Flutter (WiFi local)│ │
   │   │  · historian DuckDB  │         └──────────────────────┘ │
   │   └──────────┬───────────┘                                  │
   └──────────────┼──────────────────────────────────────────────┘
                  │ Modbus RTU + NMEA 2000
   ┌──────────────┴──────────────────────────────────────────────┐
   │   AR-NMEA-IO-v1.0  (×N tarjetas distribuidas)               │
   │   ESP32 + 10 DO + 5 DI + 1 RPM + 4 AI                       │
   │   · plug-and-produce (config descargada del VMS)            │
   │   · OTA seguro firmado                                       │
   │   · alarmas y permissives locales críticos                   │
   └──────────────┬──────────────────────────────────────────────┘
                  │ I/O físico
                  ▼
              ┌──────────┐  ┌──────────┐  ┌──────────┐
              │ Motores  │  │ Genset   │  │ Tanques, │
              │ MTU/Volvo│  │          │  │ bombas...│
              └──────────┘  └──────────┘  └──────────┘
```

## Productos relacionados

- **AR-ECDIS** (producto separado, no se desarrolla aquí). Publica al
  backbone NMEA 2000 los PGNs de navegación y actitud que VMS-Sailor
  consume: 127250 Heading, 127251 ROT, 127257 Attitude, 129025/129029
  Position, 129026 COG/SOG, 128259 Speed Water.

## Componentes por sprint

| Sprint | Foco | Componente |
|---|---|---|
| 0 | Fundaciones | core + persistencia + biblioteca seed + design system |
| 1-3 | Studio | wizard + editores + biblioteca completa |
| 4-5 | Runtime servidor | drivers + tag store + historian + alarm engine |
| 6 | Runtime cliente | desktop completo |
| 7 | Empaquetado | compilador + MSI + activación HWID |
| 8 | Seguridad operativa | permissives + authority + stability monitor |
| 9-10 | Capas + telemetría | layer config engine + VPN + audit |
| 11 | Mobile | Flutter completo |
| 12-15 | Firmware | Modbus + NMEA 2000 + OTA + hardening |
| 16+ | Refinamiento | logbook regulatorio, integraciones Seakeeper, etc. |

## Reglas de oro (recordatorio)

Ver `VMS_Sailor_v2_Parte_06_Sprints_y_reglas.md` sección 5. Las críticas:

1. Tests obligatorios en `core` y `runtime/server`
2. Sin red de salida en Runtime (salvo activación + VPN admin)
3. Auditoría siempre activa
4. Coordenadas navales `ShipCoord(x_pp, y_cl, z_bl)` siempre
5. Unidades SI internas siempre
6. Idioma español por defecto
7. Runtime inmutable para el cliente (solo deltas firmados)