立项配置数据入库、审计日志数据入库、编辑页UI界面美化、设备管理内容补充、审计日志显示优化

2026-02-27 16:16:26 +08:00
parent fd7e3fc948
commit db2d38edbc
48 changed files with 2936 additions and 909 deletions
@@ -10,6 +10,7 @@
  - `草稿视图`: 当前草稿可编辑
  - `发布预览`: 当前草稿只读预览（不直接读取 `published_data`）
  - `published_data`: 用于发布快照、差异比较与版本能力
+  - `published_project_snapshot`: 发布时的项目基础信息快照（用于“项目信息差异”判定）

 ## 2. 权限矩阵
 - `GET /setup-config`
@@ -80,6 +81,33 @@
    "centerConfirm": []
  },
  "published_data": null,
+  "published_project_snapshot": {
+    "code": "DEMO-CTMS",
+    "name": "演示项目",
+    "project_full_name": "演示项目全称",
+    "sponsor": "",
+    "protocol_no": "",
+    "lead_unit": "",
+    "principal_investigator": "",
+    "main_pm": "",
+    "research_analysis": "",
+    "research_product": "",
+    "control_product": "",
+    "indication": "",
+    "research_population": "",
+    "research_design": "",
+    "plan_start_date": "2026-02-01",
+    "plan_end_date": "2026-12-31",
+    "planned_site_count": 12,
+    "planned_enrollment_count": 120,
+    "summary_note": "",
+    "objective_note": "",
+    "status": "DRAFT",
+    "visit_interval_days": null,
+    "visit_total": null,
+    "visit_window_start_offset": null,
+    "visit_window_end_offset": null
+  },
  "saved_by": "11111111-1111-1111-1111-111111111111",
  "saved_by_name": "System Admin",
  "published_by": null,
@@ -0,0 +1,56 @@
+# 存储落库核查报告
+
+- 扫描目录: `/Users/zcc/MyCTMS/ctms-project/frontend/src`
+- 总发现数: `46`
+- 高风险: `4` / 中风险: `0` / 低风险: `42`
+
+## 明细
+
+| 风险 | 分类 | 文件 | 行号 | 调用 | key表达式 | 说明 |
+| --- | --- | --- | --- | --- | --- | --- |
+| high | business-draft | `frontend/src/views/admin/ProjectDetail.vue` | 2849 | `localStorage.getItem` | `storageKey.value` | 立项配置草稿本地兜底，需显式提示未落库 |
+| high | business-draft | `frontend/src/views/admin/ProjectDetail.vue` | 2908 | `localStorage.getItem` | `projectDraftStorageKey.value` | 立项配置草稿本地兜底，需显式提示未落库 |
+| high | business-draft | `frontend/src/views/admin/ProjectDetail.vue` | 2976 | `localStorage.removeItem` | `projectDraftStorageKey.value` | 立项配置草稿本地兜底，需显式提示未落库 |
+| high | business-draft | `frontend/src/views/admin/ProjectDetail.vue` | 2984 | `localStorage.removeItem` | `storageKey.value` | 立项配置草稿本地兜底，需显式提示未落库 |
+| low | ui-preference | `frontend/src/components/Layout.vue` | 227 | `localStorage.getItem` | `"ctms_sidebar_collapsed"` | UI偏好/上下文缓存 |
+| low | ui-preference | `frontend/src/components/Layout.vue` | 390 | `localStorage.setItem` | `"ctms_sidebar_collapsed"` | UI偏好/上下文缓存 |
+| low | auth-session | `frontend/src/components/LockScreenModal.vue` | 92 | `localStorage.getItem` | `"ctms_last_login_email"` | 认证/会话数据（非业务主数据） |
+| low | auth-session | `frontend/src/components/ThreadList.vue` | 72 | `localStorage.getItem` | `"ctms_token"` | 认证/会话数据（非业务主数据） |
+| low | auth-session | `frontend/src/components/attachments/AttachmentList.vue` | 132 | `localStorage.getItem` | `"ctms_token"` | 认证/会话数据（非业务主数据） |
+| low | auth-session | `frontend/src/components/attachments/AttachmentList.vue` | 137 | `localStorage.getItem` | `"ctms_token"` | 认证/会话数据（非业务主数据） |
+| low | auth-session | `frontend/src/components/attachments/AttachmentList.vue` | 168 | `localStorage.getItem` | `"ctms_token"` | 认证/会话数据（非业务主数据） |
+| low | auth-session | `frontend/src/components/fees/FeeAttachmentPanel.vue` | 169 | `localStorage.getItem` | `"ctms_token"` | 认证/会话数据（非业务主数据） |
+| low | auth-session | `frontend/src/components/fees/FeeAttachmentPanel.vue` | 174 | `localStorage.getItem` | `"ctms_token"` | 认证/会话数据（非业务主数据） |
+| low | auth-session | `frontend/src/components/fees/FeeAttachmentPanel.vue` | 223 | `localStorage.getItem` | `"ctms_token"` | 认证/会话数据（非业务主数据） |
+| low | auth-session | `frontend/src/session/sessionManager.ts` | 33 | `localStorage.setItem` | `"ctms_auth_broadcast"` | 认证/会话数据（非业务主数据） |
+| low | auth-session | `frontend/src/session/sessionManager.ts` | 181 | `sessionStorage.removeItem` | `LOGOUT_REASON_STORAGE_KEY` | 认证/会话数据（非业务主数据） |
+| low | auth-session | `frontend/src/session/sessionManager.ts` | 184 | `sessionStorage.setItem` | `LOGOUT_REASON_STORAGE_KEY` | 认证/会话数据（非业务主数据） |
+| low | auth-session | `frontend/src/session/sessionManager.ts` | 192 | `sessionStorage.getItem` | `LOGOUT_REASON_STORAGE_KEY` | 认证/会话数据（非业务主数据） |
+| low | auth-session | `frontend/src/session/sessionManager.ts` | 193 | `sessionStorage.removeItem` | `LOGOUT_REASON_STORAGE_KEY` | 认证/会话数据（非业务主数据） |
+| low | auth-session | `frontend/src/store/auth.ts` | 24 | `localStorage.setItem` | `LAST_LOGIN_EMAIL_KEY` | 认证/会话数据（非业务主数据） |
+| low | auth-session | `frontend/src/store/auth.ts` | 39 | `localStorage.setItem` | `LAST_LOGIN_EMAIL_KEY` | 认证/会话数据（非业务主数据） |
+| low | auth-session | `frontend/src/store/auth.ts` | 46 | `localStorage.getItem` | `LAST_LOGIN_EMAIL_KEY` | 认证/会话数据（非业务主数据） |
+| low | ui-preference | `frontend/src/store/study.ts` | 20 | `localStorage.getItem` | `LAST_STUDY_BY_USER_KEY` | UI偏好/上下文缓存 |
+| low | ui-preference | `frontend/src/store/study.ts` | 30 | `localStorage.setItem` | `LAST_STUDY_BY_USER_KEY` | UI偏好/上下文缓存 |
+| low | ui-preference | `frontend/src/store/study.ts` | 44 | `localStorage.removeItem` | `SITE_KEY` | UI偏好/上下文缓存 |
+| low | ui-preference | `frontend/src/store/study.ts` | 48 | `localStorage.setItem` | `STUDY_KEY` | UI偏好/上下文缓存 |
+| low | ui-preference | `frontend/src/store/study.ts` | 50 | `localStorage.setItem` | `STUDY_ROLE_KEY` | UI偏好/上下文缓存 |
+| low | auth-session | `frontend/src/store/study.ts` | 52 | `localStorage.getItem` | `"ctms_last_login_email"` | 认证/会话数据（非业务主数据） |
+| low | ui-preference | `frontend/src/store/study.ts` | 59 | `localStorage.getItem` | `STUDY_KEY` | UI偏好/上下文缓存 |
+| low | ui-preference | `frontend/src/store/study.ts` | 67 | `localStorage.getItem` | `STUDY_ROLE_KEY` | UI偏好/上下文缓存 |
+| low | ui-preference | `frontend/src/store/study.ts` | 70 | `localStorage.getItem` | `SITE_KEY` | UI偏好/上下文缓存 |
+| low | ui-preference | `frontend/src/store/study.ts` | 116 | `localStorage.removeItem` | `STUDY_KEY` | UI偏好/上下文缓存 |
+| low | ui-preference | `frontend/src/store/study.ts` | 117 | `localStorage.removeItem` | `STUDY_ROLE_KEY` | UI偏好/上下文缓存 |
+| low | ui-preference | `frontend/src/store/study.ts` | 118 | `localStorage.removeItem` | `SITE_KEY` | UI偏好/上下文缓存 |
+| low | ui-preference | `frontend/src/store/study.ts` | 165 | `localStorage.setItem` | `STUDY_ROLE_KEY` | UI偏好/上下文缓存 |
+| low | ui-preference | `frontend/src/store/study.ts` | 167 | `localStorage.removeItem` | `STUDY_ROLE_KEY` | UI偏好/上下文缓存 |
+| low | ui-preference | `frontend/src/store/study.ts` | 174 | `localStorage.setItem` | `SITE_KEY` | UI偏好/上下文缓存 |
+| low | ui-preference | `frontend/src/store/study.ts` | 176 | `localStorage.removeItem` | `SITE_KEY` | UI偏好/上下文缓存 |
+| low | auth-session | `frontend/src/utils/auth.ts` | 4 | `localStorage.getItem` | `TOKEN_KEY` | 认证/会话数据（非业务主数据） |
+| low | auth-session | `frontend/src/utils/auth.ts` | 7 | `localStorage.setItem` | `TOKEN_KEY` | 认证/会话数据（非业务主数据） |
+| low | auth-session | `frontend/src/utils/auth.ts` | 11 | `localStorage.removeItem` | `TOKEN_KEY` | 认证/会话数据（非业务主数据） |
+| low | auth-session | `frontend/src/utils/auth.ts` | 17 | `localStorage.setItem` | `CREDENTIAL_KEY` | 认证/会话数据（非业务主数据） |
+| low | auth-session | `frontend/src/utils/auth.ts` | 24 | `localStorage.getItem` | `CREDENTIAL_KEY` | 认证/会话数据（非业务主数据） |
+| low | auth-session | `frontend/src/utils/auth.ts` | 38 | `localStorage.removeItem` | `CREDENTIAL_KEY` | 认证/会话数据（非业务主数据） |
+| low | feature-cache | `frontend/src/views/workbench/components/PersonalTodo.vue` | 79 | `localStorage.getItem` | `props.storageKey` | 工作台本地待办缓存（非核心主数据） |
+| low | feature-cache | `frontend/src/views/workbench/components/PersonalTodo.vue` | 91 | `localStorage.setItem` | `props.storageKey` | 工作台本地待办缓存（非核心主数据） |
@@ -0,0 +1,52 @@
+# 全项目重要数据落库治理基线（2026-02-27）
+
+## 1. 口径
+
+- 纳入范围：业务主数据 + 审计数据
+- 排除范围：纯 UI 偏好、登录态会话、跨标签广播等非业务主数据
+
+## 2. 自动核查入口
+
+```bash
+backend/scripts/storage_persistence_audit.py --format markdown --output docs/storage-persistence-audit.md
+backend/scripts/storage_persistence_audit.py --fail-on-banned
+```
+
+- `docs/storage-persistence-audit.md`：当前扫描快照
+- `--fail-on-banned`：用于阻断禁止项（当前默认禁止 `audit_local_*`）
+
+## 3. 当前结论（基于 2026-02-27 扫描）
+
+- 高风险：4 条（均为 `ProjectDetail` 本地草稿兜底读写）
+- 中风险：0 条
+- 低风险：42 条（会话、偏好、工作台本地待办等）
+
+## 4. 已完成整改
+
+### 4.1 审计链路
+
+- 关键管理动作改为后端落库（站点、项目成员）
+- 审计页改为服务端唯一数据源
+- 前端本地审计日志通道已下线（不再写 `audit_local_*`）
+- 审计导出事件改为后端写入审计表
+
+### 4.2 业务链路
+
+- 设备管理已接入后端并落库
+- 项目里程碑编辑保存已改为调用后端接口并落库
+- 立项配置草稿保留本地兜底，但已增加：
+  - `SYNCED / LOCAL_ONLY / DIRTY_UNSAVED` 状态识别
+  - 本地草稿恢复确认（含过期/冲突提示）
+  - 发布前 `LOCAL_ONLY` 阻断
+  - 保存失败重试与成功后自动清理本地草稿
+- 发布比对签名已改为后端返回的 `published_project_snapshot`，不再依赖 localStorage
+
+### 4.3 门禁与流程
+
+- 已新增 CI 工作流：`.github/workflows/storage-persistence-guard.yml`
+- PR / push 到主干时会执行 `storage_persistence_audit.py --fail-on-banned`
+
+## 5. 剩余优化项（可选）
+
+1. 将“高风险清单”阈值从固定 key 规则升级为白名单机制（白名单外一律告警）。
+2. 评估是否把 `ProjectDetail` 本地草稿从 localStorage 迁移为后端草稿（可选能力，非当前口径强制项）。