# 公会资金展示优化

## 功能目标

将公会收益和人才激励金明确拆分，让用户能够直接理解：

- 当前还有多少公会收益可以分配。
- 已经向管理层分配了多少收益。
- 公会历史累计获得了多少收益。
- 人才激励金还剩多少、如何充值、可以用于什么。

## 资金关系

| 资金类型 | 资金来源 | 资金用途 | 是否可充值 | 是否参与管理层分配 |
| --- | --- | --- | --- | --- |
| 公会收益 | 任务相关公会收益 | 向会长、副会长分配 | 否 | 是 |
| 人才激励金 | 用户充值 | 人才邀请返佣 | 是 | 否 |

两类资金独立展示，不合并余额或累计金额。

## 页面一：管理公会入口

### 使用入口

我的公会 → 管理公会

### 页面展示

- “公会经营”区域展示公会收益、公会成员、人才激励三张独立卡片。
- 每张卡片均展示功能图标、进入箭头、二级页面标题、核心数据和数据说明。
- 原“公会资金池”统一使用“公会收益”名称。
- 原“公会人才激励”统一使用“人才激励”名称。

### 数据含义

- **公会收益**：展示当前可分配收益，不使用累计总收益作为入口主金额。
- **公会成员**：展示当前正式成员数量，不包含申请中或已冻结成员。
- **人才激励**：展示当前可用激励金，该金额独立于公会收益。

### 用户操作

- 点击“公会收益”进入公会收益与分配页面。
- 点击“公会成员”进入公会成员管理页面。
- 点击“人才激励”进入人才激励管理页面。

### 多语言与版式

- 三个卡片标题与下方其他二级页面入口标题保持相同字号和字重。
- 图标和进入箭头位于卡片顶部两端，不与标题占用同一行。
- 标题和数据说明最多展示两行。
- 切换较长语言后，三张卡片保持等高，金额位置保持一致。

### 注意事项

- 公会收益和人才激励必须保留两个独立入口。
- 人才激励卡片不再展示“可充值”标签。
- 充值能力在人才激励页面及公会收益页的充值导流中体现。
- 公会收益账户不提供充值能力。
- 三张卡片的数字分别属于不同业务对象，不进行相加或汇总。

## 页面二：公会收益与分配

### 使用入口

管理公会 → 公会收益

### 收益概览

- **可分配收益**：页面主金额。表示已经进入公会收益账户、尚未向会长和副会长分配的金额。
- “立即分配”与可分配收益位于同一操作行，按钮放在金额右侧；账户标签单独位于卡片顶部，不与操作按钮并列。
- “可分配收益”后的“?”打开独立说明弹框，集中解释资金定义、两种分配方式和分配后的金额变化；收益概览不重复展示长说明。
- **累计已分配收益**：表示历史已经发放给会长和副会长的金额。
- **累计总收益**：表示公会历史获得的全部收益。

资金关系：

> 累计总收益 = 可分配收益 + 累计已分配收益

页面关注顺序固定为：可分配收益 → 累计已分配收益 → 累计总收益。

### 收益分配

- 只有会长可以发起主动分配，副会长只能查看收益和分配记录。
- 会长点击“立即分配”后，可以输入全部或部分可分配收益。
- 输入有效金额后，页面按照当前管理层比例实时展示会长、副会长所得金额，以及分配后的剩余可分配收益。
- 会长完成核对后点击“确认并分配”，收益立即发放给对应管理人员，本次操作不可撤销。
- 系统继续在每月 1、11、21 日自动分配当时剩余的可分配收益；已经主动分配的金额不会重复分配。

主动分配成功后的金额关系：

- 可分配收益减少本次分配金额。
- 累计已分配收益增加本次分配金额。
- 累计总收益保持不变。

### 人才激励导流

- 展示人才激励账户当前可用激励金。
- 提供“充值人才激励金”入口。
- 点击后进入人才激励页面，并直接打开充值弹窗。
- 明确提示人才激励金不进入公会收益、不参与管理层分配。

### 收益与分配记录

- 公会收益入账使用正向金额，并展示收益来源。
- 管理层收益分配使用负向金额，并展示收款管理人员和时间。
- 分配记录区分“会长主动分配”和“系统定时分配”。
- 人才激励充值、返佣发放不在此列表展示。

### 注意事项

- 人才激励金不计入累计总收益。
- 可分配收益为 0 时，“立即分配”不可操作。
- 分配金额必须大于 0，且不能超过当前可分配收益。
- 待结算收益为 0 时不固定展示。
- 待结算收益大于 0 时作为临时状态提示，且不计入当前可分配收益。
- 公会收益页面不再提供充值按钮。

## 页面三：人才激励

### 使用入口

- 管理公会 → 人才激励
- 公会收益页 → 充值人才激励金

### 人才激励金

- **可用激励金**：当前可以继续用于人才邀请返佣的余额。
- **累计已发放**：历史已经用于人才返佣的金额。
- 提供“充值人才激励金”入口。
- 显示“独立账户”提示，并说明资金不进入公会收益、不会分配给会长或副会长。

### 活动说明

- “活动说明”进入独立的公会人才激励活动说明页面。
- 说明页面介绍奖励发放时机、每位新用户触发次数、邀请层级与返佣比例。
- 每位新用户的触发次数不设上限，由会长设置；设置几次，该新用户最多触发几次。
- 邀请层级最多为 10 层，各邀请层级的返佣比例均由会长设置。
- 说明人才激励金来源、用途、活动关闭、余额为 0 和设置变化后的规则。

### 激励设置

- 支持开启或关闭人才激励活动。
- 支持选择奖励发放时机。
- 支持由会长设置每位新用户的返佣触发次数，不设置次数上限。
- 支持设置直接邀请、间接邀请及后续邀请层级的返佣比例。
- 最多支持 10 个邀请层级，各层比例由会长分别设置。
- 用户修改设置后，通过“保存设置”保存本次调整。

### 资金记录

- 充值人才激励金使用正向金额，展示充值来源和时间。
- 发放人才返佣使用负向金额；当前账户为默认收款方，不重复展示收款用户名。
- 每条记录只显示触发返佣的直邀好友用户名，标题统一使用“直邀好友 xxx 任务返佣”，下一行展示具体任务名称，并保留发生时间。
- 充值与返佣发放统一在人才激励的资金记录中查看。

### 注意事项

- 人才激励金和公会收益账户相互独立。
- 累计已发放不代表当前可用余额。
- 人才激励活动关闭后不再产生新的返佣支出，已有资金记录继续保留。
- 可用激励金余额为 0 时，返佣自动停止；充值后若活动仍处于开启状态，则继续按会长保存的设置返佣。

## 页面四：充值人才激励金

### 使用入口

人才激励 → 充值人才激励金

### 弹窗展示

- 用户当前个人余额。
- 充值目标：人才激励账户。
- 资金用途：人才邀请返佣。
- 管理层分配：不参与。
- 充值金额输入框、“全部”和“确认充值”操作。

### 充值结果

- 充值金额不能大于当前个人余额。
- 输入有效金额后允许确认充值。
- 充值成功后，个人余额扣除充值金额，可用激励金增加对应金额。
- 资金记录中新增一条人才激励金充值记录。

### 注意事项

- 充值成功后资金只进入人才激励账户。
- 充值不会改变可分配收益、累计已分配收益或累计总收益。
- 充值资金不会分配给会长或副会长。

## 关键状态

| 状态 | 页面展示 |
| --- | --- |
| 可分配收益为 0 | “立即分配”不可操作，页面提示当前收益已全部分配。 |
| 会长输入有效分配金额 | 展示管理层预计所得金额和分配后的剩余可分配收益。 |
| 会长确认主动分配 | 更新可分配收益和累计已分配收益，累计总收益不变，并新增“会长主动分配”记录。 |
| 待结算收益为 0 | 公会收益概览不展示待结算金额。 |
| 待结算收益大于 0 | 在公会收益页显示临时待结算提示。 |
| 人才激励未开启 | 引导用户开启人才激励。 |
| 人才激励已开启、余额为 0 | 返佣自动停止，提示激励金已用完并引导充值。 |
| 人才激励余额较低 | 提示用户补充人才激励金。 |
| 人才激励余额正常 | 展示可用余额，支持继续充值或管理设置。 |

## 相关页面

- `web/task_web/guild-management/index.html`
- `web/task_web/guild-management/fund-pool.html`
- `web/task_web/guild-management/fund-pool-description.html`
- `web/task_web/guild-management/talent-incentive.html`
- `web/task_web/guild-management/talent-incentive-description.html`
