droboticflow/docs/project-member-scope.md

31 lines
4.0 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 员工供应商固定归属
- 创建员工必须选择当前组织的有效供应商;没有外部供应商就选择“默认供应商”,不能留空。供应商管理员创建员工固定继承自己的供应商。
- 每个组织有独立默认供应商 `supplier-default-<organizationId>`,重复初始化不重复创建;自动参与项目不代表可以绕过供应商任务隔离。
- 包括平台管理员在内,所有账号管理入口都不能更换已有员工的供应商。资料、密码、角色仍可修改;持久化层不写回已有记录的供应商字段。
- 所有项目自动允许本组织默认供应商参与,原供应商及其成员不变。默认供应商的在职标注员、质检员和验收员自动加入所有项目;其他供应商员工仍按项目配置加入。
- 自动关联只补缺失的项目成员:优先使用账号的默认项目角色,未设置时沿用生产账号角色;不赋予管理员生产角色,不覆盖已有成员的供应商或角色。新项目、新账号、恢复启用和启动时补齐,正在删除的项目不补。
- 项目成员继承账号供应商;项目编辑只调整角色,不提供供应商变更或跨项目同步。默认员工仍在职时,单独移出某个项目后会在下一次自动关联时重新加入;删除账号则退出项目,不会自动恢复。
- 删除沿用停用方式:撤销登录会话、移出项目,保留账号、历史标注和审核记录;同邮箱不能直接创建新身份。操作约定仍为完成任务后再删除。
- 人工任务沿用公共待领取池,领取后绑定员工供应商;默认供应商使用相同的标注、质检和隔离规则。最终验收保持项目级规则。
- 已移除内部双模式与供应商变更同步功能。领域记录仅保留旧字段兼容读取;历史 `processingScope=internal` 且无供应商的任务不会被解释成公共任务,须先按批准清单处理。
## 历史数据:预览后确认
`scripts/preview_employee_supplier_migration.py` 从标准输入读取 JSON 清单并输出 dry-run 计划,不连接数据库、不执行更新。输入包括 `organizationId`、`users`、`members`、`suppliers`。
- 账号与项目成员均为空:建议补为默认供应商。
- 账号有有效供应商、成员为空:仅建议补成员,不改角色、不新增成员。
- 员工账号为空时一律补为默认供应商,即使已有项目成员是其他供应商;已有非空项目归属保留并在预览中列出冲突,不擅自转移。失效、跨组织的非空供应商不替换,也不复制到空成员。
- 系统管理账号不进入员工补齐清单;停用员工只补空归属,不重新启用、不新增项目权限。
- 启动时先补齐员工与项目成员的空归属,再为默认供应商在职生产员工补缺失的项目成员。字段级条件更新仅匹配缺失、null、空字符串或纯空白 supplierId,可重复运行;不改变已有角色、密码、状态或任务归属。旧工作组迁移不再推断或改写员工供应商。
## 验证与发布
- 验证创建必选、管理员不可变更、成员继承、删除后会话失效且历史保留、默认与普通供应商领取及质检路由。
- 单元测试、内存 API 与本地页面验证不等于 Fanyu 真实完整流程验收。
- 发布前预览并备份对应归属字段;API/Worker 启动执行上述已确认的补空规则。创建 API 继续拒绝空供应商,前端默认选中真实的默认供应商;不能用显示名称代替持久化归属。
- Fanyu 保留 `k8s/fanyu-api-recreate.patch.yaml` 的先停旧后启新策略。完整 manifest 应用前保留 `Recreate` 并删除 `rollingUpdate`,不被通用模板覆盖。
- 发布有短暂不可用窗口;验证新实例、镜像、健康及业务后再恢复操作。回退只用已验证且遵守固定归属规则的镜像,不回退到允许更换供应商的版本。
- 不改视频处理、切片交互、算子和工作流;此前暂不处理的领取同步失败恢复问题不在本次范围。