文件
fenleixinxi/application/api/controller/AdminRbac.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

152 行
4.7 KiB
PHP

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

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

<?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));
}
}