From 7dfac594fac63e2ea4ff4409f66f35f5194aefa4 Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 16 Nov 2026 15:59:03 +0800 Subject: [PATCH] docs: brief for rectification P0 wrap-up (BUG-1931) Co-Authored-By: Claude Fable 5.2 Claude-Session: https://claude.ai/code/session_01DbBXp2U3BH1SxwAGyhhbe1 --- docs/tasks/TASK-rect-p0-wrapup-20261116.md | 72 ++++++++++++++++++++++ 1 file changed, 72 insertions(+) create mode 100644 docs/tasks/TASK-rect-p0-wrapup-20261116.md diff --git a/docs/tasks/TASK-rect-p0-wrapup-20261116.md b/docs/tasks/TASK-rect-p0-wrapup-20261116.md new file mode 100644 index 000000000..50e2c6cd6 --- /dev/null +++ b/docs/tasks/TASK-rect-p0-wrapup-20261116.md @@ -0,0 +1,72 @@ +# 生时纠正:P0 收尾——聚合统计脚本修订与旧产物检查清单(2026-11-16,Claude) + +Bug 编号:BUG-1931。 + +## 背景 + +占星师 11-16 审了 #294 交付的只读统计脚本 `docs/operations/rect-p0-aggregate-20261116.sql`,指出五处问题。脚本还没有在任何含真实用户资料的库上执行过。本单把这五处改掉,并补一份脚本覆盖不到的「旧产物与消费入口」检查清单。 + +## 不做的事 + +- 不连接、不查询任何含真实用户资料的数据库;不导出用户明细。脚本只写不跑,由产品负责人在受控环境执行。 +- 不改任何运行时行为:不改 `chart-choice` 的 API、页面、存储读写,不改报告、年运、聊天。 +- 不删除、不改写原始出生资料或历史记录的任何迁移。 +- 不改 `docs/operations/rect-p0-aggregate-20261116.sql` 原文件(它已随证据包 A 发出)。新脚本另起文件名。 +- 不碰 `references/real_case_calibration/` 下的归档。 + +## 一、新脚本 `docs/operations/rect-p0-aggregate-20261116-v2.sql` + +保持:只读、repeatable read 事务、只输出固定词表和计数、不选出任何出生资料、标识、邮箱、正文。 + +要改的五处: + +1. **来源冲突不再被首个匹配吞掉。** 现在的 `category` 是一条 `CASE`,先命中哪条算哪条。改为对每条档案分别算出各来源特征的布尔列(旧答题、旧事件采纳、segment-v1、明确手选、#229 分盘选边、填报默认),再输出: + - 各特征单独的计数; + - 同时命中两个及以上特征的计数,单列一类 `conflict`,并按「手选 + 旧来源」「其他组合」分开; + - 都没命中的 `unknown`。 + 「明确手选」如果同一条档案的记录链上还有旧答题、旧事件或选边的痕迹,归入 `conflict`,不算独立更正。 +2. **`unknown` 单独成表。** 另出一张表,只给 `unknown` 档案按「有无关联历史记录」「有无回执」「`contract` 是否缺失」分组的计数。脚本注释写明:unknown 不等于安全,也不等于应撤回。 +3. **补上已改状态档案上的旧产物。** 现在只看 `birth_time_status in ('accepted','confirmed')` 的档案及其 `ready` 报告。新增一段:历史记录表里出现过旧来源(旧答题、旧事件采纳、segment-v1、选边)的档案,不论当前状态,统计其名下各类型报告的数量(按报告类型、按报告状态分组)。表名、字段以仓内迁移为准;查不到对应字段就在注释里写明「无此字段」,不要猜。 +4. **零和「小于 5」分开。** 输出两列:`has_any`(`yes`/`no`)和 `count_display`(0 显示 `0`,1–4 显示 `<5`,其余显示数字)。注释写明:这是内部受权审计用的版本;外发前需再做组合披露审查,不能称为匿名保证。同时去掉可由总计减分组反推小组的输出:有分组被显示为 `<5` 时,该表不输出总计行。 +5. **说明统计的是什么。** 文件头注释写清:统计的是执行时刻的档案状态和现存报告,不是历史采用次数,也不能证明某份报告生成时用了已撤销的规则。 + +## 二、合成数据测试 + +新增 `frontend/tests/rectification-p0-aggregate-v2-20261116.test.ts`(沿用 #294 `rectification-p0-evidence-20261116.test.ts` 的做法;若那里是解析 SQL 文本的静态检查,就在此基础上增加可执行的检查): + +- 仓内已有可起本地数据库的测试设施时(参考 `frontend/tests/database-chart-choice-*.test.ts`),用**合成档案**灌入并执行新脚本,断言: + - 手选 + 旧答题痕迹的档案进 `conflict`,不进 `explicit_manual_choice`; + - 只有手选、无旧痕迹的档案进 `explicit_manual_choice`; + - 状态已改回的档案上的旧报告被第 3 点那段数到; + - 计数为 0 时 `has_any = no`、`count_display = 0`;计数为 3 时 `has_any = yes`、`count_display = <5`; + - 存在 `<5` 分组的表没有总计行; + - 输出中不含任何合成档案的出生日期、时间、标识。 +- 本地起不了数据库就保留静态检查,并在 PROGRESS 里写明哪些断言没有执行过,不要写成已验证。 +- 合成数据不得使用任何真实出生资料。 + +## 三、旧产物与消费入口检查清单 + +新建 `docs/research/rect-p0-artifact-checklist-20261116.md`。只盘点现状,不改行为。逐行给出:入口或产物、读的是什么(字段、函数、文件位置)、是否会读到旧校时结果、现有保护(测试名)、没有保护的写「无」。 + +至少覆盖: + +- 长报告、年运、合盘(含旧的独立合盘)、聊天取数卡、星盘面板、导出文件、首页; +- 各自的缓存:缓存键是什么,键里有没有出生时间来源或范围的版本;旧缓存在来源被撤销后会不会继续被读; +- 已生成并存库的报告快照:有没有「已校正」之类的状态字段;重开旧报告读的是快照还是当前档案; +- 用户已下载到本地的文件:写明服务器无法回收; +- 模型工具:聊天里的工具能不能读到或写回出生时间。 + +清单末尾列出「发现的缺口」,每条一句话,不给修复方案,不改代码。 + +## 四、文档 + +- `docs/BUG_HISTORY.md` 新增 BUG-1931(只在自己那一节内编辑;不写任何姓名、出生资料、邮箱、ID)。状态写 `resolved` 的前提是第二节的可执行断言真的跑过;否则写 `investigating` 并说明。 +- `CHANGELOG.md` 加一行。 +- `docs/tasks/PROGRESS-rect-p0-wrapup-20261116.md`:做了什么、跑了哪些命令和结果、没做到的。 + +## 验收 + +- `PATH=/bin:$PATH python scripts/run_quality_gate.py --profile quick --skip-frontend-runtime` 通过; +- `cd frontend && npx eslint .` 0 错误;新测试通过,前端全量测试不新增失败; +- 原脚本 `rect-p0-aggregate-20261116.sql` 与 `references/real_case_calibration/` 无改动; +- 没有任何运行时代码改动(diff 只含 SQL、测试、文档)。