docs: 规划正式代码包结构

将正式代码目标结构统一为 app/ 包和根目录 main.py,区分 app/ 正式代码与 prototypes/ 原型参照。

新增 T-000 作为首个实现任务:创建 app 包、迁移 cdp.py、补 app/__main__.py 与 main.py、修正 prototypes/demo.py 导入。

更新模块合约、技术栈、编码规则和 current-state:后续模块路径改为 app/editor.py、app/appconfig.py、app/db.py 等,启动方式为 python main.py 或 python -m app。
This commit is contained in:
chengma
2026-06-26 17:05:18 +08:00
parent 5c6fd0ff98
commit 917656f205
10 changed files with 92 additions and 57 deletions
+4 -4
View File
@@ -7,7 +7,7 @@
1. **不臆造**:选择器、字段、文件、接口不确定就查证或先用 `prototypes/inspect_images.py` 探查页面,不要猜 class 名。
2. **守范围**:只做当前任务要求的事,不顺手加批量/并行等后续功能。
3. **照架构**:复用 `cdp.py`,遵守 `04-architecture.md` 第七节“已验证结论”,不另起一套 CDP 交互。
3. **照架构**:复用 `app/cdp.py`(迁移前参考根目录 `cdp.py`),遵守 `04-architecture.md` 第七节“已验证结论”,不另起一套 CDP 交互。
4. **小步改**:一次只解决一个问题,不夹带无关重构。
5. **可验证**:改完必须能 `py_compile`,关键路径能在测试商品上跑通,对得上验收标准。
@@ -15,7 +15,7 @@
- 按链路确认:`vision` -> `requirements` -> `tech-stack` -> `architecture` -> `tasks`。
- 找到本任务对应的验收标准,写之前就知道“怎么算做对”。
- 复用优先:已有 `cdp.py` 的 `CDP`、`find_product_tab`、`create_tab`、`drag`;已有 `prototypes/demo.py`/`prototypes/set_*.py` 中验证过的 JS 片段。
- 复用优先:已有 CDP 底座(T-000 后为 `app/cdp.py`,当前来源为根目录 `cdp.py`)的 `CDP`、`find_product_tab`、`create_tab`、`drag`;已有 `prototypes/demo.py`/`prototypes/set_*.py` 中验证过的 JS 片段。
- 需求含糊或改动会偏离已验证事实时,先问。
## 2. 事实来源纪律
@@ -51,7 +51,7 @@
完成前至少检查:
- [ ] `python -m py_compile` 通过。
- [ ] `python -m compileall app main.py` 通过(T-000 前仅文档改动不要求)。
- [ ] T-006 完成后,纯逻辑改动有对应 `unittest`,至少覆盖正常路径和一个失败路径。
- [ ] 涉及 CDP 的改动,在测试商品(ITEM_ID 51100639510)上实跑验证。
- [ ] 涉及 DB 的改动,覆盖 schema 初始化、重复初始化、短事务写入、失败状态写入。
@@ -62,7 +62,7 @@
- [ ] 回复里如实说明跑了什么命令、结果如何。
```bash
python -m py_compile *.py
python -m compileall app main.py
python -m unittest discover -s tests # T-006 完成且 tests/ 存在后
python prototypes/demo.py # 单账号闭环验证(不提交)
```