Neo
509cf43284
建立项目级标杆文档 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
165 lines
8.2 KiB
Markdown
165 lines
8.2 KiB
Markdown
# 全局决策仪表板
|
||
|
||
> 日期:2026-05-04 / 用途:Neo 一站式查看 P0+P1+P2 + tasks.md 治理 + 必决/自决分级 / 状态:Wave 0 收尾,等 Neo 答剩余决策即进 Wave 1
|
||
>
|
||
> 配套文档:[NEO-DECISIONS-LOG.md](04a-feedback/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 拍板后立即执行)
|
||
|
||
1. **整合 P0+P1+P2 全部决策到 NEO-DECISIONS-LOG**(等 Neo 答完所有待决项)
|
||
2. **P0-7 §15 直接补到 P20 SPEC**(已确认 A,30 分钟工作)
|
||
3. **更新 00-index 和 04 索引**(指向新 feedback 子目录)
|
||
4. **写 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 实施。
|