组织用户使用指南

本文档为框架初稿，章节结构基于 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 分钟后自动关闭）。

权限限制

仅 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 检查额度分配与组织总池余额
折扣未生效	折扣按四级优先级匹配，请联系平台管理员确认配置