Mdeical_Sur_Report/工程分析/需求分析-2026-04-17-09-57-08.md

需求分析 — 模板新增术后字段（2026-04-17-09-57-08）

一、需求来源

用户要求在默认手术报告模板中进一步插入 4 个新字段，并使其与右侧【基本信息】动态表单联动。

二、具体字段清单

序号	字段名称	字段 key	类型	分类	选项	表单显隐
1	手术后情况	postOpCondition	单选	单选	患者麻醉恢复后安返病房	显示
2	切除标本描述	specimenDescription	单选	单选	暂无（空数组）	显示
3	是否送检病理	pathologySent	单选	单选	是, 否	显示
4	冰冻病理结果	frozenPathology	填空	text	—	显示

三、影响范围分析

1. src/types.ts

   • 需要在 Report 接口中新增 4 个字段定义，保持类型安全。
   • 需要在 DEFAULT_FORM_FIELDS 数组末尾追加 4 条 FormField 配置。

2. src/utils/defaultContent.ts

   • 默认模板 HTML 中，当前"手术后情况"、"切除标本描述"、"是否送病理检查"、"冰冻病理结果"均为纯文本或占位色 <span>。
   • 需要将这 4 处替换为 ${smartField('key')} 调用，使其具备双向绑定能力。

3. src/pages/ReportEditor.tsx

   • 右侧表单已经是"配置驱动渲染"（遍历 formFieldsConfig 按 type switch-case），新增字段后无需修改 JSX。
   • 表单 → 编辑器的同步 useEffect 使用 (reportData as any)[fieldKey] 读取，对新字段自动生效。
   • 编辑器 → 表单的 handleEditorInput 通过 data-bind 属性反射，同样自动生效。

4. src/pages/TemplateManage.tsx

   • 字段库侧边栏读取 formFieldsConfig，新增配置后自动显示在【插入字段】列表中。
   • 无需额外修改。

四、兼容性说明

• 旧用户 localStorage 中已存在 formFieldsConfig，如果其中不包含新字段，则首次进入 ReportEditor/TemplateManage 时只会显示旧字段。
• 策略：由于系统当前逻辑是"若 formFieldsConfig 有值则直接使用，不再回退到 DEFAULT_FORM_FIELDS"，因此需要额外提供一个字段合并/升级逻辑，在初始化时检测缺失字段并自动补入，确保老用户也能看到这 4 个新字段。

五、验收标准

• 新建报告时，默认模板中"手术后情况"等 4 处显示为可编辑的智能方框。
• 右侧【基本信息】表单中出现对应的 4 个输入控件（3 个单选下拉 + 1 个文本框）。
• 表单修改值后，模板中的方框实时同步；在方框中直接输入后，表单也实时同步。
• 老用户（已有 formFieldsConfig）首次进入页面时，自动补全这 4 个缺失字段。