Files
AR-VMS-Seaman/tests/core/persistence/test_roundtrip.py
T
alro65 deb04c9315 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>
2026-05-17 07:26:06 -04:00

91 lines
3.0 KiB
Python

"""Test crítico Sprint 0: roundtrip de persistencia .vmsproj.
Criterio de aceptación de la Parte 6: `load_project(save_project(p))` produce
un Project equivalente campo por campo.
"""
from __future__ import annotations
import sqlite3
from pathlib import Path
import pytest
from vmssailor.core import Project
from vmssailor.core.persistence import load_project, save_project
from vmssailor.core.persistence.vmsproj_reader import VmsProjError
from vmssailor.tools.generate_test_project import build_demo_project
def _projects_equivalent(a: Project, b: Project) -> bool:
return a.model_dump(mode="json", exclude={"updated_at"}) == b.model_dump(
mode="json", exclude={"updated_at"}
)
def test_roundtrip_minimal(sample_project: Project, tmp_path: Path) -> None:
out = tmp_path / "minimal.vmsproj"
save_project(sample_project, out)
assert out.exists()
loaded = load_project(out)
assert _projects_equivalent(sample_project, loaded)
def test_roundtrip_full_demo(tmp_path: Path) -> None:
project = build_demo_project()
out = tmp_path / "demo.vmsproj"
save_project(project, out)
loaded = load_project(out)
assert _projects_equivalent(project, loaded), (
"Roundtrip falló — el proyecto releído no coincide con el original."
)
# Stats deben coincidir 1:1
assert project.stats() == loaded.stats()
def test_vmsproj_is_real_sqlite(sample_project: Project, tmp_path: Path) -> None:
out = tmp_path / "x.vmsproj"
save_project(sample_project, out)
# Cualquier herramienta SQLite debe abrirlo
conn = sqlite3.connect(str(out))
try:
version = conn.execute("SELECT MAX(version) FROM schema_version").fetchone()[0]
assert version == 1
# Meta esperada
meta_rows = dict(conn.execute("SELECT key, value FROM meta"))
assert meta_rows["file_format"] == "vmsproj"
finally:
conn.close()
def test_load_nonexistent_raises(tmp_path: Path) -> None:
with pytest.raises(VmsProjError):
load_project(tmp_path / "does_not_exist.vmsproj")
def test_load_invalid_db_raises(tmp_path: Path) -> None:
bad = tmp_path / "bad.vmsproj"
bad.write_bytes(b"not a sqlite database at all")
with pytest.raises(Exception): # noqa: B017 -- sqlite3 levanta varias clases distintas
load_project(bad)
def test_save_overwrites_existing(sample_project: Project, tmp_path: Path) -> None:
out = tmp_path / "ow.vmsproj"
save_project(sample_project, out)
first_size = out.stat().st_size
# Modifico el proyecto y vuelvo a guardar
sample_project.notes = "Cambiado en memoria"
save_project(sample_project, out)
loaded = load_project(out)
assert loaded.notes == "Cambiado en memoria"
# El archivo sigue siendo válido
assert out.stat().st_size > 0
_ = first_size # no relevante para el assert principal
def test_save_creates_parent_dirs(sample_project: Project, tmp_path: Path) -> None:
out = tmp_path / "deep" / "nested" / "out.vmsproj"
save_project(sample_project, out)
assert out.exists()