文件
fenleixinxi/application/api/controller/AdminDist.php
linda a09a0a10be feat(api): 新增小程序用户端与后台管理端 v1 业务接口(62 端点)
一、基础设施
- route.php:58 条路由覆盖 /api/v1/**;:id 用 \d+ 约束、长路径优先
- api/controller/V1.php:响应适配为 {code,message,data}(FastAdmin 原生 {code,msg,time,data} 不兼容);
  Authorization Bearer 鉴权;统一分页;业务公共 userInfo/ext/flow/notify/adminLog
- admin/command/FcInstall.php:19 张 fa_fc_* 表 + 种子数据,幂等可重跑

二、控制器 17 个
- 用户端 Auth/Home/Post/Member/Distribution/Message/Setting
- 后台端 AdminDashboard/AdminMerchant/AdminMember/AdminPost/AdminComment/
  AdminDist/AdminOrder/AdminFinance/AdminRbac/AdminSetting

三、契约一致性
- 字段与小程序 common/mock/data.js 逐字段对齐,Mock 与真实接口可对拍
- 实现 BR-01~BR-12,错误文案与前端 mock 完全一致
- 详情联系方式强制脱敏,付费/会员方可解锁

四、验证
- tools/verify-api.mjs:63 端点契约 + 12 条业务规则 + 8 步双端闭环
- docs/05-后端实现规范.md
2026-10-15 14:36:26 +08:00

142 行
5.0 KiB
PHP

此文件含有模棱两可的 Unicode 字符

此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的,可以安全地忽略该警告。 使用 Escape 按钮显示他们。

<?php
namespace app\api\controller;
use think\Db;
/**
* 后台管理端 · 分销管理(Module-ADM-DIST)
* 路由:
* GET /api/v1/admin/dist/setting AD1 分销设置读取
* POST /api/v1/admin/dist/setting AD2 分销设置保存
* GET /api/v1/admin/dist/withdraws AD3 提现申请列表
* POST /api/v1/admin/dist/withdraw/:id/pay AD4 提现审核(打款/驳回)
*/
class AdminDist extends V1
{
/**
* AD1 分销设置读取
* GET /api/v1/admin/dist/setting → {enabled,level,level1Rate,level2Rate,settleCycle,minWithdraw}
*/
public function setting()
{
if ($this->request->isPost()) {
$this->saveSetting();
}
$this->ok($this->distConfig());
}
/**
* AD2 分销设置保存
* POST /api/v1/admin/dist/setting 入参 {enabled,level,level1Rate,level2Rate,settleCycle,minWithdraw}
* 规则 BR-08:一级+二级分佣比例不能超过 100%
*/
public function saveSetting()
{
$enabled = $this->input('enabled', $this->cfg('dist.enabled', 1));
$level = (int)$this->input('level', $this->cfg('dist.level', 2));
$level1Rate = (float)$this->input('level1Rate', $this->cfg('dist.level1Rate', 20));
$level2Rate = (float)$this->input('level2Rate', $this->cfg('dist.level2Rate', 10));
$settleCycle = (string)$this->input('settleCycle', $this->cfg('dist.settleCycle', 'T+7'));
$minWithdraw = (float)$this->input('minWithdraw', $this->cfg('dist.minWithdraw', 50));
if ($level1Rate + $level2Rate > 100) {
$this->fail('一级+二级分佣比例不能超过 100%');
}
$this->setCfg('dist.enabled', $enabled ? 1 : 0);
$this->setCfg('dist.level', $level);
$this->setCfg('dist.level1Rate', $level1Rate);
$this->setCfg('dist.level2Rate', $level2Rate);
$this->setCfg('dist.settleCycle', $settleCycle);
$this->setCfg('dist.minWithdraw', $minWithdraw);
$this->adminLog('修改分销设置');
$this->ok($this->distConfig());
}
/**
* AD3 提现申请列表
* GET /api/v1/admin/dist/withdraws → 数组 [{id,withdrawNo,user,amount,status,channel,createdAt}]
*/
public function withdraws()
{
$rows = Db::name('fc_withdraw')->alias('w')
->join('user u', 'u.id = w.user_id', 'LEFT')
->field('w.*, u.nickname AS nickname')
->order('w.createtime desc')
->select();
$list = [];
foreach ($rows as $row) {
$list[] = [
'id' => (int)$row['id'],
'withdrawNo' => (string)$row['withdraw_no'],
'user' => (string)$row['nickname'],
'amount' => (float)$row['amount'],
'status' => (string)$row['status'],
'channel' => (string)$row['channel'],
'createdAt' => $this->iso($row['createtime']),
];
}
$this->ok($list);
}
/**
* AD4 提现审核
* POST /api/v1/admin/dist/withdraw/:id/pay 入参 {op,reason?} → {id,status}
* 规则 BR-09:op=reject 时 reason 必填
*/
public function handleWithdraw()
{
$id = (int)$this->request->param('id', 0);
$op = (string)$this->input('op', '');
$reason = trim((string)$this->input('reason', ''));
if ($op === 'reject' && $reason === '') {
$this->fail('驳回需填写原因');
}
$withdraw = Db::name('fc_withdraw')->where('id', $id)->find();
if (!$withdraw) {
$this->fail('提现记录不存在', 404);
}
if ($op === 'reject') {
$status = 'rejected';
Db::name('fc_withdraw')->where('id', $id)->update([
'status' => $status,
'reason' => $reason,
]);
$this->notify($withdraw['user_id'], 'system', '提现被驳回', '您的提现申请被驳回:' . $reason);
} else {
$status = 'paid';
Db::name('fc_withdraw')->where('id', $id)->update([
'status' => $status,
'paytime' => time(),
]);
$this->flow('expense', '佣金提现', $withdraw['amount'], 0, $id);
$this->notify($withdraw['user_id'], 'system', '提现已打款', '您的提现申请已打款,请注意查收。');
}
$this->adminLog('处理提现 #' . $id . ' 结果' . $status);
$this->ok(['id' => (int)$id, 'status' => $status]);
}
/** 组装分销设置结构 */
protected function distConfig()
{
return [
'enabled' => (bool)$this->cfg('dist.enabled', 1),
'level' => (int)$this->cfg('dist.level', 2),
'level1Rate' => (float)$this->cfg('dist.level1Rate', 20),
'level2Rate' => (float)$this->cfg('dist.level2Rate', 10),
'settleCycle' => (string)$this->cfg('dist.settleCycle', 'T+7'),
'minWithdraw' => (float)$this->cfg('dist.minWithdraw', 50),
];
}
}