4.7 KiB
M6审批审计与保留开发记录
日期:2026-11-17。范围:C207及C201至C204的本地回归。手机现场验收继续暂缓,线上服务仍为之前部署的03d34f1,本次没有部署、推送、出包或修改本机已安装Work组件。
本轮实现
增加work_approval_audit_v1,记录创建、允许、拒绝、许可消费、过期、取消、卡片绑定、发送结果不明及内容清理。审计写入与对应状态修改使用同一数据库事务;写审计失败即撤回该事务,不下发许可。重复回调/重复消费不会生成第二次决定或消费事件。
审计字段仅含环境/应用、审批引用、任务/本人/设备的作用域摘要、绑定代次、动作摘要、固定动作类别、事件、状态及记录时间。不保存动作请求正文、卡片文案、账号姓名、原始用户/设备ID、访问/刷新令牌或按钮nonce。摘要是关联标识,不宣称不可重识别。审计中的consumed仅代表执行许可已消费,不代表业务已成功;业务结果仍由原任务和操作记录核对。
没有新增公开的审计查询、任意SQL或管理员执行接口;无效回调在原校验边界拒绝,本轮未增加未经验证操作者的身份审计。
保留与清理候选
| 配置 | 候选默认 | 行为 |
|---|---|---|
| HN_APPROVAL_RETENTION_ENABLED | false | 未评审前不启用后台清理 |
| HN_APPROVAL_PAYLOAD_RETENTION_DAYS | 30 | 已关闭审批的加密动作/文案/nonce及对应密钥引用到期后清空 |
| HN_APPROVAL_AUDIT_RETENTION_DAYS | 90 | 已清理审批的过期审计事件有限删除 |
30/90天只是研发候选值,应按团队正式留存要求评审,不作为公司合规期限。要求1 <= 内容保留天数 <= 审计保留天数 <= 365;启用清理还要求审批功能已开启。现有部署配置未被修改,部署脚本也未新增自动开启清理的参数。
只选择当前应用/环境内rejected、expired、cancelled、consumed审批;pending/approved不清。consumed但原任务仍inflight、unknown或已查不到任务时不清,保留恢复核对材料。使用游标分批扫描,避免待核对任务挡住其他可清项;每批最多20项,有本轮耗时预算,真正变更前再持有本人锁重读状态。
不删除审批/操作防重放记录,不改状态回pending,不删除callback发送意图/回执,不碰用户原稿、附件或任务目录。清理完成后同操作仍返回原关闭状态,不能重新取得执行许可。清理是数据库字段更新,不承诺底层磁盘备份或历史数据库页物理抹除。
测试与证据
组合针对性回归192项通过、2项跳过;包括审批闭环、设备认证、卡片、交付、部署和身份发现。跳过的2项均需独立PostgreSQL测试地址:原授权/绑定测试,以及本轮新增的审批并发测试。本轮未连接生产数据库或真实平台业务写接口。
新增审计/清理用例覆盖:字段最小化、重复决定去重、清理后重放拒绝、活跃审批不清、环境隔离、审计失败消费回滚、配置限制以及业务结果未知的consumed保留。最终游标修订后另跑该专项,结果见build-support/m6-retention-final-20261117.xml;组合记录为build-support/m6-audit-retention-20261117.xml,两批不能重复累计为功能完成数。
tests/test_approval_postgres.py已准备独立随机schema的真实数据库竞争测试:同审批并发允许/拒绝、四连接竞争消费、重开连接后再次消费及审计决定唯一。仅显式设置HN_TEST_DATABASE_URL才运行,凭据不放命令行/交付说明;只建和清理本次随机测试schema,不使用现网配置。没有测试地址,不能将跳过写作通过。
M6仍待完成
- 独立安全复核:回调来源、操作者/卡片/nonce、任务与代次,以及“模型改ID”对重复请求的影响。
- 独立PostgreSQL执行新旧竞争用例,测试锁等待/连接重建和事务失败,不只验证SQLite。
- 真实手机允许/拒绝、超时/重复点击、客户端停止/失联后的旧卡片,按用户恢复验收的时间安排。
- 应用SDK三秒回调时限及正式部署回滚;桌面主dashboard候选版本另行核对。
- 审计留存参数评审、受控运维查询与释放策略。审计/清理代码完成不代表C207已验收或整个M6已完成。
后续更新:用户明确要求安全复核与PostgreSQL验证后,已在独立本机PostgreSQL 17.7补跑原跳过用例,并新增对抗修复;最终205通过0跳过,临时实例已停止。测试与剩余边界以M6_SECURITY_REVIEW_POSTGRES_20261117.md为准。这里记录的192通过2跳过是前一批历史结果,不再作为最新结果。