alro65
6ad76a89fa
Wizard pasos 5-7 ahora funcionales (1-4 ya estaban en Sprint 1).
vmssailor/studio/designer/rule_engine.py
- RuleContext, RuleEngine, EquipmentProposal
- Lee library/rules/*.yaml y aplica reglas heuristicas
- Filtra por vessel_type, vessel_subtype, length_overall_m range
- Selecciona candidato segun condiciones 'when' (loa min/max)
- Genera tag_prefix con sustitucion {side}/{idx}
vmssailor/studio/designer/port_auto_assigner.py
- auto_assign() greedy: 1 bus Modbus RTU + tarjetas dedicadas para motores/gensets
- Tarjeta auxiliar compartida para resto de equipos
- Mapea SignalType -> ChannelType (AI/DI/DO/RPM)
- Genera TagBindings con scaling apropiado por tipo de senal
- Respeta capacidades 10/5/4/1 de AR-NMEA-IO-v1.0
- AssignmentReport con cards + tags + warnings
vmssailor/studio/wizard/step_05_equipment.py
- Tabla con propuestas del rule engine
- Checkboxes accept/reject + edicion inline de columnas
- Boton 'Regenerar' para re-aplicar reglas
vmssailor/studio/wizard/step_06_refinement.py
- Vista resumen de equipos aceptados
vmssailor/studio/wizard/step_07_topology.py
- Llama auto_assign sobre los equipos materializados
- Muestra tabla de tarjetas con uso por canal (DO/DI/AI/RPM)
- Lista warnings de capacidad
vmssailor/studio/editors/equipment_editor.py
- CRUD de Equipment del proyecto activo
- Tabla editable inline (tag_prefix, name, model_ref, system_id, coords, deck)
- Dialog modal para agregar equipos
- Senal projectMutated para refrescar canvas + sidebar
vmssailor/studio/main_window.py
- Layout actualizado: splitter vertical en panel derecho
(canvas arriba + equipment editor abajo)
- _on_project_mutated() re-distribuye al sidebar y canvas
Biblioteca expandida (Sprint 2 brief: 5-7 yates, 10+ motores, gensets, bombas):
- vessels: + azimut_grande_32m, princess_y85, trawler_32m_offshore, patrol_coastal_30m (total: 6)
- engines: + cat_c32_acert, mtu_16v_2000_m96, yanmar_8lv_370 (total: 5)
- gensets: + kohler_28efkozd, onan_qd13500 (total: 3)
- pumps: + jabsco_36800, grundfos_cm10 (NUEVO categoria pumps)
Tests (tests/studio/test_designer.py, 10 nuevos, total 120/120):
- Rule engine: load default, propose engines, candidate picking por LOA
- auto_assign builds topology compatible with Project (Pydantic validation)
- Equipment editor smoke
VesselWizard.build_project() ahora materializa equipment + topology + tags
desde las propuestas y la asignacion automatica del paso 7.
Criterios Sprint 2:
- uv run vms-studio crea proyecto completo desde wizard con equipos + tags + topologia
- vms-validate-library: OK 6 vessels, 10 equipment, 1 rules
- 120/120 pytest verde, ruff clean
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
VMS-Sailor
Vessel Management System integrado (IAS — Integrated Automation System) para buques de 30 a 40 metros.
Yates motor · Pesqueros · Patrulleros · Ferries pequeños · Offshore support pequeño
Compite en el nicho que Kongsberg K-Chief, Praxis Mega-Guard, Bachmann M-Series y Wärtsilä NACOS desatienden por enfocarse en buques de 80+ m.
Componentes
| Componente | Para quién | Stack |
|---|---|---|
| VMS-Sailor Studio | Ingeniería interna (Álvaro) | Python 3.11 + PySide6 |
| VMS-Sailor Runtime | A bordo del buque | Python 3.11 + FastAPI + SQLite + DuckDB |
| VMS-Sailor Mobile | Owner + tripulación (WiFi local) | Flutter 3.x + Dart 3.x |
| AR-NMEA-IO-v1.0 firmware | Tarjeta I/O distribuida | ESP32 + PlatformIO + C++ |
Estado actual
Sprint 0 — Fundaciones ✓
Lo que existe en este commit:
- Modelo de datos core (
vmssailor/core/) con Pydantic v2 - Persistencia portable a
.vmsproj(SQLite) - Biblioteca curada seed mínima (2 yates motor, 2 motores, 1 genset, reglas)
- Catálogo maestro completo de sistemas (
vmssailor/library/systems_catalog.json) - Validador de biblioteca + generador de proyecto demo
- Tests con cobertura ≥ 80% en
core - Design system + mockups HTML estáticos
- Firmware: solo
pinout.h(Sprint 12 implementa el firmware)
Lo que NO existe aún (sprints siguientes):
- ❌ UI Studio operativa (Sprint 1)
- ❌ Runtime servidor con drivers Modbus/NMEA 2000 (Sprint 4)
- ❌ Cliente desktop (Sprint 6)
- ❌ App móvil Flutter (Sprint 11)
- ❌ Firmware funcional (Sprint 12)
Setup
Requiere Python 3.11 y uv.
# Si no tienes Python 3.11 instalado, uv lo descarga solo:
uv python install 3.11
# Crear entorno virtual + instalar dependencias:
uv sync --extra dev
# Validar la biblioteca curada:
uv run vms-validate-library
# Generar proyecto demo y verificar roundtrip de persistencia:
uv run vms-generate-test-project
# Tests:
uv run pytest
# Lint + type check:
uv run ruff check vmssailor/ tests/ tools/
uv run mypy vmssailor/core/
Estructura del repositorio
.
├── vmssailor/ # Código Python compartido (Studio + Runtime)
│ ├── core/ # ★ Modelo de datos del producto (Sprint 0)
│ ├── library/ # ★ Biblioteca curada seed (Sprint 0)
│ ├── shared/ # Utilidades comunes
│ ├── studio/ # App Studio (Sprint 1+)
│ └── runtime/ # App Runtime (Sprint 4+)
├── firmware/ # Firmware ESP32 (Sprint 12+)
│ └── ar_nmea_io_v1/
│ └── src/config/pinout.h
├── mobile/ # App Flutter (Sprint 11)
├── tests/ # Tests Python (pytest)
├── tools/ # Scripts CLI
│ ├── validate_library.py
│ └── generate_test_project.py
├── docs/ # Documentación
│ ├── architecture.md
│ ├── coords.md
│ ├── design_system.md # ★ Sistema visual completo
│ ├── decisions_sprint0.md
│ ├── seed_data_notes.md
│ ├── mockups/ # ★ HTML mockups del producto
│ └── brand/ # ★ Logo y assets
├── installer/ # WiX MSI scripts (Sprint 7)
├── VMS_Sailor_v2_Parte_*.md # Brief original (intacto)
├── pyproject.toml
└── README.md
Documentos de referencia (intactos)
Los 6 archivos VMS_Sailor_v2_Parte_*.md son el brief original y son la verdad de referencia para todos los sprints. NO se modifican sin acuerdo explícito.
- Parte 1 — Visión, arquitectura general
- Parte 2 — Studio en detalle
- Parte 3 — Runtime en detalle
- Parte 4 — Hardware AR-NMEA-IO + firmware
- Parte 5 — Mobile
- Parte 6 — Sprints + reglas de oro
Reglas de oro (recordatorio)
- Antes de cada sprint, plan + OK explícito antes de codear.
- Tests obligatorios en
coreyruntime/server. - No agregar dependencias sin preguntar.
- Documentar normativa (IEC 60092-504, IACS UR E22, ABYC E-11, NMEA 2000, SAE J1939).
- Sin red de salida en Runtime (salvo activación inicial y VPN administrativa).
- Biblioteca curada es ORO — cambios de formato requieren migración.
- Runtime es inmutable para el cliente — solo deltas firmados.
- Auditoría siempre activa.
- Coordenadas navales
ShipCoord(x_pp, y_cl, z_bl)en todo el código. - Unidades SI internas siempre.
- Idioma: español por defecto.
- AR-ECDIS es producto separado (no se desarrolla aquí).
- Firmware y software van juntos en el mismo
.vmspack.
Detalle completo en VMS_Sailor_v2_Parte_06_Sprints_y_reglas.md sección 5.
Licencia
Software propietario de Álvaro. Ver LICENSE.txt.