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/rules/yacht_motor_planeo.yaml

@@ -0,0 +1,161 @@
+# Reglas heurísticas para yates motor planeo 20-30 m.
+#
+# Este archivo captura el conocimiento de Álvaro sobre qué sistemas y qué
+# equipos lleva típicamente un yate motor planeo del segmento objetivo.
+# El motor de reglas del Studio (Sprint 2) consulta este archivo en el
+# Paso 5 del wizard para proponer equipos al integrador.
+#
+# Filosofía: PROPONE, no impone. El integrador siempre puede ajustar.
+# data_source de cada propuesta es "seed_estimate" y queda en
+# docs/seed_data_notes.md hasta que Álvaro lo valide contra proyectos reales.
+
+meta:
+  version: 1
+  rule_id: yacht_motor_planeo
+  applies_to:
+    vessel_types: ["yacht_motor"]
+    vessel_subtypes: ["planing", "semi_planing"]
+    length_overall_m:
+      min: 18.0
+      max: 32.0
+  data_source: seed_estimate
+
+# ----- Sistemas que típicamente se incluyen -------------------------------
+
+systems_default_enabled:
+  - main_engine
+  - transmission
+  - shaft_propeller
+  - thruster
+  - trim_tabs
+  - genset
+  - shore_power
+  - msb
+  - solar
+  - fuel
+  - lube_oil
+  - fw_cooling
+  - sw_cooling
+  - bilge
+  - potable_water
+  - watermaker
+  - fire_detection
+  - fire_extinguishing
+  - hvac
+  - engine_vent
+  - nav_lights
+  - deck_lights
+  - interior_lights
+  - emergency_lights
+  - fuel_tanks
+  - water_tanks
+  - grey_black_tanks
+  - windlass
+  - anchor_system
+
+systems_optional:
+  - gyrostabilizer    # Seakeeper se vuelve muy común en este rango
+  - joystick_docking
+  - inverter_charger
+  - battery_bank
+  - searchlights
+  - davits
+  - gangway
+
+# ----- Equipos propuestos por sistema --------------------------------------
+
+equipment_proposals:
+
+  main_engine:
+    # Para yates de 20-25 m, MTU o Volvo en pares. Para 25-32 m, MTU.
+    count: 2
+    candidates:
+      - model_ref: mtu_12v_2000_m96
+        when:
+          length_overall_m: { min: 22.0, max: 32.0 }
+        rationale: "Estándar de oro en este rango. Buena disponibilidad de partes y servicio."
+      - model_ref: volvo_d13_900hp
+        when:
+          length_overall_m: { min: 18.0, max: 26.0 }
+        rationale: "Más liviano y económico que MTU 2000. Servicio mundial Volvo Penta."
+    location_template:
+      port:    { x_pp_pct: 0.25, y_cl: -0.9, z_bl: 1.2 }
+      starboard: { x_pp_pct: 0.25, y_cl:  0.9, z_bl: 1.2 }
+    tag_prefix_template: "ME_{side}"
+    sides: ["PORT", "STBD"]
+
+  genset:
+    count: 1
+    candidates:
+      - model_ref: northern_lights_m65c13
+        when:
+          length_overall_m: { min: 18.0, max: 30.0 }
+        rationale: "Confiabilidad probada. Aceptado por clase RINA/Lloyd's con poco trámite."
+    location_template:
+      default: { x_pp_pct: 0.20, y_cl: 0.0, z_bl: 1.0 }
+    tag_prefix_template: "GEN_{idx}"
+
+  fuel:
+    # Sin modelo concreto — el integrador definirá tanques estructurales en Paso 6.
+    sensors_per_tank:
+      - level
+      - temperature
+    typical_tank_count: 2
+    tag_prefix_template: "TANK_FUEL_{idx}"
+
+  bilge:
+    typical_pump_count: 3
+    tag_prefix_template: "BILGE_{location}"
+    locations_template: ["FWD", "MID", "AFT"]
+
+# ----- Permissives típicos a sugerir ---------------------------------------
+
+permissives_template:
+
+  - id: start_main_engine
+    action_id_template: "START_{tag_prefix}"
+    apply_to: ["main_engine"]
+    conditions:
+      - tag_ref_template: "{tag_prefix}.OIL_PRESS"
+        operator: ">"
+        threshold: 0.3
+        message_on_fail: "Presión aceite previa al arranque demasiado baja (lubricación insuficiente)."
+      - tag_ref_template: "{tag_prefix}.COOLANT_TEMP"
+        operator: ">"
+        threshold: 5.0
+        message_on_fail: "Refrigerante por debajo de 5°C — pre-calentar antes de arrancar."
+      - tag_ref_template: "{tag_prefix}.ESTOP_ACTIVE"
+        operator: "is_false"
+        message_on_fail: "Pulsador E-stop activado — desbloquear antes de arrancar."
+    on_fail_message: "Pre-condiciones de arranque del motor principal no cumplidas."
+
+  - id: start_genset
+    action_id_template: "START_{tag_prefix}"
+    apply_to: ["genset"]
+    conditions:
+      - tag_ref_template: "{tag_prefix}.OIL_PRESS"
+        operator: ">"
+        threshold: 0.3
+        message_on_fail: "Presión aceite previa baja."
+      - tag_ref_template: "{tag_prefix}.COOLANT_TEMP"
+        operator: ">"
+        threshold: 0.0
+        message_on_fail: "Refrigerante demasiado frío para arranque seguro."
+    on_fail_message: "Pre-condiciones de arranque del genset no cumplidas."
+
+# ----- Topología sugerida de tarjetas AR-NMEA-IO --------------------------
+
+topology_template:
+  # Patrón típico para yate planeo con 2 motores + 1 genset + tanques + auxiliares:
+  # 5-7 tarjetas distribuidas. Una maestra Modbus en el PC industrial.
+  cards_estimate:
+    min: 5
+    typical: 6
+    max: 8
+  buses:
+    - id: bus_main
+      protocol: modbus_rtu
+      role: "Maestra en PC industrial central. Esclavas distribuidas."
+    - id: bus_n2k
+      protocol: nmea2000
+      role: "Backbone NMEA 2000 del buque. Motores y gensets en modo dual."