doge 1 週間 前
親
コミット
ad64412c77

+ 26 - 0
app/Http/Controllers/agent/UploadController.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace App\Http\Controllers\agent;
+
+use App\Constants\Util;
+use App\Http\Controllers\AgentApiController;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Storage;
+
+/** 代理后台上传图片(充值凭证、人工提现收款码等),存储方式和返回格式同总后台 /admin/upload/uploadFile。 */
+class UploadController extends AgentApiController
+{
+    public function image(Request $request)
+    {
+        return $this->execute(function () use ($request) {
+            $request->validate(['image' => ['required', 'image', 'mimes:jpg,jpeg,png,webp', 'max:10240']]);
+            $image = $request->file('image');
+            // 扩展名按文件内容判断,不信任客户端文件名
+            $name = md5_file($image->getRealPath()) . '.' . ($image->extension() ?: 'webp');
+            $path = Storage::disk('public')->exists('images/' . $name)
+                ? 'images/' . $name
+                : $image->storeAs('images', $name, 'public');
+            return ['path' => Util::ensureUrl(Storage::url($path))];
+        });
+    }
+}

+ 9 - 2
docs/代理/代理充值-前端接入.md

@@ -9,6 +9,13 @@
 
 请求头带 `Authorization: Bearer <agent_token>`。返回结构:`{"code":0,"timestamp":…,"msg":"OK","data":…}`,业务错误时 `code` 非 0,`msg` 可以直接展示。
 
+## 上传图片 `POST /agent/upload/image`
+
+充值凭证、人工提现收款码等图片先用这个接口上传,再把返回的 `path` 作为 `image` / `qr_image` 提交。**不要调用总后台或会员端的上传接口**(代理 token 不通用,会返回 `101011 请登录`)。
+
+- 请求:`multipart/form-data`,字段 `image`;只支持 `jpg`、`jpeg`、`png`、`webp`,最大 10MB;每个代理每分钟最多 30 次。
+- 返回:`{"path":"https://api.example.com/storage/images/<md5>.png"}`。
+
 ## 0. 本次改动
 
 | 接口 | 改动 |
@@ -135,7 +142,7 @@ GET /agent/wallet/recharge/channels  →  渲染通道
 | 参数 | 必填 | 说明 |
 |---|---:|---|
 | `id` | 是 | 订单 ID |
-| `image` | 是 | 转账截图 URL(先用现有上传接口上传图片) |
+| `image` | 是 | 转账截图 URL(先用 `POST /agent/upload/image` 上传) |
 
 提交后 `status=5`(待审核)。不是 `status=4` 时调用返回 `待处理中,请稍后`。
 
@@ -234,7 +241,7 @@ GET /agent/wallet/recharge/channels  →  渲染通道
 | `net` | 是 | `trc20` / `erc20` |
 | `usdt_amount` | 是 | 转账的 USDT 数量,最多 4 位小数 |
 | `to_address` | 是 | 转入的平台地址(充值地址接口返回的 `address`) |
-| `image` | 是 | 转账截图 URL |
+| `image` | 是 | 转账截图 URL(先用 `POST /agent/upload/image` 上传) |
 
 总后台审核通过后入账。错误:`当前为自动到账模式,转账后无需提交凭证`、`收款地址不是平台当前的收款地址`、`待确认的充值过多,请等待审核`(最多 5 条待确认)。
 

+ 2 - 0
docs/代理/代理提现-前端接入.md

@@ -20,6 +20,8 @@
 
 请求头带 `Authorization: Bearer <agent_token>`。返回结构:`{"code":0,"timestamp":…,"msg":"OK","data":…}`,业务错误时 `code` 非 0,`msg` 可以直接展示。
 
+> 人工提现的收款码 `qr_image` 先用 `POST /agent/upload/image` 上传(说明见 [代理充值-前端接入.md](代理充值-前端接入.md) 开头),把返回的 `path` 传进来。
+
 ## 0. 本次改动
 
 | 接口 | 改动 |

+ 8 - 0
docs/前端交付/README.md

@@ -2,6 +2,14 @@
 
 本目录是2026-10-26的接口文档交付副本,按**项目 → 前台/后台/代理端**组织。
 
+## 代理后台上传图片修正(2026-11-09)
+
+- [代理后台上传图片-前端修正单](代理后台上传图片-前端修正单.md):上传时提示 `101011 请登录`,原因是用错了接口。代理后台的上传全部改用 `POST /agent/upload/image`,把返回的 `path` 作为凭证 `image` 或收款码 `qr_image` 提交。
+
+## 代理合营与入股(2026-11-09)
+
+- **先看** [代理合营与入股-前端修改清单](代理合营与入股-前端修改清单.md):代理独立后台、总后台、PC 前台分别要改什么。内容包括上传图片、菜单按类型切换、首页、周期报表、人民币充值、全通道提现、入股充值锁定、入股购买记录和代理申请类型,以及上线前后端要做的事。
+
 ## 邀请升级奖励(2026-11-04)
 
 新增固定独立活动,业务类型 `10`:会员的直属下级分享等级达到配置档位时,邀请人获得奖金,跨档叠加(等级2奖8、等级4奖18,升到等级4共26),只统计活动首次上架后绑定的下级,手动领取进可用余额。本活动只有正文,没有标题。

+ 174 - 0
docs/前端交付/代理合营与入股-前端修改清单.md

@@ -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. 在「入股配置」设置通道组合;入股代理要开放申请或购买时,打开入股开关并设置价格。

+ 72 - 0
docs/前端交付/代理后台上传图片-前端修正单.md

@@ -0,0 +1,72 @@
+# 代理后台上传图片-前端修正单(2026-11-09)
+
+## 问题
+
+代理后台上传图片时返回:
+
+```json
+{"code":101011,"msg":"请登录","data":[]}
+```
+
+原因:代理后台之前没有自己的上传接口,前端调用的是总后台(`/admin/upload/uploadFile`)或会员端的上传接口。那两个接口只认总后台或会员的登录凭证,不认代理 token,所以提示「请登录」。
+
+## 修正
+
+代理后台所有上传图片的地方,都改为调用代理后台专用接口 **`POST /agent/upload/image`**。
+
+### 请求
+
+| 项 | 说明 |
+|---|---|
+| 地址 | `POST /agent/upload/image` |
+| 请求头 | `Authorization: Bearer <agent_token>`(和代理后台其他接口相同) |
+| 格式 | `multipart/form-data` |
+| 字段 | `image`:图片文件 |
+| 限制 | 只支持 `jpg`、`jpeg`、`png`、`webp`,最大 10MB;每个代理每分钟最多 30 次 |
+
+### 返回
+
+```json
+{
+  "code": 0,
+  "timestamp": 1794193222,
+  "msg": "OK",
+  "data": {"path": "https://api.example.com/storage/images/3f2b9c0e8d7a6b5c4d3e2f1a0b9c8d7e.png"}
+}
+```
+
+`data.path` 是图片的完整地址,直接作为下面接口的参数提交。
+
+### 失败
+
+`code` 非 0,`msg` 可以直接提示,例如:
+
+| `msg` | 原因 |
+|---|---|
+| `image 必须是图片` 等校验信息 | 没传文件、不是图片、格式不对或超过 10MB |
+| HTTP 状态码 429 | 1 分钟内上传超过 30 次,稍后再试(这种情况按 HTTP 状态判断,不是业务 `code`) |
+| `请登录` | 代理 token 无效或过期(不是接口用错了) |
+
+## 需要修改的页面
+
+| 页面 | 上传后把 `path` 传给 |
+|---|---|
+| 人工充值 → 上传转账凭证 | `POST /agent/wallet/recharge/manual/image` 的 `image` |
+| USDT 充值(人工确认模式)→ 上传转账截图 | `POST /agent/wallet/recharge` 的 `image` |
+| 提现账户 → 人工提现(微信 / 支付宝)收款码 | `POST /agent/wallet/accounts` 的 `qr_image` |
+| 其他代理后台上传图片的地方(如有) | 同样改用本接口 |
+
+示例:
+
+```js
+const form = new FormData();
+form.append('image', file);
+const { data } = await agentApi.post('/agent/upload/image', form); // 代理后台的请求封装,自动带 agent token
+await agentApi.post('/agent/wallet/recharge/manual/image', { id: orderId, image: data.path });
+```
+
+## 验收
+
+1. 代理登录后上传 png 或 jpg,返回 `code=0` 和 `data.path`,在浏览器打开 `path` 能看到图片。
+2. 用这个 `path` 提交人工充值凭证,总后台「代理人民币充值」能看到凭证图片。
+3. 上传非图片文件,提示校验错误,不会出现「请登录」。

+ 1 - 0
routes/agent.php

@@ -62,4 +62,5 @@ Route::middleware('agent.auth')->group(function () {
     Route::post('/equity/orders/cancel', [EquityController::class, 'cancel']);
     Route::get('/reports', [ReportController::class, 'index']);
     Route::get('/reports/period', [ReportController::class, 'period']);
+    Route::post('/upload/image', [\App\Http\Controllers\agent\UploadController::class, 'image'])->middleware('throttle:30,1');
 });

+ 44 - 0
tests/Integration/AgentUploadTest.php

@@ -0,0 +1,44 @@
+<?php
+
+namespace Tests\Integration;
+
+use App\Http\Controllers\agent\UploadController;
+use Illuminate\Filesystem\FilesystemManager;
+use Illuminate\Http\Request;
+use Illuminate\Http\UploadedFile;
+use PHPUnit\Framework\TestCase;
+use Tests\Support\AgentTestEnvironment;
+
+/** 代理后台上传图片 POST /agent/upload/image。 */
+class AgentUploadTest extends TestCase
+{
+    use AgentTestEnvironment;
+
+    public function test_agent_uploads_image_and_rejects_other_files(): void
+    {
+        $root = sys_get_temp_dir() . '/agent-upload-' . bin2hex(random_bytes(4));
+        config(['app.url' => 'https://api.example.test', 'filesystems.default' => 'public',
+            'filesystems.disks.public' => ['driver' => 'local', 'root' => $root, 'url' => 'https://api.example.test/storage', 'visibility' => 'public']]);
+        $this->app->instance('filesystem', new FilesystemManager($this->app));
+        $png = tempnam(sys_get_temp_dir(), 'img');
+        file_put_contents($png, base64_decode('iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII='));
+        try {
+            $call = function (UploadedFile $file) {
+                $request = Request::create('/agent/upload/image', 'POST', [], [], ['image' => $file]);
+                $request->attributes->set('agent', $this->agent());
+                $this->app->instance('request', $request);
+                return (new UploadController())->image($request)->getData(true);
+            };
+            $ok = $call(new UploadedFile($png, 'proof.exe', 'image/png', null, true));
+            $this->assertSame(0, $ok['code'], (string) $ok['msg']);
+            $this->assertMatchesRegularExpression('#^https://api\.example\.test/storage/images/[0-9a-f]{32}\.png$#', $ok['data']['path'], 'extension follows file content');
+            $this->assertFileExists($root . '/images/' . basename($ok['data']['path']));
+
+            $txt = tempnam(sys_get_temp_dir(), 'txt'); file_put_contents($txt, 'not an image');
+            $this->assertNotSame(0, $call(new UploadedFile($txt, 'a.png', 'image/png', null, true))['code']);
+        } finally {
+            @unlink($png);
+            if (is_dir($root)) { array_map('unlink', glob($root . '/images/*') ?: []); @rmdir($root . '/images'); @rmdir($root); }
+        }
+    }
+}