6.5 KiB
供应商最终验收授权与共享验收池
状态:本地候选实现。此文不构成公司集群部署、PR 或客户数据写入授权。
权限契约
- 供应商独立开关默认关闭,缺少授权记录等同关闭。平台管理员可以修改;供应商管理员只能读本供应商状态。
- 开关开启后,该供应商可创建/转入最终验收员,该角色可从同组织全部生产项目的验收池领取任务。项目生产授权、标注和质检隔离、生产供应商归属不变。
- 关闭后停止创建/转入验收员和新共享领取;成功领取持久化本轮处理资格,绑定账号、供应商、阶段、轮次、领取时间和授权版本。原轮次可完成、保存草稿、读取绑定视频、通过/退回并核对超时提交;下一轮不继承。
- 旧验收账号按旧项目权限继续工作,没有自动扩权。旧账号改走其他角色后,再转回必须有授权。后台缺失记录或读取失败不提供共享访问。
- 任务、历史决定、标注 JSON、审核意见和统计归属不迁移;退回仍进入原生产链路的质检。
存储与并发
supplierAcceptanceAuthorizations保存组织/供应商唯一授权、版本及操作人/时间历史。PUT 校验版本,防止管理员互相覆盖。创建账号、变更角色、更新授权及共享领取在 Mongo 的现有组织供应商互斥下检查;领取保留原账号互斥与任务版本 CAS,单机和副本集使用相同契约。
acceptanceCompatibilitySnapshots 按组织保存首次升级时的验收账号 ID。RunMigrations 在其他账号迁移前初始化;后续账号创建也先确保清单已建立。清单只建立一次,重放仅标记原名单中仍为旧验收身份的账号;新账号和角色变更已标记 managed,不会被重新认作旧账号。旧缺省字段兼容保留,不能删掉此路径。
HumanItem.acceptanceClaim 保存本轮资格;正式提交和草稿操作回执也保留该依据,因此撤权后成功决定清除任务领取人,不会阻断原回执核对。该回执资格只允许访问本人原操作,不提供下一轮任务权限。
组织连续验收接口为 POST /api/review-continuation,明确 scope=all 或 scope=project,projectId=...;原项目接口兼容。运行中明确切换项目时停止旧队列并接续新范围;已手动暂停、刷新或异常暂停的页面不自动恢复。候选每页最多 100 条且排除证据正文,先本人最早领取,再最早创建。历史时间含时区、缺少领取时间也可排序;批次及权限在请求内复用。真正领取时重新从持久化存储核验。
项目/工作流筛选可以列出共享范围,但通用 Run/产物权限不扩张。验收视频与文件读取必须通过该任务绑定的证据入口。内部测试任务与其他组织不进入共享池。
升级前清单、备份与回退
先遵循 docs/release/README.md,有发布记录则先检查该记录状态。此次新增兼容标记属于数据库写入,需要上线前单独确认该精确范围,不能把普通镜像部署授权解释为所有数据迁移授权。
- 取得实际部署 commit/镜像摘要,核对组织、Mongo 数据库、当前镜像;在账号创建/角色切换的维护窗口内生成备份,避免旧代码在清单建立后继续新建未标记的验收员。滚动升级期间不得混用旧账号写入入口;新版本就绪后再恢复该入口,授权开关保持关闭。
- 从未跟踪环境文件加载
MONGO_URI、MONGO_DB,执行只读命令:go run ./cmd/acceptance-access-audit --org <组织ID> --deployment-version <已核实旧版本> --output local-data/releases/<发布ID>/acceptance-access-before.json。 只保存验收身份、授权与操作历史、兼容清单、在途共享领取及旧版本,不包含密码、Cookie、标注正文或视频地址。文件只新建不覆盖,权限 0600,输出 SHA-256。首次升级清单可能尚不存在,备份中的验收身份列表就是升级前对照。 - 经明确授权后部署;启动迁移建立兼容清单,不开任何供应商开关。再备份一次,核对前后验收身份与授权状态,包括现有 05 账号;不能重新生成任务或自动改派。
- 经单独许可的隔离测试账号验证后,业务管理员才按需要开启指定供应商。线上生产验证保持只读。
- 回退前再运行只读备份并检查
unfinishedSharedClaims。有跨项目已领任务时,先完成当前轮次或取得用户批准的处置方案;旧版本可能无权继续处理这些任务,禁止直接回退留下不可操作任务。不能恢复整库、覆盖客户新增内容,也不能清空兼容清单来“重建”历史权限。
本地验证方式
- API/存储回归:
go test ./internal/api ./internal/store -run 'TestSharedAcceptance|TestSupplierAcceptance|TestAcceptanceRevocation|TestReviewContinuation|TestReviewSession|TestReviewDecision' -count=1。 - 真实 Mongo:
ACCEPTANCE_LOCAL_MONGO_URI=mongodb://127.0.0.1:27018 go test ./internal/store -run TestSharedAcceptanceMongo -count=1;27028 副本集同样验证。仅临时acceptance_auth_test_*库,结束清理该库。 - 真实浏览器:先起 Vite 5173(代理本地 3001),再
ACCEPTANCE_BROWSER_TEST=1 go test ./internal/api -run '^TestSupplierAcceptanceBrowser$' -count=1 -v。使用 27018 的随机acceptance_browser_test_*库、合成视频、进程内随机密码和两家供应商/两个项目;真实登录与接口,不伪造业务响应。结束关闭 API、删除该隔离库。截图和结果在未跟踪的local-data/verification/supplier-acceptance/。
验证证据及基线比较见 本地验证记录;上线实测仍需另行授权。
本人验收记录与当前切片
最终验收任务池提供与质检一致的“我已验收”入口,按当前项目、工作流及来源筛选展示本人正式通过或退回过的任务,不计入仅领取或保存草稿的任务。记录复用现有决定事件,不迁移历史数据;沿用当前账号的组织和业务读取权限。列表展示任务当前状态,并可筛选“已通过”或“打回”。同一任务多次审查仍展示一张任务卡片,不是逐轮决定日志。
进入该列表暂停连续审查,查看结果不领取任务、不获取编辑权;历史卡片仅提供查看入口。右侧“当前切片/当前画面标注”沿用质检组件,普通与专注布局均展示,切换视频、文件清单等页签时保留当前切片信息。