建立项目级标杆文档 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
100 lines
5.0 KiB
Markdown
100 lines
5.0 KiB
Markdown
# 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 §三](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](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](../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](../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 建立 |
|