docs(task): brief for reports-no-web-wording-20261109

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01DbBXoyn7Hj3LCW3BUs5bZ8
2026-11-09 00:14:42 +08:00
1 changed files with 61 additions and 0 deletions
@@ -0,0 +1,61 @@
+# TASK：报告、年报、合盘不向用户显示“联网 / 外部资料 / MEVG / 真实案例”字样（2026-11-09）
+
+- 分支：`codex/reports-no-web-wording-20261109`（基于 staging `04b49609`）
+- Bug 编号：BUG-1810（开工时核对 `docs/BUG_HISTORY.md` 的最大编号；1809–1830 已预留给本批任务）
+- 负责验收：Claude（jyotisha-2a）
+
+## 背景
+
+产品负责人于 2026-11-08 决定：用户看到的任何文字，都不出现“联网 / 外部资料 / 外部核验 / MEVG / 真实案例校准”这类说法，两种解读方式都一样。后台的回执、审计记录和证据卡保留原样，不删除。
+
+聊天部分已在另一分支完成。本任务只处理**报告、年报、合盘报告**这三处的用户可见文字。
+
+此决定与占星师“缺口不能隐藏”的裁定不一致，属于产品的取舍。说明已写在 `references/product_runtime_contract.md`，聊天分支上线后会带上；本任务不要改这个文件。
+
+## 要改的文件（先逐个打开核对，以实际代码为准）
+
+- `frontend/src/lib/report-public-projection.ts`
+- `frontend/src/lib/annual-report-generate.ts`
+- `frontend/src/lib/personal-report-reading.ts`
+- `frontend/src/lib/synastry-full-technical.ts`
+- `scripts/annual_service/report_facts.py`
+- `scripts/report_render/audit_chapters.py`
+
+做法：
+
+1. 找出上述文件中写给用户、或写给模型并会出现在用户可见正文里的上述字样，包括提示词里要求模型写“没有联网核对 / 外部资料未核验”之类的指令。
+2. 用户可见的文字一律删除。删掉一整行后，不要留下空的表格行或空标题。
+3. 后台字段（审计行、回执里的 MEVG / Real Case 行、`status` 字段）保持原样，只是不再渲染给用户。
+4. `scripts/full_report_quality_gate.py` 如果有校验要求报告里必须出现这类字样，改为不要求，并改为检查后台记录仍然存在。
+
+## 不要碰
+
+- `references/` 下占星师的方法文件（例如 `references/event_judgment_marriage.md`）一字不改。那是上游原文。
+- `references/product_runtime_contract.md`、`frontend/src/lib/consultation-*.ts`、`frontend/src/mastra/**`：聊天部分，另一分支在改。
+- `frontend/src/lib/consult-preset-prompts.ts`。
+- 不改任何计算逻辑。
+
+## 验收标准
+
+1. 用一张合成测试盘生成个人报告、年报、合盘报告的用户可见文本（用现有测试夹具），全文不出现以下字样：`联网`、`外部资料`、`外部核验`、`MEVG`、`真实案例`、`Real Case`、`Global Web`。为三处各写一条测试，放在现有对应测试文件里，或新建 `frontend/tests/report-no-web-wording-20261109.test.ts` 与 `tests/test_report_no_web_wording_20261109.py`。
+2. 后台记录仍在：回执或审计数据里 MEVG / Real Case 行仍然存在。为此写一条断言。
+3. 改动既有断言时，写“原值 / 新值 / 原因”三栏注释。原因写：`产品负责人 2026-11-08：用户可见文字不出现联网/外部核验字样，后台保留`。
+4. 在 `docs/BUG_HISTORY.md` 末尾追加 BUG-1810（格式照最近的条目）。不写任何出生资料或姓名。
+
+## 自测命令（Windows / PowerShell）
+
+- `frontend\node_modules\.bin\tsc --noEmit -p frontend`
+- 在 `frontend` 下运行 `npm run lint`
+- `node node_modules/tsx/dist/cli.mjs --test tests/<改到或新建的测试文件>`（在 `frontend` 下）
+- `.venv\Scripts\python -m pytest tests/test_report_no_web_wording_20261109.py tests/<改到的报告测试> -q`
+
+前端全量测试和 Python 快速门由 Claude 在验收时跑。
+
+## 进度记录
+
+`docs/tasks/PROGRESS-reports-no-web-wording-20261109.md`
+
+## 何时停下来选“需拍板”
+
+- 某处字样属于法律或合规必须保留的免责声明（例如“不构成医疗/投资建议”），不确定能不能删时。
+- 删掉以后报告结构明显缺了一节，需要产品决定怎么补。