refactor(shell): R08-T10 xong — app.py 1293 -> 128, MainWindow tách thành 11 file

Đây là deliverable còn thiếu duy nhất trong 17 task của Gamma. app.py 128 chỉ còn điểm vào chương trình presentation/shell/ main_window.py 362 __init__ + vòng đời cửa sổ nav_rail.py 385 dựng rail + cây điều hướng + thu gọn top_bar.py 234 thanh trên + tài khoản + đáy rail session_events.py 104 lịch sử, thông báo task xong page_registry.py 82 4 màn chính, dựng lười, _goto rail_project.py 132 bộ chọn project + RECENTS lifecycle_coordinator.py 110 canh màn hình + tắt sạch tray_manager.py 76 khay hệ thống toast.py 40 thông báo góc trên trái bootstrap.py 42 Composition Root branding.py 26 ASSETS + app_icon rail_metrics.py 37 kích thước rail + cách vẽ hàng Mọi file dưới 400 dòng. Đây là ngưỡng CASAN Check 2. NÓI THẲNG VỀ CÁCH TÁCH: sáu file trong đó là MIXIN, không phải widget rời. Cả loạt phương thức đọc/ghi state của cửa sổ (self._page_widgets, self.workspace, self.splitter...). Biến thành đối tượng cộng tác thì phải viết lại từng chỗ self.X thành self.window.X — gần 800 dòng sửa chỉ để đổi cách gọi, rủi ro cao mà không đổi hành vi. Mixin cho đúng thứ đang cần: mỗi mảng một file, ai sửa rail thì mở file rail. Chuyển thành widget thật khi có cửa sổ thứ hai cần dùng lại — hiện chưa có. Giữ đường vào cũ: MainWindow, app_icon, _NAV_*, _Toast vẫn import được từ cowork_local.app, nên 24 checker trong tools/ không phải sửa. BA LỖI TỰ GÂY TRONG LÚC TÁCH, ĐỀU DO CHECKER BẮT ------------------------------------------------- 1. 12 import lazy nằm trong thân hàm bị thụt lề nên regex đổi mức tương đối của tôi bỏ sót -> ModuleNotFoundError khi bấm vào rail. 2. Bộ dò import thiếu của tôi tính cả import cục bộ trong hàm KHÁC, nên tưởng QHBoxLayout đã có -> 17 checker đỏ. Bỏ cách dò, cấp thẳng khối import đầy đủ rồi cắt phần không dùng. 3. Hằng số ASSETS và _NAV_* nằm ở khối tôi không mang theo -> NameError. Cả ba đều là lỗi im lặng với bộ test đơn vị (714 vẫn xanh suốt) và chỉ lộ khi dựng cửa sổ thật. Đó chính là lý do bộ checker trong tools/ tồn tại. Cập nhật 2 đích đột biến của check_probes_bite: mã nó cần sửa đã dời khỏi app.py sang rail_project.py và nav_rail.py. 714 test xanh. 24/24 checker qua. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-26 10:32:22 +09:00
parent bc282c71d0
commit 70a0c2fdcf
11 changed files with 1549 additions and 1309 deletions
@@ -0,0 +1,82 @@
+"""Bốn màn chính và cách chuyển giữa chúng — R08-T10.
+
+Dashboard và Lịch chỉ được dựng ở lần mở đầu tiên (dựng lười) — mở app không
+phải trả giá cho hai màn có thể cả phiên không ai vào. ``_ensure_page`` là chỗ
+duy nhất biết điều đó, nên mọi đường tới một trang đều phải đi qua ``_goto``.
+
+Cùng kiểu mixin, xem ghi chú ở đầu ``nav_rail.py``.
+"""
+from __future__ import annotations
+
+from PySide6.QtCore import Qt
+from ...i18n import tr
+from ...ui.dashboard_tab import DashboardTab
+from ...ui.monitoring_tab import MonitoringTab
+from ...ui.schedule_task_tab import ScheduleTaskTab
+
+
+class PageRegistryMixin:
+    def _page_index(self, widget) -> int:
+        return self.pages.indexOf(widget)
+    def _build_dashboard(self):
+        d = DashboardTab(self.ctx)
+        d.status_message.connect(self.statusBar().showMessage)
+        self.dashboard = d
+        return d
+    def _build_schedule(self):
+        s = ScheduleTaskTab(self.ctx, self.task_scheduler)
+        s.status_message.connect(self.statusBar().showMessage)
+        self.schedule = s
+        return s
+    def _build_monitoring(self):
+        m = MonitoringTab(self.ctx, cowork=self.cowork, structure=self.structure,
+                          task_scheduler=self.task_scheduler)
+        m.status_message.connect(self.statusBar().showMessage)
+        self.monitoring = m
+        return m
+    def _ensure_page(self, row: int) -> None:
+        """Build a lazy nav page on first visit and swap it in for its placeholder."""
+        if not (0 <= row < len(self._built)) or self._built[row]:
+            return
+        builder = self._nav_defs[row][2]
+        if builder is None:
+            return
+        real = builder()
+        placeholder = self._page_widgets[row]
+        self.pages.insertWidget(row, real)     # placeholder shifts to row+1
+        self.pages.removeWidget(placeholder)
+        placeholder.deleteLater()
+        self._page_widgets[row] = real
+        self._built[row] = True
+    def _page_index(self, widget) -> int:
+        if widget is self.workspace:
+            return self._ROW_WORKSPACE
+        if self.dashboard is not None and widget is self.dashboard:
+            return self._ROW_DASHBOARD
+        if self.schedule is not None and widget is self.schedule:
+            return self._ROW_SCHEDULE
+        if self.monitoring is not None and widget is self.monitoring:
+            return self._ROW_MONITORING
+        return self.pages.indexOf(widget)
+    def _goto(self, page: int, sub) -> None:
+        self._ensure_page(page)                # build lazy page on first visit
+        self.pages.setCurrentIndex(page)
+        if page == self._ROW_WORKSPACE:
+            self.workspace.refresh()           # re-list projects + threads on entry
+        widget = self._page_widgets[page]
+        if sub is not None and hasattr(widget, "select_subtab"):
+            # Enforce the project gate here rather than at each entry point. A
+            # greyed rail row cannot be clicked, but _goto is also reached from
+            # RECENTS and from startup restore, and it used to open a sub-tab
+            # the gate was holding shut — page shown, tab strip still hiding it.
+            if hasattr(widget, "subtab_available") and not widget.subtab_available(sub):
+                self.statusBar().showMessage(tr("app.nav.needs_project"), 4000)
+            else:
+                widget.select_subtab(sub)
+        # Move the highlight with the content, however navigation was triggered —
+        # a programmatic _goto used to leave it on whatever was clicked last.
+        if not self._nav_building:
+            self._select_nav_row(page, sub)
+        self._update_dock_guard()
+        # Switching pages updates which conversation is "current".
+        self._refresh_history()