|
|
@@ -0,0 +1,67 @@
|
|
|
+# 报告详情页可修改报告日期 · 增量设计
|
|
|
+
|
|
|
+- 日期:2026-10-26
|
|
|
+- 状态:✅ 开工依据(用户已明确需求「查看报告详情页面,应可以修改报告日期」,方案待派发)
|
|
|
+- 关联:`2026-10-25-indicator-timeline-display-{prd,design}.md`(多期展示,报告日期是时序排序键)
|
|
|
+- 前置:T01(指标时序地基)完成后同批实施;本任务与 T01 在 `HealthReportService.java` / 迁移文件上有**文件交集,必须串行**
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 1. 需求
|
|
|
+
|
|
|
+用户查看报告详情页时,应能修改报告日期(AI 解析出的日期可能不准确,需人工校正)。
|
|
|
+
|
|
|
+## 2. 现状核查结论(2026-10-26 实测)
|
|
|
+
|
|
|
+| 层面 | 现状 | 结论 |
|
|
|
+|---|---|---|
|
|
|
+| 前端入口 | `report-detail.vue` 编辑态(draft/edit)已有「报告日期」输入框(154-155 行,`v-model="payload.summary.reportDate"`);但 **view 模式编辑按钮仅 `isGutFlora` 显示**(18 行),且菌群报告列表实际跳 `gut-flora-detail.vue`(report-list.vue:455),该页编辑态**无日期字段**;DAN 报告走 `report-result.vue`,无编辑入口 | **查看态无入口,需求目前做不到** |
|
|
|
+| 后端落库 | `/report/edit` → `updateReportFromPayload`(HealthReportService.java:1843-1852)已支持更新 `health_reports.report_date`;末尾 pipeline 重写 `indicator_values`(upsert SQL 含 `report_date = VALUES(report_date)`,时序日期会同步) | ✅ 已具备 |
|
|
|
+| 校验 | 无 | ① `SimpleDateFormat("yyyy-MM-dd")` 默认 **lenient**:`2025-13-45` 解析为 2026-02-14 不报错;② 无未来日期拦截;③ 解析失败仅 `log.warn` **静默**,前端仍提示"已保存" |
|
|
|
+| 联动 | 改日期后已刷新 7 维评分 + 食材推荐 | **`member_indicator_current` 快照未刷新**:`updateReportFromPayload` 未调 `refreshMemberIndicatorCurrent`。多期对比「上一期」按 report_date 排序,改日期导致顺序变化时快照错乱 |
|
|
|
+| date_source | T01 迁移 422/423 正在落地(含 date_source 列) | 手动改的日期应标 `real`(真实已知),与回填的 `unknown/derived` 区分;本任务需在 T01 迁移落地后接上 |
|
|
|
+
|
|
|
+## 3. 方案(最小版)
|
|
|
+
|
|
|
+### 3.1 前端(report-detail.vue)
|
|
|
+
|
|
|
+- **view 模式入口**:报告头部 `headInfo.reportDateText` 旁加「修改」入口(tap 进入日期编辑,用日期选择器或 text input,格式 `yyyy-MM-dd`),保存复用 `editHealthReport(reportId, payload, subjectId)`(api.js 已有)。
|
|
|
+- **payload 组装**:进入 view 编辑前需保证 `payload.summary.reportDate` 有值(取 `headInfo.reportDate`),保存时随 payload 提交。
|
|
|
+- **交互文案**:修改成功 → toast「已保存」+ 重载 `loadData()`;失败 → 显示后端返回的明确错误(不吞)。
|
|
|
+- 范围:**本任务只做 report-detail.vue 一个入口**(覆盖 physical_exam/tongue/dan 等非菌群报告);`gut-flora-detail.vue` 与 `report-result.vue` 的日期修改入口列为 P1-2(避免本轮扩散),但**后端能力统一就位**,后续各页接入只需加入口。
|
|
|
+
|
|
|
+### 3.2 后端(HealthReportService.updateReportFromPayload)
|
|
|
+
|
|
|
+- **严格解析**:`sdf.setLenient(false)`;解析失败**抛业务异常**(`IllegalArgumentException` 或统一 `BizException`),由 Controller 返回明确错误信息(如「报告日期格式应为 yyyy-MM-dd」),**不再静默**。
|
|
|
+- **未来日期拦截**:解析成功后校验 `!parsedDate.after(new Date())`(当天可;允许当天,拒绝未来)。超范围抛异常。
|
|
|
+- **联动刷新快照**:日期变更成功分支末尾补调 `refreshMemberIndicatorCurrent(subjectId, reportId)`(复用现有方法,幂等 upsert)——修正多期「上一期」定位。注意 `subjectId` 为空(未绑定成员)时该方法内部已 return 保护,安全。
|
|
|
+- **date_source 标记**(依赖 T01 迁移落地):若 `indicator_values.date_source` 列存在,手动改日期时对该报告的时序行置 `real`(T01 后由 pipeline/回填统一处理 `unknown/derived`;本任务只负责手动修改路径,用 `columnExists` 兜底防旧库崩)。
|
|
|
+- **幂等性**:pipeline 重写 `indicator_values` 基于 UNIQUE(source_type, source_id, definition_id) upsert,改日期不改指标不会产生重复行 ✅。
|
|
|
+
|
|
|
+### 3.3 校验规则汇总
|
|
|
+
|
|
|
+| 规则 | 实现 |
|
|
|
+|---|---|
|
|
|
+| 格式 | 严格 `yyyy-MM-dd`(lenient=false),非法即报错 |
|
|
|
+| 未来日期 | `parsedDate.after(now)` 拒绝 |
|
|
|
+| 空值 | 不传/空串 = 不修改日期(保持现状) |
|
|
|
+| 前置依赖 | date_source 写入前先 columnExists 检查 |
|
|
|
+
|
|
|
+## 4. 验收标准
|
|
|
+
|
|
|
+1. 查看任意非菌群报告详情页 → 报告日期旁有「修改」入口 → 修改后保存成功 → 页面头部日期与 `health_reports.report_date` 同步更新 ✅
|
|
|
+2. 修改后 `indicator_values.report_date` 同步为新值(查询验证同 reportId 的时序行日期已变)✅
|
|
|
+3. 修改日期后成员「上一期」对比(`member_indicator_current`)重算正确(构造两个报告改日期前后各查一次快照)✅
|
|
|
+4. 输入 `2025-13-45` / `2099-01-01` / 乱字符 → 前端收到明确错误,不弹「已保存」✅
|
|
|
+5. T01 迁移落地后:手动改日期 → 该报告时序行 `date_source='real'` ✅(若 date_source 列不存在则跳过,不崩)
|
|
|
+
|
|
|
+## 5. 边界与不做(本轮)
|
|
|
+
|
|
|
+- 不做 `gut-flora-detail.vue` / `report-result.vue` 的日期入口(P1-2)。
|
|
|
+- 不做「按日期重排报告列表」的联动(现有列表已按 report_date desc 排,改日期后列表自动顺位,无需额外开发)。
|
|
|
+- 不做批量改日期 / 管理端入口(D8 最小版已在 T 系列规划,本任务不扩展)。
|
|
|
+
|
|
|
+## 6. Git 纪律
|
|
|
+
|
|
|
+- 独立分支(如 `feat/report-date-editable`),分步 commit;**不合并 cfclub**;不动 docs/;commit 前 `git diff-tree --name-only` 自查产物;**commit 后立即 push**。
|
|
|
+- 与 T01 文件交集(HealthReportService.java、迁移),**必须 T01 合入主线或至少 T01 会话结束后再开工**,避免并发覆盖。
|