# PJ2026-010507 组织管理

## 修改历史

| 版本 | 对应 commit id | 更新日期 | 变更说明 |
| --- | --- | --- | --- |

当前正文仍在规格治理草稿中；未定稿前不新增版本号，不为单次编辑追加 `待提交` 版本。

## 正文

## PJ2026-010507 组织管理需求规格

## 1. 文档控制

| 字段 | 内容 |
| --- | --- |
| 编号 | PJ2026-010507 |
| 短名 | 组织管理 |
| 层级 | L2 课题 |
| 状态 | 已生效 |
| 需求规格模板 | [ISO/IEC/IEEE 29148 需求规格模板](../../templates/iso-iec-ieee-29148-requirements-spec-template.md) |
| 上级规格 | [PJ2026-0105 用户管理](PJ2026-0105-user-management.md) |
| 规格治理索引 | [规格治理](spec-governance.md) |

本文采用 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-010501-account-session.md)。
- 组织访问边界和越权判断归 [PJ2026-010506 租户隔离](PJ2026-010506-tenant-isolation.md)。
- 组织项目或工作台的页面体验归 [客户端](PJ2026-0104-client.md)。
- Agent 执行和 workspace materialization 归 [Agent编排](PJ2026-0102-agent-orchestration.md)。
- 真实硬件资源事实和 HWPOD 资源池归 [硬件池](PJ2026-0101-hardware-pool.md)。

## 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 组织身份 | [账号会话](PJ2026-010501-account-session.md)、[客户端](PJ2026-0104-client.md) |

组织管理应提供组织创建、资料维护和状态管理能力，使团队或企业可以作为 HWLAB 协同和运营边界存在。

组织身份是组织成员、组织项目、组织工作台、组织资源和组织账务的上游事实。个人账号不能用临时标签替代组织身份。

### 6.2 USER-ORG-REQ-002 成员与角色

| 编号 | 短名 | 主责模块 | 关联模块 |
| --- | --- | --- | --- |
| USER-ORG-REQ-002 | 成员角色 | PJ2026-01050702 成员角色 | [权限配额](PJ2026-010503-access-quota.md)、[租户隔离](PJ2026-010506-tenant-isolation.md) |

组织管理应提供组织成员邀请、移除、状态和组织角色能力，使组织内访问和管理操作可以按成员关系授权。

组织角色只定义组织内权限上下文；全局 admin、个人账号状态和 API key 策略仍由对应用户管理课题定义。

### 6.3 USER-ORG-REQ-003 组织项目与工作台

| 编号 | 短名 | 主责模块 | 关联模块 |
| --- | --- | --- | --- |
| USER-ORG-REQ-003 | 项目工作台 | PJ2026-01050703 项目工作台 | [客户端](PJ2026-0104-client.md)、[Agent编排](PJ2026-0102-agent-orchestration.md)、[硬件池](PJ2026-0101-hardware-pool.md) |

组织管理应定义组织项目和组织工作台归属，使组织成员可以在同一组织上下文中发起任务、查看结果和共享资源。

项目和工作台的用户体验由客户端实现，Agent 和硬件模块消费组织上下文与归属，不在本地创建另一个组织模型。

### 6.4 USER-ORG-REQ-004 组织运营边界

| 编号 | 短名 | 主责模块 | 关联模块 |
| --- | --- | --- | --- |
| USER-ORG-REQ-004 | 组织运营 | PJ2026-01050704 组织运营 | [账单后台](PJ2026-010505-billing-admin.md)、[计量账本](PJ2026-010504-metering-ledger.md)、[权限配额](PJ2026-010503-access-quota.md) |

组织管理应定义组织级 plan、entitlement、quota、billing 和资源归属边界，使组织可以作为资源消费和账务汇总主体。

组织运营边界不得破坏个人用户账本和租户隔离。组织级消费应能追溯到组织、成员、项目、工作台和具体 resource type。
