feat(T-002): 建立核心数据模型与状态枚举

- src/core/status.py: TaskStatus 六态枚举,英文成员 + display_name/from_display
  中英映射(单一事实源),对齐 04-architecture.md §3.4。
- src/core/models.py: OrderTask dataclass,字段集合/类型对齐 §3.3;支付模式不挂模型。
- tests/test_models.py: 枚举完整性/双向映射/未知值报错/默认值/实例独立性。
- 文档同步:04 §3.4 约定补 from_display;tasks/progress/current-state 更新。

验证:compileall OK;unittest Ran 10 tests, OK。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
chengma
2026-06-24 17:17:52 +08:00
co-authored by Claude Opus 4.8
parent 2863bf2750
commit c41f37a27d
8 changed files with 205 additions and 11 deletions
+1 -1
View File
@@ -169,7 +169,7 @@ OrderTask
约定:
- 中↔英映射只在写入 Excel 或渲染 GUI 的边界处发生(建议由 `TaskStatus` 提供 `display_name` 属性集中维护),核心逻辑只比较英文枚举成员。
- 中↔英映射只在写入 Excel 或渲染 GUI 的边界处发生,由 `TaskStatus` 的 `display_name` 属性与 `from_display` 反查集中维护(单一事实源),核心逻辑只比较英文枚举成员。
- `OrderTask.status` 字段类型为 `TaskStatus`,不直接存中文字符串。
- 注意区分「任务状态」与「执行器状态」:上表是单条任务的 `status`;批次级的「暂停」属于执行器状态,不进入本枚举(见 §4.5)。
+6 -6
View File
@@ -7,10 +7,10 @@
## 当前快照
- 日期:2026-06-24
- 阶段:Phase 0 地基(T-001 完成)/ 原型验证前
- 阶段:Phase 0 地基(T-001、T-002 完成)/ 原型验证前
- 技术栈:Python 3.10(骨架已跑通);计划接入 PySide6 + `uiautomator2` + ADB + `openpyxl`
- 生产代码:已初始化最小骨架(`src/main.py` 最小入口)
- 测试:标准库 `unittest` 冒烟测试(`tests/test_smoke.py`)
- 生产代码:骨架 + 核心数据模型(`src/main.py` 入口、`src/core/` 状态枚举与任务模型)
- 测试:标准库 `unittest`,覆盖冒烟与核心模型(`tests/test_smoke.py`、`tests/test_models.py`)
- 数据:尚未提供真实 Excel 样例
## 当前目录要点
@@ -18,7 +18,7 @@
| 路径 | 状态 | 说明 |
| --- | --- | --- |
| `docs/` | 已有 | 项目规范化文档,已按 harness coding 文档风格建立。 |
| `src/` | 已有 | 已建最小入口 `src/main.py`;GUI/执行器/Excel/Android 模块由后续任务添加。 |
| `src/` | 已有 | `main.py` 入口 + `core/`(`status.py` 状态枚举、`models.py` 任务模型);GUI/执行器/Excel/Android 模块后续添加。 |
| `tests/` | 已有 | 已建冒烟测试 `tests/test_smoke.py`(unittest)。 |
| `requirements.txt` | 已有 | 依赖清单;当前零第三方运行时依赖,含依赖纪律注释。 |
| `samples/` | 待建 | 脱敏 Excel 样例。 |
@@ -29,9 +29,9 @@
任务定义以 [`../tasks.md`](../tasks.md) 为准,执行记录以 [`../progress.md`](../progress.md) 为准。
- 已完成:项目文档初始化;`T-001 初始化 Python 项目骨架`。
- 已完成:项目文档初始化;`T-001 初始化 Python 项目骨架`;`T-002 建立核心数据模型和状态枚举`。
- 正在进行:无。
- 下一个可领取任务:`T-002 建立核心数据模型和状态枚举`。
- 下一个可领取任务:`T-003 建立日志和运行产物目录策略`。
## 当前可运行内容