sprint-0: fundaciones VMS-Sailor

Sprint 0 completo del producto VMS-Sailor (Vessel Management System
integrado para buques 30-40m). Brief de referencia en
VMS_Sailor_v2_Parte_*.md (intacto).

Core (vmssailor.core, 95.17% coverage, 99 tests verde):
- ShipCoord: sistema naval x_pp/y_cl/z_bl frozen
- Vessel, Deck, Bulkhead
- Equipment, EquipmentModel, Sensor, EquipmentSpec
- Tag, AlarmConfig, TagBinding, Scaling
- CardInstance, Bus, Topology con validacion 21 puntos I/O AR-NMEA-IO-v1.0
- Alarm, PermissiveRule, Condition
- Project agregado raiz con validacion cross-entity
- Persistencia portable .vmsproj (SQLite) con roundtrip verificable

Biblioteca curada seed (vmssailor.library):
- systems_catalog.json completo (catalogo maestro Parte 1 sec 7)
- 2 vessels: Sunseeker 76, Ferretti 850
- 2 motores: MTU 12V 2000 M96, Volvo D13-900
- 1 genset: Northern Lights M65C13
- yacht_motor_planeo.yaml (reglas heuristicas)
- TODO marcado data_source=seed_estimate - requiere validacion datasheets

Tools:
- vms-validate-library: CLI valida biblioteca completa
- vms-generate-test-project: CLI demo + verificacion roundtrip persistencia

Design System + 8 mockups HTML estaticos:
- docs/design_system.md (paleta Deep Ocean, gradientes, typography, motion)
- docs/brand/ (logo + variantes SVG)
- docs/mockups/splash, studio_main, runtime_overview,
  runtime_mimic_fuel (P&ID animado), runtime_alarms, runtime_trim (panel
  estrella con horizonte artificial), mobile_overview, mobile_trim
- docs/mockups/index.html (galeria)

Firmware (Sprint 12+ implementacion):
- firmware/ar_nmea_io_v1/src/config/pinout.h con macros GPIO

Decisiones autonomas documentadas en docs/decisions_sprint0.md.

Stack: Python 3.11 + uv + Pydantic v2 + SQLite stdlib + hatchling +
pytest 9 + ruff + mypy. Sin PySide6, FastAPI, Flutter ni firmware
funcional (entran en sprints siguientes).

Criterio de aceptacion Sprint 0: cumplido.
- uv sync: OK
- pytest: 99/99 verde
- cov vmssailor.core: 95.17% (objetivo >=80%)
- ruff: clean
- vms-validate-library: OK
- vms-generate-test-project: INTEGRIDAD OK

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

vmssailor/library/equipment/engines/mtu_12v_2000_m96.json

@@ -0,0 +1,130 @@
+{
+  "id": "mtu_12v_2000_m96",
+  "manufacturer": "MTU",
+  "model_name": "12V 2000 M96",
+  "category": "engine_main",
+  "typical_systems": ["main_engine"],
+  "specs": {
+    "power_kw": 1432,
+    "rpm_nominal": 2450,
+    "weight_kg": 2600,
+    "length_m": 2.13,
+    "width_m": 1.18,
+    "height_m": 1.27,
+    "fuel_consumption_lph": 320
+  },
+  "description": "MTU Series 2000, 12 cilindros en V, 24.0 L, 2-stage turbo. Aplicación yates rápidos / patrulleros / fast ferries. Common Rail. Habla J1939 nativo en su MCU.",
+  "data_source": "seed_estimate",
+  "default_sensors": [
+    {
+      "id": "rpm",
+      "name": "RPM",
+      "unit_si": "rpm",
+      "range_normal_min": 0,
+      "range_normal_max": 2600,
+      "alarm_high_value": 2550,
+      "alarm_high_priority": "high",
+      "default_signal_type": "pulse_magnetic_pickup",
+      "description": "Régimen del cigüeñal."
+    },
+    {
+      "id": "oil_press",
+      "name": "Presión de aceite",
+      "unit_si": "bar",
+      "range_normal_min": 3.5,
+      "range_normal_max": 6.5,
+      "alarm_low_value": 1.5,
+      "alarm_low_priority": "emergency",
+      "default_signal_type": "4-20ma",
+      "description": "Presión aceite lubricante en galería principal."
+    },
+    {
+      "id": "oil_temp",
+      "name": "Temperatura de aceite",
+      "unit_si": "C",
+      "range_normal_min": 60,
+      "range_normal_max": 110,
+      "alarm_high_value": 120,
+      "alarm_high_priority": "high",
+      "default_signal_type": "rtd_pt100"
+    },
+    {
+      "id": "coolant_temp",
+      "name": "Temperatura refrigerante",
+      "unit_si": "C",
+      "range_normal_min": 65,
+      "range_normal_max": 95,
+      "alarm_high_value": 100,
+      "alarm_high_priority": "emergency",
+      "default_signal_type": "rtd_pt100"
+    },
+    {
+      "id": "boost_press",
+      "name": "Presión de sobrealimentación",
+      "unit_si": "bar",
+      "range_normal_min": 0.0,
+      "range_normal_max": 2.5,
+      "default_signal_type": "4-20ma"
+    },
+    {
+      "id": "fuel_press",
+      "name": "Presión de combustible",
+      "unit_si": "bar",
+      "range_normal_min": 3.0,
+      "range_normal_max": 6.0,
+      "alarm_low_value": 2.0,
+      "alarm_low_priority": "high",
+      "default_signal_type": "4-20ma"
+    },
+    {
+      "id": "alternator_v",
+      "name": "Voltaje alternador",
+      "unit_si": "V",
+      "range_normal_min": 27.0,
+      "range_normal_max": 29.0,
+      "alarm_low_value": 24.0,
+      "alarm_low_priority": "high",
+      "default_signal_type": "voltage_divider"
+    },
+    {
+      "id": "load_pct",
+      "name": "Carga del motor",
+      "unit_si": "%",
+      "range_normal_min": 0,
+      "range_normal_max": 100,
+      "default_signal_type": "4-20ma"
+    },
+    {
+      "id": "running_hours",
+      "name": "Horas totales",
+      "unit_si": "h",
+      "range_normal_min": 0,
+      "range_normal_max": 80000,
+      "default_signal_type": "4-20ma"
+    },
+    {
+      "id": "start_cmd",
+      "name": "Comando arranque",
+      "unit_si": "bool",
+      "default_signal_type": "relay_no"
+    },
+    {
+      "id": "stop_cmd",
+      "name": "Comando parada",
+      "unit_si": "bool",
+      "default_signal_type": "relay_no"
+    },
+    {
+      "id": "running_state",
+      "name": "Estado motor en marcha",
+      "unit_si": "bool",
+      "default_signal_type": "dry_contact"
+    },
+    {
+      "id": "estop_active",
+      "name": "E-stop activado",
+      "unit_si": "bool",
+      "default_signal_type": "dry_contact"
+    }
+  ]
+}

vmssailor/library/equipment/engines/volvo_d13_900hp.json

@@ -0,0 +1,112 @@
+{
+  "id": "volvo_d13_900hp",
+  "manufacturer": "Volvo Penta",
+  "model_name": "D13-900",
+  "category": "engine_main",
+  "typical_systems": ["main_engine"],
+  "specs": {
+    "power_kw": 662,
+    "rpm_nominal": 2300,
+    "weight_kg": 1430,
+    "length_m": 1.69,
+    "width_m": 0.99,
+    "height_m": 1.16,
+    "fuel_consumption_lph": 160
+  },
+  "description": "Volvo Penta D13 inline-6, 12.8 L, common rail, twin-entry turbo. Aplicación yates motor 60-90 pies. Habla J1939 nativo.",
+  "data_source": "seed_estimate",
+  "default_sensors": [
+    {
+      "id": "rpm",
+      "name": "RPM",
+      "unit_si": "rpm",
+      "range_normal_min": 0,
+      "range_normal_max": 2400,
+      "alarm_high_value": 2350,
+      "alarm_high_priority": "high",
+      "default_signal_type": "pulse_magnetic_pickup"
+    },
+    {
+      "id": "oil_press",
+      "name": "Presión de aceite",
+      "unit_si": "bar",
+      "range_normal_min": 3.0,
+      "range_normal_max": 5.5,
+      "alarm_low_value": 1.5,
+      "alarm_low_priority": "emergency",
+      "default_signal_type": "4-20ma"
+    },
+    {
+      "id": "oil_temp",
+      "name": "Temperatura de aceite",
+      "unit_si": "C",
+      "range_normal_min": 60,
+      "range_normal_max": 110,
+      "alarm_high_value": 120,
+      "alarm_high_priority": "high",
+      "default_signal_type": "rtd_pt100"
+    },
+    {
+      "id": "coolant_temp",
+      "name": "Temperatura refrigerante",
+      "unit_si": "C",
+      "range_normal_min": 70,
+      "range_normal_max": 92,
+      "alarm_high_value": 98,
+      "alarm_high_priority": "emergency",
+      "default_signal_type": "rtd_pt100"
+    },
+    {
+      "id": "boost_press",
+      "name": "Presión de sobrealimentación",
+      "unit_si": "bar",
+      "range_normal_min": 0.0,
+      "range_normal_max": 2.2,
+      "default_signal_type": "4-20ma"
+    },
+    {
+      "id": "alternator_v",
+      "name": "Voltaje alternador",
+      "unit_si": "V",
+      "range_normal_min": 13.5,
+      "range_normal_max": 14.5,
+      "alarm_low_value": 12.0,
+      "alarm_low_priority": "high",
+      "default_signal_type": "voltage_divider"
+    },
+    {
+      "id": "load_pct",
+      "name": "Carga del motor",
+      "unit_si": "%",
+      "range_normal_min": 0,
+      "range_normal_max": 100,
+      "default_signal_type": "4-20ma"
+    },
+    {
+      "id": "running_hours",
+      "name": "Horas totales",
+      "unit_si": "h",
+      "range_normal_min": 0,
+      "range_normal_max": 80000,
+      "default_signal_type": "4-20ma"
+    },
+    {
+      "id": "start_cmd",
+      "name": "Comando arranque",
+      "unit_si": "bool",
+      "default_signal_type": "relay_no"
+    },
+    {
+      "id": "stop_cmd",
+      "name": "Comando parada",
+      "unit_si": "bool",
+      "default_signal_type": "relay_no"
+    },
+    {
+      "id": "running_state",
+      "name": "Estado motor en marcha",
+      "unit_si": "bool",
+      "default_signal_type": "dry_contact"
+    }
+  ]
+}

vmssailor/library/equipment/gensets/northern_lights_m65c13.json

@@ -0,0 +1,114 @@
+{
+  "id": "northern_lights_m65c13",
+  "manufacturer": "Northern Lights",
+  "model_name": "M65C13",
+  "category": "genset",
+  "typical_systems": ["genset"],
+  "specs": {
+    "power_kw": 52,
+    "rpm_nominal": 1800,
+    "weight_kg": 880,
+    "length_m": 1.55,
+    "width_m": 0.74,
+    "height_m": 0.96,
+    "voltage_v": 230,
+    "current_a": 226,
+    "fuel_consumption_lph": 16.3
+  },
+  "description": "Genset marino diésel Northern Lights M65C13 (Lugger), 65 kVA / 52 kW @ 1800 rpm 60 Hz (válido también a 50 Hz con curva diferente). Motor John Deere 4045 base. Aplicación yates motor 70-90 pies y patrulleros medianos.",
+  "data_source": "seed_estimate",
+  "default_sensors": [
+    {
+      "id": "rpm",
+      "name": "RPM",
+      "unit_si": "rpm",
+      "range_normal_min": 0,
+      "range_normal_max": 1850,
+      "default_signal_type": "pulse_magnetic_pickup"
+    },
+    {
+      "id": "oil_press",
+      "name": "Presión de aceite",
+      "unit_si": "bar",
+      "range_normal_min": 2.5,
+      "range_normal_max": 4.5,
+      "alarm_low_value": 1.0,
+      "alarm_low_priority": "emergency",
+      "default_signal_type": "4-20ma"
+    },
+    {
+      "id": "coolant_temp",
+      "name": "Temperatura refrigerante",
+      "unit_si": "C",
+      "range_normal_min": 70,
+      "range_normal_max": 95,
+      "alarm_high_value": 102,
+      "alarm_high_priority": "emergency",
+      "default_signal_type": "rtd_pt100"
+    },
+    {
+      "id": "voltage_l1",
+      "name": "Tensión L1",
+      "unit_si": "V",
+      "range_normal_min": 220,
+      "range_normal_max": 240,
+      "alarm_low_value": 200,
+      "alarm_low_priority": "high",
+      "alarm_high_value": 250,
+      "alarm_high_priority": "high",
+      "default_signal_type": "voltage_divider"
+    },
+    {
+      "id": "current_l1",
+      "name": "Corriente L1",
+      "unit_si": "A",
+      "range_normal_min": 0,
+      "range_normal_max": 230,
+      "alarm_high_value": 250,
+      "alarm_high_priority": "high",
+      "default_signal_type": "4-20ma"
+    },
+    {
+      "id": "freq",
+      "name": "Frecuencia",
+      "unit_si": "Hz",
+      "range_normal_min": 49.5,
+      "range_normal_max": 60.5,
+      "default_signal_type": "pulse_inductive"
+    },
+    {
+      "id": "load_pct",
+      "name": "Carga",
+      "unit_si": "%",
+      "range_normal_min": 0,
+      "range_normal_max": 100,
+      "default_signal_type": "4-20ma"
+    },
+    {
+      "id": "running_hours",
+      "name": "Horas totales",
+      "unit_si": "h",
+      "range_normal_min": 0,
+      "range_normal_max": 80000,
+      "default_signal_type": "4-20ma"
+    },
+    {
+      "id": "start_cmd",
+      "name": "Comando arranque",
+      "unit_si": "bool",
+      "default_signal_type": "relay_no"
+    },
+    {
+      "id": "stop_cmd",
+      "name": "Comando parada",
+      "unit_si": "bool",
+      "default_signal_type": "relay_no"
+    },
+    {
+      "id": "breaker_status",
+      "name": "Estado breaker principal",
+      "unit_si": "bool",
+      "default_signal_type": "dry_contact"
+    }
+  ]
+}