Versión {v} · Sprint 1
+Herramienta de ingeniería para configurar el VMS-Sailor de cada buque.
+Propiedad intelectual de Álvaro. Todos los derechos reservados.
""", + ) + + # ----- Public ops --------------------------------------------------- + + def set_project(self, project: Project | None, *, path: Path | None) -> None: + self._project = project + self._project_path = path + has_project = project is not None + self._act_save.setEnabled(has_project) + self._act_save_as.setEnabled(has_project) + self._btn_save_top.setEnabled(has_project) + self._btn_validate.setEnabled(has_project) + self._btn_compile.setEnabled(has_project) + self._update_window_title() + self._update_stats() + if project is not None: + self.projectChanged.emit(project) + + # ----- Helpers ------------------------------------------------------ + + def _update_window_title(self) -> None: + if not self._project: + self.setWindowTitle("VMS-Sailor Studio — Sin proyecto") + self._breadcrumb_label.setText( + "VMS-Sailor Studio · sin proyecto abierto · usa Proyecto › Nuevo desde wizard" + ) + return + crumbs = f"Proyectos / {self._project.id} / Topología" + self._breadcrumb_label.setText(crumbs) + path_str = str(self._project_path) if self._project_path else "(sin guardar)" + self.setWindowTitle(f"VMS-Sailor Studio — {self._project.name} ({path_str})") + + def _update_stats(self) -> None: + if not self._project: + self._stats_label.setText("0 sistemas · 0 equipos · 0 tags · 0 tarjetas") + return + s = self._project.stats() + self._stats_label.setText( + f"{s['systems']} sistemas · {s['equipment']} equipos · {s['tags']} tags · " + f"{s['cards']} tarjetas · {s['permissive_rules']} rules" + ) + + def _update_clock(self) -> None: + now = datetime.now() + self._clock_label.setText(now.strftime("%H:%M:%S · %Y-%m-%d")) + + # ----- Test helpers ------------------------------------------------- + + def current_project(self) -> Project | None: + return self._project diff --git a/vmssailor/studio/theme.py b/vmssailor/studio/theme.py new file mode 100644 index 0000000..2a747de --- /dev/null +++ b/vmssailor/studio/theme.py @@ -0,0 +1,392 @@ +"""Tema visual del Studio — aplica los design tokens del Sprint 0 a PySide6. + +Los tokens canónicos viven en `docs/design_system.md` y `docs/mockups/_tokens.css`. +Este módulo replica esos valores en Python para construir el QSS (Qt Style Sheets) +y los QPalette necesarios. +""" + +from __future__ import annotations + +from PySide6.QtGui import QColor, QFont, QFontDatabase, QPalette +from PySide6.QtWidgets import QApplication + +# ----- Paleta Deep Ocean (canónica) -------------------------------------- + +C_ABYSS = "#04111F" +C_MIDNIGHT = "#0A1A2E" +C_STEEL = "#1A2B42" +C_IRON = "#2C3E5C" +C_FOG = "#7C8B9F" +C_SAND = "#E6EAF0" +C_FOAM = "#F2F5F9" +C_CYAN = "#00D9FF" +C_CYAN_DEEP = "#1B7FB5" +C_HORIZON = "#5BC0EB" + +C_OK = "#00E08A" +C_INFO = "#5BC0EB" +C_WARN = "#FFB020" +C_HIGH = "#FF8030" +C_EMERGENCY = "#FF3B47" + + +# ----- Fuentes ----------------------------------------------------------- + +FAMILY_DISPLAY = "Space Grotesk" +FAMILY_UI = "Inter" +FAMILY_MONO = "JetBrains Mono" + +FALLBACK_DISPLAY = "Segoe UI" +FALLBACK_UI = "Segoe UI" +FALLBACK_MONO = "Cascadia Mono" + + +def best_family(preferred: str, fallback: str) -> str: + """Devuelve `preferred` si está instalado, si no `fallback`.""" + families = set(QFontDatabase.families()) + if preferred in families: + return preferred + return fallback + + +def display_font( + point_size: int = 16, weight: QFont.Weight | int = QFont.Weight.DemiBold +) -> QFont: + f = QFont(best_family(FAMILY_DISPLAY, FALLBACK_DISPLAY)) + f.setPointSize(point_size) + if isinstance(weight, int): + # PySide6 6.11 requiere QFont.Weight, no int. Aproximamos. + if weight <= 300: + weight = QFont.Weight.Light + elif weight <= 400: + weight = QFont.Weight.Normal + elif weight <= 500: + weight = QFont.Weight.Medium + elif weight <= 600: + weight = QFont.Weight.DemiBold + elif weight <= 700: + weight = QFont.Weight.Bold + else: + weight = QFont.Weight.Black + f.setWeight(weight) + return f + + +def ui_font(point_size: int = 10) -> QFont: + f = QFont(best_family(FAMILY_UI, FALLBACK_UI)) + f.setPointSize(point_size) + return f + + +def mono_font(point_size: int = 10) -> QFont: + f = QFont(best_family(FAMILY_MONO, FALLBACK_MONO)) + f.setPointSize(point_size) + return f + + +# ----- Stylesheet global ------------------------------------------------- + + +_QSS = f""" +QMainWindow, QDialog, QWidget {{ + background-color: {C_ABYSS}; + color: {C_SAND}; +}} + +QWidget#topbar {{ + background-color: {C_MIDNIGHT}; + border-bottom: 1px solid {C_STEEL}; +}} + +QWidget#sidebar {{ + background-color: {C_MIDNIGHT}; + border-right: 1px solid {C_STEEL}; +}} + +QWidget#statusbar {{ + background-color: {C_MIDNIGHT}; + border-top: 1px solid {C_STEEL}; + color: {C_FOG}; +}} + +QLabel {{ + color: {C_SAND}; +}} + +QLabel#title {{ + color: {C_FOAM}; + font-weight: 600; +}} + +QLabel#h1 {{ + color: {C_FOAM}; + font-size: 22pt; + font-weight: 600; +}} + +QLabel#caption {{ + color: {C_FOG}; + font-size: 9pt; +}} + +QLabel#overline {{ + color: {C_FOG}; + font-size: 9pt; + font-weight: 700; + letter-spacing: 2px; + text-transform: uppercase; +}} + +QPushButton {{ + background-color: transparent; + color: {C_SAND}; + border: 1px solid {C_IRON}; + border-radius: 6px; + padding: 8px 16px; + min-width: 80px; +}} +QPushButton:hover {{ + background-color: {C_STEEL}; +}} +QPushButton:pressed {{ + background-color: {C_IRON}; +}} +QPushButton:disabled {{ + background-color: {C_STEEL}; + color: {C_FOG}; + border-color: transparent; +}} + +QPushButton#primary {{ + background-color: {C_CYAN}; + color: {C_ABYSS}; + border: none; + font-weight: 600; +}} +QPushButton#primary:hover {{ + background-color: {C_HORIZON}; +}} + +QPushButton#danger {{ + background-color: {C_EMERGENCY}; + color: {C_FOAM}; + border: none; + font-weight: 700; +}} + +QLineEdit, QSpinBox, QDoubleSpinBox, QComboBox, QPlainTextEdit, QTextEdit {{ + background-color: {C_STEEL}; + color: {C_FOAM}; + border: 1px solid {C_IRON}; + border-radius: 4px; + padding: 6px 10px; + selection-background-color: {C_CYAN}; + selection-color: {C_ABYSS}; +}} +QLineEdit:focus, QSpinBox:focus, QDoubleSpinBox:focus, QComboBox:focus {{ + border-color: {C_CYAN}; +}} + +QComboBox::drop-down {{ + border: none; + width: 24px; +}} +QComboBox::down-arrow {{ + image: none; + width: 0; + height: 0; + border-left: 5px solid transparent; + border-right: 5px solid transparent; + border-top: 6px solid {C_FOG}; + margin-right: 8px; +}} +QComboBox QAbstractItemView {{ + background-color: {C_MIDNIGHT}; + color: {C_SAND}; + border: 1px solid {C_IRON}; + selection-background-color: {C_CYAN_DEEP}; + selection-color: {C_FOAM}; +}} + +QCheckBox {{ + color: {C_SAND}; + spacing: 8px; +}} +QCheckBox::indicator {{ + width: 18px; + height: 18px; + background-color: {C_STEEL}; + border: 1px solid {C_IRON}; + border-radius: 3px; +}} +QCheckBox::indicator:hover {{ + border-color: {C_CYAN}; +}} +QCheckBox::indicator:checked {{ + background-color: {C_CYAN}; + border-color: {C_CYAN}; + image: none; +}} + +QListWidget, QTreeWidget, QTableWidget {{ + background-color: {C_MIDNIGHT}; + color: {C_SAND}; + border: 1px solid {C_STEEL}; + border-radius: 6px; + outline: 0; +}} +QListWidget::item, QTreeWidget::item {{ + padding: 8px 10px; + border-radius: 4px; +}} +QListWidget::item:hover, QTreeWidget::item:hover {{ + background-color: {C_STEEL}; +}} +QListWidget::item:selected, QTreeWidget::item:selected {{ + background-color: rgba(0, 217, 255, 30); + color: {C_FOAM}; + border-left: 2px solid {C_CYAN}; +}} + +QHeaderView::section {{ + background-color: {C_MIDNIGHT}; + color: {C_FOG}; + border: none; + border-right: 1px solid {C_STEEL}; + padding: 8px; + font-weight: 600; +}} + +QMenuBar {{ + background-color: {C_MIDNIGHT}; + color: {C_SAND}; + border-bottom: 1px solid {C_STEEL}; +}} +QMenuBar::item {{ + padding: 6px 12px; + background: transparent; +}} +QMenuBar::item:selected {{ + background-color: {C_STEEL}; + color: {C_CYAN}; +}} + +QMenu {{ + background-color: {C_MIDNIGHT}; + color: {C_SAND}; + border: 1px solid {C_IRON}; +}} +QMenu::item {{ + padding: 6px 24px; +}} +QMenu::item:selected {{ + background-color: {C_STEEL}; + color: {C_CYAN}; +}} + +QToolBar {{ + background-color: {C_MIDNIGHT}; + border: none; + spacing: 4px; + padding: 4px; +}} + +QStatusBar {{ + background-color: {C_MIDNIGHT}; + color: {C_FOG}; + border-top: 1px solid {C_STEEL}; +}} + +QScrollBar:vertical {{ + background: {C_ABYSS}; + width: 12px; + border: none; +}} +QScrollBar::handle:vertical {{ + background: {C_IRON}; + border-radius: 6px; + min-height: 30px; +}} +QScrollBar::handle:vertical:hover {{ + background: {C_FOG}; +}} +QScrollBar::add-line:vertical, QScrollBar::sub-line:vertical {{ + height: 0; +}} +QScrollBar:horizontal {{ + background: {C_ABYSS}; + height: 12px; + border: none; +}} +QScrollBar::handle:horizontal {{ + background: {C_IRON}; + border-radius: 6px; + min-width: 30px; +}} +QScrollBar::add-line:horizontal, QScrollBar::sub-line:horizontal {{ + height: 0; +}} + +QGroupBox {{ + color: {C_FOAM}; + border: 1px solid {C_STEEL}; + border-radius: 8px; + margin-top: 18px; + padding-top: 12px; + font-weight: 600; +}} +QGroupBox::title {{ + subcontrol-origin: margin; + left: 12px; + padding: 0 6px; + color: {C_FOG}; + font-size: 9pt; + letter-spacing: 1.5px; + text-transform: uppercase; +}} + +QWizard {{ + background-color: {C_ABYSS}; +}} +QWizard QWidget {{ + background-color: {C_ABYSS}; +}} + +QToolTip {{ + background-color: {C_MIDNIGHT}; + color: {C_FOAM}; + border: 1px solid {C_CYAN}; + padding: 6px 10px; + border-radius: 4px; +}} +""" + + +def apply_theme(app: QApplication) -> None: + """Aplica el tema completo Deep Ocean a la app. + + - Stylesheet QSS + - QPalette (para widgets que no respetan QSS) + - Fuentes default + """ + app.setStyle("Fusion") + + palette = QPalette() + palette.setColor(QPalette.Window, QColor(C_ABYSS)) + palette.setColor(QPalette.WindowText, QColor(C_SAND)) + palette.setColor(QPalette.Base, QColor(C_MIDNIGHT)) + palette.setColor(QPalette.AlternateBase, QColor(C_STEEL)) + palette.setColor(QPalette.Text, QColor(C_FOAM)) + palette.setColor(QPalette.Button, QColor(C_STEEL)) + palette.setColor(QPalette.ButtonText, QColor(C_SAND)) + palette.setColor(QPalette.BrightText, QColor(C_EMERGENCY)) + palette.setColor(QPalette.Highlight, QColor(C_CYAN)) + palette.setColor(QPalette.HighlightedText, QColor(C_ABYSS)) + palette.setColor(QPalette.Link, QColor(C_CYAN)) + palette.setColor(QPalette.ToolTipBase, QColor(C_MIDNIGHT)) + palette.setColor(QPalette.ToolTipText, QColor(C_FOAM)) + palette.setColor(QPalette.PlaceholderText, QColor(C_FOG)) + app.setPalette(palette) + + app.setFont(ui_font(10)) + app.setStyleSheet(_QSS) diff --git a/vmssailor/studio/widgets/__init__.py b/vmssailor/studio/widgets/__init__.py new file mode 100644 index 0000000..83833a4 --- /dev/null +++ b/vmssailor/studio/widgets/__init__.py @@ -0,0 +1 @@ +"""Widgets reutilizables del Studio.""" diff --git a/vmssailor/studio/widgets/system_sidebar.py b/vmssailor/studio/widgets/system_sidebar.py new file mode 100644 index 0000000..0193e14 --- /dev/null +++ b/vmssailor/studio/widgets/system_sidebar.py @@ -0,0 +1,165 @@ +"""Sidebar dinámico de sistemas del proyecto. + +Lee el catálogo maestro de sistemas y muestra: +- Sistemas habilitados del Project (en la parte superior, con contador de equipos) +- Sistemas NO habilitados pero disponibles (al pie, en gris) + +En Sprint 1 es sólo visualización. En Sprint 2 se podrá toggle desde aquí. +""" + +from __future__ import annotations + +from collections import Counter + +from PySide6.QtCore import Qt, Signal +from PySide6.QtWidgets import ( + QFrame, + QLabel, + QListWidget, + QListWidgetItem, + QVBoxLayout, + QWidget, +) + +from vmssailor.core.enums import SystemId +from vmssailor.core.project import Project +from vmssailor.library import load_systems_catalog +from vmssailor.studio.theme import C_FOG, ui_font + + +class SystemSidebar(QWidget): + """Lista lateral de sistemas. Emite `systemActivated(SystemId)` al doble-click.""" + + systemActivated = Signal(str) + + def __init__(self, parent: QWidget | None = None) -> None: + super().__init__(parent) + self._project: Project | None = None + self._catalog = self._load_catalog_safe() + + layout = QVBoxLayout(self) + layout.setContentsMargins(0, 0, 0, 0) + layout.setSpacing(0) + + # Header section: wizard / overview + self._wizard_label = QLabel("WIZARD") + self._wizard_label.setObjectName("overline") + self._wizard_label.setFont(ui_font(9)) + self._wizard_label.setStyleSheet( + f"color: {C_FOG}; padding: 16px 16px 6px 16px; letter-spacing: 2px;" + ) + layout.addWidget(self._wizard_label) + + self._wizard_steps = QListWidget() + self._wizard_steps.setFrameShape(QFrame.Shape.NoFrame) + for step in self._WIZARD_STEPS: + item = QListWidgetItem(step) + item.setFlags(item.flags() & ~Qt.ItemIsSelectable) + self._wizard_steps.addItem(item) + self._wizard_steps.setFixedHeight(self._wizard_steps.sizeHintForRow(0) * 8 + 10) + layout.addWidget(self._wizard_steps) + + # Systems section + self._systems_header = QLabel("SISTEMAS HABILITADOS") + self._systems_header.setObjectName("overline") + self._systems_header.setFont(ui_font(9)) + self._systems_header.setStyleSheet( + f"color: {C_FOG}; padding: 16px 16px 6px 16px; letter-spacing: 2px;" + ) + layout.addWidget(self._systems_header) + + self._enabled_list = QListWidget() + self._enabled_list.setFrameShape(QFrame.Shape.NoFrame) + self._enabled_list.itemDoubleClicked.connect(self._on_double_click_enabled) + layout.addWidget(self._enabled_list, 1) + + self._available_header = QLabel("DISPONIBLES (NO HABILITADOS)") + self._available_header.setObjectName("overline") + self._available_header.setFont(ui_font(9)) + self._available_header.setStyleSheet( + f"color: {C_FOG}; padding: 16px 16px 6px 16px; letter-spacing: 2px;" + ) + layout.addWidget(self._available_header) + + self._available_list = QListWidget() + self._available_list.setFrameShape(QFrame.Shape.NoFrame) + self._available_list.setMaximumHeight(140) + layout.addWidget(self._available_list) + + self.refresh() + + # ----- Const ----------------------------------------------------- + + _WIZARD_STEPS = ( + "1 · Tipo de buque", + "2 · Plantilla", + "3 · Dimensiones", + "4 · Sistemas", + "5 · Equipos sugeridos", + "6 · Refinamiento", + "7 · Topología I/O", + "8 · Confirmación", + ) + + # ----- Public ---------------------------------------------------- + + def set_project(self, project: Project | None) -> None: + self._project = project + self.refresh() + + def refresh(self) -> None: + self._enabled_list.clear() + self._available_list.clear() + + if self._project is None: + self._systems_header.setText("SISTEMAS HABILITADOS · sin proyecto") + self._enabled_list.addItem("(crea o abre un proyecto)") + return + + enabled = set(self._project.systems_enabled) + equipment_count: Counter[str] = Counter() + for eq in self._project.equipment: + equipment_count[eq.system_id.value] += 1 + + self._systems_header.setText( + f"SISTEMAS HABILITADOS · {len(enabled)}" + ) + + for sys_id_str in sorted(s.value for s in enabled): + name = self._system_display_name(sys_id_str) + count = equipment_count.get(sys_id_str, 0) + label = f"{name} · {count} eq" if count else f"{name} · —" + item = QListWidgetItem(label) + item.setData(Qt.UserRole, sys_id_str) + self._enabled_list.addItem(item) + + all_known = {s.value for s in SystemId} + disabled = sorted(all_known - {s.value for s in enabled}) + self._available_header.setText( + f"DISPONIBLES (NO HABILITADOS) · {len(disabled)}" + ) + for sys_id_str in disabled[:40]: + item = QListWidgetItem(self._system_display_name(sys_id_str)) + item.setForeground(Qt.GlobalColor.darkGray) + item.setData(Qt.UserRole, sys_id_str) + self._available_list.addItem(item) + + # ----- Internals ------------------------------------------------- + + def _load_catalog_safe(self) -> dict: + try: + return load_systems_catalog() + except Exception: + return {"categories": []} + + def _system_display_name(self, sys_id_value: str) -> str: + for cat in self._catalog.get("categories", []): + for s in cat.get("systems", []): + if s.get("id") == sys_id_value: + return s.get("name", sys_id_value) + return sys_id_value.replace("_", " ").title() + + def _on_double_click_enabled(self, item: QListWidgetItem) -> None: + sys_id = item.data(Qt.UserRole) + if sys_id: + self.systemActivated.emit(sys_id) diff --git a/vmssailor/studio/widgets/vessel_canvas.py b/vmssailor/studio/widgets/vessel_canvas.py new file mode 100644 index 0000000..61f2fd0 --- /dev/null +++ b/vmssailor/studio/widgets/vessel_canvas.py @@ -0,0 +1,345 @@ +"""VesselCanvas — QGraphicsView con grilla naval y silueta del buque. + +Sistema de coordenadas: +- ShipCoord (x_pp, y_cl, z_bl) en metros +- Transformación a pixels: 1 m → 20 px (configurable vía zoom) +- Origen Pp (popa) en la izquierda, proa a la derecha + +Sprint 1: muestra eslora con grilla, marcadores de mamparos y equipos. +""" + +from __future__ import annotations + +from PySide6.QtCore import QPointF, QRectF, Qt +from PySide6.QtGui import ( + QBrush, + QColor, + QLinearGradient, + QPainter, + QPen, + QPolygonF, +) +from PySide6.QtWidgets import ( + QFrame, + QGraphicsScene, + QGraphicsView, + QHBoxLayout, + QLabel, + QVBoxLayout, + QWidget, +) + +from vmssailor.core.coords import ShipCoord +from vmssailor.core.project import Project +from vmssailor.studio.theme import ( + C_ABYSS, + C_CYAN, + C_CYAN_DEEP, + C_FOAM, + C_FOG, + C_MIDNIGHT, + C_SAND, + C_STEEL, + C_WARN, + mono_font, + ui_font, +) + +# Mapeo metros -> pixels por defecto +PX_PER_M_DEFAULT = 20.0 + + +def ship_to_scene(coord: ShipCoord, px_per_m: float = PX_PER_M_DEFAULT) -> QPointF: + """Transformación de coordenadas navales a coordenadas de la escena. + + En la escena: X crece a la derecha (= x_pp positivo hacia proa), + Y crece HACIA ABAJO en Qt — por eso invertimos y_cl. + + El centro vertical de la escena (y=0) corresponde a la línea de crujía. + """ + x = coord.x_pp * px_per_m + y = -coord.y_cl * px_per_m # estribor abajo, babor arriba en pantalla + return QPointF(x, y) + + +class VesselCanvas(QWidget): + """Canvas central del Studio.""" + + def __init__(self, parent: QWidget | None = None) -> None: + super().__init__(parent) + self._project: Project | None = None + self._px_per_m = PX_PER_M_DEFAULT + + # Hero header + layout = QVBoxLayout(self) + layout.setContentsMargins(0, 0, 0, 0) + layout.setSpacing(0) + + header = QWidget() + header.setFixedHeight(56) + header.setStyleSheet(f"background: {C_MIDNIGHT}; border-bottom: 1px solid {C_STEEL};") + h_lay = QHBoxLayout(header) + h_lay.setContentsMargins(24, 0, 24, 0) + self._title = QLabel("Topología del buque") + self._title.setObjectName("title") + self._title.setFont(ui_font(13)) + self._title.setStyleSheet(f"color: {C_FOAM}; font-weight: 600;") + h_lay.addWidget(self._title) + h_lay.addStretch(1) + self._zoom_label = QLabel("Zoom: 100%") + self._zoom_label.setFont(mono_font(9)) + self._zoom_label.setStyleSheet(f"color: {C_FOG};") + h_lay.addWidget(self._zoom_label) + layout.addWidget(header) + + # Scene + view + self._scene = QGraphicsScene(self) + self._view = _VesselGraphicsView(self._scene, self) + self._view.setFrameShape(QFrame.NoFrame) + self._view.setRenderHint(QPainter.Antialiasing) + self._view.setRenderHint(QPainter.SmoothPixmapTransform) + self._view.setBackgroundBrush(self._background_brush()) + self._view.setDragMode(QGraphicsView.ScrollHandDrag) + self._view.setTransformationAnchor(QGraphicsView.AnchorUnderMouse) + self._view.zoomChanged.connect(self._on_zoom_changed) + layout.addWidget(self._view, 1) + + self._render_empty_state() + + # ----- Background --------------------------------------------------- + + def _background_brush(self) -> QBrush: + grad = QLinearGradient(0, 0, 0, 1) + grad.setCoordinateMode(QLinearGradient.ObjectBoundingMode) + grad.setColorAt(0.0, QColor(C_ABYSS)) + grad.setColorAt(1.0, QColor(C_MIDNIGHT)) + return QBrush(grad) + + # ----- Public ------------------------------------------------------- + + def set_project(self, project: Project | None) -> None: + self._project = project + if project is None: + self._render_empty_state() + else: + self._render_project() + + def fit_in_view(self) -> None: + if not self._scene.items(): + return + self._view.fitInView(self._scene.itemsBoundingRect().adjusted(-40, -40, 40, 40), Qt.KeepAspectRatio) + + # ----- Rendering ---------------------------------------------------- + + def _render_empty_state(self) -> None: + self._scene.clear() + self._scene.setSceneRect(QRectF(-200, -200, 1200, 600)) + # Grid + self._draw_grid(self._scene.sceneRect(), grid_m=1.0) + # Center label + msg = self._scene.addText( + "Abre un proyecto existente (.vmsproj) o crea uno con\n" + "Proyecto › Nuevo desde wizard…", + ui_font(11), + ) + msg.setDefaultTextColor(QColor(C_FOG)) + rect = msg.boundingRect() + msg.setPos(-rect.width() / 2 + 400, -rect.height() / 2 + 100) + self._title.setText("Topología del buque · sin proyecto") + + def _render_project(self) -> None: + assert self._project is not None + self._scene.clear() + v = self._project.vessel + + # Compute scene rect + margin_m = 5.0 + rect_m = QRectF( + -margin_m * self._px_per_m, + -(v.beam_max_m / 2 + margin_m) * self._px_per_m, + (v.length_overall_m + 2 * margin_m) * self._px_per_m, + (v.beam_max_m + 2 * margin_m) * self._px_per_m, + ) + self._scene.setSceneRect(rect_m) + + # Grid + self._draw_grid(rect_m, grid_m=1.0) + + # Silhouette (plan view, simplified): a hull-shaped polygon + self._draw_vessel_plan(v) + + # Bulkheads + for b in v.bulkheads: + x_px = b.x_pp * self._px_per_m + self._draw_bulkhead(x_px, v.beam_max_m, b.name) + + # Equipment markers + for eq in self._project.equipment: + self._draw_equipment(eq) + + # Axes + self._draw_axes(v.length_overall_m, v.beam_max_m) + + self._title.setText( + f"Topología del buque · {v.name} · " + f"{v.length_overall_m:.1f}×{v.beam_max_m:.1f}×{v.draft_m:.1f} m" + ) + + # Fit + self.fit_in_view() + + def _draw_grid(self, rect: QRectF, grid_m: float = 1.0) -> None: + step = grid_m * self._px_per_m + pen = QPen(QColor(C_STEEL)) + pen.setWidthF(0.5) + pen.setCosmetic(True) + + x = rect.left() - (rect.left() % step) + while x <= rect.right(): + self._scene.addLine(x, rect.top(), x, rect.bottom(), pen) + x += step + y = rect.top() - (rect.top() % step) + while y <= rect.bottom(): + self._scene.addLine(rect.left(), y, rect.right(), y, pen) + y += step + + # Centerline (y_cl = 0) — más visible + cl_pen = QPen(QColor(C_CYAN_DEEP)) + cl_pen.setWidthF(0.8) + cl_pen.setStyle(Qt.DashLine) + cl_pen.setCosmetic(True) + self._scene.addLine(rect.left(), 0, rect.right(), 0, cl_pen) + + # Pp (x=0) — más visible + self._scene.addLine(0, rect.top(), 0, rect.bottom(), cl_pen) + + def _draw_vessel_plan(self, vessel) -> None: + L = vessel.length_overall_m * self._px_per_m + B = vessel.beam_max_m * self._px_per_m + b2 = B / 2 + + poly = QPolygonF( + [ + # Stern (popa) — square-ish + QPointF(0, -b2 * 0.85), + QPointF(0, b2 * 0.85), + # Mid-stern out to full beam + QPointF(L * 0.18, b2), + # Parallel mid-body + QPointF(L * 0.70, b2), + # Bow taper + QPointF(L * 0.92, b2 * 0.55), + QPointF(L, 0), + QPointF(L * 0.92, -b2 * 0.55), + QPointF(L * 0.70, -b2), + QPointF(L * 0.18, -b2), + ] + ) + + grad = QLinearGradient(0, -b2, 0, b2) + grad.setColorAt(0.0, QColor(C_SAND)) + grad.setColorAt(0.5, QColor("#94A3B8")) + grad.setColorAt(1.0, QColor(C_FOG)) + brush = QBrush(grad) + pen = QPen(QColor(C_ABYSS)) + pen.setWidthF(2) + pen.setCosmetic(True) + self._scene.addPolygon(poly, pen, brush) + + def _draw_bulkhead(self, x_px: float, beam_m: float, name: str) -> None: + b2 = beam_m * self._px_per_m / 2 + pen = QPen(QColor(C_CYAN)) + pen.setWidthF(1.5) + pen.setStyle(Qt.DashLine) + pen.setCosmetic(True) + self._scene.addLine(x_px, -b2, x_px, b2, pen) + text = self._scene.addText(name, ui_font(8)) + text.setDefaultTextColor(QColor(C_CYAN)) + text.setPos(x_px - text.boundingRect().width() / 2, b2 + 6) + + def _draw_equipment(self, eq) -> None: + center = ship_to_scene(eq.location, self._px_per_m) + + # color por sistema (simplificado: motor cyan, genset amber, otros sand) + sys_v = eq.system_id.value + if sys_v == "main_engine": + color = QColor(C_CYAN) + elif sys_v == "genset": + color = QColor(C_WARN) + else: + color = QColor(C_SAND) + + # Halo (the returned QGraphicsItem stays owned by the scene) + self._scene.addEllipse( + center.x() - 14, + center.y() - 14, + 28, + 28, + QPen(color, 1.2, Qt.SolidLine), + QBrush(QColor(color.red(), color.green(), color.blue(), 40)), + ) + # Dot + self._scene.addEllipse( + center.x() - 6, + center.y() - 6, + 12, + 12, + QPen(QColor(C_ABYSS), 1.5), + QBrush(color), + ) + # Label + text = self._scene.addText(eq.tag_prefix, ui_font(8)) + text.setDefaultTextColor(QColor(C_FOAM)) + text.setPos(center.x() - text.boundingRect().width() / 2, center.y() + 12) + + def _draw_axes(self, length_m: float, beam_m: float) -> None: + # Ruler X + pen = QPen(QColor(C_FOG)) + pen.setCosmetic(True) + ruler_y = (beam_m / 2 + 1.5) * self._px_per_m + L = length_m * self._px_per_m + self._scene.addLine(0, ruler_y, L, ruler_y, pen) + for m in range(0, int(length_m) + 1, 5): + x = m * self._px_per_m + self._scene.addLine(x, ruler_y - 4, x, ruler_y + 4, pen) + t = self._scene.addText(f"{m} m", mono_font(7)) + t.setDefaultTextColor(QColor(C_FOG)) + t.setPos(x - t.boundingRect().width() / 2, ruler_y + 6) + label = self._scene.addText("x_pp →", mono_font(8)) + label.setDefaultTextColor(QColor(C_CYAN)) + label.setPos(L + 12, ruler_y - 8) + + # Pp arrow / origin + origin_label = self._scene.addText("Pp", mono_font(9)) + origin_label.setDefaultTextColor(QColor(C_CYAN)) + origin_label.setPos(-20, ruler_y - 8) + + # ----- Slots -------------------------------------------------------- + + def _on_zoom_changed(self, scale: float) -> None: + self._zoom_label.setText(f"Zoom: {scale * 100:.0f}%") + + +class _VesselGraphicsView(QGraphicsView): + """QGraphicsView con zoom por wheel + scroll-pan.""" + + from PySide6.QtCore import Signal # local import to avoid double importing + + zoomChanged = Signal(float) + + def __init__(self, scene: QGraphicsScene, parent: QWidget | None = None) -> None: + super().__init__(scene, parent) + self._scale = 1.0 + self.setMouseTracking(True) + + def wheelEvent(self, event) -> None: # type: ignore[override] + delta = event.angleDelta().y() + if delta == 0: + return + factor = 1.15 if delta > 0 else 1 / 1.15 + new_scale = self._scale * factor + if not (0.1 <= new_scale <= 10.0): + return + self._scale = new_scale + self.scale(factor, factor) + self.zoomChanged.emit(self._scale) diff --git a/vmssailor/studio/wizard/__init__.py b/vmssailor/studio/wizard/__init__.py new file mode 100644 index 0000000..9d4336a --- /dev/null +++ b/vmssailor/studio/wizard/__init__.py @@ -0,0 +1,9 @@ +"""Wizard de creación de proyecto de buque (Studio). + +Sprint 1: pasos 1-4 funcionales + 5-8 placeholders. +Sprint 2: pasos 5-8 implementados con rule_engine. +""" + +from vmssailor.studio.wizard.wizard import VesselWizard + +__all__ = ["VesselWizard"] diff --git a/vmssailor/studio/wizard/step_01_vessel_type.py b/vmssailor/studio/wizard/step_01_vessel_type.py new file mode 100644 index 0000000..9550e0e --- /dev/null +++ b/vmssailor/studio/wizard/step_01_vessel_type.py @@ -0,0 +1,131 @@ +"""Paso 1: tipo y subtipo del buque.""" + +from __future__ import annotations + +from PySide6.QtWidgets import ( + QComboBox, + QFormLayout, + QLabel, + QLineEdit, + QVBoxLayout, + QWidget, + QWizardPage, +) + +from vmssailor.core.enums import VesselSubtype, VesselType +from vmssailor.studio.theme import C_FOG, ui_font + +_SUBTYPES_BY_TYPE = { + VesselType.YACHT_MOTOR: [ + VesselSubtype.PLANING, + VesselSubtype.SEMI_PLANING, + VesselSubtype.DISPLACEMENT, + ], + VesselType.YACHT_SAIL: [VesselSubtype.DISPLACEMENT], + VesselType.FISHING: [ + VesselSubtype.PURSE_SEINER, + VesselSubtype.TRAWLER, + VesselSubtype.LONGLINER, + ], + VesselType.PATROL: [VesselSubtype.COASTAL, VesselSubtype.OCEANIC], + VesselType.FERRY: [VesselSubtype.PASSENGER, VesselSubtype.ROLL_ON_ROLL_OFF], + VesselType.OFFSHORE_SUPPORT: [VesselSubtype.AHTS, VesselSubtype.PSV], +} + + +_TYPE_LABELS = { + VesselType.YACHT_MOTOR: "Yate motor", + VesselType.YACHT_SAIL: "Yate vela", + VesselType.FISHING: "Pesquero", + VesselType.PATROL: "Patrullero", + VesselType.FERRY: "Ferry", + VesselType.OFFSHORE_SUPPORT: "Offshore support", +} + +_SUBTYPE_LABELS = { + VesselSubtype.PLANING: "Planeo", + VesselSubtype.SEMI_PLANING: "Semi-planeo", + VesselSubtype.DISPLACEMENT: "Desplazamiento", + VesselSubtype.PURSE_SEINER: "Cerquero", + VesselSubtype.TRAWLER: "Arrastrero", + VesselSubtype.LONGLINER: "Palangrero", + VesselSubtype.COASTAL: "Costero", + VesselSubtype.OCEANIC: "Oceánico", + VesselSubtype.PASSENGER: "Pasajeros", + VesselSubtype.ROLL_ON_ROLL_OFF: "Ro-ro", + VesselSubtype.AHTS: "AHTS", + VesselSubtype.PSV: "PSV", + VesselSubtype.OTHER: "Otro", +} + + +class Step01VesselType(QWizardPage): + def __init__(self, parent: QWidget | None = None) -> None: + super().__init__(parent) + self.setTitle("Paso 1 · Tipo de buque") + self.setSubTitle( + "Elige la categoría principal del buque y su subcategoría. " + "Esto filtra las plantillas disponibles en el paso 2." + ) + + layout = QVBoxLayout(self) + layout.setSpacing(18) + + # Project basics + intro = QLabel( + "Cada proyecto VMS-Sailor corresponde a UN buque de UN cliente.\n" + "Aquí defines lo básico para empezar; el wizard te guiará por los demás pasos." + ) + intro.setWordWrap(True) + intro.setStyleSheet(f"color: {C_FOG};") + intro.setFont(ui_font(10)) + layout.addWidget(intro) + + form = QFormLayout() + form.setHorizontalSpacing(20) + form.setVerticalSpacing(12) + + self._project_name = QLineEdit() + self._project_name.setPlaceholderText('Ej: M/Y Aurora — Sunseeker 76') + form.addRow("Nombre del proyecto:", self._project_name) + + self._customer = QLineEdit() + self._customer.setPlaceholderText("Ej: Acme Yachts S.A.") + form.addRow("Cliente / Armador:", self._customer) + + self._type_combo = QComboBox() + for vt in VesselType: + self._type_combo.addItem(_TYPE_LABELS[vt], vt.value) + form.addRow("Tipo de buque:", self._type_combo) + + self._subtype_combo = QComboBox() + form.addRow("Subcategoría:", self._subtype_combo) + + layout.addLayout(form) + layout.addStretch(1) + + # Register fields (no asterisk so they're optional at validation time; + # we provide defaults during build_project). + from vmssailor.studio.wizard.wizard import ( + F_CUSTOMER, + F_PROJECT_NAME, + F_VESSEL_SUBTYPE, + F_VESSEL_TYPE, + ) + + self.registerField(F_PROJECT_NAME + "*", self._project_name) + self.registerField(F_CUSTOMER, self._customer) + self.registerField(F_VESSEL_TYPE, self._type_combo, "currentData", "currentIndexChanged") + self.registerField( + F_VESSEL_SUBTYPE, self._subtype_combo, "currentData", "currentIndexChanged" + ) + + self._type_combo.currentIndexChanged.connect(self._populate_subtypes) + self._populate_subtypes() + + def _populate_subtypes(self) -> None: + self._subtype_combo.clear() + v_type = VesselType(self._type_combo.currentData()) + subs = _SUBTYPES_BY_TYPE.get(v_type, [VesselSubtype.OTHER]) + for s in subs: + self._subtype_combo.addItem(_SUBTYPE_LABELS[s], s.value) diff --git a/vmssailor/studio/wizard/step_02_template.py b/vmssailor/studio/wizard/step_02_template.py new file mode 100644 index 0000000..72a81e7 --- /dev/null +++ b/vmssailor/studio/wizard/step_02_template.py @@ -0,0 +1,167 @@ +"""Paso 2: selección de plantilla de biblioteca curada.""" + +from __future__ import annotations + +from PySide6.QtCore import Qt +from PySide6.QtWidgets import ( + QHBoxLayout, + QLabel, + QLineEdit, + QListWidget, + QListWidgetItem, + QVBoxLayout, + QWidget, + QWizardPage, +) + +from vmssailor.library import load_library +from vmssailor.studio.theme import C_FOG, mono_font, ui_font + + +class Step02Template(QWizardPage): + def __init__(self, parent: QWidget | None = None) -> None: + super().__init__(parent) + self.setTitle("Paso 2 · Plantilla de buque") + self.setSubTitle( + "Elige una plantilla de la biblioteca curada. Las dimensiones del paso 3 " + "se pre-rellenarán pero puedes ajustar después." + ) + + outer = QHBoxLayout(self) + outer.setSpacing(20) + + # Left: list of templates filtered by type + self._list = QListWidget() + self._list.setMinimumWidth(280) + outer.addWidget(self._list, 1) + + # Right: details + right = QVBoxLayout() + outer.addLayout(right, 2) + + self._name_label = QLabel("(Selecciona una plantilla)") + self._name_label.setObjectName("title") + self._name_label.setFont(ui_font(13)) + right.addWidget(self._name_label) + + self._meta_label = QLabel("") + self._meta_label.setFont(mono_font(10)) + self._meta_label.setStyleSheet(f"color: {C_FOG};") + right.addWidget(self._meta_label) + + self._desc_label = QLabel("") + self._desc_label.setWordWrap(True) + right.addWidget(self._desc_label) + + right.addStretch(1) + + # Hidden vessel_name field for the next step + self._vessel_name = QLineEdit() + self._vessel_name.hide() + + from vmssailor.studio.wizard.wizard import F_TEMPLATE_ID, F_VESSEL_NAME + + self.registerField(F_TEMPLATE_ID, self, "selected_template_id", "templateChanged") + self.registerField(F_VESSEL_NAME, self._vessel_name) + + self._templates: dict[str, dict] = {} + self._selected_id: str | None = None + self._load_templates() + + self._list.currentItemChanged.connect(self._on_selection_changed) + + # ----- Property API (for QWizard field) ------------------------------- + + from PySide6.QtCore import Property, Signal # type: ignore + + templateChanged = Signal() + + def get_selected_template_id(self) -> str: + return self._selected_id or "" + + def set_selected_template_id(self, value: str) -> None: + self._selected_id = value + self.templateChanged.emit() + + selected_template_id = Property( + str, fget=get_selected_template_id, fset=set_selected_template_id, notify=templateChanged + ) + + # ----- Internals ------------------------------------------------------ + + def initializePage(self) -> None: + from vmssailor.studio.wizard.wizard import F_VESSEL_TYPE + + type_str = self.field(F_VESSEL_TYPE) + self._refresh_list(type_str) + + def _load_templates(self) -> None: + try: + result = load_library() + for v in result.vessels: + self._templates[v.id] = { + "id": v.id, + "name": v.name, + "type": v.type.value, + "length_overall_m": v.length_overall_m, + "beam_max_m": v.beam_max_m, + "draft_m": v.draft_m, + "description": v.description, + } + except Exception: + # Si la biblioteca falla, no rompemos el wizard. + pass + + # Also add a "blank" template + self._templates["__blank__"] = { + "id": "__blank__", + "name": "Plantilla en blanco", + "type": "*", + "length_overall_m": 24.0, + "beam_max_m": 5.5, + "draft_m": 1.8, + "description": "Empezar desde cero, sin plantilla de buque. Defines todas las dimensiones manualmente.", + } + + def _refresh_list(self, type_filter: str | None) -> None: + self._list.clear() + for tid, t in self._templates.items(): + if type_filter and t["type"] not in (type_filter, "*"): + continue + label = ( + f"{t['name']}\n" + f" {t['length_overall_m']:.1f} × {t['beam_max_m']:.1f} m" + if tid != "__blank__" + else t["name"] + ) + item = QListWidgetItem(label) + item.setData(Qt.UserRole, tid) + self._list.addItem(item) + if self._list.count() > 0: + self._list.setCurrentRow(0) + + def _on_selection_changed(self, current: QListWidgetItem | None) -> None: + if not current: + return + tid = current.data(Qt.UserRole) + t = self._templates.get(tid) + if not t: + return + self._selected_id = tid + self._vessel_name.setText(t["name"]) + self._name_label.setText(t["name"]) + self._meta_label.setText( + f"id: {t['id']} LOA {t['length_overall_m']:.1f} m · " + f"manga {t['beam_max_m']:.1f} m · calado {t['draft_m']:.1f} m" + ) + self._desc_label.setText(t.get("description", "") or "(sin descripción)") + self.templateChanged.emit() + self.completeChanged.emit() + + def isComplete(self) -> bool: + return self._selected_id is not None + + def get_template(self) -> dict | None: + if self._selected_id: + return self._templates.get(self._selected_id) + return None diff --git a/vmssailor/studio/wizard/step_03_dimensions.py b/vmssailor/studio/wizard/step_03_dimensions.py new file mode 100644 index 0000000..9e8a3b2 --- /dev/null +++ b/vmssailor/studio/wizard/step_03_dimensions.py @@ -0,0 +1,105 @@ +"""Paso 3: dimensiones físicas del buque.""" + +from __future__ import annotations + +from PySide6.QtWidgets import ( + QDoubleSpinBox, + QFormLayout, + QLabel, + QVBoxLayout, + QWidget, + QWizardPage, +) + +from vmssailor.studio.theme import C_FOG, ui_font + + +class Step03Dimensions(QWizardPage): + def __init__(self, parent: QWidget | None = None) -> None: + super().__init__(parent) + self.setTitle("Paso 3 · Dimensiones principales") + self.setSubTitle( + "Edita las dimensiones principales del buque. Los valores se pre-rellenan " + "desde la plantilla del paso 2 si elegiste una." + ) + + layout = QVBoxLayout(self) + layout.setSpacing(18) + + intro = QLabel( + "Todas las medidas en metros (sistema internacional). " + "Estos valores se usan en core para validar coordenadas de equipos y tarjetas." + ) + intro.setWordWrap(True) + intro.setStyleSheet(f"color: {C_FOG};") + intro.setFont(ui_font(10)) + layout.addWidget(intro) + + form = QFormLayout() + form.setHorizontalSpacing(20) + form.setVerticalSpacing(14) + + self._loa = self._make_spin(1.0, 200.0, 24.0, " m", 1) + form.addRow("Eslora total (LOA):", self._loa) + + self._beam = self._make_spin(1.0, 30.0, 5.5, " m", 2) + form.addRow("Manga máxima:", self._beam) + + self._draft = self._make_spin(0.3, 10.0, 1.8, " m", 2) + form.addRow("Calado:", self._draft) + + self._bh_aft = self._make_spin(0.0, 200.0, 4.0, " m desde Pp", 1) + form.addRow("Mamparo popa sala máquinas:", self._bh_aft) + + self._bh_fwd = self._make_spin(0.0, 200.0, 8.0, " m desde Pp", 1) + form.addRow("Mamparo proa sala máquinas:", self._bh_fwd) + + layout.addLayout(form) + layout.addStretch(1) + + from vmssailor.studio.wizard.wizard import ( + F_BEAM, + F_BULKHEAD_AFT, + F_BULKHEAD_FWD, + F_DRAFT, + F_LOA, + ) + + self.registerField(F_LOA, self._loa, "value", "valueChanged") + self.registerField(F_BEAM, self._beam, "value", "valueChanged") + self.registerField(F_DRAFT, self._draft, "value", "valueChanged") + self.registerField(F_BULKHEAD_AFT, self._bh_aft, "value", "valueChanged") + self.registerField(F_BULKHEAD_FWD, self._bh_fwd, "value", "valueChanged") + + def _make_spin(self, lo: float, hi: float, default: float, suffix: str, decimals: int) -> QDoubleSpinBox: + s = QDoubleSpinBox() + s.setRange(lo, hi) + s.setDecimals(decimals) + s.setSingleStep(0.1 if decimals >= 1 else 1) + s.setSuffix(suffix) + s.setValue(default) + s.setMinimumWidth(180) + return s + + def initializePage(self) -> None: + # If the user picked a template in step 2, pre-fill from it. + from vmssailor.studio.wizard.wizard import F_TEMPLATE_ID + + wizard = self.wizard() + tpl_id = self.field(F_TEMPLATE_ID) + if not tpl_id or not wizard: + return + # Look up the step 2 page to get the template dict + from vmssailor.studio.wizard.step_02_template import Step02Template + + for pid in range(8): + page = wizard.page(pid) + if isinstance(page, Step02Template): + tpl = page.get_template() + if tpl: + self._loa.setValue(tpl["length_overall_m"]) + self._beam.setValue(tpl["beam_max_m"]) + self._draft.setValue(tpl["draft_m"]) + self._bh_aft.setValue(max(2.0, tpl["length_overall_m"] * 0.15)) + self._bh_fwd.setValue(max(5.0, tpl["length_overall_m"] * 0.30)) + break diff --git a/vmssailor/studio/wizard/step_04_systems.py b/vmssailor/studio/wizard/step_04_systems.py new file mode 100644 index 0000000..dd68608 --- /dev/null +++ b/vmssailor/studio/wizard/step_04_systems.py @@ -0,0 +1,152 @@ +"""Paso 4: selección de sistemas habilitados. + +Lee el catálogo maestro de sistemas y muestra checkboxes agrupados por categoría. +Pre-selecciona los sistemas marcados como `default_for` el VesselType del paso 1. +""" + +from __future__ import annotations + +from PySide6.QtWidgets import ( + QCheckBox, + QFrame, + QGridLayout, + QGroupBox, + QLabel, + QPushButton, + QScrollArea, + QVBoxLayout, + QWidget, + QWizardPage, +) + +from vmssailor.library import load_systems_catalog +from vmssailor.studio.theme import C_FOG, ui_font + + +class Step04Systems(QWizardPage): + def __init__(self, parent: QWidget | None = None) -> None: + super().__init__(parent) + self.setTitle("Paso 4 · Sistemas instalados") + self.setSubTitle( + "Marca los sistemas que tendrá el buque. Esto define el menú lateral del Runtime y " + "qué tags se generarán en sprints siguientes." + ) + + outer = QVBoxLayout(self) + outer.setSpacing(10) + + header = QLabel( + "Pre-selección automática según tipo de buque. Ajusta marcando/desmarcando." + ) + header.setWordWrap(True) + header.setStyleSheet(f"color: {C_FOG};") + header.setFont(ui_font(10)) + outer.addWidget(header) + + # Buttons row + btn_row = QGridLayout() + self._btn_select_defaults = QPushButton("Resetear a defaults del tipo") + self._btn_select_all = QPushButton("Marcar todos") + self._btn_select_none = QPushButton("Desmarcar todos") + btn_row.addWidget(self._btn_select_defaults, 0, 0) + btn_row.addWidget(self._btn_select_all, 0, 1) + btn_row.addWidget(self._btn_select_none, 0, 2) + outer.addLayout(btn_row) + + self._btn_select_defaults.clicked.connect(self._select_defaults) + self._btn_select_all.clicked.connect(self._select_all) + self._btn_select_none.clicked.connect(self._select_none) + + # Scroll area with category groups + scroll = QScrollArea() + scroll.setWidgetResizable(True) + scroll.setFrameShape(QFrame.Shape.NoFrame) + outer.addWidget(scroll, 1) + + content = QWidget() + self._content_layout = QVBoxLayout(content) + self._content_layout.setSpacing(14) + scroll.setWidget(content) + + # Build categories + self._checkboxes: dict[str, QCheckBox] = {} + self._catalog = self._load_catalog_safe() + self._build_categories() + + # Register field + from vmssailor.studio.wizard.wizard import F_SYSTEMS + + self.registerField(F_SYSTEMS, self, "enabled_systems", "systemsChanged") + + # ----- Property API ------------------------------------------------ + + from PySide6.QtCore import Property, Signal + + systemsChanged = Signal() + + def get_enabled_systems(self) -> list[str]: + return [sid for sid, cb in self._checkboxes.items() if cb.isChecked()] + + def set_enabled_systems(self, value: list[str]) -> None: + for sid, cb in self._checkboxes.items(): + cb.setChecked(sid in value) + self.systemsChanged.emit() + + enabled_systems = Property( + list, + fget=get_enabled_systems, + fset=set_enabled_systems, + notify=systemsChanged, + ) + + # ----- Internals --------------------------------------------------- + + def _load_catalog_safe(self) -> dict: + try: + return load_systems_catalog() + except Exception: + return {"categories": []} + + def _build_categories(self) -> None: + for cat in self._catalog.get("categories", []): + group = QGroupBox(cat.get("name", "—")) + grid = QGridLayout(group) + grid.setHorizontalSpacing(20) + grid.setVerticalSpacing(6) + for idx, sys in enumerate(cat.get("systems", [])): + cb = QCheckBox(sys.get("name", sys["id"])) + cb.setToolTip(f"id: {sys['id']}") + cb.stateChanged.connect(self.systemsChanged.emit) + self._checkboxes[sys["id"]] = cb + grid.addWidget(cb, idx // 3, idx % 3) + self._content_layout.addWidget(group) + self._content_layout.addStretch(1) + + def _system_default_for(self, sys_id: str) -> list[str]: + for cat in self._catalog.get("categories", []): + for s in cat.get("systems", []): + if s.get("id") == sys_id: + return s.get("default_for", []) + return [] + + def _select_defaults(self) -> None: + from vmssailor.studio.wizard.wizard import F_VESSEL_TYPE + + v_type = self.field(F_VESSEL_TYPE) + if not v_type: + return + for sid, cb in self._checkboxes.items(): + cb.setChecked(v_type in self._system_default_for(sid)) + + def _select_all(self) -> None: + for cb in self._checkboxes.values(): + cb.setChecked(True) + + def _select_none(self) -> None: + for cb in self._checkboxes.values(): + cb.setChecked(False) + + def initializePage(self) -> None: + # On first entry, pre-select defaults for the chosen vessel type. + if not any(cb.isChecked() for cb in self._checkboxes.values()): + self._select_defaults() diff --git a/vmssailor/studio/wizard/step_08_confirm.py b/vmssailor/studio/wizard/step_08_confirm.py new file mode 100644 index 0000000..e813247 --- /dev/null +++ b/vmssailor/studio/wizard/step_08_confirm.py @@ -0,0 +1,134 @@ +"""Paso 8: confirmación final con resumen del proyecto.""" + +from __future__ import annotations + +from PySide6.QtCore import Qt +from PySide6.QtWidgets import QLabel, QVBoxLayout, QWidget, QWizardPage + +from vmssailor.studio.theme import ( + C_FOAM, + C_FOG, + C_MIDNIGHT, + C_OK, + C_SAND, + C_STEEL, + ui_font, +) + + +class Step08Confirm(QWizardPage): + def __init__(self, parent: QWidget | None = None) -> None: + super().__init__(parent) + self.setTitle("Paso 8 · Confirmación") + self.setSubTitle( + "Revisa el resumen del proyecto. Pulsa «Crear proyecto» para abrirlo en el editor." + ) + + layout = QVBoxLayout(self) + layout.setSpacing(16) + + self._summary_card = QLabel() + self._summary_card.setWordWrap(True) + self._summary_card.setTextFormat(Qt.RichText) + self._summary_card.setFont(ui_font(11)) + self._summary_card.setStyleSheet( + f""" + background: {C_MIDNIGHT}; + border: 1px solid {C_STEEL}; + border-radius: 12px; + padding: 20px; + color: {C_SAND}; + """ + ) + layout.addWidget(self._summary_card, 1) + + footer = QLabel( + "Una vez creado el proyecto se abre en el editor principal del Studio. " + "Podrás agregar equipos, tags y tarjetas, y guardar el .vmsproj cuando quieras.\n\n" + "Sprint 2 traerá: editor de equipos, motor de reglas, asignación de I/O." + ) + footer.setWordWrap(True) + footer.setStyleSheet(f"color: {C_FOG};") + footer.setFont(ui_font(9)) + layout.addWidget(footer) + + def initializePage(self) -> None: + from vmssailor.studio.wizard.wizard import ( + F_BEAM, + F_BULKHEAD_AFT, + F_BULKHEAD_FWD, + F_CUSTOMER, + F_DRAFT, + F_LOA, + F_PROJECT_NAME, + F_SYSTEMS, + F_TEMPLATE_ID, + F_VESSEL_NAME, + F_VESSEL_SUBTYPE, + F_VESSEL_TYPE, + ) + + project_name = self.field(F_PROJECT_NAME) or "(sin nombre)" + customer = self.field(F_CUSTOMER) or "(sin cliente)" + v_type = self.field(F_VESSEL_TYPE) or "—" + v_sub = self.field(F_VESSEL_SUBTYPE) or "—" + template = self.field(F_TEMPLATE_ID) or "—" + v_name = self.field(F_VESSEL_NAME) or "—" + loa = self.field(F_LOA) or 0.0 + beam = self.field(F_BEAM) or 0.0 + draft = self.field(F_DRAFT) or 0.0 + bh_aft = self.field(F_BULKHEAD_AFT) or 0.0 + bh_fwd = self.field(F_BULKHEAD_FWD) or 0.0 + systems = self.field(F_SYSTEMS) or [] + + n_sys = len(systems) + systems_str = ", ".join(systems[:10]) + if n_sys > 10: + systems_str += f", … (+{n_sys - 10})" + if not systems_str: + systems_str = "(ninguno seleccionado)" + + html = f""" ++ Cliente: {customer} +
+ +| Eslora | {loa:.1f} m |
| Manga | {beam:.1f} m |
| Calado | {draft:.1f} m |
| Mamparo popa SM | x_pp {bh_aft:.1f} m |
| Mamparo proa SM | x_pp {bh_fwd:.1f} m |
+ ✓ El proyecto se creará sin equipos. Agrega equipos manualmente o + espera Sprint 2 (motor de reglas). +
+ """ + self._summary_card.setText(html) diff --git a/vmssailor/studio/wizard/step_57_placeholder.py b/vmssailor/studio/wizard/step_57_placeholder.py new file mode 100644 index 0000000..a5c1ba1 --- /dev/null +++ b/vmssailor/studio/wizard/step_57_placeholder.py @@ -0,0 +1,46 @@ +"""Placeholder para pasos 5, 6, 7 — se implementan en Sprint 2.""" + +from __future__ import annotations + +from PySide6.QtCore import Qt +from PySide6.QtWidgets import QLabel, QVBoxLayout, QWidget, QWizardPage + +from vmssailor.studio.theme import C_CYAN, C_FOG, C_SAND, display_font, ui_font + + +class Step57Placeholder(QWizardPage): + """Placeholder visual con explicación clara de qué viene en Sprint 2.""" + + def __init__(self, *, index: int, title: str, parent: QWidget | None = None) -> None: + super().__init__(parent) + self.setTitle(f"Paso {index} · {title}") + self.setSubTitle("Este paso se implementa en Sprint 2. Por ahora se omite.") + + layout = QVBoxLayout(self) + layout.setSpacing(16) + layout.addStretch(1) + + big = QLabel(f"Paso {index}") + big.setFont(display_font(48, 700)) + big.setStyleSheet(f"color: {C_CYAN};") + big.setAlignment(Qt.AlignCenter) + layout.addWidget(big) + + msg = QLabel(title) + msg.setFont(ui_font(14)) + msg.setStyleSheet(f"color: {C_SAND};") + msg.setAlignment(Qt.AlignCenter) + layout.addWidget(msg) + + body = QLabel( + "El motor de reglas heurísticas (yacht_motor_planeo.yaml ya está en biblioteca)\n" + "propondrá equipos automáticamente para los sistemas habilitados.\n\n" + "En Sprint 1 se omite — el proyecto se crea con sistemas pero sin equipos todavía.\n" + "Equipos se pueden agregar manualmente desde el editor en Sprint 2." + ) + body.setFont(ui_font(10)) + body.setStyleSheet(f"color: {C_FOG};") + body.setAlignment(Qt.AlignCenter) + layout.addWidget(body) + + layout.addStretch(2) diff --git a/vmssailor/studio/wizard/wizard.py b/vmssailor/studio/wizard/wizard.py new file mode 100644 index 0000000..7ae6242 --- /dev/null +++ b/vmssailor/studio/wizard/wizard.py @@ -0,0 +1,147 @@ +"""QWizard contenedor + builder de Project a partir del estado del wizard.""" + +from __future__ import annotations + +import logging + +from PySide6.QtWidgets import QWidget, QWizard + +from vmssailor.core import ( + Project, + SystemId, + Vessel, + VesselSubtype, + VesselType, +) +from vmssailor.core.vessel import Bulkhead, Deck +from vmssailor.shared.ids import make_project_id +from vmssailor.studio.theme import ( + C_ABYSS, + C_SAND, +) +from vmssailor.studio.wizard.step_01_vessel_type import Step01VesselType +from vmssailor.studio.wizard.step_02_template import Step02Template +from vmssailor.studio.wizard.step_03_dimensions import Step03Dimensions +from vmssailor.studio.wizard.step_04_systems import Step04Systems +from vmssailor.studio.wizard.step_08_confirm import Step08Confirm +from vmssailor.studio.wizard.step_57_placeholder import Step57Placeholder + +logger = logging.getLogger(__name__) + + +# Wizard field keys used across steps +F_PROJECT_NAME = "project.name" +F_CUSTOMER = "project.customer" +F_VESSEL_TYPE = "vessel.type" +F_VESSEL_SUBTYPE = "vessel.subtype" +F_TEMPLATE_ID = "vessel.template_id" +F_VESSEL_NAME = "vessel.name" +F_LOA = "vessel.length_overall_m" +F_BEAM = "vessel.beam_max_m" +F_DRAFT = "vessel.draft_m" +F_BULKHEAD_FWD = "vessel.bulkhead_fwd_m" +F_BULKHEAD_AFT = "vessel.bulkhead_aft_m" +F_SYSTEMS = "systems.enabled" + + +class VesselWizard(QWizard): + """Wizard 8 pasos para crear un nuevo Project desde cero.""" + + def __init__(self, parent: QWidget | None = None) -> None: + super().__init__(parent) + self.setWindowTitle("VMS-Sailor · Nuevo proyecto") + self.setMinimumSize(900, 640) + self.setWizardStyle(QWizard.ModernStyle) + self.setOption(QWizard.NoBackButtonOnStartPage, True) + self.setOption(QWizard.HaveHelpButton, False) + self.setOption(QWizard.IndependentPages, False) + + # Add pages + self.addPage(Step01VesselType()) + self.addPage(Step02Template()) + self.addPage(Step03Dimensions()) + self.addPage(Step04Systems()) + self.addPage(Step57Placeholder(index=5, title="Equipos sugeridos (Sprint 2)")) + self.addPage(Step57Placeholder(index=6, title="Refinamiento manual (Sprint 2)")) + self.addPage(Step57Placeholder(index=7, title="Topología I/O AR-NMEA-IO (Sprint 2)")) + self.addPage(Step08Confirm()) + + # Style + self.setStyleSheet( + f""" + QWizard {{ background: {C_ABYSS}; }} + QWidget {{ background: {C_ABYSS}; color: {C_SAND}; }} + QWizard QPushButton {{ min-width: 100px; }} + """ + ) + + # Localización de botones (QWizard usa textos del sistema) + self.setButtonText(QWizard.NextButton, "Siguiente >") + self.setButtonText(QWizard.BackButton, "< Atrás") + self.setButtonText(QWizard.FinishButton, "Crear proyecto") + self.setButtonText(QWizard.CancelButton, "Cancelar") + + # ----- Project construction ----------------------------------------- + + def build_project(self) -> Project: + """Construye un `Project` a partir de los datos capturados por el wizard.""" + project_name = self.field(F_PROJECT_NAME) or "Proyecto sin nombre" + customer = self.field(F_CUSTOMER) or "" + vessel_name = self.field(F_VESSEL_NAME) or project_name + v_type = self.field(F_VESSEL_TYPE) or VesselType.YACHT_MOTOR.value + v_sub = self.field(F_VESSEL_SUBTYPE) or VesselSubtype.PLANING.value + loa = float(self.field(F_LOA) or 24.0) + beam = float(self.field(F_BEAM) or 5.5) + draft = float(self.field(F_DRAFT) or 1.8) + bh_fwd = float(self.field(F_BULKHEAD_FWD) or (loa * 0.30)) + bh_aft = float(self.field(F_BULKHEAD_AFT) or (loa * 0.15)) + systems_raw = self.field(F_SYSTEMS) or [SystemId.MAIN_ENGINE.value] + + # Build vessel + decks = [ + Deck(id="lower", name="Cubierta inferior", z_bl_bottom=0.4, z_bl_top=draft + 1.0), + Deck( + id="main", + name="Cubierta principal", + z_bl_bottom=draft + 1.0, + z_bl_top=draft + 3.0, + ), + ] + bulkheads = [ + Bulkhead(id="er_aft", name="Mamparo popa SM", x_pp=bh_aft), + Bulkhead(id="er_fwd", name="Mamparo proa SM", x_pp=bh_fwd), + ] + try: + vessel = Vessel( + id=f"wizard_{int(loa * 10)}m", + name=vessel_name, + type=VesselType(v_type), + subtype=VesselSubtype(v_sub), + length_overall_m=loa, + beam_max_m=beam, + draft_m=draft, + decks=decks, + bulkheads=bulkheads, + data_source="user_input", + ) + except Exception as exc: + logger.error("Vessel build failed: %s", exc) + raise + + # Equipment + tags llegan en Sprint 2 (rule engine). Por ahora, vacío. + try: + systems_enabled = [SystemId(s) for s in systems_raw] + except ValueError: + systems_enabled = [SystemId.MAIN_ENGINE] + + project_id = make_project_id(customer or "cliente", vessel.id) + return Project( + id=project_id, + name=project_name, + customer=customer, + vessel=vessel, + systems_enabled=systems_enabled, + equipment=[], + tags=[], + notes="Creado desde wizard Sprint 1. Sprint 2 agregará equipos sugeridos.", + )