feat(报表分析): 新增签署总览等四个报表菜单并拆分演示数据开关
This commit is contained in:
yelan
+25
-3
@@ -84,7 +84,7 @@ TanStack Vue Query、PDF 预览、报表图表、自动化测试和签字板适
|
||||
|
||||
## 当前状态
|
||||
|
||||
已完成 Vite 基础初始化、路由、Pinia、原型主题 CSS、登录页、首页、签署工作台、签署记录查询和文档库管理页面。角色权限与系统设置中的菜单设置已接入 MEDISIGN RBAC 接口；导航、路由和页面操作按授权资源树控制，角色数据范围在角色配置中维护，员工页面只负责绑定角色。组织架构页按机构→院区→科室分组展示员工列表，新增院区默认归属“新华院区”，支持节点筛选、员工维护和组织节点维护。系统参数卡片仍保留 Mock，真实签字板/线上签名回调和打印服务仍需设备或后端能力。
|
||||
已完成 Vite 基础初始化、路由、Pinia、原型主题 CSS、登录页、首页、签署工作台、签署记录查询、文档库管理页面和「报表分析」四个菜单（签署总览 / 签署量分析 / 签署时效分析 / 患者结构分析）。角色权限与系统设置中的菜单设置已接入 MEDISIGN RBAC 接口；导航、路由和页面操作按授权资源树控制，角色数据范围在角色配置中维护，员工页面只负责绑定角色。组织架构页按机构→院区→科室分组展示员工列表，新增院区默认归属“新华院区”，支持节点筛选、员工维护和组织节点维护。系统参数卡片仍保留 Mock，真实签字板/线上签名回调和打印服务仍需设备或后端能力。
|
||||
|
||||
文档库管理的真实模式已打通「模板 → 版本 → 正文」三段：
|
||||
|
||||
@@ -111,10 +111,16 @@ ClinicalLayout（实际导航和页面路由由授权菜单资源树提供）
|
||||
├─ /system/org 组织架构 / 员工角色绑定
|
||||
├─ /system/role 角色权限与数据范围
|
||||
├─ /doc/library 文档库管理
|
||||
├─ /report/index 报表分析
|
||||
├─ /report/index 报表分析（签署报表与导出任务，走 reports/signing/* 接口）
|
||||
├─ /report/sign/overview 报表分析 / 签署总览
|
||||
├─ /report/sign/volume 报表分析 / 签署量分析
|
||||
├─ /report/sign/timeliness 报表分析 / 签署时效分析
|
||||
├─ /report/patient/structure 报表分析 / 患者结构分析
|
||||
└─ /system/setting 系统设置 / 菜单设置
|
||||
```
|
||||
|
||||
注意 `/report/index` 与另外四个报表页是**两套菜单、两套后端面**：前者是「系统管理 → 报表分析」下的签署报表与导出任务（真实接口已接入，见 [reports-api.md](./docs/reports-api.md)）；后者是「报表分析」目录下的四个独立菜单，后端目前没有任何分析聚合接口，因此只有演示数据（`VITE_MOCK_REPORT_ANALYTICS`）。两者的路由与 `componentPath` 都以后端菜单资源树为准，不要照抄原型里的 `MENU_TREE`（原型写的是 `/report/overview` 等，与后端不一致）。
|
||||
|
||||
布局拆分为 `Menu`、`Header` 和 `Container` 三个公共组件，页面内容由各自的 View 负责。
|
||||
|
||||
页面目录按业务域组织：`auth` 保留登录页；工作台页面位于 `views/workbench`；管理页面位于 `views/management`。每个具体页面目录都有 `index.vue` 入口和 `components` 目录，用于继续拆分当前页面组件。
|
||||
@@ -238,10 +244,26 @@ API 模块与页面按业务域对应。工作台页面使用 `api/workbench`
|
||||
|
||||
演示数据缺省开启（`VITE_MOCK_SIGN_RECORDS`），且与签署工作台**分开开关**：两者共用一个开关会导致「关掉工作台的演示数据」把记录页一起带进空态。
|
||||
|
||||
## 报表分析（签署总览 / 签署量分析 / 签署时效分析 / 患者结构分析）
|
||||
|
||||
四个菜单共用一套数据源与筛选条件：
|
||||
|
||||
- `api/workbench/report-analytics.ts`：数据集。**后端没有任何分析聚合接口**，真实模式返回 `{ tasks: [], available: false }` 而不抛错，页面据此显示「后端尚未提供报表分析接口」的说明，不渲染一张全 0 的假报表。
|
||||
- `views/reports/aggregate.ts`：全部聚合逻辑，纯函数（不依赖 DOM 与 Vue），可用 Node 直跑断言。
|
||||
- `views/reports/filter-store.ts`：**四个菜单共用一份筛选条件**（模块级 `reactive`）。原型里它们是同一筛选条下的四个页签，各存一份会导致切页时筛选被重置、四个页面的数字看起来互相矛盾。
|
||||
- `views/reports/components/ReportPageShell.vue`：标题 + 筛选条 + 数据可用性闸门 + 导出弹窗，四个页面共用；页面只填自己的图表内容。
|
||||
- 图表是手写内联 SVG（`ReportBarChart` / `ReportBarList`），不引图表库：只需要柱状图与横向条形榜两种形态，引库要多几百 KB 且读不到主题 CSS 变量。渐变 id 用 `useId()` 取每实例唯一值。
|
||||
|
||||
**演示数据的两条硬约束**：① 用固定种子的 PRNG（mulberry32），不用 `Math.random` —— 否则每次刷新数字都在跳，截图对不上、断言写不了；② 时间锚定「距今天数」，不写死日期 —— 写死之后过几天再打开，近 7 天 / 近 14 天 / 本月全是空的，看起来像筛选坏了。
|
||||
|
||||
**边界**：① 时效指标只统计**已签署**任务（未完成任务不是「签得快」而是「还没签完」，计入会稀释均值），样本为 0 时显示「—」而不是 0；② 患者结构统计的是**人次**而非人数，同一患者多次签署会重复计数，页面上已写明；③ 导出是前端按条件生成 CSV（UTF-8 带 BOM、CRLF），与签署记录查询共用 `utils/csv-export.ts`。**后端提供导出任务后应改为服务端导出**：导出范围与导出人必须进审计日志，浏览器里做不到。真实接入聚合接口时，后端应按页面出四个聚合接口，**不要**照搬现在的形状把全量任务明细拉到浏览器里算。
|
||||
|
||||
演示数据缺省开启（`VITE_MOCK_REPORT_ANALYTICS`，与 `/report/index` 的 `VITE_MOCK_REPORTS` 分开）。
|
||||
|
||||
API 请求和响应类型按业务域放在 `api/workbench/types.ts`、`api/management/types.ts`；页面展示和交互类型放在对应 View 目录的 `types.ts`；全局复用类型放在 `types/common.ts`。页面提交模型会在 API 边界转换为后端 DTO，不向后端发送患者快照、文档名称或明文手机号等页面字段。
|
||||
|
||||
开发环境默认使用 `/api` 作为同源接口前缀，Vite 会将 `/api` 转发到 `https://ipad.shenynet.com`，因此浏览器不会直接跨域请求后端。代理配置位于 `vite.config.ts`，不改写 `/api/v1/...` 路径。修改代理或环境变量后需要重启 Vite 开发服务。
|
||||
|
||||
生产环境不会使用 Vite 的开发代理，需要在 Nginx 或其他网关中配置同样的 `/api` 反向代理。Mock 开关按业务模块（对齐菜单）拆分，缺省只有文档库之外的签署侧（签署工作台 `VITE_MOCK_SIGNING`、签署记录查询 `VITE_MOCK_SIGN_RECORDS`）使用演示数据，其余模块直接调用真实后端；各开关的环境变量名与缺省值见 `src/utils/mock-flags.ts`，需要临时切换时在本地 `.env.*.local` 里覆盖即可。使用本地开发代理时，`VITE_API_BASE_URL` 应填写 `/api`；如果改为直连后端，则需要后端配置允许当前前端源的 CORS。
|
||||
生产环境不会使用 Vite 的开发代理，需要在 Nginx 或其他网关中配置同样的 `/api` 反向代理。Mock 开关按业务模块（对齐菜单）拆分，缺省使用演示数据的只有签署侧（签署工作台 `VITE_MOCK_SIGNING`、签署记录查询 `VITE_MOCK_SIGN_RECORDS`）与「报表分析」目录下的四个菜单（`VITE_MOCK_REPORT_ANALYTICS`，后端没有分析聚合接口），其余模块直接调用真实后端；各开关的环境变量名与缺省值见 `src/utils/mock-flags.ts`，需要临时切换时在本地 `.env.*.local` 里覆盖即可。使用本地开发代理时，`VITE_API_BASE_URL` 应填写 `/api`；如果改为直连后端，则需要后端配置允许当前前端源的 CORS。
|
||||
|
||||
当前尚未接入的签署能力包括手写板设备桥接、线上签署页面/签名回调和打印服务。签署投递、一次性 Token 消费和真实 PNG 上传 API 已完成封装，但页面不能用 Canvas 演示数据冒充真实签名；需要接入设备适配器或患者 H5 回调后再启用。短信初次发送接口需要完整手机号，而患者查询只返回脱敏手机号，因此真实模式会要求当前操作人员确认完整投递地址；生产环境也可以改为由后端根据患者 ID 解析投递地址。签署工作台缺省即使用演示数据（`VITE_MOCK_SIGNING`），需要走真实投递时把它设为 `false`。
|
||||
|
||||
Reference in New Issue
Block a user