sprint-1: Studio shell PySide6 + wizard 8 pasos

Sprint 1 entrega el shell del Studio operativo. Para correrlo:
    uv run vms-studio

Componentes:

vmssailor/studio/theme.py
- Aplica design tokens del Sprint 0 (paleta Deep Ocean) a PySide6
- QSS global completo + QPalette + fuentes Inter/Space Grotesk/JetBrains Mono

vmssailor/studio/app.py
- StudioApp (QApplication) con tema, logo, version
- run_studio() entry point

vmssailor/studio/main_window.py
- Layout: topbar / sidebar / canvas central / statusbar
- Menus: Proyecto (Nuevo wizard, Abrir, Guardar, Guardar como, Salir),
  Edicion/Vista (stubs Sprint 2), Ayuda
- Operaciones funcionales: New from wizard, Open .vmsproj, Save, Save As,
  Validate (cross-entity), Compile (placeholder)
- Reloj live + statusbar con stats del proyecto

vmssailor/studio/widgets/system_sidebar.py
- Sidebar dinamico que muestra wizard steps + sistemas habilitados + disponibles
- Lee catalogo maestro y proyecto activo
- Senial systemActivated(SystemId) al doble-click

vmssailor/studio/widgets/vessel_canvas.py
- QGraphicsView central con grilla naval (1m por celda)
- Renderiza silueta del buque en planta + mamparos + equipos
- ship_to_scene() transformacion canonica naval -> escena
- Centerline + Pp axis marcados
- Ruler de eslora con marcas cada 5m
- Zoom con wheel + scroll-pan, label de zoom% en header

vmssailor/studio/wizard/ - QWizard 8 pasos
- step_01_vessel_type: tipo + subtipo + nombre proyecto + cliente
- step_02_template: selector con biblioteca curada (Sunseeker, Ferretti, blank)
- step_03_dimensions: LOA/manga/calado/mamparos con pre-fill de plantilla
- step_04_systems: checkboxes agrupados por categoria con pre-select por default_for
- step_57_placeholder: stubs visuales para Sprint 2 (pasos 5, 6, 7)
- step_08_confirm: resumen HTML completo del proyecto a crear
- VesselWizard.build_project() construye un Project valido

Tests (tests/studio/, 11 nuevos, total 110/110):
- pytest-qt offscreen
- Smoke tests del MainWindow, wizard, canvas, sidebar
- test_ship_to_scene_mapping (transformacion naval->escena)

Stack agregado:
- PySide6 6.11.1
- pytest-qt 4.5.0

Decisiones autonomas:
- QFont.setWeight requiere QFont.Weight enum en PySide6 6.11 (no int)
- QFrame.Shape.NoFrame (no QListWidget.NoFrame) para PySide6 6.11
- Pasos 5-7 quedan placeholders explicitos: Sprint 2 implementa rule engine
- Wizard crea Project sin equipment todavia (Sprint 2 los agrega)

Criterios de aceptacion Sprint 1:
- uv run vms-studio: abre ventana operativa
- 110/110 pytest verde
- ruff clean
- Smoke offscreen: MainWindow + Wizard + Canvas + Sidebar OK

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-05-17 07:52:31 -04:00
parent deb04c9315
commit 813476c8db
21 changed files with 2470 additions and 10 deletions
+60
View File
@@ -0,0 +1,60 @@
"""StudioApp — bootstrap de la aplicación PySide6."""
from __future__ import annotations
import sys
from pathlib import Path
from PySide6.QtCore import QSize, Qt
from PySide6.QtGui import QIcon
from PySide6.QtWidgets import QApplication
from vmssailor.shared.logging_setup import setup_logging
from vmssailor.studio.theme import apply_theme
from vmssailor.version import __version__
BRAND_ROOT = Path(__file__).resolve().parents[2] / "docs" / "brand"
class StudioApp(QApplication):
"""Application class del Studio. Aplica tema y configuración global."""
def __init__(self, argv: list[str] | None = None) -> None:
super().__init__(argv or sys.argv)
self.setOrganizationName("Aerom")
self.setApplicationName("VMS-Sailor Studio")
self.setApplicationVersion(__version__)
self.setApplicationDisplayName("VMS-Sailor Studio")
# Hi-DPI scaling se maneja automáticamente en Qt6.
# Solo seteamos política de redondeo amigable.
self.setAttribute(Qt.AA_UseHighDpiPixmaps, True)
# Logo del app
icon_svg = BRAND_ROOT / "favicon.svg"
if icon_svg.exists():
self.setWindowIcon(QIcon(str(icon_svg)))
apply_theme(self)
def run_studio(argv: list[str] | None = None) -> int:
"""Lanza la aplicación Studio y bloquea hasta que cierre.
Devuelve el exit code de Qt.
"""
setup_logging()
app = StudioApp(argv)
# Import perezoso para evitar costos cuando solo se chequea --help.
from vmssailor.studio.main_window import MainWindow
window = MainWindow()
window.resize(QSize(1440, 900))
window.show()
return app.exec()
if __name__ == "__main__":
sys.exit(run_studio())