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>
84 lines
2.5 KiB
Python
84 lines
2.5 KiB
Python
"""Sistema de coordenadas naval.
|
|
|
|
Regla de oro #11: coordenadas navales consistentes en TODO el código.
|
|
|
|
- X: desde Perpendicular de Popa (Pp), positivo hacia proa.
|
|
- Y: desde Línea de Crujía (CL), positivo a estribor, negativo a babor.
|
|
- Z: desde Línea Base (BL), positivo hacia arriba.
|
|
|
|
Todo en metros (SI).
|
|
|
|
`ShipCoord` es inmutable (`frozen=True`). Cualquier transformación a
|
|
pantalla pasa por renderers (UI) explícitos, NO por métodos de esta clase.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from typing import ClassVar
|
|
|
|
from pydantic import BaseModel, ConfigDict, Field
|
|
|
|
|
|
class ShipCoord(BaseModel):
|
|
"""Punto en el marco del buque (Pp / CL / BL).
|
|
|
|
Buques típicos del segmento 30-40 m:
|
|
- Eslora total: 20 - 60 m
|
|
- Manga máxima: 5 - 15 m
|
|
- Calado: 0.5 - 5 m
|
|
- Altura sobre BL: -3 m (quilla) a +20 m (mástil)
|
|
|
|
Los validadores permiten un margen extra para cubrir buques en
|
|
desarrollo y errores de captura del integrador.
|
|
"""
|
|
|
|
model_config = ConfigDict(frozen=True, extra="forbid")
|
|
|
|
x_pp: float = Field(
|
|
...,
|
|
ge=-5.0,
|
|
le=200.0,
|
|
description="Metros desde Perpendicular de Popa, positivo hacia proa.",
|
|
)
|
|
y_cl: float = Field(
|
|
...,
|
|
ge=-30.0,
|
|
le=30.0,
|
|
description="Metros desde Línea de Crujía, +estribor / -babor.",
|
|
)
|
|
z_bl: float = Field(
|
|
...,
|
|
ge=-10.0,
|
|
le=50.0,
|
|
description="Metros desde Línea Base, positivo hacia arriba.",
|
|
)
|
|
|
|
ORIGIN: ClassVar[str] = "Pp/CL/BL"
|
|
UNIT: ClassVar[str] = "m"
|
|
|
|
def as_tuple(self) -> tuple[float, float, float]:
|
|
"""Devuelve (x_pp, y_cl, z_bl) para serialización o cálculos numpy."""
|
|
return (self.x_pp, self.y_cl, self.z_bl)
|
|
|
|
def is_starboard(self) -> bool:
|
|
"""True si está a estribor (y_cl > 0)."""
|
|
return self.y_cl > 0.0
|
|
|
|
def is_port(self) -> bool:
|
|
"""True si está a babor (y_cl < 0)."""
|
|
return self.y_cl < 0.0
|
|
|
|
def is_centerline(self) -> bool:
|
|
"""True si está en línea de crujía (y_cl == 0, con tolerancia mm)."""
|
|
return abs(self.y_cl) < 1e-3
|
|
|
|
def distance_to(self, other: ShipCoord) -> float:
|
|
"""Distancia euclídea 3D en metros entre dos puntos del buque."""
|
|
dx = self.x_pp - other.x_pp
|
|
dy = self.y_cl - other.y_cl
|
|
dz = self.z_bl - other.z_bl
|
|
return (dx * dx + dy * dy + dz * dz) ** 0.5
|
|
|
|
def __str__(self) -> str:
|
|
return f"ShipCoord(x_pp={self.x_pp:.2f}, y_cl={self.y_cl:+.2f}, z_bl={self.z_bl:+.2f}) [m]"
|