一、基础设施
- 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
152 行
4.7 KiB
PHP
152 行
4.7 KiB
PHP
<?php
|
||
|
||
namespace app\api\controller;
|
||
|
||
use think\Db;
|
||
|
||
/**
|
||
* 后台管理端 · 权限管理(Module-ADM-RBAC)
|
||
* 路由:
|
||
* GET /api/v1/admin/roles AR1 角色列表
|
||
* POST /api/v1/admin/role AR2 新增/保存角色
|
||
* GET /api/v1/admin/accounts AR3 子账号列表
|
||
* GET /api/v1/admin/logs AR4 操作日志
|
||
*
|
||
* 注意:fa_auth_group 实际无 remark 字段(id,pid,name,rules,createtime,updatetime,status),
|
||
* roles() 的 remark 固定返回 '';saveRole() 写库不写 remark。
|
||
*/
|
||
class AdminRbac extends V1
|
||
{
|
||
/**
|
||
* AR1 角色列表
|
||
* GET /api/v1/admin/roles → 数组 [{id,name,permissions,remark}]
|
||
*/
|
||
public function roles()
|
||
{
|
||
$rows = Db::name('auth_group')->order('id asc')->select();
|
||
|
||
$list = [];
|
||
foreach ($rows as $row) {
|
||
$rules = (string)$row['rules'];
|
||
if ($rules === '*') {
|
||
$permissions = ['*'];
|
||
} else {
|
||
$permissions = array_values(array_filter(array_map('strval', explode(',', $rules)), function ($v) {
|
||
return $v !== '';
|
||
}));
|
||
}
|
||
$list[] = [
|
||
'id' => (int)$row['id'],
|
||
'name' => (string)$row['name'],
|
||
'permissions' => $permissions,
|
||
'remark' => '',
|
||
];
|
||
}
|
||
|
||
$this->ok($list);
|
||
}
|
||
|
||
/**
|
||
* AR2 新增/保存角色
|
||
* POST /api/v1/admin/role 入参 {name,permissions[],remark?,id?} → {id,name,permissions,remark}
|
||
* 规则 BR-12:name 必填、permissions 非空
|
||
*/
|
||
public function saveRole()
|
||
{
|
||
$id = (int)$this->input('id', 0);
|
||
$name = trim((string)$this->input('name', ''));
|
||
$remark = trim((string)$this->input('remark', ''));
|
||
|
||
$permissions = (array)$this->input('permissions', []);
|
||
$permissions = array_values(array_filter(array_map(function ($v) {
|
||
return (string)$v;
|
||
}, $permissions), function ($v) {
|
||
return $v !== '';
|
||
}));
|
||
|
||
if ($name === '') {
|
||
$this->fail('请填写角色名称');
|
||
}
|
||
if (empty($permissions)) {
|
||
$this->fail('请至少分配一项权限');
|
||
}
|
||
|
||
$rules = implode(',', $permissions);
|
||
$data = [
|
||
'name' => $name,
|
||
'rules' => $rules,
|
||
'pid' => 0,
|
||
'status' => 'normal',
|
||
'updatetime' => time(),
|
||
];
|
||
|
||
if ($id && Db::name('auth_group')->where('id', $id)->find()) {
|
||
Db::name('auth_group')->where('id', $id)->update($data);
|
||
} else {
|
||
$data['createtime'] = time();
|
||
$id = Db::name('auth_group')->insertGetId($data);
|
||
}
|
||
|
||
$this->adminLog('保存角色 #' . $id . ' ' . $name);
|
||
|
||
$this->ok([
|
||
'id' => (int)$id,
|
||
'name' => $name,
|
||
'permissions' => $permissions,
|
||
'remark' => $remark,
|
||
]);
|
||
}
|
||
|
||
/**
|
||
* AR3 子账号列表
|
||
* GET /api/v1/admin/accounts → 数组 [{id,username,roleId,roleName,status,lastLoginAt}]
|
||
*/
|
||
public function accounts()
|
||
{
|
||
$groups = Db::name('auth_group')->column('name', 'id');
|
||
$rows = Db::name('admin')->order('id asc')->select();
|
||
|
||
$list = [];
|
||
foreach ($rows as $row) {
|
||
$gid = (int)$row['group_id'];
|
||
$roleName = ($gid && isset($groups[$gid])) ? (string)$groups[$gid] : '';
|
||
$list[] = [
|
||
'id' => (int)$row['id'],
|
||
'username' => (string)$row['username'],
|
||
'roleId' => $gid,
|
||
'roleName' => $roleName,
|
||
'status' => ((int)$row['logintime'] > 0) ? 1 : 0,
|
||
'lastLoginAt' => $this->iso($row['logintime']),
|
||
];
|
||
}
|
||
|
||
$this->ok($list);
|
||
}
|
||
|
||
/**
|
||
* AR4 操作日志
|
||
* GET /api/v1/admin/logs 入参 {page,size}
|
||
* → 分页 {list:[{id,account,action,ip,createdAt}],page,size,total,hasMore}
|
||
*/
|
||
public function logs()
|
||
{
|
||
list($page, $size) = $this->pager();
|
||
|
||
$total = Db::name('admin_log')->count();
|
||
$rows = Db::name('admin_log')->order('createtime desc')->page($page, $size)->select();
|
||
|
||
$list = [];
|
||
foreach ($rows as $row) {
|
||
$list[] = [
|
||
'id' => (int)$row['id'],
|
||
'account' => (string)$row['username'],
|
||
'action' => (string)$row['title'],
|
||
'ip' => (string)$row['ip'],
|
||
'createdAt' => $this->iso($row['createtime']),
|
||
];
|
||
}
|
||
|
||
$this->ok($this->paginate($list, $total, $page, $size));
|
||
}
|
||
}
|