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>
44 lines
1.2 KiB
Python
44 lines
1.2 KiB
Python
"""Logging unificado para Studio, Runtime y tools.
|
|
|
|
Sprint 0: configuración mínima. Sprint 4+ agregará rotación, file handlers,
|
|
journald, etc.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import logging
|
|
import sys
|
|
from typing import Final
|
|
|
|
_DEFAULT_FORMAT: Final[str] = (
|
|
"%(asctime)s %(levelname)-7s %(name)-30s :: %(message)s"
|
|
)
|
|
_DEFAULT_DATEFMT: Final[str] = "%Y-%m-%d %H:%M:%S"
|
|
|
|
_configured: bool = False
|
|
|
|
|
|
def setup_logging(level: int = logging.INFO, *, verbose: bool = False) -> None:
|
|
"""Configura el root logger una sola vez.
|
|
|
|
Idempotente: llamadas posteriores son no-op (a menos que se cambie level).
|
|
"""
|
|
global _configured
|
|
root = logging.getLogger()
|
|
if _configured:
|
|
root.setLevel(level)
|
|
return
|
|
|
|
handler = logging.StreamHandler(sys.stderr)
|
|
handler.setFormatter(logging.Formatter(_DEFAULT_FORMAT, datefmt=_DEFAULT_DATEFMT))
|
|
root.addHandler(handler)
|
|
root.setLevel(logging.DEBUG if verbose else level)
|
|
_configured = True
|
|
|
|
|
|
def get_logger(name: str) -> logging.Logger:
|
|
"""Logger de módulo. Asegura que setup_logging() se haya llamado."""
|
|
if not _configured:
|
|
setup_logging()
|
|
return logging.getLogger(name)
|