# 精简角色上下文与能力对象

POST/user/info使用App Shell精简投影。独立GET/iam/me/roles及capabilities保留完整元数据，两类响应不互相复制字段表。

| 字段 | 类型 | 合同 |
| --- | --- | --- |
| iam_context.roles | array（对象数组） | 直接角色选项，非权限并集 |
| roles[].role_id / role_name | string | 规范角色标识与名称 |
| roles[].lifecycle_version | integer | Role生命周期版本 |
| roles[].selectable | boolean | 当前是否可选 |
| roles[].disabled_reason | string | 可用时空；ROLE_NOT_ACTIVE或ROLE_PROVISIONING_NOT_READY说明不可用 |
| iam_context.default_role_id / explicit_role_id / effective_role_id | string | 默认角色、未验证显式候选、当前唯一有效角色；空值有独立含义 |
| iam_context.default_role_version | integer | 默认角色绑定版本，非角色生命周期版本 |
| iam_context.role_context_status | string | ready/default_missing/candidate_invalid/role_disabled |
| iam_capabilities.effective_role_id | string | 能力所用的有效角色 |
| iam_capabilities.request_id / trace_id | string | 诊断标识，不从精简iam_context寻找 |
| iam_capabilities.items | array（对象数组） | 精简能力项，非ready时当前不进行能力计算并返回空数组 |
| items[].capability_id / reason_code | string | 稳定能力标识和返回的原因码，不自行用显示名称推断 |
| items[].allowed / all_resources | boolean | 明确允许及对象范围类型 |
| items[].resource_ids | string[]（字符串数组） | 精确对象范围；all_resources=true时应为空 |

Bootstrap不返回role option的lifecycle_state/system_role，不返回iam_context的schema/capability/request/trace元数据，不返回iam_capabilities.capability_version，也不返回item.action_id/resource_type。精简是handler与proto定义的合同，不计SDK丢字段；若需完整元数据调用相应独立接口。

未请求项/非ready空能力不能使用旧缓存补成allow。对象操作还需allowed=true且all_resources=true或canonical ID精确命中，实际写请求仍重做权限检查。切换候选后清旧context/capability/依赖缓存再bootstrap，不能把一次摘要永久当权限凭据。

iam_snapshot_version由展示事实、内部完整角色/版本、能力和授权快照等计算；部分参与字段不在精简JSON内，调用者不能仅用该JSON重算，也不把它当数据写入版本。当前service的Owner/保留成员旧展示和选路例外与规范边界继续按原IAM冲突记录核对，不通过改文档扩张授权模型。
