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

5.0 KiB

Raw Blame History

Neo 决策记录(P0 + P1 + P2 累积)

日期:2026-05-04 起 / 用途:记录 Neo 在反馈中已拍板的决策,作为后续 Wave 实施的判据维护方式:每轮反馈后由主线增补,Neo 校核

一、P0 第二轮决策(全部 Y,P0-7 选 A)

来源:Neo 在本会话回复中明确确认。

#	问题	Neo 决策	后续动作
1	P0-1 SCD2 视图入口 + P20 SPEC 加 6 处 patch	Y	Wave 1 改 ETL 3 处 SQL + 修 NULL 兼容 + P20 加 §1.4/§3.5/§5.6/AC14-15/§11.2/T16-T17
2	P0-1 base_dws_task 工资任务 3 处 Bug 一并修	Y	作为独立 P1 Bug,Wave 1-2 修
3	P0-5 接受 24 偏离点 4 类分级	Y	立即治理 6 + Wave 协同 6 + 长期治理 5 + 可接受 4 + 其他 3
4	P0-5 致命 1(4 处 fdw_etl 残留 1-2h)	Y(D Bug)	立即进 Wave 1-3,修 tenant_users/excel/clues 共 4 处
5	P0-5 致命 2(JWT aud 缺失 2-3h)	Y(D Bug)	立即进 Wave 1-3,修 auth/jwt.py 签发 + 校验
6	P0-5 各级分别纳入 Wave	Y(按 §三表)	见 00-P0-round2-feedback-response-summary.md §三
7	P0-5 CI 自动化校验落地	Y(长期投资)	pre-commit hook + 周报,Wave 5 起步
8	P0-7 P20 §15 落地	A 直接补到 P20	主线立即写入 P20(30 分钟)
9	P0-7 §15.5 多角色身份提醒机制	Y	看板沙箱接入完成时主动提醒 Neo 切身份
10	P0-7 §15.2 走查再加 `/tenant-admins` + `/etl-tasks`	Y	主线在 §15 patch 中补全(共 12 路由)

二、P0 第一轮决策(已拍板)

来自 00-P0-feedback-response-summary.md:

项	Neo 决策
P0-2	"主 + 副"方案,Wave 5 落地
P0-3	Wave 0 完成后,Wave 1 据 Wave 0 更新 → A 修
P0-4	A 改文档,Wave 5 落地(已确认)
P0-6	同意推迟到 P0-7 收口后,临时加二次确认守卫

三、P1 第一轮决策

来自 04b-feedback/00-P1-feedback-response-summary.md:

#	Neo 决策	Wave
P1-1	接受方案 A,Wave Neo 由主线决定 → Wave 2	Wave 2
P1-2	同意	Wave 5
P1-3	接受 SPEC 化"cross-page-params-spec.md"	Wave 1-3 + Wave 5
P1-4	(默认接受 A 改文档,从清单消除)	Wave 5
P1-5	接受 packages/shared 跨包枚举	Wave 2
P1-6	接受方案 A 完全合并(保留 unified)	Wave 2
P1-7	接受 B+D 混合,Wave 1 起批 1	跨 Wave
P1-8	同意 3 种触发条件	Wave 1-3
P1-9	同意	Wave 5
P1-10	(默认接受 B 现状对,从清单移除)	—
P1-11	同意,前端已 6 分支,补后端契约	Wave 1
P1-12	接受 0=散客 + isScattered	Wave 4
P1-13	担忧"上下文复杂",G-1 调研发现 tasks.md 严重失实	Phase 0-3 渐进
extra dev-trace	接受 Drop,Wave 排序由主线决定 → Wave 5	Wave 5

四、P1 第二轮决策(Neo 已答)

#	问题	主线建议	Neo 决策
1	P1-13 Phase 0-3 渐进路径	Y	关闭(以现状为准)
2	P1-13 Phase 0 立即跑 SELECT	Y	关闭
3	P1-13 先校正 tasks.md 标记	Y	关闭
4	dev-trace 排到 Wave 5 单 PR 1-2h	Y	Y 同意
5	tasks.md 跨 Wave 真实性审计任务(40 份 / 25-30h)	强烈 Y	N 不做(浪费时间)
6	tasks.md hook 防再撒谎	Y	N 不做
7	战略.3 P11 上线门槛(看板沙箱 + 5 项 ETL + 致命 1+2 修)	Y	Y 必须满足
8	战略.4 答完后开 Wave 1	Y	Y

Neo 总指示:"关于 Krio 的 task.md 引发的 P1-13 问题关闭,时间久了。关于 Krio 的 spec 造成的现实与文档差异,以当前现实情况为准。"

五、P2 决策(已读 04c)

来自 04c-feedback/00-P2-feedback-response-summary.md:

5.1 直接同意(8 + 5 子项 = 13 项)

项	决策
P2-1/2/3/5/8/10/11/12	选 A 或同意,Wave 5 落地
P2-13.1/3/4/5	A 或同意建议
P2-13.2	B(改原建议 A→B,代码源 + 自动生成)

5.2 P2 待答项 Neo 反馈(已处理)

#	问题	主线建议	Neo 决策
P2.A	P2-4 ROOM 死代码	去掉(BD 修订)	重新调研(H-1 错了,course/category 是不同概念,课程分布在多表)
P2.B	P2-4 service-record-card 命名统一	Y	(P2-4 重新调研后再定)
P2.C	P2-7 board-finance 隐式 null	Y D Bug	找到的 Bug 修复(原行为可接受)
P2.D	P2-6 R2 起步	Y	同意(后续观察跟踪)
P2.E	P2-9 H-2 7 审稿题	Y	同意(全接受主线建议)
H2.1-7	P2-9 设计细节	各项建议	同意(全接受)

六、变更记录

日期	事件
2026-05-04	P0 二轮 + P1 一轮决策入库
2026-05-04	P0 二轮全部 Y 确认 + P1 二轮 / P2 13 项部分确认
2026-05-04	全局决策仪表板 GLOBAL-DECISION-DASHBOARD.md 建立

5.0 KiB Raw Blame History

Neo 决策记录(P0 + P1 + P2 累积)

一、P0 第二轮决策(全部 Y,P0-7 选 A)

二、P0 第一轮决策(已拍板)

三、P1 第一轮决策

四、P1 第二轮决策(Neo 已答)

五、P2 决策(已读 04c)

5.1 直接同意(8 + 5 子项 = 13 项)

5.2 P2 待答项 Neo 反馈(已处理)

六、变更记录

5.0 KiB

Raw Blame History