docs: 增加按模块的改动计划总览
This commit is contained in:
+42
-16
@@ -22,17 +22,40 @@
|
||||
- §3「设计决策」不是待办:改动前必须先与维护者确认,禁止当成缺陷直接「修复」。若某项决策需要调整,先在 §3 改写该条,再开对应实现条目。
|
||||
- 编号规则:条目编号以中文领域前缀开头,形如 `复习-02`,前缀必须让人一眼看出改动落在哪块(会话、复习、报告、归属、导出、AI、数据、安全、运维、清理);设计决策用 `会话-决策01` 这种形式。编号不复用,旧编号作为别名保留在条目首次出现处(如 `复习-02(原 LPT-09)`)。
|
||||
|
||||
## 2. 状态总览
|
||||
## 2. 改动计划总览(按模块)
|
||||
|
||||
| 优先级 | 条目 |
|
||||
|--------|------|
|
||||
| P0 数据正确性 | 会话-01 ~ 会话-04(原 LPT-01、LPT-03 ~ LPT-05;原 LPT-02 已改为设计决策 会话-决策01,编号不再复用)|
|
||||
| P1 会挡路的功能缺口 | 会话-05、报告-01、复习-02、导出-01(原 LPT-07 ~ LPT-10;原 LPT-06 已实现,编号不再复用)|
|
||||
| P2 AI 链路 | AI-01 ~ AI-04(原 LPT-11 ~ LPT-14)|
|
||||
| P3 检索与数据增长 | 数据-01、复习-03 ~ 复习-05、数据-02 ~ 数据-03(原 LPT-15 ~ LPT-20)|
|
||||
| P4 安全与运维 | 安全-01 ~ 安全-04、运维-01、清理-01(原 LPT-21 ~ LPT-26)|
|
||||
| 待实施的设计变更 | 归属-01 内容归属与待归类(原 DC-01)|
|
||||
| 待确认的设计缺口 | 复习-01 复习回路补全(原 DC-02)|
|
||||
按模块给设计和决策。`状态` 含义:**可直接实施**(方案已定,不需维护者再拍板)/**待决策**(结论落地前不要开工)/**依赖其他条目**。
|
||||
|
||||
| 模块 | 条目 | 优先级 | 状态 | 需要先定什么 |
|
||||
|------|------|--------|------|--------------|
|
||||
| 学习会话生命周期 | 会话-01 遗忘检测路径不统一 | P0 | 可直接实施 | — |
|
||||
| | 会话-02 `isOverTime()` 误报超时 | P0 | 可直接实施 | — |
|
||||
| | 会话-03 结束会话不幂等 | P0 | 可直接实施 | — |
|
||||
| | 会话-04 悬挂会话无收敛 | P0 | 待决策 | 收敛方式(惰性 / 定时扫描 / 并用)+ 2 小时硬兜底阈值 |
|
||||
| | 会话-05 活跃会话拦截无出路 | P1 | 待决策 | 出口形式(结束并开始新任务 / 放弃会话),建议与会话-04 同批 |
|
||||
| 内容归属与报告 | 归属-01 内容归属与待归类 | 待实施 | 设计已确认 | 实现级取舍:碎片表如何承载归属、报告字段拆分、归类交互落点 |
|
||||
| | 报告-01 报告与碎片不可修订 | P1 | 待设计 | 与归属-01 同批改报告结构;修订与删除的边界(软删除、历史报告标记) |
|
||||
| 复习 | 复习-01 复习回路补全 | 待确认 | 待决策(6 项) | Feed 是否含报告;反馈动作形态;覆盖率口径;待归类呈现;遗漏项语义;排序可配置性 |
|
||||
| | 复习-02 Feed 只读无反馈动作 | P1 | 依赖复习-01 | 反馈动作形态(复习-01 第 2 项) |
|
||||
| | 复习-03 Feed 随机取样 | P3 | 待决策 | id 区间随机 / 候选池 / 时间窗口随机 |
|
||||
| | 复习-04 覆盖率查询拉全量 | P3 | 依赖复习-01 | 覆盖率口径(复习-01 第 3 项) |
|
||||
| | 复习-05 Feed 返回全文 | P3 | 依赖复习-01 | 条目单位与摘要口径(复习-01 第 1 项) |
|
||||
| AI 链路 | AI-01 事务内同步等 AI | P2 | 待决策 | 事务外纯读对比(小改)/ 任务表 + 异步回写 |
|
||||
| | AI-02 全链路同步阻塞 | P2 | 可实施(方案已定) | 若 AI-01 选任务表方案,则与 AI-01 同批 |
|
||||
| | AI-03 单 worker 串行无重试 | P2 | 可直接实施 | — |
|
||||
| | AI-04 防并发锁是 JVM 内存锁 | P2 | 可直接实施 | 需确认「生成中」的对外语义(返回任务状态而非实体) |
|
||||
| 数据与检索 | 数据-01 业务主表缺索引 | P3 | 可直接实施 | — |
|
||||
| | 数据-02 统计聚合在内存 | P3 | 待决策 | SQL 聚合下推 / 物化统计表 |
|
||||
| | 数据-03 编号撞号风险 | P3 | 待决策 | UUID/ULID / 加随机位 |
|
||||
| 导出 | 导出-01 无数据导出 | P1 | 待决策(小) | 格式(Markdown / JSON)与范围(按任务 / 时间),默认方案可直接采用 |
|
||||
| 安全 | 安全-01 数据库凭证明文 | P4 | 待决策 + 需你执行 | 是否轮换凭证;历史值清理还是视为已泄露 |
|
||||
| | 安全-02 Actuator 鉴权边界 | P4 | 待决策 | 白名单 / 独立端口 + 网络策略(涉 `lpt-infra`) |
|
||||
| | 安全-03 AI 入站无防护 | P4 | 可直接实施 | 内部鉴权方式(共享 token / 仅网络策略) |
|
||||
| | 安全-04 生产打印全部 SQL | P4 | 可直接实施 | — |
|
||||
| 运维与清理 | 运维-01 备份只在同一 PVC | P4 | 待决策 | 异地 / 对象存储目标选型,需你提供目标 |
|
||||
| | 清理-01 死代码与死表 | P4 | 待决策 | 删除 / 保留并在 `lpt-docs` 说明定位 |
|
||||
|
||||
已确认的设计决策(不是待办):会话-决策01 少于 10 分钟不计入总时长;会话-决策02 遗忘判定阈值 50 分钟。
|
||||
|
||||
---
|
||||
|
||||
@@ -295,13 +318,16 @@
|
||||
|
||||
---
|
||||
|
||||
## 9. 建议落地顺序
|
||||
## 9. 建议推进顺序(按模块)
|
||||
|
||||
1. **AI-01**(AI 移出事务)—— 最小改动,避免全站卡死。
|
||||
2. **会话-01 / 会话-03**(结算时间统一、结束幂等)—— 一批改完即修正时间数据口径,建议同时补用例。
|
||||
3. **会话-04 / 会话-05**(服务端收敛与 2 小时硬兜底、活跃会话出口)。
|
||||
4. **AI-02 / AI-03**(AI 异步化与队列可靠性)。
|
||||
5. **数据-01 / 复习-03 / 复习-04 / 数据-02**(索引与聚合下推)—— 数据量还小时成本最低。
|
||||
同一模块内的条目触碰同一批表结构、口径或配置,建议一个模块一次性改完,避免出现双口径并存的中间态。
|
||||
|
||||
1. **学习会话生命周期**:会话-03(结束幂等)+ 会话-01(结算口径统一)一批,修正时间数据口径并补用例;再做会话-02;最后做会话-04 + 会话-05(需先给收敛方式与出口形式的决策)。
|
||||
2. **内容归属与报告**:归属-01 与报告-01 合并一次改完碎片表与报告结构(碎片归属、报告四段结构、导图待更新标记、检索口径)。
|
||||
3. **复习**:先落复习-01 的六项结论(口径与内容边界),再依次做复习-02 / 复习-03 / 复习-04 / 复习-05(排序与摘要都建立在口径之上)。
|
||||
4. **AI 链路**:AI-01(先把 AI 移出事务)→ AI-02 + AI-03(异步任务与队列可靠性)→ AI-04(并发锁与生成中语义)。
|
||||
5. **数据与检索 + 导出**:数据-01(补索引)→ 数据-02 / 数据-03,导出-01 可并行。
|
||||
6. **安全与运维清理**:安全-01 ~ 安全-04、运维-01、清理-01,彼此独立,可并行推进。
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user