Files

Neo 509cf43284 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 残留, 已修 commit 17f045a)
- P0-5 致命 2 (JWT aud 缺失, 已修 commit 17f045a)
- P0-6 clearAllTasks 守卫 (Wave 3)
- P0-8 DBViewer 黑名单漏 (已修 commit 17f045a)
- 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

2026-05-04 07:38:28 +08:00

3.2 KiB

Raw Blame History

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 的决策提问

是否同意把"P5.2"在 04b P1-13 改名为"P4-prerequisite-fixes"?
剩余 T3 / T4 / T5 / T6 是否纳入 Wave 1-3 修?
P0-1 的 SPI 调研中也提到过 "P5.2 文件",同样应修正为"P4-prerequisite-fixes"?

本文件解决 P1-13 文件存在性问题。文档冲突已落地,无需进一步调研。

3.2 KiB Raw Blame History