feat(config): 按业务模块拆分 Mock 开关

用 VITE_MOCK_* 系列环境变量替换全局 VITE_USE_MOCK，各模块独立控制演示数据启用，并新增 src/utils/mock-flags.ts 统一解析缺省值。文档库关闭演示库时如实提示接口待接入，避免静默沿用本地数据或覆盖已保存内容。
2026-09-15 09:47:31 +08:00
parent c7da24cef6
commit fc22d22f85
23 changed files with 162 additions and 35 deletions
@@ -80,7 +80,7 @@

 ## 当前核验结论

-文档权限页面仅在显式设置 `VITE_USE_MOCK=true` 时使用演示数据；未设置该变量或设置为其他值时，页面调用真实权限接口。修改环境变量后需要重启 Vite。
+文档权限页面仅在显式设置 `VITE_MOCK_DOCUMENT_PERMISSIONS=true` 时使用演示数据；未设置该变量或设为 `false` 时，页面调用真实权限接口。该开关缺省关闭。修改环境变量后需要重启 Vite。

 本轮新增接口已覆盖当前文档权限页面的后端缺口，暂无阻断前端接入的缺失接口。跨模板矩阵查询最多支持 100 个模板，批量保存最多支持 200 项；页面当前采用“模板选择 + 当前模板矩阵”的交互，没有臆造跨模板对比表。

@@ -12,7 +12,7 @@
 - 明细由 tasks 服务端分页返回；
 - 院区、科室和模板分类由 options 返回；
 - 导出改为服务端异步任务，完成后下载文件；
- VITE_USE_MOCK 非 false 时仍保留原有 Mock 演示数据。
+- 打开 `VITE_MOCK_REPORTS` 时仍保留原有 Mock 演示数据；该开关缺省关闭，报表默认走服务端报表接口。

 ## 2. 接入矩阵

@@ -69,7 +69,7 @@
 真实接口模式：

 ```bash
-VITE_USE_MOCK=false npm run dev
+VITE_MOCK_USERS=false npm run dev
 ```

 至少验证以下场景：
@@ -2,7 +2,7 @@

 > 事实基准：用户于 2026-09-02 导出的 default_OpenAPI.json，OpenAPI 3.1.0，MEDISIGN 患者电子签 API v1。
 >
-> 接入状态：当 VITE_USE_MOCK=false 时，首页已接入 GET /api/v1/workbench/overview。
+> 接入状态：首页缺省（`VITE_MOCK_WORKBENCH_HOME` 未开启）已接入 GET /api/v1/workbench/overview。

 ## 1. 核验结论