KCGL/app at 956d4acb5f6e76806195a701ddf616921aa0d584 - KCGL

Files

yueli 956d4acb5f feat(audit): 快照嵌套分层渲染 + 凭据字段从接口剥离（安全修复）

起因：借库管理等单据的详情页仍显示原始 JSON 代码块。
根因：details 有**第三种**存法 {'payload': {...}}，且内部嵌着对象数组
（items 明细行），而旧实现只认平铺的 created/deleted_snapshot，
遇到非平铺结构就退化成原始 JSON。

1. 快照键收敛（后端）
   created / deleted_snapshot / payload 三种键与展示标题收进
   audit_labels.SNAPSHOT_VIEWS，经 /audit/labels 下发 snapshotViews，
   前端不再硬编键名 —— 将来加第四种只改一处。
   audit_export_service 与 daily_report_service 改为引用同一份。
   changes_summary 也改用 snapshot_of_any：payload 型记录的新增摘要
   此前整列为空，现在有内容了（如「新增（借库管理）：物料明细 1 项、
   备注、借用人、签名、预计归还时间」）。

2. 分层渲染（前端）
   · 标量字段 → el-descriptions（保留字典翻译与空值/技术字段过滤）
   · 数组字段 → el-table：列取**所有元素键的并集**（同一数组内元素键
     并不完全一致，只取首个元素会漏字段），跳过技术字段，列头走 fieldLabel
   · 标量数组（arrival_photo 等图片 URL 列表）→ 单列表格
   · details / payload 本身是数组或标量的情况也一并处理
   · 只有确实无可识别结构时才回落到原始 JSON

   实测全库 58728 条：**0 条**会退化到原始 JSON 兜底
   （payload 1495 条全部拆出结构）。

3. ★ 安全修复：审计快照里存有**明文密码**，本次从所有出口剥离
   实测 `用户管理/新增` 的 payload 快照记着哈希前的原始密码（27 条，
   形如 '123456'、'shili0823'），因为写入路径把请求体整包记进了审计。

   · sanitize_details()：递归剥掉凭据类字段，应用于列表与详情接口
   · changes_of / snapshot_of 在**源头**滤掉凭据：逐个出口去补必然漏掉
     某一个，而漏掉的那个就是泄漏点（日报附件、导出、摘要都走这两个函数）
   · 凭据判定用**关键词**（password/passwd/secret/token/private_key）
     而非逐个登记 —— 今天漏的是 payload 里的 password，明天可能是
     reset_token。新表加凭据字段也自动被挡住。

   ★ 第一版我只做了前端隐藏（hiddenFields），被测试抓出来：原始响应里
     密码照样在，打开 devtools 就读得到。**要挡的数据必须在接口出口剥掉，
     前端隐藏不是防线。**

验证：14 + 15 项断言全过，含「列表/详情响应无密码原文与 password 键」
「全量导出的表头与单元格均无凭据」「日报三天附件无凭据」
「sanitize_details 递归进嵌套数组且不原地改原对象」。
6 列结构与附件大小未变（490.5K / 193.4K / 10.3K）；vue-tsc 与 vite build exit=0。

⚠️ 数据库中仍存有明文密码（16 条非空），本次只挡展示与导出，**未改数据** ——
   改数据不可逆，需单独立项决定。

2026-09-28 10:40:00 +08:00