Remove frontend JSON export actions
- Remove user-visible JSON export options from report editor, report management, template management, bulk template export, and AI debug logs. - Keep HTML template package and PDF/browser print exports as the supported frontend export formats. - Change per-template export to generate reusable HTML template packages. - Preserve legacy JSON template import compatibility without exposing new JSON export buttons. - Update README, AGENTS, feature, requirement, design, module, API contract, progress, and testing docs for the export policy change.
This commit is contained in:
@@ -322,7 +322,7 @@ pageSize?: number
|
||||
|
||||
### `GET /api/reports/:id/export.json`
|
||||
|
||||
返回结构化报告 JSON。权限与查看报告一致。当前确定不需要水印、导出原因、审批或专门导出审计；现阶段仍主要由前端 Blob 导出。
|
||||
返回结构化报告 JSON。权限与查看报告一致。当前确定不需要水印、导出原因、审批或专门导出审计；用户可见前端 Blob JSON 导出入口已移除，如后续需要结构化交换应由后端接口统一提供。
|
||||
|
||||
## Templates API
|
||||
|
||||
|
||||
@@ -180,7 +180,7 @@ main.tsx
|
||||
|
||||
- 调用 Reports API 获取权限过滤后的报告。
|
||||
- 前端搜索、状态筛选和日期筛选。
|
||||
- 删除报告、历史恢复、JSON 导出和批量操作。
|
||||
- 删除报告、历史恢复、打印/PDF 导出和批量操作。
|
||||
|
||||
`ReportView` 负责只读展示：
|
||||
|
||||
@@ -199,7 +199,7 @@ main.tsx
|
||||
- 富文本命令、表格、字段、图片占位符、AI 区域插入。
|
||||
- 字段库维护。
|
||||
- 模板图片资源上传和删除。
|
||||
- 模板 JSON 导入导出。
|
||||
- 模板 HTML 模板包导出和 HTML/历史 JSON 模板包导入。
|
||||
|
||||
后续拆分优先级：
|
||||
|
||||
|
||||
@@ -96,7 +96,7 @@ AI 可编辑区域通过 `.ai-region[data-ai-id]` 和内部 `.ai-content` 定位
|
||||
|
||||
`src/utils/print.ts` 通过隐藏 iframe 写入报告 HTML 和打印样式，然后调用浏览器打印。PDF 导出依赖浏览器“另存为 PDF”，不是服务端生成 PDF。
|
||||
|
||||
JSON 导出使用 Blob 下载，报告导出主要包含元信息和 `DEFAULT_FORM_FIELDS` 中定义的字段。
|
||||
前端用户可见 JSON 导出入口已移除。报告导出保留浏览器打印/PDF；模板导出保留可回导 HTML 模板包和 PDF 打印预览，历史 JSON 模板包只作为导入兼容格式保留。
|
||||
|
||||
## 外部服务设计
|
||||
|
||||
|
||||
@@ -31,8 +31,8 @@
|
||||
| 报告管理筛选 | 真实集成 | `ReportManage` 优先调用 `GET /api/reports`，后端按超级管理员/管理员/医生过滤；前端继续支持搜索、状态和时间筛选；只有开发/显式回退模式下 API 不可用才回退本地报告。 |
|
||||
| 报告查看 | 真实集成 | `ReportView` 优先调用 `GET /api/reports/:id`，后端校验查看权限；页面渲染报告 HTML；只有开发/显式回退模式下 API 不可用才回退本地权限检查。 |
|
||||
| PDF 导出 | 真实集成 | 通过隐藏 iframe 或 `window.print()` 调用浏览器打印，用户手动保存为 PDF；不是后端 PDF 生成。 |
|
||||
| JSON 导出 | 真实可用 | Blob 下载结构化报告字段或模板包；模板 JSON 包适合系统内迁移。 |
|
||||
| 模板管理 | 真实集成 | `TemplateManage` 优先调用 `/api/templates?access=manage`，新增/编辑/删除会写后端并清洗 HTML；新增后保存内容以当前页面模板列表为准并同步兼容缓存，避免旧本地缓存覆盖新模板；字段库优先调用 `/api/library/fields`，模板图片资源优先调用 `/api/files`。导入导出支持 JSON 模板包、可再导入的 HTML 模板包和 PDF 打印预览，仍主要在前端处理。 |
|
||||
| 前端 JSON 导出 | 已移除 | 用户可见的报告、模板和 AI 日志 JSON 导出入口已移除；模板导入仍兼容旧 JSON 模板包。 |
|
||||
| 模板管理 | 真实集成 | `TemplateManage` 优先调用 `/api/templates?access=manage`，新增/编辑/删除会写后端并清洗 HTML；新增后保存内容以当前页面模板列表为准并同步兼容缓存，避免旧本地缓存覆盖新模板；字段库优先调用 `/api/library/fields`，模板图片资源优先调用 `/api/files`。导出保留 HTML 模板包和 PDF 打印预览，导入兼容 HTML 模板包和旧 JSON 模板包，仍主要在前端处理。 |
|
||||
| 模板权限 | 真实集成 | 后端按部门模板、部门授权和个人模板过滤 `access=use/manage`；迁移期仍同步 `localStorage.templates`，仅在开发/显式回退模式下作为回退。 |
|
||||
| 我的个人模板 | 真实集成 | 医生在报告编辑器中保存个人模板时优先调用 `POST /api/templates`，后端把模板归属当前用户；只有开发/显式回退模式下 API 不可用才回退本地模板。 |
|
||||
| 用户管理 | 真实集成 | `UserManage` 优先调用 `/api/users` 增删改查，后端校验超级管理员/管理员范围、管理员唯一性和医生创建约束；只有开发/显式回退模式下 API 不可用才保留本地回退。 |
|
||||
@@ -67,7 +67,7 @@
|
||||
| `src/pages/ReportManage.test.tsx` | 医生/管理员报告可见范围。 |
|
||||
| `src/utils/permissions.test.ts` | 报告权限、管理员本部门范围、医生个人模板和部门模板范围。 |
|
||||
| `src/utils/templateList.test.ts` | 模板列表合并，覆盖新增模板不被旧缓存覆盖。 |
|
||||
| `src/utils/templateExport.test.ts` | JSON/HTML 模板包生成、HTML 回导、旧 JSON 兼容和文件名清理。 |
|
||||
| `src/utils/templateExport.test.ts` | HTML 模板包生成、HTML 回导、旧 JSON 导入兼容和文件名清理。 |
|
||||
| `src/utils/storage.test.ts` | 本地存储、系统设置混淆兼容、会话恢复键、默认 Provider 不携带内置 Key 的契约。 |
|
||||
| `src/utils/defaultContent.test.ts` | 默认模板结构、智能字段、图片占位符、AI 区域、字段和 Provider 配置。 |
|
||||
| `src/utils/print.test.ts` | 浏览器打印导出入口。 |
|
||||
|
||||
@@ -26,8 +26,7 @@
|
||||
- 删除：优先调用 `DELETE /api/reports/:id` 做后端软删除，再同步本地兼容缓存；只有本地回退开启时，API 不可用才会从本地 `reports` 中移除。
|
||||
- 历史版本：查看 `Report.history`，可恢复某个历史内容到编辑器。
|
||||
- 导出 PDF：调用浏览器打印。
|
||||
- 导出 JSON：下载结构化字段数据。
|
||||
- 批量导出和批量删除：基于表格选中项操作。
|
||||
- 批量导出 PDF 和批量删除：基于表格选中项操作。
|
||||
|
||||
医生只能编辑或删除自己的报告。
|
||||
|
||||
@@ -43,11 +42,6 @@
|
||||
|
||||
后端 `Report` 表保存标题、患者姓名、住院号、HTML 正文、作者、部门、状态和修订版本。`Report.metadata` 暂存患者扩展字段；视频和关键帧文件内容写入 `FileResource`，报告中的媒体引用、排序和抽帧信息写入 `ReportMedia` 关系表。Reports API 返回时仍组装成前端兼容的 `videos` 和 `capturedFrames` 字段。
|
||||
|
||||
## 导出 JSON 内容
|
||||
## JSON 导出
|
||||
|
||||
当前报告 JSON 导出主要包含：
|
||||
|
||||
- `meta`：报告 ID、标题、创建/更新时间、作者和状态。
|
||||
- `fields`：按 `DEFAULT_FORM_FIELDS` 提取的报告字段。
|
||||
|
||||
报告正文 HTML 和视频帧数据不在这个结构化字段导出范围内。
|
||||
前端用户可见的报告 JSON 导出入口已移除。当前报告导出只保留浏览器打印/PDF 路径，结构化数据交换后续如需要应走后端 API 或数据库层能力。
|
||||
|
||||
@@ -34,8 +34,8 @@
|
||||
- 删除或批量删除模板。
|
||||
- 保存当前模板内容。
|
||||
- 打印模板预览。
|
||||
- 单个导出 JSON 模板包、HTML 模板包和 PDF 打印预览，批量导出 JSON。
|
||||
- 从 JSON 模板包或 HTML 模板包导入。
|
||||
- 单个导出 HTML 模板包和 PDF 打印预览。
|
||||
- 从 HTML 模板包或历史 JSON 模板包导入。
|
||||
|
||||
新增、编辑、保存内容和删除模板会优先调用后端 `POST/PATCH/DELETE /api/templates`，后端会对模板 HTML 做白名单清洗；成功后同步 `localStorage.templates` 作为兼容缓存。只有本地回退开启时，API 失败才允许写本地模板。
|
||||
|
||||
@@ -72,7 +72,7 @@
|
||||
|
||||
## 导入导出格式
|
||||
|
||||
单模板 JSON 模板包大致结构：
|
||||
前端用户可见导出只保留 HTML 模板包和 PDF 打印预览。历史 JSON 模板包仍可导入，兼容结构大致如下：
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -85,8 +85,6 @@
|
||||
}
|
||||
```
|
||||
|
||||
HTML 模板包是一个可直接用浏览器打开的完整 HTML 文件，包含 A4 页面样式、打印样式和内嵌的 `surclaw_template_package` 元数据。它比 JSON 更适合保留“报告整体观感”，也可以重新导入系统恢复模板 HTML 和字段定义。
|
||||
HTML 模板包是一个可直接用浏览器打开的完整 HTML 文件，包含 A4 页面样式、打印样式和内嵌的 `surclaw_template_package` 元数据。它比 JSON 更适合保留“报告整体观感”，也是当前推荐的可回导模板交换格式。
|
||||
|
||||
PDF 导出走浏览器打印，适合归档和人工查看，不适合再次导入编辑。
|
||||
|
||||
批量导出使用 `type: "surclaw_template_package_batch"`，包含 `templates` 数组。当前导入逻辑只接受单模板 JSON/HTML 包。
|
||||
|
||||
@@ -8,10 +8,10 @@
|
||||
- 工作台统计已接入 `GET /api/dashboard/stats`。
|
||||
- 报告编辑、模板选择、字段绑定、富文本编辑已实现。
|
||||
- 视频上传、自动抽帧、手动截帧、关键帧插入已实现；视频和关键帧优先上传到后端 Files API。
|
||||
- AI 对话、AI 区域改写、差异确认和调用日志已实现；AI 对话已改为后端 `/api/ai/chat` 代理。
|
||||
- AI 对话、AI 区域改写和差异确认已实现；AI 对话已改为后端 `/api/ai/chat` 代理。
|
||||
- 报告编辑器会监听正文 AI 区域变化，新插入的 AI 可编辑区域会立即同步到 AI 撰写目标下拉栏。
|
||||
- 讯飞语音听写入口已实现，并已改为后端 `/api/speech/iat` WebSocket 代理；前端启动前会检查麦克风采集能力和安全上下文。
|
||||
- 报告管理、查看、历史恢复、打印、JSON/PDF 导出已实现。
|
||||
- 报告管理、查看、历史恢复和打印/PDF 导出已实现；用户可见前端 JSON 导出入口已移除。
|
||||
- 报告 API 已实现列表、详情、创建、保存、完成修订、历史记录和软删除；`ReportManage`、`ReportView`、`ReportEditor` 已优先调用后端，只有开发/显式回退模式下才保留本地回退。
|
||||
- 后端报告校验已区分草稿和完成状态：草稿允许患者姓名/住院号暂空，完成报告仍强制要求。
|
||||
- 模板管理、字段库、模板导入导出已实现；模板 API 已支持可用/可管理列表、详情、创建、更新、删除和个人模板；字段库已优先接入 `/api/library/fields`。
|
||||
@@ -85,5 +85,6 @@
|
||||
| 2026-05-02 | 增加 Nginx 和 NestJS 请求体上限配置，修复大图文报告保存 `request entity too large`。 |
|
||||
| 2026-05-02 | 新增 Docker HTTPS 演示入口和麦克风访问说明，解决非安全上下文下语音听写不可启动的问题。 |
|
||||
| 2026-05-02 | 修复模板管理中新建模板后点击保存内容导致模板从列表消失的问题，并补充单元测试和 E2E。 |
|
||||
| 2026-05-02 | 模板管理新增 HTML 模板包导出/导入，修正右上角 JSON 导出为标准模板包。 |
|
||||
| 2026-05-02 | 模板管理新增 HTML 模板包导出/导入。 |
|
||||
| 2026-05-02 | 修复报告编辑器新增 AI 可编辑区域后 AI 撰写下拉栏不立即更新的问题，并补充 E2E。 |
|
||||
| 2026-05-02 | 移除前端用户可见 JSON 导出入口，保留模板历史 JSON 导入兼容。 |
|
||||
|
||||
@@ -40,13 +40,13 @@
|
||||
- 支持按状态和时间范围筛选。
|
||||
- 医生只能看到本人报告；管理员和超级管理员可看到更多报告。
|
||||
- 支持查看、编辑、删除、历史版本恢复。
|
||||
- 支持单份或批量导出 PDF/JSON。
|
||||
- 支持单份或批量通过浏览器打印导出 PDF。
|
||||
|
||||
### 模板管理
|
||||
|
||||
- 支持模板新增、编辑、删除、批量删除。
|
||||
- 支持模板内容富文本编辑、智能字段插入、图片占位符、AI 可编辑区域。
|
||||
- 支持模板导入导出 JSON 包。
|
||||
- 支持模板导出可回导 HTML 模板包；导入兼容 HTML 模板包和历史 JSON 模板包。
|
||||
- 支持表单字段库维护，包括字段显示、选项、时间格式、默认值和下划线样式。
|
||||
- 新增模板后会同步当前用户或部门用户的模板权限。
|
||||
|
||||
|
||||
@@ -84,7 +84,7 @@ AI 第三方接口、讯飞语音上游 WebSocket、麦克风权限和真实视
|
||||
| 默认字段和 AI Provider | 已覆盖 | `defaultContent.test.ts` |
|
||||
| 打印导出入口 | 已覆盖 | `print.test.ts` |
|
||||
| 模板列表合并工具 | 已覆盖 | `templateList.test.ts`，防止新增模板被旧本地缓存覆盖。 |
|
||||
| 模板导入导出工具 | 已覆盖 | `templateExport.test.ts`，覆盖 JSON/HTML 模板包、HTML 回导、旧 JSON 兼容和文件名清理。 |
|
||||
| 模板导入导出工具 | 已覆盖 | `templateExport.test.ts`，覆盖 HTML 模板包、HTML 回导、旧 JSON 导入兼容和文件名清理。 |
|
||||
| 默认快捷登录 | 已覆盖 | `e2e/login.spec.ts` |
|
||||
| 报告权限 E2E | 已覆盖 | `e2e/report-permissions.spec.ts` |
|
||||
| 报告修订版本 E2E | 已覆盖 | `e2e/report-revision.spec.ts` |
|
||||
|
||||
Reference in New Issue
Block a user