---
url: https://limapi.com/docs/platform/organization.md
---
# 组织用户使用指南

> 本文档为框架初稿，章节结构基于 Portal 平台现有功能与组织充值流程整理，待原始使用说明文档内容补充后完善。

## 1. 组织与角色

平台支持组织（团队/企业）模式。组织内分为三种角色：

| 角色 | 权限 |
|------|------|
| **OWNER**（所有者） | 组织充值、分配成员额度、管理组织设置 |
| **ADMIN**（管理员） | 协助管理成员与日常运营 |
| **MEMBER**（成员） | 使用分配的额度调用模型 |

登录后，用户信息接口会返回 `orgId` 与 `orgRole` 字段标识所属组织与角色；`orgId` 为空表示独立个人用户。

## 2. 组织资金流

组织计费采用「资金池 → 分配 → 消费」模式：

```
组织管理员扫码充值 → 组织总池（organizations.total_balance）
                        ↓ OWNER 分配额度
                   成员可用额度（members.org_balance）
                        ↓ 调用模型时优先扣除
                   成员余额消耗
```

**使用顺序**：OWNER 扫码充值到组织总池 → OWNER 分配额度给成员 → 成员使用。

## 3. 组织充值（OWNER）

1. 使用 OWNER 账号登录 Portal。
2. 进入「组织充值」页面，输入金额（单笔最低 10 元）。
3. 微信扫码完成支付，资金进入组织总池。
4. 可在订单列表中查看充值记录与状态（未支付订单 30 分钟后自动关闭）。

::: warning 权限限制
仅 `orgRole = OWNER` 的用户可以发起组织充值，其他角色操作会返回 403。
:::

## 4. 分配成员额度（OWNER）

OWNER 在「组织管理 → 成员管理」中为成员分配可用额度。成员调用模型时优先消耗组织分配的额度。

## 5. 组织折扣

平台支持四级折扣优先级（按顺序取第一个命中值）：

| 优先级 | 层级 | 示例 |
|---|---|---|
| P1（最高） | 组织 × 模型折扣 | 某组织使用某模型享 85 折 |
| P2 | 模型全局折扣 | 某模型全场 7 折 |
| P3 | 组织统一折扣 | 某组织全场 95 折 |
| P4（最低） | 租户个人折扣 | 个人 VIP 9 折 |
| 兜底 | 系统默认 | 不打折 |

组织折扣由平台管理侧配置。账单按折后价格结算。

## 6. 成员使用流程

1. 成员使用自己的账号登录 Portal（账号需已加入组织）。
2. 创建个人 API Key。
3. 调用模型时按组织折扣计费，优先消耗组织分配额度。
4. 成员可在 Portal 查看自己的调用记录与消费明细。

## 7. 常见问题

| 问题 | 说明 |
|------|------|
| 充值入口不可见 | 确认当前账号 orgRole 是否为 OWNER |
| 成员调用报 `insufficient_balance` | 联系 OWNER 检查额度分配与组织总池余额 |
| 折扣未生效 | 折扣按四级优先级匹配，请联系平台管理员确认配置 |