1.优化渠道管理中直属投注额度和总投注额度

2.管理员管理中三个菜单数据显示限制
This commit is contained in:
2026-05-30 15:53:36 +08:00
parent 16a7ef7413
commit f6197a9af5
13 changed files with 195 additions and 92 deletions

View File

@@ -14,7 +14,8 @@ Documents the **Channel Management** page (`/admin/channel`): summary cards, lis
| Enabled | `status = 1` |
| Pending dividend (count) | `carryover_balance > 0` |
| Pending dividend (amount) | Sum of those balances |
| Paid dividend | Sum of paid `agent_commission_record` in scope; clickable dialog requires `viewDividendRecords` |
| Paid dividend | Sum of paid `agent_commission_record` in scope; clickable dialog requires `channel/index` |
| Company total bet | Total bets in readable scope; clickable records dialog requires `channel/index` |
List filters: **All / With balance / No balance / Enabled only / Disabled only** (UI search only).
@@ -36,9 +37,7 @@ List filters: **All / With balance / No balance / Enabled only / Disabled only**
| Node | Label | Behavior |
|------|-------|----------|
| `channel/viewDividendRecords` | Paid dividend records | Top card + dialog |
| `channel/viewDirectBetRecords` | Direct bet records | Direct bet column click |
| `channel/viewSettlementBetRecords` | Settlement-scope bets | Row action |
| `channel/index` | View | List, stat card clicks, bet/dividend record dialogs |
| `channel/manualSettle` | Manual settle | Preview + submit (readable channel) |
| `channel/batchSettlePending` | Batch settle | Writable enabled channels in scope |
@@ -59,8 +58,8 @@ Re-login after role changes to refresh `authNode`.
| Entry | API | Data |
|-------|-----|------|
| Direct bet amount | `directBetRecordList` | All play records for channel |
| View settlement bets | `settlementBetRecordList` | `status = 2` only |
| Direct bet amount (column) | `directBetRecordList` | All play records for that channel |
| Company total bet (top card) | `companyBetRecordList` | All play records in readable scope |
**Filters (GET):** `period_no`, `user_keyword`, `result_number`, `pick_number`, `win_hit` (`won`/`lost`/`pending`), `page`, `limit`.

View File

@@ -79,9 +79,9 @@
* **创建总代/子代账号**:在 **管理员管理**`/admin/auth/admin`)维护代理树:`parent_admin_id``commission_share_rate`(顶级角色组从渠道总佣金分得 %,子代理从上级实得抽取 %)、`channel_id`、邀请码。
* **代理树状图 (Tree View)**:管理员列表以树形展示;非超管仅见本人及全部下级。
* **渠道管理页**`/admin/channel`
* 顶部统计:渠道数、待分红、已分红(可点开记录);列表支持分红余额/启用状态筛选。
* 顶部统计:渠道数、待分红、已分红、**公司总投注额**(可点开全部下注记录);列表支持分红余额/启用状态筛选。
* **数据范围**`AdminChannelScopeService`;全平台只读条件见 `docs/渠道管理后台说明.md` §3。
* **操作**查看总投注金额 / 直属投注记录(弹窗 + 筛选);手动结算(超管或 `channel/manualSettle`)。
* **操作**直属投注额列点击 / 公司总投注额卡片(弹窗 + 筛选);手动结算(超管或 `channel/manualSettle`)。
* **渠道佣金结算**
* 按渠道 `agent_mode` 与已结算注单计算渠道总佣金(非充值口径)。
* 按代理树拆分各管理员实得,写入 `agent_commission_record`**即时入账** `admin_wallet`

View File

@@ -16,7 +16,8 @@
| 启用渠道 | `status = 1` 的渠道数 |
| 待分红渠道 | `carryover_balance > 0` 的渠道数 |
| 待分红总额 | 上述渠道 `carryover_balance` 合计 |
| 已分红金额 | 可读范围内渠道下,已发放佣金(`agent_commission_record.status = 1`)合计;**可点击**打开已分红记录弹窗(需 `viewDividendRecords` 权限 |
| 公司总投注额 | 可读范围内全部玩家总投注(含未结算);**可点击**打开全部下注记录(需 `channel/index` |
| 已分红金额 | 可读范围内渠道下,已发放佣金(`agent_commission_record.status = 1`)合计;**可点击**打开已分红记录弹窗(需 `channel/index` |
列表上方筛选:**全部 / 有分红余额 / 无分红余额 / 仅启用 / 仅停用**(前端 `search` 条件,不改变数据范围规则)。
@@ -54,17 +55,15 @@
### 4.1 常用列
- 渠道标识、名称、代理模式、联营负结转、契约编号、结算周期等
- **直属投注额**:该渠道`game_play_record` 投注合计**可点击**打开直属下注记录弹窗(需 `viewDirectBetRecords`
- 操作列:**查看总投注金额**、**手动结算**、编辑、删除(后两者受写权限约束
- **直属投注额**:该渠道名下全部玩家的总投注额(含未结算)**可点击**打开该渠道直属玩家游戏下注记录(需 `channel/index`
- 顶部统计卡片 **公司总投注额**:当前账号可见渠道范围内的真实码量合计(含未结算);**可点击**打开全部下注记录明细(需 `channel/index`
- 操作列:**手动结算**、编辑、删除(后两者受写权限约束)
### 4.2 操作按钮权限
| 按钮权限节点 | 名称 | 行为 |
|--------------|------|------|
| `channel/index` | 查看 | 列表与详情 |
| `channel/viewDividendRecords` | 查看已分红记录 | 顶部「已分红金额」卡片与弹窗 |
| `channel/viewDirectBetRecords` | 查看直属投注记录 | 「直属投注额」列点击 |
| `channel/viewSettlementBetRecords` | 查看总投注金额 | 操作列;分红口径已结算注单 |
| `channel/index` | 查看 | 列表、统计卡片点击、下注/分红记录弹窗 |
| `channel/manualSettle` | 手动结算 | 操作列;预览并提交渠道结算(见 §5 |
| `channel/batchSettlePending` | 一键批量结算 | 批量结算当前账号**可写范围**内启用渠道 |
| `channel/add` / `edit` / `del` | 增删改 | 须对目标渠道具备写权限 |
@@ -91,8 +90,8 @@
| 入口 | 接口 | 数据范围 |
|------|------|----------|
| 直属投注额 | `GET /admin/channel/directBetRecordList` | 该渠道全部游玩记录 |
| 查看总投注额 | `GET /admin/channel/settlementBetRecordList` | 该渠道 **已结算** 记录(`status = 2`,参与分红口径 |
| 直属投注额(列点击) | `GET /admin/channel/directBetRecordList` | 该渠道名下玩家 **全部** 游玩记录(含未结算) |
| 公司总投注额(顶部卡片) | `GET /admin/channel/companyBetRecordList` | 当前账号可见渠道范围内 **全部** 游玩记录(含未结算 |
### 6.1 顶部统计Card
@@ -124,7 +123,7 @@
## 7. 已分红记录弹窗
- **接口**`GET /admin/channel/dividendRecordList`
- **权限**`channel/viewDividendRecords`
- **权限**`channel/index`
- **字段**:结算单号、渠道名、代理账号、分红金额、结算周期、发放时间等
---