From dcc883ca5633459c8ab7d0fe1114306d29edd590 Mon Sep 17 00:00:00 2001 From: Claude Date: Fri, 13 Nov 2026 09:56:02 +0800 Subject: [PATCH] docs(tasks): brief for #239 chart-choice-rounds-page Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01DbBXozsiu43ob7B8UZCmDM --- .../TASK-chart-choice-rounds-page-20261113.md | 52 +++++++++++++++++++ 1 file changed, 52 insertions(+) create mode 100644 docs/tasks/TASK-chart-choice-rounds-page-20261113.md diff --git a/docs/tasks/TASK-chart-choice-rounds-page-20261113.md b/docs/tasks/TASK-chart-choice-rounds-page-20261113.md new file mode 100644 index 00000000..b340d3d3 --- /dev/null +++ b/docs/tasks/TASK-chart-choice-rounds-page-20261113.md @@ -0,0 +1,52 @@ +# TASK:选盘页多轮流程、v2 采纳记录、老用户「还有 N 处没确认」、报告读 v2 段(2026-11-13) + +- Gitea:#239(父单 #229) +- 分支:`codex/chart-choice-rounds-page-20261113`。**开工条件:#238(引擎单)合入 staging 之后。**开工前先 rebase 到最新的 staging。 +- Bug 编号:BUG-1873 +- 验收:Claude(jyotisha-e6) + +不得自行写「产品决定/裁定」;任务书没写的取舍一律选需拍板。不得修改或删除既有断言来让测试通过;确需修改的,写明原值、新值和原因。 + +## 背景 + +见父单 #229 和引擎单的任务书。产品决定(2026-11-13): + +- 六张关键分盘:D1、D9、D10、D2、D6、D8; +- 最多 3 轮,剩下的记为未定; +- 老用户在生时纠正页看到「还有 N 处没确认」提示,可以接着问; +- 报告不加任何提示(报告只负责出报告)。 + +## 要做的 + +1. **页面多轮。** `frontend/src/components/chart-choice/chart-choice-page.tsx`:每轮沿用现有的对比卡(CompareCard)、问题(ChooseStep)和结果页(ResultStep),不新造控件。 + - 每轮的结果页加一行「第 n 处,共 m 处」(m = 已问的轮数 + `remaining_key_lines`,最多 3)。 + - 主按钮:还有下一轮时为「接着确认下一处」,最后一轮为现有的采纳按钮。 + - 加一个次要入口「先到这里」,对应引擎的 `stop: true`。 + - 文案遵守产品 UI 规则:不写提示性副标题,不出现术语堆叠。 +2. **采纳。** 用 v2 记录(segment、rounds、undetermined_charts)。`chart_choice_adopt_v3` 如果需要多存字段,写新迁移,不改旧迁移。保存时刻可以带秒(见引擎单)。 +3. **老用户提示。** 生时纠正页的首页(HomeView)在档案的采纳记录是 v1、而且引擎返回剩余关键线 > 0 时,显示一行「还有 N 处没确认」,点击后从上次结果接着问。 + - v2 记录里如果 `undetermined_charts` 非空,同样显示,N = 未定分盘对应的线数。 + - 文案和样式复用现有的卡片和链接,不新增按钮样式。 +4. **报告读 v2。** `frontend/src/lib/personal-report-longform-birth.ts::rectifiedReadingWindow`: + - 有 v2 `segment` 时,直接用它(秒级),不再用「window + line_at」去推; + - v1 记录保持 #227 的逻辑; + - `undetermined_charts` 原样放进 `birth_time_window`,只记录,不额外处理。 +5. 页面截图(手机宽度)附在 PR 里:第 1 轮、第 2 轮、最后一轮的结果页,以及老用户提示。 + +## 不要碰 + +- 引擎规则(引擎单负责)。 +- 报告的复查与等级逻辑。 +- 冻结文件。 + +## 验收 + +1. 前端测试: + - 三轮流程的状态流转正确; + - 「先到这里」会带上 `stop`; + - v2 采纳的请求体正确; + - 老用户提示的显示条件正确; + - 报告用 v2 segment 算出的前后误差正确,秒级也正确。 +2. 真实 PostgreSQL 测试:v2 记录能存、能读,`active_birth_time` 带秒。 +3. 截图交给产品负责人看过以后,才能标 `待真机`。 +4. tsc、eslint 0 个错误,前端相关测试和 Python 快速门全部通过。