一、基础设施
- 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
202 行
6.2 KiB
PHP
202 行
6.2 KiB
PHP
<?php
|
||
|
||
namespace app\api\controller;
|
||
|
||
use think\Db;
|
||
|
||
/**
|
||
* 用户端 · 会员中心(Module-MEMBER)
|
||
* 路由:
|
||
* GET /api/v1/member/plans M1 会员套餐
|
||
* GET /api/v1/member/benefits M2 会员权益
|
||
* POST /api/v1/member/open M3 开通会员
|
||
* GET /api/v1/member/orders M4 我的订单
|
||
* GET /api/v1/member/assets M5 我的资产
|
||
*/
|
||
class Member extends V1
|
||
{
|
||
/**
|
||
* M1 会员套餐
|
||
* GET /api/v1/member/plans → [{planId,name,price,originPrice,days,tag}]
|
||
* 规则:仅 enabled=1,按 sort asc
|
||
*/
|
||
public function plans()
|
||
{
|
||
$rows = Db::name('fc_plan')
|
||
->where('enabled', 1)
|
||
->order('sort asc')
|
||
->select();
|
||
|
||
$list = [];
|
||
foreach ($rows as $row) {
|
||
$list[] = [
|
||
'planId' => (string)$row['plan_code'],
|
||
'name' => (string)$row['name'],
|
||
'price' => (float)$row['price'],
|
||
'originPrice' => (float)$row['origin_price'],
|
||
'days' => (int)$row['days'],
|
||
'tag' => (string)$row['tag'],
|
||
];
|
||
}
|
||
$this->ok($list);
|
||
}
|
||
|
||
/**
|
||
* M2 会员权益
|
||
* GET /api/v1/member/benefits → {freeView,postDiscount,distRate,benefits[]}
|
||
* 规则:读配置 member.benefit,未配置返回默认
|
||
*/
|
||
public function benefits()
|
||
{
|
||
$default = [
|
||
'freeView' => 20,
|
||
'postDiscount' => '8 折',
|
||
'distRate' => '一级 20% / 二级 10%',
|
||
'benefits' => ['每日免费查看 20 条联系方式', '发布信息 8 折', '专属会员标识', '分销佣金加速结算'],
|
||
];
|
||
|
||
$cfg = $this->cfg('member.benefit', null);
|
||
if (!is_array($cfg)) {
|
||
$cfg = $default;
|
||
}
|
||
|
||
$benefits = isset($cfg['benefits']) && is_array($cfg['benefits']) && $cfg['benefits']
|
||
? array_values($cfg['benefits'])
|
||
: $default['benefits'];
|
||
|
||
$this->ok([
|
||
'freeView' => isset($cfg['freeView']) ? (int)$cfg['freeView'] : $default['freeView'],
|
||
'postDiscount' => isset($cfg['postDiscount']) ? (string)$cfg['postDiscount'] : $default['postDiscount'],
|
||
'distRate' => isset($cfg['distRate']) ? (string)$cfg['distRate'] : $default['distRate'],
|
||
'benefits' => $benefits,
|
||
]);
|
||
}
|
||
|
||
/**
|
||
* M3 开通会员
|
||
* POST /api/v1/member/open {planId,payType} → {orderNo,status,expireAt}
|
||
* 规则 BR-07;套餐按 plan_code 查;余额支付扣 fa_user.money
|
||
*/
|
||
public function open()
|
||
{
|
||
$user = $this->auth();
|
||
|
||
$planId = trim((string)$this->input('planId', ''));
|
||
if ($planId === '') {
|
||
$this->fail('请选择会员套餐');
|
||
}
|
||
|
||
$payType = (string)$this->input('payType', '');
|
||
if (!in_array($payType, ['wxpay', 'balance'], true)) {
|
||
$this->fail('支付方式不支持');
|
||
}
|
||
|
||
$plan = Db::name('fc_plan')->where('plan_code', $planId)->find();
|
||
if (!$plan) {
|
||
$this->fail('套餐不存在');
|
||
}
|
||
|
||
$amount = round((float)$plan['price'], 2);
|
||
$now = time();
|
||
|
||
$orderNo = $this->orderNo('MO');
|
||
$orderId = Db::name('fc_order')->insertGetId([
|
||
'order_no' => $orderNo,
|
||
'user_id' => $user['id'],
|
||
'type' => 'member',
|
||
'title' => (string)$plan['name'],
|
||
'amount' => $amount,
|
||
'pay_type' => $payType,
|
||
'status' => 'paid',
|
||
'paytime' => $now,
|
||
'related_id' => 0,
|
||
'createtime' => $now,
|
||
'updatetime' => $now,
|
||
]);
|
||
|
||
if ($payType === 'balance') {
|
||
$balance = (float)$user['money'];
|
||
if ($balance < $amount) {
|
||
$this->fail('余额不足');
|
||
}
|
||
$balance = round($balance - $amount, 2);
|
||
Db::name('user')->where('id', $user['id'])->update([
|
||
'money' => $balance,
|
||
'updatetime' => $now,
|
||
]);
|
||
}
|
||
|
||
$ext = $this->ext($user['id']);
|
||
$base = (int)$ext['member_expiretime'];
|
||
if ($base < $now) {
|
||
$base = $now;
|
||
}
|
||
$expire = $base + (int)$plan['days'] * 86400;
|
||
|
||
Db::name('fc_user_ext')->where('user_id', $user['id'])->update([
|
||
'is_member' => 1,
|
||
'member_level' => (string)$plan['name'],
|
||
'member_expiretime' => $expire,
|
||
'updatetime' => $now,
|
||
]);
|
||
|
||
$this->flow('income', '会员开通', $amount, 0, $orderId);
|
||
|
||
$this->ok([
|
||
'orderNo' => $orderNo,
|
||
'status' => 'paid',
|
||
'expireAt' => $this->iso($expire),
|
||
]);
|
||
}
|
||
|
||
/**
|
||
* M4 我的订单
|
||
* GET /api/v1/member/orders {page,size} → {list,page,size,total,hasMore}
|
||
* 规则:按 createtime desc
|
||
*/
|
||
public function orders()
|
||
{
|
||
$user = $this->auth();
|
||
list($page, $size) = $this->pager();
|
||
|
||
$total = Db::name('fc_order')->where('user_id', $user['id'])->count();
|
||
|
||
$rows = Db::name('fc_order')
|
||
->where('user_id', $user['id'])
|
||
->order('createtime desc')
|
||
->page($page, $size)
|
||
->select();
|
||
|
||
$list = [];
|
||
foreach ($rows as $row) {
|
||
$list[] = [
|
||
'id' => (int)$row['id'],
|
||
'orderNo' => (string)$row['order_no'],
|
||
'type' => (string)$row['type'],
|
||
'title' => (string)$row['title'],
|
||
'amount' => (float)$row['amount'],
|
||
'payType' => (string)$row['pay_type'],
|
||
'status' => (string)$row['status'],
|
||
'createdAt' => $this->iso($row['createtime']),
|
||
];
|
||
}
|
||
|
||
$this->ok($this->paginate($list, $total, $page, $size));
|
||
}
|
||
|
||
/**
|
||
* M5 我的资产
|
||
* GET /api/v1/member/assets → {balance,coupons:[],points}
|
||
*/
|
||
public function assets()
|
||
{
|
||
$user = $this->auth();
|
||
|
||
$this->ok([
|
||
'balance' => (float)$user['money'],
|
||
'coupons' => [],
|
||
'points' => (int)$user['score'],
|
||
]);
|
||
}
|
||
}
|