Codex
7.0 KiB
PJ2026-010507 组织管理
修改历史
| 版本 | 对应 commit id | 更新日期 | 变更说明 |
|---|
当前正文仍在规格治理草稿中；未定稿前不新增版本号，不为单次编辑追加 待提交 版本。
正文
PJ2026-010507 组织管理需求规格
1. 文档控制
| 字段 | 内容 |
|---|---|
| 编号 | PJ2026-010507 |
| 短名 | 组织管理 |
| 层级 | L2 课题 |
| 状态 | 已生效 |
| 需求规格模板 | ISO/IEC/IEEE 29148 需求规格模板 |
| 上级规格 | PJ2026-0105 用户管理 |
| 规格治理索引 | 规格治理 |
本文采用 ISO/IEC/IEEE 29148 需求规格模板的项目裁剪版：正文只保留组织管理的稳定使命、范围、术语、系统边界、内部分工和原子需求。
2. 目的和范围
2.1 目的
组织管理负责 HWLAB 2B 协同中的组织身份、成员、组织角色、组织项目和组织工作台归属，使多个用户可以围绕同一组织上下文共享项目、任务、资源、结果和账务边界。
D601 v0.3 当前以个人用户和 admin 管理为主，尚未把组织作为一等业务实体；本课题定义从个人账号基线扩展到组织协同、组织级资源授权和组织级租户隔离的目标能力。
2.2 范围内
- 组织创建、组织资料、组织状态和组织身份。
- 组织成员、邀请、移除、成员状态和组织角色。
- 组织项目、组织工作台、组织内 Agent session、HWPOD/CaseRun 资源归属。
- 组织级 plan、entitlement、quota、billing summary 和 admin 管理边界。
- 个人账号与组织上下文切换、默认归属和迁移规则。
2.3 范围外
- 个人账号登录和 Web session 归 PJ2026-010501 账号会话。
- 组织访问边界和越权判断归 PJ2026-010506 租户隔离。
- 组织项目或工作台的页面体验归 客户端。
- Agent 执行和 workspace materialization 归 Agent编排。
- 真实硬件资源事实和 HWPOD 资源池归 硬件池。
3. 术语表
| 术语 | 定义 |
|---|---|
| 组织 | 多个用户协作的业务主体，可拥有成员、项目、工作台、资源和账务边界。 |
| 组织成员 | 与组织绑定并拥有组织角色的用户。 |
| 组织角色 | 用户在组织内的权限类别，例如 owner、admin、member 或 viewer。 |
| 组织项目 | 归属于组织并可被成员按权限访问的项目。 |
| 组织工作台 | 归属于组织并承载组织内任务、资源和结果入口的工作台。 |
| 组织上下文 | 请求或任务当前所属的组织、项目和工作台身份。 |
4. 系统边界和接口
本规格把组织管理作为用户管理的 2B 协同事实层看待；本章只描述输入、输出和责任边界。
| 边界项 | 内容 |
|---|---|
| 外部使用者 | 组织 owner、组织成员、平台管理员、客户端、Agent编排、硬件池、HarnessRL、账单后台。 |
| 外部输入 | 组织创建请求、成员邀请、角色变更、组织项目归属、组织工作台归属、组织 plan/entitlement 配置和组织上下文选择。 |
| 受控资源 | 组织、组织成员、组织角色、组织项目、组织工作台、组织资源归属、组织 billing context 和组织 tenant context。 |
| 外部输出 | 组织摘要、成员列表、角色判断、组织上下文、组织资源归属、组织账务摘要和组织内访问判断输入。 |
| 用户接口 | Cloud Web 组织入口、HTTP API、admin API、CLI 组织命令。 |
| 系统边界 | 组织管理负责组织事实和归属；不定义页面布局、Agent 执行、硬件状态、账本扣费细节或平台发布机制。 |
5. 内部分工与规格索引
| 编号 | 模块或课题 | 规格文档 | 主责边界 | 上游依赖 | 下游支撑 |
|---|---|---|---|---|---|
| PJ2026-01050701 | 组织身份 | 本规格 6.1 | 组织创建、资料和状态 | 账号会话、admin 权限 | 客户端、租户隔离 |
| PJ2026-01050702 | 成员角色 | 本规格 6.2 | 成员邀请、移除和组织角色 | 组织身份、账号会话 | 权限配额、客户端 |
| PJ2026-01050703 | 项目工作台 | 本规格 6.3 | 组织项目和组织工作台归属 | 成员角色、客户端工作台 | Agent编排、硬件池 |
| PJ2026-01050704 | 组织运营 | 本规格 6.4 | 组织 plan、quota、billing 和资源归属 | 权限配额、计量账本 | 账单后台、租户隔离 |
6. 原子需求
6.1 USER-ORG-REQ-001 组织身份
| 编号 | 短名 | 主责模块 | 关联模块 |
|---|---|---|---|
| USER-ORG-REQ-001 | 组织身份 | PJ2026-01050701 组织身份 | 账号会话、客户端 |
组织管理应提供组织创建、资料维护和状态管理能力，使团队或企业可以作为 HWLAB 协同和运营边界存在。
组织身份是组织成员、组织项目、组织工作台、组织资源和组织账务的上游事实。个人账号不能用临时标签替代组织身份。
6.2 USER-ORG-REQ-002 成员与角色
| 编号 | 短名 | 主责模块 | 关联模块 |
|---|---|---|---|
| USER-ORG-REQ-002 | 成员角色 | PJ2026-01050702 成员角色 | 权限配额、租户隔离 |
组织管理应提供组织成员邀请、移除、状态和组织角色能力，使组织内访问和管理操作可以按成员关系授权。
组织角色只定义组织内权限上下文；全局 admin、个人账号状态和 API key 策略仍由对应用户管理课题定义。
6.3 USER-ORG-REQ-003 组织项目与工作台
| 编号 | 短名 | 主责模块 | 关联模块 |
|---|---|---|---|
| USER-ORG-REQ-003 | 项目工作台 | PJ2026-01050703 项目工作台 | 客户端、Agent编排、硬件池 |
组织管理应定义组织项目和组织工作台归属，使组织成员可以在同一组织上下文中发起任务、查看结果和共享资源。
项目和工作台的用户体验由客户端实现，Agent 和硬件模块消费组织上下文与归属，不在本地创建另一个组织模型。
6.4 USER-ORG-REQ-004 组织运营边界
| 编号 | 短名 | 主责模块 | 关联模块 |
|---|---|---|---|
| USER-ORG-REQ-004 | 组织运营 | PJ2026-01050704 组织运营 | 账单后台、计量账本、权限配额 |
组织管理应定义组织级 plan、entitlement、quota、billing 和资源归属边界，使组织可以作为资源消费和账务汇总主体。
组织运营边界不得破坏个人用户账本和租户隔离。组织级消费应能追溯到组织、成员、项目、工作台和具体 resource type。