chore(docs): Wave 0 调研产出 + P0/P1/P2 反馈调研
建立项目级标杆文档 docs/_overview/ 作为产品全景索引, 解决"PRD 零碎、文档膨胀、跨子系统调研无入口"的问题。 主要内容: - 00-index 总索引 + 维护协议 + 与 CLAUDE.md 关系 - 01-product-overview 产品全景脑图(6 角色 / 6 子系统 / 数据流 / 7 业务概念 / 8+1 AI 矩阵 / 22 术语) - 02a-miniprogram-page-matrix 小程序 21 页业务指纹 - 02b-adminweb-page-matrix admin-web 19 路由业务指纹 - 03-test-spec 测试规范 (L1-L5 分层 + 走查模板 + 75-95 case 估算) - 04-doc-conflicts 39 条冲突索引(P0×8 / P1×13 / P2×13 + 5 子项) - 04a/b/c-conflicts-*-detail 业务故事卡(7 字段:关联/逻辑/影响/选项/判定) - 05-orphan-pages-cleanup admin-web 6 孤儿页面处置(1 归档 + 4 保留) - WAVES-MASTER-PLAN.md 全 Wave 主计划(0-5,共 22-32 工作日) - WAVE-1-KICKOFF.md Wave 1 实施 kickoff - GLOBAL-DECISION-DASHBOARD.md 全局决策仪表板 反馈调研产物: - 04a-feedback/ P0 两轮反馈(8+8 项决策 + D-1/2/3 + F-1/2 子代理产出) - 04b-feedback/ P1 两轮反馈(13+1+5 项 + E-1/2/3/4 + G-1/2 子代理产出) - 04c-feedback/ P2 反馈(13 项 + 5 子项 + H-1/2/3 子代理产出) - NEO-DECISIONS-LOG 累积决策记录 关键追加发现 8 处 D Bug(原蓝本 0): - P0-3 看板沙箱接入(Wave 1 W1-T1) - P0-5 致命 1 (4 处 fdw_etl 残留, 已修 commit17f045a) - P0-5 致命 2 (JWT aud 缺失, 已修 commit17f045a) - P0-6 clearAllTasks 守卫 (Wave 3) - P0-8 DBViewer 黑名单漏 (已修 commit17f045a) - P1-3 task-detail 跳转传 task_id 而非 customer_id - P2-7 board-finance 隐式 null - 2 个独立 Bug (page_context.created_at + ClueCategory 字典) 参考: docs/_overview/00-index.md
This commit is contained in:
@@ -0,0 +1,65 @@
|
||||
# P1-13 prerequisite-fixes 文件确认与介绍
|
||||
|
||||
> 日期:2026-05-04 / 触发:Neo 在 04b P1-13 反馈
|
||||
> Neo 提供线索路径:`\docs\specs\p4-prerequisite-fixes`
|
||||
|
||||
## 一、确认结果
|
||||
|
||||
**Neo 提供的路径正确,文件确实存在。** P1-13 原冲突中提到的"P5.2-prerequisite-fixes"是**记忆错位**,实际是 **P4-prerequisite-fixes**(Kiro spec 风格三件套):
|
||||
|
||||
```
|
||||
docs/specs/p4-prerequisite-fixes/
|
||||
├── design.md (技术设计)
|
||||
├── requirements.md (需求文档)
|
||||
└── tasks.md (任务拆分)
|
||||
```
|
||||
|
||||
## 二、这个文档做什么(业务介绍)
|
||||
|
||||
**全名**:**P4 前置依赖修复**(不是 P5 的前置)。
|
||||
|
||||
**触发原因**:P4 核心业务层(任务系统 + 备注系统 + 触发器机制)实现并通过属性测试后,对比 SPEC 发现 6 处实现偏差,这些偏差会**阻塞 P6 前端任务模块开发**,所以前置修复。
|
||||
|
||||
**来源报告**:`docs/reports/P4-spec-vs-implementation-gap-analysis.md`
|
||||
|
||||
## 三、6 个定点修复
|
||||
|
||||
| # | 修复点 | GAP 编号 | 影响模块 | 实施状态(根据 design.md) |
|
||||
|---|---|---|---|---|
|
||||
| T1 | 任务列表返回已放弃任务(active + abandoned 都返) | GAP-3 | task_manager.py | **已实现,需验证** |
|
||||
| T2 | 召回完成检测器仅匹配 high_priority_recall + priority_recall(不误判 follow_up_visit / relationship_building) | GAP-6 | recall_detector.py | **已实现,需验证** |
|
||||
| T3 | 备注回溯重分类器冲突处理(冲突时跳过 / 顶替 / 跳过创建) | GAP-7 | note_reclassifier.py | **需修改** |
|
||||
| T4 | 回访任务完成条件改为"有备注即完成"(不依赖 AI 评分) | (新增) | note_service.py + note_reclassifier.py | **需修改** |
|
||||
| T5 | trigger_scheduler last_run_at 事务安全(handler + last_run_at 同一事务) | GAP-9 | trigger_scheduler.py | **需修改** |
|
||||
| T6 | 任务生成器 cron 改 04:00 → 07:00(匹配门店营业节奏) | (新增) | trigger_scheduler.py 默认值 | **种子已改,默认值仍 4:00,需修** |
|
||||
|
||||
## 四、与 Wave 1-5 的关系
|
||||
|
||||
**这 6 个修复点不在 Wave 0 的 39 条文档冲突清单里**(本身是"实现偏差"不是"文档冲突"),但与 Wave 1-3 的代码 D Bug 修复方向高度一致:
|
||||
|
||||
- T3 / T4 涉及备注 + 任务系统逻辑,Wave 1-3 走查时会自然碰到
|
||||
- T5 触发器事务安全,Wave 1 沙箱验证会暴露
|
||||
- T6 cron 默认值,Wave 4 调度验证会发现
|
||||
|
||||
**推荐**:把 P4-prerequisite-fixes 的剩余 T3 / T4 / T5 / T6 纳入 **Wave 1 ~ Wave 3** 一并修(估算 1 工作日内可完成)。
|
||||
|
||||
## 五、对 04b P1-13 原结论的修正
|
||||
|
||||
原结论(P1-13):
|
||||
> "P5.2-prerequisite-fixes 文件是否应存在但缺失" — 标 **C 待补**
|
||||
|
||||
**修正**:
|
||||
- 不是 P5.2,是 **P4**
|
||||
- 文件**已存在**,在 `docs/specs/p4-prerequisite-fixes/`(Kiro 风格三件套)
|
||||
- 6 个修复点中 3 个已完成,3 个未完成
|
||||
- 建议改判定为:**B 现状对 + Wave 1-3 推进剩余修复**
|
||||
|
||||
## 六、给 Neo 的决策提问
|
||||
|
||||
1. 是否同意把"P5.2"在 04b P1-13 改名为"P4-prerequisite-fixes"?
|
||||
2. 剩余 T3 / T4 / T5 / T6 是否纳入 Wave 1-3 修?
|
||||
3. P0-1 的 SPI 调研中也提到过 "P5.2 文件",同样应修正为"P4-prerequisite-fixes"?
|
||||
|
||||
---
|
||||
|
||||
> 本文件解决 P1-13 文件存在性问题。文档冲突已落地,无需进一步调研。
|
||||
Reference in New Issue
Block a user