feat(演示): 持久化 Mock 数据并打通文档库发起签署闭环

clinical-web/src/utils/mock-storage.ts

@@ -0,0 +1,46 @@
+/**
+ * 演示数据的本地持久化（仅 Mock 模式使用）。
+ *
+ * 文档库与签署任务的演示数据原本只存在模块内存里，刷新页面就回到初始状态，
+ * 自测「文档库建文书 → 发起签署 → 签署 → 查看留痕」每次都要重来一遍。
+ * 这里把这份数据镜像到 localStorage，刷新后可以接着测。
+ *
+ * 只存演示数据，不涉及登录态、权限或真实患者信息；写入失败（容量超限、
+ * 浏览器禁用存储）时静默降级为纯内存数据，不打断正在进行的操作。
+ */
+
+const STORAGE_PREFIX = 'medical-sign:mock:'
+
+/** 演示数据键名：清空演示数据时按这里的清单统一清理 */
+export const MOCK_STORAGE_KEYS = {
+  documentLibrary: `${STORAGE_PREFIX}document-library`,
+  signingTasks: `${STORAGE_PREFIX}signing-tasks`,
+} as const
+
+export function readMockState<T>(key: string): T | null {
+  try {
+    const raw = window.localStorage.getItem(key)
+
+    return raw ? (JSON.parse(raw) as T) : null
+  } catch {
+    // 存储被禁用，或存量数据与当前结构不兼容：按「没有本地数据」处理，页面照常初始化
+    return null
+  }
+}
+
+export function writeMockState(key: string, value: unknown): void {
+  try {
+    window.localStorage.setItem(key, JSON.stringify(value))
+  } catch {
+    // 容量超限或存储被禁用：退化为纯内存演示数据，不打扰使用者
+  }
+}
+
+/** 清空全部演示数据，调用方负责重新加载数据或刷新页面 */
+export function clearMockState(): void {
+  try {
+    Object.values(MOCK_STORAGE_KEYS).forEach((key) => window.localStorage.removeItem(key))
+  } catch {
+    // 存储不可用时本来就无需清理
+  }
+}