alro65
deb04c9315
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>
56 lines
2.8 KiB
Markdown
56 lines
2.8 KiB
Markdown
# Notas sobre la biblioteca seed — Sprint 0
|
|
|
|
> Todos los archivos de `vmssailor/library/vessels/` y `vmssailor/library/equipment/` están marcados con `data_source: "seed_estimate"`. Antes de Sprint 1, **Álvaro debe revisar y validar contra datasheets oficiales**.
|
|
|
|
## Filosofía
|
|
|
|
Para no bloquear el Sprint 0 esperando datasheets de fabricantes, todas las entradas de biblioteca seed traen:
|
|
|
|
- Valores plausibles tomados de información pública (catálogos de fabricantes, especificaciones técnicas accesibles)
|
|
- `data_source: "seed_estimate"` como bandera explícita
|
|
- Estructura completa de campos para no requerir migraciones tras validación
|
|
|
|
El validador `vms-validate-library` emite **INFO** (no error, no warning) por cada entrada `seed_estimate` para que el integrador sepa exactamente qué revisar.
|
|
|
|
## Entradas a validar
|
|
|
|
### Vessels
|
|
|
|
| ID | Modelo | Campos críticos a verificar |
|
|
|---|---|---|
|
|
| `sunseeker_76` | Sunseeker 76 Yacht | LOA, beam, draft, displacement, bulkhead positions, deck heights |
|
|
| `ferretti_850` | Ferretti 850 | Idem |
|
|
|
|
Específicamente, las **posiciones de mamparos** (`bulkheads[].x_pp`) y las **alturas de cubierta** (`decks[].z_bl_bottom`, `z_bl_top`) son **estimaciones** — el integrador real medirá esto en el GA del buque.
|
|
|
|
### Equipment models
|
|
|
|
| ID | Modelo | Campos a verificar |
|
|
|---|---|---|
|
|
| `mtu_12v_2000_m96` | MTU 12V 2000 M96 | power_kw, rpm_nominal, weight_kg, dimensions, fuel_consumption_lph, **sensores específicos** y sus rangos / alarmas |
|
|
| `volvo_d13_900hp` | Volvo Penta D13-900 | Idem |
|
|
| `northern_lights_m65c13` | Northern Lights M65C13 | power_kw, voltaje nominal (¿230V o 120/240V split?), corriente, rpm, **sensores y rangos** |
|
|
|
|
### Sensores típicos (`default_sensors`)
|
|
|
|
Para cada `EquipmentModel`, los sensores listados con sus rangos normales y umbrales de alarma son **plantillas** sugeridas. Cada buque real puede tener:
|
|
|
|
- Sensores adicionales no contemplados (RTDs específicos, sondas en lugares no estándar)
|
|
- Sensores omitidos por costo
|
|
- Umbrales ajustados según armador / sociedad de clasificación
|
|
|
|
En Sprint 1 (Studio wizard paso 6) el integrador refina los sensores reales para cada equipo concreto.
|
|
|
|
### Reglas heurísticas
|
|
|
|
`rules/yacht_motor_planeo.yaml` contiene la heurística inicial de Álvaro. Es esperable que la afine con experiencia de campo. La rule_engine de Sprint 2 las consume.
|
|
|
|
## Cómo validar al despertar
|
|
|
|
1. Ejecutar `uv run vms-validate-library --verbose` para ver la lista de INFOs
|
|
2. Para cada modelo, abrir su JSON y comparar contra el datasheet oficial:
|
|
- Ajustar valores
|
|
- Cambiar `data_source` a `"manufacturer_datasheet"` cuando esté verificado
|
|
3. Correr `uv run pytest tests/library/` para que sigan los tests verdes
|
|
4. Si cambia algún rango o umbral de alarma, actualizar también las reglas heurísticas si afectan
|