83 lines
2.7 KiB
Markdown
83 lines
2.7 KiB
Markdown
# 端到端模块化新架构（src/new/）
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
src/new/
|
||
├── __init__.py
|
||
├── core/
|
||
│ ├── __init__.py
|
||
│ └── base_view.py # 基础通讯接口（继承 QWidget + dispatch_execute）
|
||
├── services/ # 独立后端大脑
|
||
│ ├── __init__.py
|
||
│ ├── step1_service.py # Step 1 真实服务（execute_step1）
|
||
│ └── placeholder_service.py # step2-step13 占位服务
|
||
├── views/ # 独立前端皮囊
|
||
│ ├── __init__.py
|
||
│ ├── step1_view.py # Step 1 真实视图（继承 BaseView）
|
||
│ └── placeholder_view.py # step2-step13 占位视图
|
||
└── main_router.py # 路由与调度壳（QMainWindow + QThread）
|
||
```
|
||
|
||
## 端到端调用链
|
||
|
||
```
|
||
Step1View._on_run_clicked (绿色按钮)
|
||
│ self.dispatch_execute("step1", self.get_config())
|
||
▼
|
||
BaseView.dispatch_execute (沿父链上溯)
|
||
│ ancestor.run_single_step(step_id, config)
|
||
▼
|
||
MainRouter.run_single_step (查 ROUTES 表 → 注入 work_dir)
|
||
│ TaskWorker(service_func, config).start()
|
||
▼
|
||
services.step1_service.execute_step1(config)
|
||
│ 调 WaterMaskStep.run(...) → 包装成 dict 返回
|
||
▼
|
||
MainRouter._on_step_done (按 status 写日志)
|
||
```
|
||
|
||
## 运行验证
|
||
|
||
### 1. 三层冒烟（推荐先跑）
|
||
|
||
```cmd
|
||
cd D:\111\office\ZHLduijie\1.WQ\WQ_GUI
|
||
python _smoke_new_arch.py
|
||
```
|
||
|
||
预期输出 `汇总：54/54 通过`。
|
||
|
||
### 2. 启动路由主窗口
|
||
|
||
```cmd
|
||
cd D:\111\office\ZHLduijie\1.WQ\WQ_GUI
|
||
python -m src.new.main_router
|
||
```
|
||
|
||
或：
|
||
|
||
```cmd
|
||
python src\new\main_router.py
|
||
```
|
||
|
||
启动后：
|
||
|
||
* 左侧 `QListWidget` 显示 13 个 step（step1 真实，其余占位）
|
||
* 点击 `执行 Step 1: 水域掩膜` → 绿色按钮 → `dispatch_execute`
|
||
* 底部 `QTextEdit` 实时打印 `[Router]` / `[Service]` 日志
|
||
|
||
## 关键设计原则
|
||
|
||
1. **view 零业务**：`src/new/views/*.py` 绝不 import 任何 `src/core/`、`src/services/`
|
||
2. **service 零 PyQt**：`src/new/services/*.py` 不 import 任何 PyQt、不读写全局
|
||
3. **唯一跨界通道**：`BaseView.dispatch_execute` 把 (step_id, config) 推给主窗口
|
||
4. **后台执行不阻塞 UI**：`TaskWorker(QThread)` 子线程跑 service
|
||
5. **错误兜底**：service 任何异常都被 TaskWorker 捕获并转成 `{status: "error", ...}`
|
||
|
||
## 当前状态
|
||
|
||
| step | view | service | 状态 |
|
||
|--------|---------------------|------------------------|---------------------|
|
||
| step1 | `Step1View` 真实 | `execute_step1` 真实 | ✅ 已迁移 |
|
||
| step2-13 | `PlaceholderView` | `execute_placeholder` | 🚧 占位待迁移 | |