9.6 KiB
账号与供应商管理
界面和角色
左侧菜单统一为“账号管理”,继续使用原表格、颜色、按钮、弹窗和深色主题。管理员在同一页通过左侧目录切换“管理员账号”与各供应商,右侧显示账号列表。支持供应商名称搜索、账号姓名/邮箱搜索。
- 管理员账号独立,不绑定供应商;创建时角色固定为管理员。
- 其余账号必须绑定一个有效供应商。供应商目录下创建账号时自动绑定当前供应商,角色单选:供应商管理员、标注员、质检审核员、最终验收员。
- 供应商管理员只看到本供应商的生产员工,只能分配三种生产角色;不能管理管理员、自己或其他供应商管理员。
- 账号创建后供应商不可变。管理员和供应商账号不能直接互转,应分别创建身份,避免改写历史归属。
- 沿用账号停用、恢复、逻辑删除和密码管理。最后一个管理员保护、旧会话失效、离职任务释放继续生效。
供应商增删改查
GET /api/suppliers 列表;POST /api/suppliers 新增;PUT /api/suppliers/{supplierId} 改名;DELETE /api/suppliers/{supplierId} 删除。
仅管理员可执行写操作。空名称拒绝;同一业务范围内名称去首尾空白、不区分大小写判重。默认供应商不可改名或删除。改名保持原 ID 及全部关联。
删除前检查所有状态的账号、项目成员、项目工作流、人工任务/批次、标注任务、交付记录、作业记录、历史成员和绑定供应商的工作流配置。有关联时返回 409 和分类数量;已停用账号也属于关联数据。无关联时保留供应商记录为删除标记,从列表和选择器中隐藏,不级联删除。
MongoDB 通过数据库持久互斥保护供应商变更与所属账号创建;支持事务时额外使用事务。名称写入按业务范围串行校验。MemoryStore 在互斥锁内校验和写入。
唯一角色与项目授权
一个项目可以同时包含多个供应商及其成员,项目不绑定唯一供应商。单个 Capture 的供应商归属决定该任务的生产访问范围;不同供应商可以在同一项目内分别处理任务。
账号的 role 是唯一职责来源。取消“默认项目角色”、项目成员角色多选、批量改项目角色及项目创建时的角色勾选。
- 项目成员只表示参与关系;读取时展示账号当前生产角色。
- 项目成员新增接口可省略
roles。为兼容原协议保留数组,但传入时必须恰好一个且等于账号角色;管理身份不能作为生产成员加入。 set_roles批量操作明确拒绝;角色变更从账号管理进行。- API 标注/质检/验收权限、随机领取、普通领取/任务分配,以及 Worker 的供应商生产角色覆盖检查,都依据账号唯一角色。旧项目角色数组不能增加权限。
- 有未完成的已领取人工任务或关联标注任务时拒绝修改角色。MongoDB 角色变更、普通领取与随机领取使用同一个账号级持久互斥;支持事务时共同写账号文档,避免“检查后又被领取”的竞态。
- 标注员已送检的旧标注记录处于
pending_quality或pending_acceptance时,保留原领取人作为历史归属,不再据此阻止标注员修改角色。本人仍领取的人工任务、切片失败、待标注、返工及状态不明的旧任务继续阻断;切换为审核员后仍不能审核本人提交的数据。此规则只调整角色变更判断,不清空领取字段、草稿、版本或审核记录。 defaultProjectRoles和旧项目roles保留用于历史审计,不再作为额外授权,不自动覆写历史。
历史检查与上线边界
管理员页面“检查历史账号与项目角色”调用只读接口 GET /api/users/hierarchy-audit,显示管理员仍绑定供应商、非管理员缺少有效供应商、旧默认角色、项目角色或供应商冲突、账号缺失,并附未完成领取任务数量。供应商管理员无权读取全局清单。
不删除 Organization 底层数据。2026-09-21 用户已确认 zhuchunling1 属于默认供应商,并授权覆盖发布;TestFanyuDefaultSupplierRepair 仅修复已核对的成员及六个独立 Capture 的当前归属,保存不可变 before-images 和修复事件,保留已有切片与标注历史。部署前应在目标环境执行历史清单检查,优先解决有在途任务的角色/归属冲突,再同时更新 API、前端和 Worker。否则旧 Worker 仍会按旧角色数组判断流程人员覆盖。
MongoDB 单机兼容
真实 Fanyu 检测为 standalone(事务返回 IllegalOperation),因此不能仅依赖副本集测试。
- 供应商写入与账号创建按业务范围互斥;角色变更、密码/状态更新与任务领取按账号互斥;最后管理员保护使用独立共享互斥。
- 互斥保存在
accountMutationLocks,由 MongoDB 单文档条件更新原子获取。副本集继续执行事务;仅对明确的事务不支持错误回退到同一互斥保护下的操作。 - 互斥不使用会自动过期的租约,避免暂停进程恢复后与新持有者同时写入。正常结束只释放自身 owner;等待 5 秒仍不可获得时返回忙碌错误。
- 若进程崩溃或网络结果不确定,锁保留以阻止冲突写入。运维须先确认 owner 对应进程已停止、核对操作结果,再只清理该 owner 的锁;禁止按时间批量解锁或添加 TTL。
- 只读上线检查:
ACCOUNT_RELEASE_AUDIT=1运行TestAccountHierarchyReleaseAudit。另设ACCOUNT_TRANSACTION_PROBE=1时在随机account_deploy_probe_*隔离数据库执行真实写入兼容测试,并删除该测试库;不修改业务库数据。
验证
- Go:账号权限、供应商生命周期、项目单角色继承、旧多角色拒绝授权、历史清单只读、默认供应商、标注随机领取、质检领取/流转、证据权限、Worker 人员覆盖。
- 真实本地 MongoDB:同名供应商并发创建仅一个成功;删除与创建所属账号不会同时成功;角色变更与旧角色领取不会同时成功;最后管理员保护。
- Chrome 对接本地隔离 API:管理员目录、供应商新增/改名/重复名/关联阻止删除/空供应商删除、账号创建单角色、供应商管理员权限、项目成员只读角色;浅色、深色和移动尺寸。
npm run lint:web、npm run build:web、全项目 Go 编译;前端供应商成员选择回归。
本地 Mongo 验证开关 ACCOUNT_LOCAL_MONGO_TEST=1,默认 localhost:27028 / accountQA 副本集;另设 ACCOUNT_LOCAL_MONGO_STANDALONE=1 切换 localhost:27029 单机实例,使用随机 supplier_local_test_* 测试库并清理;不读取线上凭据。浏览器内存服务通过 ACCOUNT_LOCAL_SERVER=1 显式启动,使用临时密码,可用 ACCOUNT_QA_PORT 指定端口。
上线实测补充(2026-09-21)
在 Fanyu 使用隔离账号和两组 60 秒合成采集,实际调用线上 API、标注处理服务与 Worker:同一项目的两个供应商分别完成随机领取、提交、质检、最终验收和打包,生成两个 accepted 交付包。每组左右视频各 240 帧、IMU 480 行,证据目录可读取左右 MP4。跨角色和跨供应商质检领取被拒绝。测试完成后移除本次生成的业务项目/账号并移除测试供应商的可选入口,产物隔离保留用于验证。
同时发现 Worker 健康检查把 poll interval 当成完整循环耗时,正常约 82 秒的循环会超过固定 30 秒门槛。现按最近成功循环的耗时增加有上限的容差,并公开 readinessWindowMs;失败循环不延长门槛,实际 cycleDurationMs 保留。该修正解决误判,不代表调度循环本身已加速。
供应商最终验收授权(本地候选,2026-09-29)
“授权项目”上方新增默认关闭的“允许最终验收”。仅平台管理员可更改,供应商管理员可查看。开启后,该供应商可以新建最终验收员、将未领任务的员工改为该角色;验收员访问同组织全部生产项目的终审池,无需供应商项目授权。默认供应商也可设置,不改变其改名、删除限制。平台管理员创建或转入此角色同样须先开启授权;原验收员修改资料不受影响。
GET/PUT /api/suppliers/{supplierId}/acceptance-authorization 返回状态、版本、操作历史及已领共享任务数。PUT 必须携带当前版本,过期返回 409。关闭前显示影响与当前数量。授权、创建/转角色和共享领取使用同一组织供应商写锁;新领取以持久化权限校验为准。
关闭后禁止新建/转入验收员和新共享领取;已领取任务按本人、本轮、阶段及领取时间保留处理依据,草稿、观看、通过/退回和超时结果核对仍可继续。新一轮和重新分配不继承旧依据。该授权不扩大供应商管理员、标注员或质检员权限;通用 Run/产物接口不扩权,跨项目视频只通过验收任务绑定的证据入口读取。不同组织、内部测试池仍隔离。
首次升级前生成 acceptanceCompatibilitySnapshots:按组织记录当时的验收账号身份。初始化与启动重放幂等,后建账号不会加入清单。旧账号继续原权限判断(包括既有 05 账号),没有自动开启共享授权。新账号和改过角色的账号标记为 managed;旧角色改走再改回必须取得授权,重放迁移也不会恢复其旧资格。
上线前另行授权并按共享验收发布说明备份、初始化和核验;本次没有发布或客户数据写入授权。