refactor(shell): R08-T10 — bootstrap + tách TrayManager và LifecycleCoordinator

app.py 1356 -> 1293 dòng. presentation/shell/ có 3 file:

  bootstrap.py               Composition Root (đã vào ở commit trước)
  tray_manager.py            khay hệ thống + thông báo bong bóng
  lifecycle_coordinator.py   canh cửa sổ theo màn hình + tắt cho sạch

Vì sao tách khay: khay là thứ CÓ THỂ KHÔNG TỒN TẠI (một số môi trường Linux,
phiên RDP). Trước đây mỗi chỗ dùng phải tự nhớ kiểm `if self.tray is not None`
— có 6 chỗ như thế, và 3 chỗ còn phải tự bọc try/except quanh showMessage.
Gói lại thì chỗ gọi cứ gọi, không có khay thì không có gì xảy ra.

Vì sao tách vòng đời: hai việc trong đó không phải việc của giao diện. Canh
cửa sổ theo màn hình là số học thuần (anh Nam có hai màn khác độ phân giải và
khác tỉ lệ phóng — kéo qua lại là vùng làm việc đổi). Còn shutdown là thứ tự
dừng có ý nghĩa: bộ lập lịch trước để nó không kịp khởi động việc mới trong
lúc ta đang dừng việc cũ, rồi mới tới worker, rồi ngắt tiến trình MCP.

closeEvent/moveEvent/resizeEvent vẫn ở lớp cửa sổ vì Qt gọi thẳng vào đó,
nhưng phần quyết định đã chuyển đi. closeEvent từ 30 dòng còn 11.

Giữ self.tray thành property trỏ vào self._tray.icon — vài chỗ còn đọc tên cũ.

Đã lấy mốc trước khi bóc rồi so lại sau: 24/24 checker trong tools/ qua cả hai
lần. Đây là bộ đặc tả thật cho MainWindow (check_nav, check_rail_align,
check_layout_geometry, check_controls_alive... dựng cửa sổ thật offscreen trên
BẢN SAO của ~/.cowork_local, scheduler bị vô hiệu hoá). 632 test xanh.

CHƯA làm hết R08-T10: plan ghi tách thành main_window.py + tray_manager.py +
lifecycle_coordinator.py. Hai file sau đã xong, main_window.py thì chưa —
MainWindow vẫn nằm trong app.py và vẫn 1095 dòng. Đo lại thì khối lượng không
nằm ở ba cụm plan nêu mà ở hai cụm khác:

    nav rail    18 method, ~340 dòng
    topbar      8 method,  ~157 dòng
    __init__    279 dòng

Hai cụm đó dính chặt vào state của cửa sổ, chuyển đi cần đổi giao diện giữa
chúng chứ không phải dời chỗ, nên tôi dừng ở đây thay vì làm nửa vời.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Nam Pham Dinh Thanh
2026-08-25 19:56:37 +09:00
co-authored by Claude Opus 5
parent 2246d55286
commit c77ce36191
3 changed files with 214 additions and 91 deletions
+110
View File
@@ -0,0 +1,110 @@
"""Vòng đời cửa sổ chính — R08-T10.
Bóc từ ``app.py::MainWindow``. Hai việc, đều không phải việc của giao diện:
1. **Canh cửa sổ theo màn hình đang đứng.** Người dùng có hai màn khác độ phân
giải và khác tỉ lệ phóng; kéo cửa sổ sang màn kia là vùng làm việc đổi. Đây
là số học thuần, không đụng widget nào ngoài chính cửa sổ.
2. **Tắt cho sạch.** Dừng bộ lập lịch, dừng mọi lượt chạy còn dở, ngắt tiến
trình MCP. Thiếu một bước là để lại tiến trình con chạy mồ côi sau khi
người dùng đã thoát.
Các hàm ``closeEvent``/``moveEvent``/``resizeEvent`` vẫn phải nằm ở lớp cửa sổ
— Qt gọi thẳng vào đó — nhưng phần quyết định thì ở đây.
"""
from __future__ import annotations
from PySide6.QtGui import QGuiApplication
#: Cửa sổ chiếm bao nhiêu phần màn hình khi mở lần đầu.
SCREEN_SHARE_W, SCREEN_SHARE_H = 0.80, 0.85
#: Chừa mép để cửa sổ không đụng thanh tác vụ.
MARGIN = 60
#: Kích thước tối thiểu mong muốn — vẫn phải nhỏ hơn màn hình thật.
MIN_W, MIN_H = 820, 520
class LifecycleCoordinator:
def __init__(self, window):
self.window = window
self._last_screen = None
# ---- canh theo màn hình ----------------------------------------------
def fit_to_screen(self, want_w: int, want_h: int) -> None:
w = self.window
screen = w.screen() or QGuiApplication.primaryScreen()
avail = screen.availableGeometry() if screen else None
if avail is None:
w.resize(want_w, want_h)
return
# Lấy một phần màn hình: không bao giờ nhỏ hơn kích thước yêu cầu, cũng
# không bao giờ lớn hơn thứ màn hình hiển thị nổi.
width = min(max(want_w, int(avail.width() * SCREEN_SHARE_W)),
avail.width() - MARGIN)
height = min(max(want_h, int(avail.height() * SCREEN_SHARE_H)),
avail.height() - MARGIN)
self._apply_minimum(avail)
w.resize(max(width, 1), max(height, 1))
frame = w.frameGeometry()
frame.moveCenter(avail.center())
w.move(frame.topLeft())
def screen_maybe_changed(self) -> bool:
"""Gọi khi cửa sổ bị di chuyển. Trả True nếu đúng là đã đổi màn hình.
Trả về bool để chỗ gọi biết có cần xếp lại mấy thứ nổi hay không —
kéo cửa sổ trong cùng một màn thì không cần làm gì cả.
"""
w = self.window
screen = w.screen()
if screen is self._last_screen:
return False
self._last_screen = screen
avail = screen.availableGeometry() if screen else None
if avail is not None:
self._apply_minimum(avail)
return True
def _apply_minimum(self, avail) -> None:
# Kích thước tối thiểu không bao giờ được vượt quá thứ màn hình hiển
# thị nổi — nếu không thì cửa sổ không thu nhỏ vừa màn được nữa.
self.window.setMinimumSize(min(MIN_W, avail.width() - MARGIN),
min(MIN_H, avail.height() - MARGIN))
# ---- đóng và tắt ------------------------------------------------------
def should_keep_running(self) -> bool:
"""Đóng cửa sổ có nghĩa là chạy nền tiếp, hay là thoát hẳn?
Chạy nền tiếp chỉ khi có khay hệ thống để quay lại — không có khay mà
vẫn ẩn đi thì người dùng mất luôn đường vào app.
"""
w = self.window
if w.tray is None or w._really_quit:
return False
return bool(w.ctx.config.data.get("tray", {}).get("minimize_on_close", True))
def shutdown(self) -> None:
"""Dừng mọi thứ đang chạy. Thứ tự có ý nghĩa: bộ lập lịch trước, để nó
không kịp khởi động thêm việc mới trong lúc ta đang dừng việc cũ."""
w = self.window
w.task_scheduler.stop() # dừng luôn các task đã lên lịch
if getattr(w, "routing_scheduler", None) is not None:
w.routing_scheduler.stop()
for tab in (w.cowork,):
for worker in tab.active_workers():
if worker.isRunning():
worker.request_stop()
worker.wait(1500)
if hasattr(w.structure, "stop_cmem_ui"):
w.structure.stop_cmem_ui()
# Không bao giờ để lại tiến trình MCP đã kết nối chạy mồ côi.
w.ctx.stop_mcp_connections()