|
|
@@ -0,0 +1,174 @@
|
|
|
+# 代理合营与入股-前端修改清单(2026-11-09)
|
|
|
+
|
|
|
+本清单汇总本轮代理相关改动里**前端需要修改的地方**,按三个前端分开。每项只写要改什么,接口细节见链接的完整文档。
|
|
|
+
|
|
|
+| 前端 | 章节 |
|
|
|
+|---|---|
|
|
|
+| 代理独立后台 | [一](#一代理独立后台) |
|
|
|
+| 总后台 | [二](#二总后台) |
|
|
|
+| PC 前台(melbet_sport-api) | [三](#三pc-前台melbet_sport-api) |
|
|
|
+
|
|
|
+通用约定不变:代理后台请求头 `Authorization: Bearer <agent_token>`,成功 `code=0`;业务错误 `code` 非 0,`msg` 可直接展示。金额为 4 位小数字符串。
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 一、代理独立后台
|
|
|
+
|
|
|
+### 1. 上传图片(新增,必改)
|
|
|
+
|
|
|
+| 项 | 内容 |
|
|
|
+|---|---|
|
|
|
+| 接口 | `POST /agent/upload/image`,`multipart/form-data`,字段 `image`(jpg/jpeg/png/webp,≤10MB) |
|
|
|
+| 返回 | `{"path":"https://…/storage/images/xxx.png"}` |
|
|
|
+| 要改 | 代理后台所有上传(充值凭证、USDT 凭证、人工提现收款码)都改调这个接口。**不要再调总后台或会员端的上传接口**,否则返回 `101011 请登录` |
|
|
|
+
|
|
|
+文档:[代理充值-前端接入](../代理/代理充值-前端接入.md) 开头「上传图片」。
|
|
|
+
|
|
|
+### 2. 菜单按代理类型切换(必改)
|
|
|
+
|
|
|
+登录或 `GET /agent/profile` 返回 `type`:`1` 合营、`2` 入股(股东)。
|
|
|
+
|
|
|
+| 菜单 | 合营 | 入股 |
|
|
|
+|---|---|---|
|
|
|
+| 首页、资金账户(充值 / 提现)、修改密码、登录日志 | 显示 | 显示 |
|
|
|
+| 分成方案、合营分成记录 | 显示 | 隐藏 |
|
|
|
+| 所有会员、合营日报、财务统计、注单统计 | 显示 | **隐藏**(接口对入股代理返回「入股代理不能查看会员明细,请使用周期报表」) |
|
|
|
+| 入股 | 隐藏 | 显示 |
|
|
|
+| 周期报表(新) | 显示 | 显示 |
|
|
|
+
|
|
|
+### 3. 首页(接口不变,改文案)
|
|
|
+
|
|
|
+`GET /agent/dashboard` 参数和字段不变,后端按 token 自动返回范围:合营为名下会员,入股为全平台。
|
|
|
+
|
|
|
+- 新字段 `scope`:`own` / `platform`。标题按它显示「名下会员汇总统计」或「平台汇总统计」。
|
|
|
+- 欢迎语按 `type` 区分,不要固定写「股东」:合营显示「尊敬的合营代理」,入股显示「尊敬的股东」。
|
|
|
+- 「总佣金金额」:入股代理隐藏;合营代理建议改名为「合营分成」。
|
|
|
+- 不展示 `agent_count`(已废弃)。
|
|
|
+
|
|
|
+文档:[代理首页](../代理/代理首页.md)。
|
|
|
+
|
|
|
+### 4. 周期报表(新页面)
|
|
|
+
|
|
|
+| 项 | 内容 |
|
|
|
+|---|---|
|
|
|
+| 接口 | `GET /agent/reports/period?period=day\|week\|month&start_date=&end_date=` |
|
|
|
+| 页面 | 日期范围 + 按日 / 按周 / 按月切换;`totals` 合计卡片;`list` 表格(最新在前,可展开 `categories` 游戏分类) |
|
|
|
+| 字段 | 新增会员、投注人数、注单数、充值、提现、人工加扣款、优惠、返水、投注、有效投注、会员输赢、公司盈亏;合营代理多一个 `agent_share` |
|
|
|
+
|
|
|
+文档:[代理周期报表-前端接入](../代理/代理周期报表-前端接入.md)。
|
|
|
+
|
|
|
+### 5. 充值(新增人民币充值)
|
|
|
+
|
|
|
+| 项 | 接口 |
|
|
|
+|---|---|
|
|
|
+| 通道列表 | `GET /agent/wallet/recharge/channels`(同会员 `GET /api/wallet/channel` 格式) |
|
|
|
+| 在线充值(808/NO/JD/三斤) | `POST /agent/wallet/recharge/online`:`amount`(≤2 位小数)、`payment_type`;打开返回的 `url` 或展示二维码 `image` |
|
|
|
+| 人工充值 | `POST /agent/wallet/recharge/manual` 提交金额 → 等 `status=4` 后展示 `pay_data` 收款信息 → `POST /agent/wallet/recharge/manual/image` 上传凭证 → 等审核 |
|
|
|
+| 撤回人工充值 | `POST /agent/wallet/recharge/manual/cancel`(`status=0/4` 可撤回) |
|
|
|
+| 人民币充值记录 | `GET /agent/wallet/payment-orders`(状态 0~7) |
|
|
|
+| USDT 充值 | 不变:`/agent/wallet/recharge/address`、`POST /agent/wallet/recharge`、`/agent/wallet/recharges` |
|
|
|
+
|
|
|
+页面:通道 `value=usdt` 走 USDT,`rgcz` 走人工充值,其他走在线充值。记录页分「人民币充值」「USDT 充值」两个标签。
|
|
|
+
|
|
|
+文档:[代理充值-前端接入](../代理/代理充值-前端接入.md)。
|
|
|
+
|
|
|
+### 6. 提现(支持全部提现通道)
|
|
|
+
|
|
|
+| 项 | 改动 |
|
|
|
+|---|---|
|
|
|
+| 通道列表 | 新增 `GET /agent/wallet/withdraw/channels`(同会员 `withdrawChannel`,带 `requires_*` 和人工提现的 `payout_methods`) |
|
|
|
+| 提现账户 | `POST /agent/wallet/accounts` 新增 `type`(通道,默认 `usdt`)及 `card_no`、`bank_name`、`bank_branch`、`payout_method`、`qr_image`、`real_name`;`GET /agent/wallet/accounts` 返回全部通道,可按 `type` 筛选 |
|
|
|
+| 申请提现 | USDT 账户仍传 `usdt_amount`;**其他通道传 `amount`**(人民币,≤2 位小数) |
|
|
|
+| 提现记录 | 新状态 `processing` 代付中、`failed` 代付失败;新字段 `channel`、`status_text`、`pay_no` |
|
|
|
+| 真实姓名 | 除 usdt、JDpay 外都要实名;代理没有真实姓名时首次绑卡要填 `real_name` |
|
|
|
+
|
|
|
+文档:[代理提现-前端接入](../代理/代理提现-前端接入.md)。
|
|
|
+
|
|
|
+### 7. 入股代理:充值锁定 7 天(资金页)
|
|
|
+
|
|
|
+`GET /agent/wallet/summary` 对入股代理新增:
|
|
|
+
|
|
|
+- `locked_amount`:冻结中(充值未满 N 天)的金额;
|
|
|
+- `recharge_lock_days`:锁定天数 N;
|
|
|
+- `recharge_locks`:明细(`amount`、`remaining`、`recharged_at`、`unlock_at`)。
|
|
|
+
|
|
|
+页面展示「冻结中 X(充值 N 天后可提现)」及到期时间。锁定中的钱可以直接买股份。提现超额时提示「可提现余额不足(充值未满 7 天的金额暂不可提现)」。
|
|
|
+
|
|
|
+文档:[代理后台调整-前端接入](../代理/代理后台调整-前端接入.md) 第 2 节「`GET /agent/wallet/summary`」。
|
|
|
+
|
|
|
+### 8. 入股页(接口不变)
|
|
|
+
|
|
|
+`GET /agent/equity` 返回配置、持股和购买记录 `orders`;下单 `POST /agent/equity/orders`,取消 `POST /agent/equity/orders/cancel`。
|
|
|
+
|
|
|
+- 下单返回 `status=completed`:提示「开通成功」。
|
|
|
+- 下单返回 `status=pending_payment`:提示「请充值,到账后自动开通」,并引导到充值页。
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 二、总后台
|
|
|
+
|
|
|
+### 1. 代理人民币充值(新菜单 `agentPaymentOrders`)
|
|
|
+
|
|
|
+| 操作 | 接口 |
|
|
|
+|---|---|
|
|
|
+| 列表 | `GET /admin/agent/payment-orders`(`type=1` 在线 / `3` 人工) |
|
|
|
+| 人工充值:发送收款信息 | `POST /admin/agent/payment-orders/pay-data` |
|
|
|
+| 人工充值:审核 | `POST /admin/agent/payment-orders/audit`(2 通过 / 3 驳回) |
|
|
|
+| 在线充值:拒绝 / 查单 | `POST /admin/agent/payment-orders/reject`、`/query` |
|
|
|
+| 角标 | `GET /admin/paymentOrder/unProcessed` 的 `agentRecharge` |
|
|
|
+
|
|
|
+注意:代理的**人工充值不在**「代理充值记录」`/admin/agent/recharges` 里,那里只有 USDT 充值。
|
|
|
+
|
|
|
+### 2. 入股配置(`GET/POST /admin/agent/settings`)新增字段
|
|
|
+
|
|
|
+- `recharge_channel_group_id`:代理用的充值 / 提现**通道组合**,下拉用现有通道组合列表,已删除的组合不能选。
|
|
|
+- `equity_recharge_lock_days`:入股代理充值锁定天数,默认 7,`0` 不锁定。
|
|
|
+
|
|
|
+### 3. 代理提现(`/admin/agent/withdrawals`)
|
|
|
+
|
|
|
+- 新筛选 `channel`;新状态 `processing` 代付中、`failed` 代付失败。
|
|
|
+- 列表展示 `channel`、`account_snapshot`(收款信息)、`pay_no`。
|
|
|
+- 按钮按通道区分:
|
|
|
+ - USDT / 人工提现:「通过」→ 人工打款后点「已打款」;
|
|
|
+ - 三方通道:「通过」即发起代付(建议按钮文案为「代付」),之后等回调;
|
|
|
+ - `processing` 只展示,不能驳回。
|
|
|
+
|
|
|
+### 4. 入股购买记录(新菜单 `agentEquityOrders`)
|
|
|
+
|
|
|
+- 列表 `GET /admin/agent/equity-orders`:筛选代理、账号、订单号、状态、下单 / 开通时间;`summary` 合计。
|
|
|
+- 取消待付款订单 `POST /admin/agent/equity-orders/cancel`(`id`、`remark` 必填)。
|
|
|
+
|
|
|
+文档:[代理入股购买记录-前端接入](../总后台/代理入股购买记录-前端接入.md)。
|
|
|
+
|
|
|
+### 5. 独立代理申请审核
|
|
|
+
|
|
|
+- 列表 `GET /admin/agent/applications` 新增 `type`、`type_text` 字段和 `type` 筛选。
|
|
|
+- 审核弹窗展示会员选择的类型,并提供类型下拉(默认值为申请的 `type`)。通过时不传 `type` 就按会员选的类型开通。
|
|
|
+
|
|
|
+文档:[独立代理申请-审核接入](../总后台/独立代理申请-审核接入.md)。
|
|
|
+
|
|
|
+以上总后台各项的完整说明见 [代理合营与入股-前端接入](../总后台/代理合营与入股-前端接入.md)。
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 三、PC 前台(melbet_sport-api)
|
|
|
+
|
|
|
+### 独立代理申请:选择代理类型
|
|
|
+
|
|
|
+| 项 | 内容 |
|
|
|
+|---|---|
|
|
|
+| 状态 | `GET /api/agent/status` 新增 `type`、`type_text`、`type_options`(`[{value:1,label:"合营",enabled:true},{value:2,label:"入股",enabled:false}]`) |
|
|
|
+| 申请 | `POST /api/agent/apply` 新增参数 `type`(`1` 合营 / `2` 入股,不传为合营) |
|
|
|
+| 要改 | 申请表单加「代理类型」单选,选项来自 `type_options`,`enabled=false` 的置灰;提交带 `type`;审核中 / 已开通状态展示 `type_text` |
|
|
|
+| 新错误 | `代理类型错误`、`暂未开放入股代理申请` |
|
|
|
+
|
|
|
+文档:melbet_sport-api 仓库 `docs/独立代理申请-会员接入.md`(bot-28 副本:[独立代理申请-会员接入](../前端接口/独立代理申请-会员接入.md))。
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 四、上线前后端要做的(前端联调前确认)
|
|
|
+
|
|
|
+1. 执行全部迁移:`php artisan migrate --force`。涉及代理人民币充值、提现通道、代理申请类型、入股购买记录菜单、入股充值锁定。缺迁移时相关接口会报「系统处理失败,请稍后重试」。
|
|
|
+2. 给后台角色勾选新菜单和按钮:代理人民币充值、入股购买记录。
|
|
|
+3. 补算会员日报历史(周期报表要用):`nohup php artisan report:member-daily --all > storage/logs/member-daily-backfill.log 2>&1 &`。
|
|
|
+4. 在「入股配置」设置通道组合;入股代理要开放申请或购买时,打开入股开关并设置价格。
|