主题
25 管理员操作文档
后台（/admin/）按权限模块组织。角色（kd_admin_roles）持有模块权限位，员工（kd_admins）绑定角色；超级管理员拥有 *。权限定义见 AdminPermissionService::MODULES。
登录与权限
| 操作 | 接口 |
|---|---|
| 登录 | POST /admin/auth/login → JWT |
| 我的权限 | GET /admin/auth/permissions |
| 当前管理员 | GET /admin/auth/me |
| 登出 | POST /admin/auth/logout |
每个控制器映射到一个权限模块（CONTROLLER_MAP），无权访问返回 403。
权限模块总览
| 模块键 | 名称 | 涵盖控制器 |
|---|---|---|
dashboard | 仪表盘 | Dashboard、Index |
product | 商品中心 | Product、ProductGroup、ConfigOption、Module |
content | 内容/模板 | Banner、Theme、Setting |
client | 客户中心 | User、Host |
finance | 财务中心 | Order、Invoice、Transaction、Gateway |
marketing | 营销中心 | Report、Promo、Affiliate |
upstream | 上下游 | Upstream、ApiKey |
support | 支持中心 | Ticket、Announcement、Maintenance、Kb、Notify |
plugin | 插件管理 | Addon、Marketplace |
upgrade | 系统更新 | Upgrade |
migration | 数据迁移 | Migration |
system | 系统管理 | Staff、Role |
仪表盘
GET /admin/dashboard/stats：核心指标（用户/商品/订单/未付款等）GET /admin/dashboard/overview：概览（指标 + 趋势）
商品中心
| 功能 | 接口 |
|---|---|
| 商品列表/详情 | /admin/product/index、/admin/product/read?id= |
| 新增/编辑/删除商品 | /admin/product/create、update?id=、delete?id= |
| 刷新上游商品上下文 | /admin/product/refresh_upstream?id= |
| 商品组 | /admin/product_group/{index,read,create,update,delete} |
| 可配置选项组/选项/子选项 | /admin/config_option/*（createGroup/Option/Suboption 等） |
| 开通模块查看/测试 | /admin/module/{index,read,test} |
内容 / 模板
| 功能 | 接口 |
|---|---|
| 轮播图 | /admin/banner/{index,read,create,update,delete} |
| 主题 | /admin/theme/{index,sync,activate,ssrMode} |
| 站点设置 | /admin/setting/{site,saveSite} |
| 外观设置 | /admin/setting/{appearance,saveAppearance} |
| 实名设置 | /admin/setting/{realname,saveRealname} |
| 分组设置 | /admin/setting/{group,saveGroup} |
客户中心
| 功能 | 接口 |
|---|---|
| 客户列表/详情/编辑 | /admin/user/{index,read,update} |
| 调整余额 | /admin/user/adjustCredit |
| 重置密码 | /admin/user/resetPassword |
| 实名审核 | /admin/user/approveRealname、rejectRealname |
| 服务实例列表/详情 | /admin/host/{index,read} |
| 开通/暂停/恢复/终止 | /admin/host/{provision,suspend,unsuspend,terminate} |
| 备注 | /admin/host/updateNotes |
财务中心
| 功能 | 接口 |
|---|---|
| 订单列表/详情 | /admin/order/{index,read} |
| 账单列表/详情/标记已付 | /admin/invoice/{index,read,markPaid} |
| 交易流水 | /admin/transaction/index |
| 支付网关 | /admin/gateway/{index,create,update,delete} |
营销中心
| 功能 | 接口 |
|---|---|
| 报表（概览/趋势/热销/网关占比） | /admin/report/{overview,trend,topProducts,gatewayShare} |
| 优惠码 | /admin/promo/{index,create,update,delete} |
| 分销/佣金/提现审核 | /admin/affiliate/{index,setRate,withdrawals,review} |
上下游
| 功能 | 接口 |
|---|---|
| 上游管理 | /admin/upstream/{index,create,update,delete,test,sync} |
| 上游商品/导入/同步实例 | /admin/upstream/{products,import,syncHost} |
| API 密钥（开放 API） | /admin/api_key/{index,create,update,delete,users} |
支持中心
| 功能 | 接口 |
|---|---|
| 工单 | /admin/ticket/{index,read,reply,close} |
| 工单部门 | /admin/ticket/{departments,createDepartment,updateDepartment,deleteDepartment} |
| 公告 | /admin/announcement/{index,read,create,update,delete} |
| 维护通知 | /admin/maintenance/{index,read,create,update,delete} |
| 知识库分类/文章 | /admin/kb/*（categories/articles 及增改删） |
| 通知设置/测试 | /admin/notify/{index,save,testMail,testSms} |
插件管理
| 功能 | 接口 |
|---|---|
| 本地插件 | /admin/addon/{index,install,uninstall,enable,disable,config,saveConfig} |
| 插件市场 | /admin/marketplace/{index,detail,fetch,install,upgrade,sync} |
系统更新 / 数据迁移 / 系统管理
| 功能 | 接口 |
|---|---|
| 系统更新 | /admin/upgrade/{index,check,apply,rollback}（见 26 更新产品开发文档） |
| 数据迁移 | /admin/migration/{index,test,run} |
| 员工 | /admin/staff/{index,create,update,delete} |
| 角色与权限 | /admin/role/{index,create,update,delete} |
下一篇：26 更新产品开发文档