DTL-20260820-03 | V3.3.0 活标本失活及文档修正¶
日志编号：DTL-20260820-03 类型：DTL（听写任务日志） 维护人：听写（DT） 日期：2026-08-21 关联：DTL-20260820-02 阶段 5 完成、协作记录 COLLAB-20260820-02、项目推进计划 V1.1、DT-听写工作手册 §七 文件安全要求
一、事实确认¶
TL 指令（2026-08-21）：「实际上听码，听云，听写都已经重启了，不存在活标本」。
1.1 勘察结果（听写侧独立验证）¶
| 勘察项 | 方法 | 结果 |
|---|---|---|
| 进程存活 | Get-Process python,uvicorn |
❌ 无 python/uvicorn 进程 |
| 端口可达 | Invoke-WebRequest http://127.0.0.1:8000/health |
❌ 目标计算机积极拒绝（TCP 连接失败） |
| dip1/backend/app/ .py 源文件 | 递归枚举 | ❌ app/ 目录下无 DDD 业务 .py 文件（仅剩 pycache 目录+极少 .pyc，且不全） |
| alembic/versions/ | 枚举 | ❌ 空目录（0001~0011 迁移脚本全部不存在） |
结论：V3.3.0 代码当前状态——三重丢失： 1. 磁盘 .py 源文件全量丢失（2026-08-20 已确认） 2. Gitee 远程从未 push V3.3.0（2026-08-20 听云排查已确认） 3. 进程内存活标本随三 AI 重启消失（2026-08-21 TL 确认+听写侧独立验证）
1.2 风险评估¶
| 风险 | 等级 | 说明 | 缓解 |
|---|---|---|---|
| V3.3.0 代码无任何对照基准 | 中 | 原本可直接用活标本 openapi 136 路由+S7 功能验收作对照，现改为：静态基线（文档硬约束）+ 功能验收（复跑 TR-20260819-03）双轨 | 详见 §二 新对照基准 |
| 听码恢复代码时偏离原基线 | 中 | 听码无活标本核对，可能出现功能漂移 | 听写在听码完成后先做静态基线机器核对，再复跑功能验收 |
| 文档中"活标本勿重启"条款误导后续 AI | 低 | 若不修正，后续 AI 会尝试保护一个已不存在的进程，浪费资源 | 本日志 §三 全文档修正清单 |
二、V3.3.0 新对照基准（替代原活标本）¶
2.1 静态基线（硬约束，文档驱动）¶
来源：协作记录 COLLAB-20260820-02 §代码基线要求 + §丢失/缺失的代码范围。
| # | 静态基线项 | 核对方法 | 判定通过标准 |
|---|---|---|---|
| S-B1 | WDE-001~005 共 5 条 BUG 修复 | 源码 grep + DTO validator 断言 | 5 条全命中 |
| S-B2 | Alembic head = 0011_v33_ext_ufcs_oqs_mfd | alembic current + 文件清单（0001~0011 共 11 份） |
head=0011，0001~0011 全部存在，29 张新表全覆盖 |
| S-B3 | v3 种子数据 | 源码 grep v3_seed.py 函数清单 | UFCS 21 + VQR 16 + MFR 1 + LGD 1 + 17 demo 账号（ON CONFLICT DO NOTHING） |
| S-B4 | 7 项环境变量读取 | 源码 config.py + os.environ 键 grep | UFCS_SECRET/UFCS_TOKEN_TTL_HOURS/UFCS_MAX_ATTEMPTS_PER_IP/DT_BACKDOOR_ENABLED/DT_BACKDOOR_TOKEN/OQS_ORL_BASE_URL/PDF_OUTPUT_DIR |
| S-B5 | BD 后门 6 端点注册 | 源码 grep 路由装饰器 | GET /api/dt/health、config、schema、seed、users、rbac，共 6 |
| S-B6 | 9 层模块结构清单 | 目录递归 diff | interfaces/api ~ alembic/versions 全部目录 + ~70+ .py 文件数量范围符合 |
2.2 功能验收基准（复跑历史测试报告）¶
来源：协作记录 §TR-20260819-03 DIP1 V3.3 UAT S7 全链路测试完成日报。
| # | 功能验收项 | 复跑方法 | 判定通过标准 |
|---|---|---|---|
| F-A1 | openapi 路由总数 | 启动后 GET /openapi.json | 总数 = 136；V3 路径（/oqs/ /lgd/ /mfd/ /ufcs/ /dt/）= 72 条 |
| F-A2 | S7-1 OQS 完整报价流 | 重跑 UC-23.1~23.8 | 8/8 PASS，final=1141.60 HKD |
| F-A3 | S7-2 CST 订单全链路 | 重跑 UC-15.1~15.10b（含运营端操作模拟） | 17/17 PASS（修复原 3 个脚本缺运营端操作 FAIL）或 14/17 + 脚本备注 |
| F-A4 | S7-3 LGD 运单流转 | 重跑 UC-17.1~19.2 | 11/11 PASS |
| F-A5 | S7-4 MFR 专项 | 重跑 UC-24.1~26.3 | 11/11 PASS（修复原空 dict body FAIL）或 10/11 + 脚本备注 |
| F-A6 | BD 后门 6 端点 | GET BD-01~06 | BD-01 overall=ok + BD-02/03/04/05/06 结构正确 |
两套基准为"与"关系：静态基线（§2.1）全部通过 并且 功能验收基准（§2.2）全部通过，方可视为 V3.3.0 代码恢复合格。
三、文档修正清单¶
3.1 已修正文档（4 份，共 N 处活标本/勿重启表述）¶
| 文档 | 版本变化 | 修正内容摘要 |
|---|---|---|
| 协作记录.md | V1.8 → V1.9 修订追加 | ① COLLAB-02 协作内容追加"2026-08-21 更新"活标本失活+新对照基准说明 ② COLLAB-02 提交后通知：对照验证改为静态基线+功能验收对齐 ③ COLLAB-02 进展记录 3 处：启动通知删除活标本保护提示 + 9 步流程第 6/7 步改为新验收方式 + 追加 2026-08-21 06:00 TL 确认失活进展记录 ④ COLLAB-01 进展记录两处：V3.3.0 正确性对照基准引用改指向 COLLAB-02 新说明 + 失活结论更新双重变三重丢失 |
| 项目推进计划.md | V1.0 → V1.1 | ① 代码丢失状态描述：活标本消失确认 ② 甘特图 d1：对照活标本 → 静态基线核对+功能验收对齐；v2：openapi 136 对照 → 静态+功能基准核对 ③ §3.3 全文重写：活标本对照基准 → 静态基线+功能验收双轨 + 2026-08-21 变更说明 |
| DT-听写工作手册.md | V1.0 → V1.0 修订追加 | ① §7.1 教训背景：追加活标本失活事实 ② §7.2 禁止行为 4：单靠进程存活 → 全量丢失说明 ③ §7.3 必须行为 4：切勿重启进程 → 双轨模式引用 PJR §3.3 |
| DTL-20260820-02 | V1.0 → V1.0 修订追加 | ① 9 步流程第 6/7 步：活标本表述 → 新验收方式 ② 阶段 5 完成判定表：活标本保护 → 活标本失活事实变更+新对照基准指向 DTL-03 |
3.2 本日志留痕（本条）¶
本日志 DTL-20260820-03 即为事实变更的过程留痕，对应 PJM V3.0 §日志体系"事实变更须独立日志成文"。
四、后续行动（听写侧）¶
| # | 行动项 | 触发条件 | 负责 |
|---|---|---|---|
| 1 | 启动听码（加载 4 份文档：WDE 工作手册+SPEC+IMP+COLLAB-02） | TL 签发 | TL |
| 2 | 听码完成代码恢复后，先做静态基线核对（§2.1 S-B1~B6 6 项 39 子项） | 听码通知听写 | 听写 |
| 3 | 静态基线通过后，本地启动服务复跑功能验收基准（§2.2 F-A1~A6） | §2.1 全通过 | 听写 |
| 4 | 双轨全通过后，打包 push hk2026 + scp 推送听云 + 通知听云部署 10 步 | §2.1 + §2.2 全通过 | 听写 |
| 5 | 听云部署完成后，听写 BD 后门复验（BD-01~06）+ 关闭 COLLAB 三连 | @听云 通知 | 听写 |
| 6 | UAT 真实用户测试启动（招募 2-3 内部测试用户 + 1 真实客户） | COLLAB-20260819-01 closed | 听写 |
五、经验教训¶
- 活标本不能作为唯一对照基准：进程、磁盘、远程、备份是 4 层防御；此次三重损失（磁盘误删+远程未 push+进程重启）属于极端情况，但必须预设至少 2 层防御失效的预案。本次 V3.3.0 的补救方案就是将"文档中的代码基线硬约束"和"历史 UAT 测试报告"升格为正式对照基准，直接替代运行时活标本。
- 测试报告必须完整、可复跑、版本冻结：TR-20260819-03 之所以能升格为功能验收基准，正是因为它包含了完整的子用例 HTTP 响应、关键数据（final=1141.60 HKD、LGD ETA=4.90min、NPS=9 星级=5）、覆盖率统计表——这些都是不依赖运行时环境的硬证据。后续 UAT 报告须严格保持此深度。
- 事实变更立即回写文档：TL 口头澄清活标本不存在后，听写立即在所有相关文档（协作记录/PJR/DT 手册/既有 DTL）中回写失活说明，并独立成文 DTL-03，避免后续 AI（含听写未来重启后）仍被过时的"活标本勿重启"提示误导。
六、留痕¶
- 本日志：DTL-20260820-03
- 关联协作记录：COLLAB-20260820-02 / COLLAB-20260820-01（均追加 2026-08-21 失活说明）
- 关联推进计划：PJR V1.1（§2.1 + §3.3）
- 关联手册：DT-听写工作手册 V1.0（§七）
- 关联历史日志：DTL-20260820-02（阶段 5 完成判定表追加事实变更）
本日志为听写（DT）过程留痕，对应 PJM V3.0 §日志规范，记录 V3.3.0 活标本失活事实、新对照基准定义、以及全项目 4 份文档的活标本修正执行清单。