feat(文档库): 打通模板正文真实模式并新增渲染验证
模板列表接口不返回正文，展示、编辑与发起签署前需再取版本详情获取 contentHtml， 为此新增 getTemplateContent、createTemplateWithContent、updateTemplateContent 与 deleteTemplate（归档），并在签署端按 contentSha256 缓存正文快照。 同时新增 scripts/login.cjs 与 scripts/verify-pages.cjs，通过真实登录与 CDP 渲染截图、断言关键内容并收集运行时错误，并补充 .gitignore、eslint 忽略与文档说明。
This commit is contained in:
yelan
+13
-3
@@ -84,9 +84,17 @@ TanStack Vue Query、PDF 预览、报表图表、自动化测试和签字板适
|
||||
|
||||
## 当前状态
|
||||
|
||||
已完成 Vite 基础初始化、路由、Pinia、原型主题 CSS、登录页、首页、签署工作台第一版 Mock 和文档库管理页面。登录、首页统计、签署工作台的患者/就诊/模板/任务/审计、签署文件下载、短信重发、模板创建/版本工作流、用户组织查询与用户创建编辑，以及按模板维护文档权限已经接入 MEDISIGN 后端；系统设置仍保留 Mock，真实签字板/线上签名回调和打印服务仍需设备或后端能力。
|
||||
已完成 Vite 基础初始化、路由、Pinia、原型主题 CSS、登录页、首页、签署工作台和文档库管理页面。登录、首页统计、签署工作台的患者/就诊/模板/任务/审计、签署文件下载、短信重发、模板创建/版本工作流、用户组织查询与用户创建编辑，以及按模板维护文档权限已经接入 MEDISIGN 后端；文档库管理已接入模板与版本接口，系统设置仍保留 Mock，真实签字板/线上签名回调和打印服务仍需设备或后端能力。
|
||||
|
||||
自测与演示：开启 `VITE_MOCK_DOCUMENTS` / `VITE_MOCK_SIGNING`（两者缺省即为开启）时，文档库和签署任务的演示数据会镜像到 localStorage（见 `utils/mock-storage.ts`），刷新页面后仍可继续，不必每次重建文书、重发签署；文档库页头的「重置演示数据」可清空这些本地数据回到初始状态。持久化只针对演示数据，不涉及登录态与真实患者信息。
|
||||
文档库管理的真实模式已打通「模板 → 版本 → 正文」三段：
|
||||
|
||||
- 列表读 `GET /api/v1/templates`（自动翻完所有页），再把扁平的模板列表组织成页面需要的「科室 → 分类 → 文书」树；
|
||||
- 正文不在列表接口里（`TemplateResponseDto` 只给 `templateContentSha256`，不给正文），预览、编辑、发起签署前都要再取一次版本详情 `GET /api/v1/templates/{id}/versions/{versionId}` 拿 `contentHtml`。取不到正文时页面如实报错，不展示空壳模板；
|
||||
- 新建走「建模板 + 建首版」两步，编辑走「建新版本 + 更新模板」；模板没有 DELETE 接口，页面上的「删除」实际是归档动作（`POST .../versions/{versionId}/archive`），保留历史留痕链。
|
||||
|
||||
签署工作台的真实模式同样依赖正文：`GET /api/v1/templates/available-versions` 只返回 `contentSha256`，签署端用这个哈希当缓存键去换回正文快照（同一哈希命中同一份正文，版本更新后哈希变化即自动失效），避免版本更新后仍按旧正文签署。取不到正文时任务详情如实提示并给出占位版式，不退化成「看起来像真文书」的假纸样。
|
||||
|
||||
自测与演示：开启 `VITE_MOCK_DOCUMENTS` / `VITE_MOCK_SIGNING`（两者缺省即为开启）时，文档库和签署任务的演示数据会镜像到 localStorage（见 `utils/mock-storage.ts`），刷新页面后仍可继续，不必每次重建文书、重发签署；文档库页头的「重置演示数据」可清空这些本地数据回到初始状态（该按钮只在演示模式下出现）。持久化只针对演示数据，不涉及登录态与真实患者信息。本地建议在 `.env.development.local` 里显式写出这两个开关，不要依赖缺省值。
|
||||
|
||||
## 当前路由结构
|
||||
|
||||
@@ -170,7 +178,9 @@ API 模块与页面按业务域对应。工作台页面使用 `api/workbench`
|
||||
- `GET /api/v1/sign-artifacts/{artifactId}/download`：原始 PDF、签署后 PDF、签名原图下载；
|
||||
- `POST /api/v1/sign-deliveries/{taskId}/sms/resend`：短信重发，自动携带幂等键；
|
||||
- `GET/POST /api/v1/templates`、`GET /api/v1/templates/{id}`：模板列表、详情；
|
||||
- `GET/POST /api/v1/templates/{id}/versions`、版本工作流接口：版本查询、创建、送审、驳回、通过、发布、停用、归档；
|
||||
- `PUT /api/v1/templates/{id}`：更新模板元数据；
|
||||
- `GET/POST /api/v1/templates/{id}/versions`、`GET /api/v1/templates/{id}/versions/{versionId}`：版本列表、创建与版本详情（**正文 `contentHtml` 只在这个详情接口里返回**）；
|
||||
- `POST /api/v1/templates/{id}/versions/{versionId}/{action}`（submit-review / reject / approve / publish / disable / archive）：版本工作流，模板「删除」即走 archive；
|
||||
- `GET /api/v1/users`、`GET /api/v1/roles`、`GET /api/v1/campuses`、`GET /api/v1/departments`：用户页真实查询及组织字典；
|
||||
- `GET /api/v1/users/{id}/roles`、`PUT /api/v1/users/{id}/roles`、`PUT /api/v1/users/{id}/management`：用户角色读取和用户资料/角色聚合保存；
|
||||
- `POST /api/v1/users/{id}/password/reset`、`POST /api/v1/users/import/preview`、`POST /api/v1/users/import/commit`、`GET /api/v1/users/import/jobs/{jobId}`：管理员重置密码和用户导入流程；
|
||||
|
||||
Reference in New Issue
Block a user