一、基础设施
- 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
33 行
762 B
PHP
33 行
762 B
PHP
<?php
|
||
|
||
namespace app\api\controller;
|
||
|
||
use think\Db;
|
||
|
||
/**
|
||
* 站点 UI 配置(用户端读取,Module-SETTING)
|
||
* 路由:
|
||
* GET /api/v1/setting/ui 站点名称/LOGO/图标覆盖(允许游客访问)
|
||
*/
|
||
class Setting extends V1
|
||
{
|
||
/**
|
||
* 站点 UI 配置(游客可用)
|
||
* GET /api/v1/setting/ui
|
||
* → {siteName, logo, icons}(icons 恒为对象)
|
||
*/
|
||
public function ui()
|
||
{
|
||
$icons = $this->cfg('ui.icons', []);
|
||
if (!is_array($icons)) {
|
||
$icons = [];
|
||
}
|
||
|
||
$this->ok([
|
||
'siteName' => (string)$this->cfg('ui.siteName', '同城分类信息'),
|
||
'logo' => (string)$this->cfg('ui.logo', ''),
|
||
'icons' => (object)$icons,
|
||
]);
|
||
}
|
||
}
|