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

8.2 KiB

Raw Blame History

全局决策仪表板

日期:2026-05-04 / 用途:Neo 一站式查看 P0+P1+P2 + tasks.md 治理 + 必决/自决分级 / 状态:Wave 0 收尾,等 Neo 答剩余决策即进 Wave 1

配套文档:NEO-DECISIONS-LOG.md 已确认决策 / 各 00 总报告

一、Neo 已拍板项总览

1.1 P0 第一轮 + 第二轮全部确认

#	项	决策
P0-1	SCD2 视图入口方案 + P20 6 处 patch	Y
P0-1 副	base_dws_task 工资任务 3 处 Bug 一并修	Y(独立 P1 Bug)
P0-2	"主+副"BD 手册 + 3 处链接	Y(Wave 5)
P0-3	看板沙箱接入,Wave 1 修(等 Wave 0 收尾)	Y
P0-4	A 改文档 PRD(2 字段为准)	Y(Wave 5)
P0-5 主	matching.py 维持现状 + 文档说明	Y(C)
P0-5 24 偏离	4 类分级(立即/Wave/长期/可接受)	Y
P0-5 致命 1	4 处 fdw_etl 残留 1-2h	Y(D Bug)
P0-5 致命 2	JWT aud 缺失 2-3h	Y(D Bug)
P0-5 CI	pre-commit hook + 周报	Y(长期)
P0-6	推迟到 P0-7 收口后,先临时守卫	Y
P0-7 主	P20 SPEC 投入使用	Y
P0-7 §15	直接补到 P20 §15(成果层走查)	A
P0-7 §15.5	多角色身份提醒机制	Y
P0-7 §15.2	走查再加 /tenant-admins / /etl-tasks	Y
P0-8	DBViewer 选项 D(白名单+只读账号)	Y

1.2 P1 第一轮全部确认

#	项	决策
P1-1	A 一次性迁移 9 人时 → Wave 2	Y
P1-2	同意,改 3-4 处文档	Y(Wave 5)
P1-3	SPEC 化"cross-page-params-spec.md"	Y
P1-4	(默认)A 改文档,从清单消除	Y
P1-5	packages/shared 跨包枚举,AI 不返标记	Y
P1-6	A 完全合并(保留 unified)	Y
P1-7	B+D 混合,Wave 1 起批 1	Y
P1-8	三种触发条件	Y
P1-9	userId/User_ID 文档明文	Y
P1-10	(默认)B 现状对,从清单移除	Y
P1-11	选 A,前端已 6 分支补后端契约	Y
P1-12	0=散客 + isScattered API	Y
dev-trace	Drop 移除,Wave 排序由主线 → Wave 5	Y

1.3 P2 直接同意 8 + 5 子项

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

二、Neo 待拍板项(20 个 Y/N + 几个 ABC)

2.1 P0 二轮已答(10)— 全部 Y

见 NEO-DECISIONS-LOG。

2.2 P1 二轮(5)+ G-2 衍生(1)

| # | 问题 | 主线建议 | 反馈 | |---|---|---| | P1.A | P1-13 接受 Phase 0-3 渐进路径(不一次性修) | Y | 见下 | | P1.B | P1-13 Phase 0 立即跑 SELECT 校核 | Y | 见下 | | P1.C | P1-13 先校正 tasks.md 标记状态 | Y | 见下 | | P1.D | dev-trace Wave 5 单 PR 1-2h | Y | 同意 | | P1.E | tasks.md 撒谎是项目治理问题,起跨 Wave 真实性审计任务(40 份 / 25-30h) | 强烈 Y | 不做，见下 | | G-2.F | tasks.md 真实性审计的修复策略(批量校正还是按 SPEC 逐个) | 主线建议 + Neo 拍板 | 同不做，见下 |

关于krio的task.md引发的 P1-13 问题关闭吧，时间比较久了。而且现状能接受，不要浪费时间纠结这些问题。关于Krio的spec造成的现实与文档差异，以当前现实情况为准。

2.3 P2 待拍(5)+ H-2 设计审稿(7)

我在04c-feedback/00-P2-feedback-response-summary.md中处理。

#	问题	主线建议
P2.A	P2-4 ROOM 死代码:去掉/补配置/维持现状	去掉(BD 手册修订)
P2.B	P2-4 service-record-card vip/tip 命名同步统一	Y
P2.C	P2-7 board-finance 隐式 null 纳入 D Bug	Y(D Bug)
P2.D	P2-6 接受 R2 起步(SQL LEFT 16 字)+ R1 后续观察	Y
P2.E	P2-9 H-2 7 个审稿题一次答完	Y
H2.1	P2-9 表名 `biz.site_contact_info` 是否合适	Y
H2.2	P2-9 是否硬拦真名黑名单(防误填"厉超")	(Neo 自定)
H2.3	P2-9 小程序刷新时机:onLoad / onShow / 二者都	onShow(切店即刷)
H2.4	P2-9 tenant-admin 菜单文字:"门店联系信息"	Y
H2.5	P2-9 新行自动创建策略:首次 GET 返 404 vs 自动创建空行	自动创建空行
H2.6	P2-9 是否加变更审计(谁改的)	Y(updated_by 已设计)
H2.7	P2-6 R2 起步 vs 直接 R1 异步	R2(成本最低)

2.4 全局战略级 — Neo 必决

| # | 问题 | 主线建议 | 反馈 | |---|---|---| | 战略.1 | 全项目 40 份 tasks.md 真实性审计是否启动?(25-30h 分散到 Wave 5)| 强烈 Y | 不做，跳过 | | 战略.2 | tasks.md 撒谎根源是 AI 协作"乐观勾选 + 缺产物校验",是否引入 hook 防未来再撒谎(commit 前校验声明的产物文件存在) | Y(长期投资) | 不做，跳过 | | 战略.3 | P11 上线门槛:看板沙箱接入(Wave 1) + 5 项 ETL 数据准确(Wave 4) + 致命 1+2 修(Wave 1-3) 全部满足才推 | Y | 对的，需要处理完 | | 战略.4 | Wave 0 收尾后立即开 Wave 1?还是先把所有反馈 Y/N 答完 | 答完后开 Wave 1 | 对的，答完后开 Wave 1 |

三、Neo 必决 vs 主线自决分级(回答你的开放问题)

3.1 Neo 必决项(必须 Neo 拍板)

同意已下建议。

类型	例子	触发条件
跨 Wave 资源协调	P1-7 admin API PRD 分批策略	跨多 Wave 投资
生产 DDL	P1-1 schema 迁移 / P0-7 表加列 / P2-9 新表	影响生产 schema
AI 费用	A/B prompt 评分(>20 调用)/ App2 prompt v5.1 全量评估	真调 dashscope
项目级规范	tasks.md 真实性审计是否启动 / RLS 双 schema 模板 / CI hook 引入	影响所有 SPEC
上线门槛	P11 满足条件 / Wave 5 收尾验收	决定上线时机
业务设计	P2-9 no-permission 显示信息 / P0-3 看板沙箱衔接交互	用户可见的产品决策

3.2 主线可自决项(无需 Neo,主线直接做)

类型	例子	触发条件
单文件 Bug 修	P0-1 NULL 兼容 / page_context.created_at / fdw_etl 残留 4 处	修复路径明确 < 50 行
文档同步(已知错误)	P0-1 SPI 26→27 三处 / P1-2 mvp 路径 / P1-9 User_ID 注释	错误已确认
测试补漏	P1-13 Phase 3 补 8 项测试 / 通用 unit / integration / e2e	实施确定
重构(已确定方向)	P1-6 触发器 API 合并 / P1-5 跨包枚举 / dev-trace Drop	Neo 已点头方向
Wave 内排序	dev-trace Wave 5 / P1-1 Wave 2 / P0-7 §15 走查批次	不影响其他 Wave
audit 补齐	每次实施后写审计记录	实施完即写
Grep / 校核 / 普查	tasks.md 真实性扩大审计执行 / P0-5 偏离点扫描扩展	Neo 已批准范围

3.3 灰区(主线给建议 + Neo 1 句确认)

类型	例子	流程
实施方案多选	P0-7 §15 patch A/B/C / P0-1 step2 修法选项 / P1-13 Phase 1 必修内容	主线分析后给推荐,Neo 1 句确认
工作量大于预期	P1-7 admin API PRD 工作量从 1 工作日变 3 工作日	主线告知,Neo 是否调整范围
Bug 优先级	调研中新挖的 Bug(P0-3 / P2-7 board-finance / page_context / ClueCategory)	主线评定 P0/P1/P2,Neo 是否调级

3.4 估计比例

Neo 必决:~10% 决策点(战略/规范/费用)
主线可自决:~80% 决策点(实施/测试/文档)
灰区:~10% 决策点(选项/工作量/优先级)

回答 Neo "还需要决定什么":主线自决能覆盖 90% 的风险修复和控制。Neo 主要把握战略层(必决项)+ 灰区 1 句确认即可。

四、本会话剩余主线工作(等 Neo 拍板后立即执行)

整合 P0+P1+P2 全部决策到 NEO-DECISIONS-LOG(等 Neo 答完所有待决项)
P0-7 §15 直接补到 P20 SPEC(已确认 A,30 分钟工作)
更新 00-index 和 04 索引(指向新 feedback 子目录)
写 Wave 1 实施 kickoff 文档(Neo 答完所有 Y/N 后)

五、Wave 1 实施前置检查清单(Neo 全 Y 后)

P0 二轮 10 项 Y(已确认)
P1 二轮 5+1 项 Y(待答)
P2 5 项 + H-2 7 项 Y(待答)
全局战略 4 项 Y(待答)
P20 SPEC §15 patch 落地(主线执行)
各 feedback 总报告 + 各调研产出 Neo 已读

----- 以上完成后即可启动 Wave 1。

累积已产出文件总数:25+ 份 / 累积冲突 39 条 / 决策点 60+ 项 / 追加发现 D Bug 7 处。推荐 Neo 集中 30 分钟答完剩余 20+ 决策点,即可全面进入 Wave 1 实施。

8.2 KiB Raw Blame History Unescape Escape