Stev_Wang
61894df401
背景：A2 开卡前完成 H1 权限门，确认权限点目录、特殊权限、SoD 三对、六类数据范围与超管隐式全集口径（ADR-001）。 改动： - shared：30 权限点 / 10 模块目录与元数据、特殊权限 6 编码、SoD 三对、角色与权限树契约；/me 改 dataScopes 多角色并集。 - prisma：expand 迁移新增 permissions / data_scopes；种子按原型口径重写角色权限、数据范围与 8 项特殊授予。 - api：角色 CRUD / 复制 / 停用 / 删除、权限点启动同步、SoD 40304、系统角色保护、六类范围 ScopeContext 与 CustomerDirectory 端口、变更审计与 outbox。 - web：方案 B 主从分栏三角色页面（列表 / 编辑器 / 新建），权限树、范围选择、特殊权限二次确认、保存影响、SoD 冲突、只读态与模板预填。 - 测试：角色集成 13 条 + A2 e2e 1 条；A1 全量回归。 验证：format:check / lint / typecheck / test（306）/ test:int（27）/ A2 e2e（1，复跑通过）/ openapi:export 全绿。
7.9 KiB
7.9 KiB
种子数据状态（A2）
A0 只 seed「已建表」的 system_configs；A1 补齐组织、账号与角色种子；A2 补齐权限点目录、角色权限映射与六类数据范围种子。全部种子按业务唯一键 upsert，幂等：重复执行不重复插入，也不覆盖已存在的密码 / 人工调整值。
权限点编码唯一事实源是
packages/shared/src/permissions.ts（30 个 / 10 模块 / 6 个特殊权限 / 3 对 SoD），seed.ts直接引用 shared 源码目录，不在本文件复制编码字符串。
已 seed（prisma/seed.ts）
| 数据 | 来源 | 幂等键 | 说明 |
|---|---|---|---|
| 平台系统配置 7 项 | system_configs |
config_key |
平台名、导出链接有效期、上传上限、分页大小、AI 预算比例等，A0 起延续 |
| 部门 / 小组 9 个（两级） | departments |
code |
内容生产中心（素材一组 / 素材二组 / 设计组）、交付中心（客户成功组）、平台技术部（AI 工程组 / 平台运维组）；一级部门负责人取 leader_account，用户种子之后回填 leader_user_id |
| 权限点目录 30 个 | permissions |
code（只增不删） |
10 个模块（script / material / asset / delivery / customer / customer_group / identity / industry / platform / audit）；启动时由 PermissionCatalogService 幂等 upsert，seed 同步一次 |
| 角色 10 个 + 角色权限点 | roles / role_permissions |
角色 code；权限映射先清后建 |
与 design/a2-ui-v1/brief.md §4 对齐：超级管理员（隐式全集，映射 24 普通 + 6 特殊）、平台管理员 12+1（audit:read）、素材运营 9、设计师 4、文案策划 2、审核员 4、AI 工程师 3+1（ai:configure）、客户负责人 5、行业配置 4、审核主管 5（停用）；非超管角色合计 50 条映射，特殊授予共 8 项；新建角色仍默认全空、特殊权限单独授予 |
| 角色数据范围 | data_scopes |
角色 code；范围先清后建 |
一个角色只允许一种范围类型：超管 / 平台管理员 / AI 工程师 / 行业配置 = all；素材运营 / 设计师 = owned_customers；文案策划 = department；审核员 / 审核主管 = department_and_children；客户负责人 = customer_groups（A3 前无客户组，保留一行 target_id = NULL 以固定范围类型，不降级为最小权限） |
| 用户 11 个（超管 1 + 示例 10） | users / user_roles |
account；用户角色先清后建 |
超管 admin，示例用户与 A1 原型口径一致（陈默、林清、周岸、赵一诺、高岑、苏禾、沈知远、江岚、唐嘉、何岸）；唐嘉 / 何岸为停用态，用于「停用即时失效」联调 |
| 用户初始密码 | users.password_hash |
— | 统一 lingxi2026（Argon2id），must_change_password=true：首登强制改密 |
登录账号（本地联调）
| 账号 | 姓名 | 角色 | 部门 / 小组 | 状态 |
|---|---|---|---|---|
admin |
灵犀管理员 | 超级管理员 | 平台技术部（直属） | 在职 |
chen.mo |
陈默 | 素材运营、客户负责人 | 内容生产中心 / 素材一组 | 在职 |
lin.qing |
林清 | 设计师 | 内容生产中心 / 设计组 | 在职 |
zhou.an |
周岸 | 文案策划 | 内容生产中心 / 素材二组 | 在职 |
zhao.yinuo |
赵一诺 | 审核员 | 内容生产中心 / 素材二组 | 在职 |
gao.cen |
高岑 | 客户负责人 | 交付中心 / 客户成功组 | 在职 |
su.he |
苏禾 | AI 工程师 | 平台技术部 / AI 工程组 | 在职 |
shen.zhiyuan |
沈知远 | 超级管理员 | 平台技术部（直属） | 在职 |
jiang.lan |
江岚 | 平台管理员 | 平台技术部 / 平台运维组 | 在职 |
tang.jia |
唐嘉 | 素材运营 | 内容生产中心 / 素材一组 | 停用 |
he.an |
何岸 | 客户负责人 | 交付中心 / 客户成功组 | 停用 |
登录账号按共享契约
accountSchema不含@（邮箱本地部分 / 工号风格）；邮箱由种子自动生成账号@lingxi.cn。
使用
pnpm db:migrate # 应用 a2_role_permissions_data_scopes 迁移（expand：permissions / data_scopes 两张新表）
pnpm db:seed # 幂等写入上述种子（可重复执行；空库与存量库均已验证）
# 本地重置：pnpm db:reset（会重新执行全部迁移与 seed）
与 A1 / A2 遗留的关系
- A1 记录的角色 / 用户种子已延续；A2 在其上补齐权限点目录、特殊权限口径（默认关闭、显式授予）与六类数据范围。
- 角色权限数按原型
design/a2-ui-v1/brief.md对齐（12/9/4/2/4/3/5/4/5，特殊授予 8 项）；用户仍为 A1 的 11 个示例账号，原型「绑定用户 28 名」属 UI 示例数据，未扩种用户。 - 字典（A4）、客户 / 客户组（A3）、行业包（A3）仍留待后续批次建表，不在本种子内。
data_scopes只存角色声明的范围与授权对象；解析后的可见客户集合由CustomerDirectory端口在请求期计算，A3 前为空集（种子不写客户 id）。- 原有的
Q-A0-01（种子验收与建表顺序冲突）已随 A1 建表解除。
已知限制
- 客户数据（客户、客户组）属 A3，客户转交接口当前返回占位错误
42201（客户转交将在客户模块（A3）提供），种子不含客户；customer_groups范围暂无可指向的客户组。 - 审计表属 A5，
@Audit当前写结构化日志（含前后值与影响用户数）；A5 落库后在此扩展日志 + 审计表双写。 outbox_events已写入role.permissions.changed占位事件（角色新建 / 更新 / 停用 / 删除），通知投递随 A5 / 任务中心接入。