1.1 用户列表
用户基础信息查询与管理。支持按手机号/昵称搜索、按类型(H5用户 / CP用户 / 管理员)筛选。提供分页列表、用户类型变更、启用/禁用、详情查看、新增用户。顶部统计卡片展示用户总数及各类型分布。
GET /api/user/admin/usersPUT /api/user/admin/users/:idPOST /api/user/admin/usersGET /api/user/admin/users/stats
1.2 CP 审核
CP(内容提供商/分销商)入驻审核工作台。按待审核/已通过/已拒绝三个状态分 Tab 管理,支持一键通过或拒绝。列表展示手机号/企业昵称/审核状态/注册时间。
GET /api/user/admin/cp-reviewPOST /api/user/admin/cp-review/:id?action=缺少拒绝原因录入
1.3 实名审核
用户实名认证审核队列。展示用户名/真实姓名/身份证号/状态/提交时间,支持通过/驳回操作。
GET /api/user/admin/realnamePUT /api/user/admin/realname/:id/audit
1.4 账号状态
账号冻结/封禁/解冻管理。支持三种状态(正常/冻结/封禁)切换,需填写变更备注,操作留痕。
GET /api/user/admin/accountsPUT /api/user/admin/accounts/:id/status
1.5 角色权限
RBAC 角色-权限管理。支持创建/编辑/删除角色,通过复选框组分配 17 项细粒度权限(dramas / users / orders / payment / risk / agent / settings / reports / system 的 read / write)。
GET/POST /api/system/admin/rolesPUT/DELETE /api/system/admin/roles/:id17 项权限粒度
2.1 短剧管理
短剧 CRUD 核心模块。列表展示 ID / 剧名 / CP / 类目 / 集数 / 热度 / 上下架状态 / 审核状态,支持审核通过/拒绝、上下架切换、新建/编辑短剧(含封面文件上传)。筛选维度:审核状态、关键词搜索。
GET /api/content/dramasPOST/PUT /api/content/dramasPOST /api/content/dramas/:id/reviewPOST /api/content/dramas/:id/publish新建/编辑表单页 + 封面上传
2.2 内容审核
独立的内容审核队列(与短剧管理审核分离)。展示封面/名称/分类/作者/提交时间,审核状态 PENDING / APPROVED / REJECTED,驳回时需填写原因。对接 /api/content/admin 路径。
GET /api/content/admin/dramas/auditPUT /api/content/admin/dramas/:id/audit与 2.1 审核功能重复
2.3 商品管理
选品中台商品查看与同步。展示商品编码/名称/类目/品牌/售价/同步状态(待同步/同步中/已同步),支持关键词搜索和触发全量同步。对接 productSyncClient 选品中台。
GET /api/content/products/searchPOST /api/content/products/sync
2.4 弹幕管理
弹幕内容管理中枢。按短剧 ID 查询全部弹幕、单条添加、CSV / JSON 批量导入(自动映射 epNum → episodeId)、删除。AI 弹幕紫色标记、亮点弹幕红色标记,类型含普通/亮点/AI。CSV 格式:epNum,timePoint,content,type,author。
GET /api/content/dramas/:dramaId/bulletsPOST /api/content/bullets/import (multipart)POST /api/content/bulletsDELETE /api/content/bullets/:idCSV + JSON 双格式导入
2.5 用户反馈
用户意见反馈工单处理。按状态(未处理/已解决/已关闭)筛选,支持关键词搜索、查看详情弹窗并回复处理。
GET /api/user/admin/feedbackPUT /api/user/admin/feedback/:id/resolve
2.6 分类管理
短剧分类体系管理(古装/都市/悬疑等),对接 fa_category 表。支持类型(短剧/文章)、排序权重、父级层级、封面图、导航显示控制。
GET/POST/PUT/DELETE /api/content/legacy/categories
2.7 Banner 管理
首页/频道 Banner 轮播图管理。支持标题、图片 URL、跳转链接、排序权重、启用开关。操作含新增/编辑/删除/启用切换。
GET/POST /api/cms/admin/bannersPUT /api/cms/admin/banners/:id/toggle
3.1 广告位管理
广告投放位置配置(pre-roll / mid-roll / reward / banner),设置类型(video / banner)、时长、金币奖励、启用开关。含统计卡片(在投数/今日收益/曝光量/点击率)。
当前为前端 Mock 数据需对接后端 API 实现持久化
3.2 广告池管理
广告素材全生命周期管理。支持开屏/激励视频/Banner/原生四种类型,配置图片 URL、跳转链接、权重(1-100)、启用开关。
GET/POST /api/ad/admin/poolPUT /api/ad/admin/pool/:id/toggle
3.3 广告收入报表
广告收入数据看板。展示今日/昨日/本月收入、展示量、点击量、点击率六个核心指标,ECharts 日收入趋势图 + 收入明细表。
GET /api/ad/admin/incomeECharts 可视化
4.1 风控大盘
风控数据总览。6 项核心统计(总设备/高风险设备/今日事件/今日拦截/启用规则/黑名单数),风险等级分布可视化(LOW / MEDIUM / HIGH / CRITICAL),最近拦截事件列表,快捷操作入口。
GET /api/risk/admin/dashboardGET /api/risk/admin/events?decision=BLOCK
4.2 规则配置
可编程风控规则引擎。规则含编码/名称/类别(DEVICE / NETWORK / BEHAVIOR / LOCATION)/匹配表达式(13 种:IS_ROOT、IS_EMULATOR、IS_HOOK、IS_VPN、IS_PROXY、IS_DEBUG 等)/动作(BLOCK / WARN / LOG / PASS)/优先级。修改即时生效,无需重启。
GET/POST /api/risk/admin/rulesPUT /api/risk/admin/rules/:id/toggle13 种检测表达式
4.3 黑名单管理
多维度封禁名单。支持按设备 ID / OAID / IMEI / IP 四种维度封禁,可设过期时间(永久或定期),填写封禁原因。设备上报时自动拦截。
GET/POST /api/risk/admin/blacklistDELETE /api/risk/admin/blacklist/:id
4.4 屏蔽管理
IP 段 / 设备 ID / OAID 维度的屏蔽策略。与黑名单功能高度重叠,支持启用开关和过期时间。
GET/POST /api/risk/admin/shielding与黑名单功能边界模糊
4.5 风险记录(设备指纹 & 风控事件)
三 Tab 页:设备指纹列表(厂商 / 安全检测标签 Root/模拟器/Hook/VPN/多开 / 风险评分 / 等级)、风控事件流(决策结果 / 命中规则)、评分权重配置(各风险维度权重实时调整)。设备详情弹窗展示完整指纹信息。
GET /api/risk/admin/devicesGET /api/risk/admin/eventsGET/PUT /api/risk/admin/scores设备详情弹窗
5.1 消息管理
内容监测与敏感词过滤。展示今日弹幕总量/触发敏感词数/已拦截数,敏感词库可动态增删(赌博/诈骗/色情/违法/政治敏感/人身攻击/广告推广),含拦截记录表(时间/用户/内容/命中词/处理结果)。
当前为前端硬编码数据需对接后端敏感词过滤服务
5.2 通知推送
App 推送通知管理。支持全部用户 / VIP 定向推送,填写标题和内容,发送后标记状态(待发送/已发送)。
GET/POST /api/cms/admin/notifications
5.3 公告管理
平台公告发布。支持标题、内容、优先级(普通/重要),启用开关控制显示。
GET/POST /api/cms/admin/notices
6.1 IP 管理
IP 白名单/黑名单管理。支持 CIDR 格式(如 192.168.1.0/24),配置备注,用于访问控制和风控辅助。
GET/POST /api/cms/admin/ips
6.2 渠道管理
应用分发渠道配置(对接 fa_channel 表)。管理渠道编码/名称/状态开关/最低版本/当前版本/包名。用于多渠道包分发和版本控制。📍 本轮已从「用户管理」移至「平台治理」分组。
GET/POST /api/content/legacy/channelsfa_channel 表 CRUD
6.3 卡密管理
虚拟卡密(兑换码)生成与管理。支持批量生成(1-100 个)、设置金额、固定/随机面额类型。列表展示卡密/金额/状态(未使用/已使用/已过期)/使用用户。
GET /api/kami/admin/listPOST /api/kami/admin/generate
6.4 代理看板
渠道代理体系总览。6 项核心指标(总代理/活跃代理/本月新增/总佣金/待结算/已结算),TOP10 代理收入排行,ECharts 日新增代理趋势图。下级树状图(多级追溯,Lv1-Lv3 层级标记)+ 收款账号管理(银行/户名/账号脱敏/设默认)。
GET /api/user/channel/dashboardGET /api/user/channel/childrenGET/POST /api/agent/admin/banksECharts + 下级树状展开
6.5 奖励活动
代理拉新/充值返佣等活动配置。活动类型:拉新奖励 / 充值返佣 / 签到奖励 / 自定义,设定奖励金额和有效期(日期范围选择器),支持启用/停用切换。
GET/POST /api/agent/admin/rewards
6.6 任务管理
用户任务系统。任务类型含签到/邀请/观看/充值,配置奖励(金币或现金)和完成条件,支持启用开关和分页列表。
GET /api/task/admin/listPUT /api/task/admin/:id/toggle
7.1 支付渠道
微信支付 / 支付宝渠道参数配置。管理 AppID、商户号、API 密钥、回调域名,修改即时生效。支持启用/停用切换。📍 本轮已移至数据BI上方。
GET/POST /api/payment/configAPI 密钥明文存储与传输
7.2 订单列表
全平台交易订单查询。按状态(待支付/已支付/已退款/已关闭)筛选、按订单号搜索。展示订单号/用户ID/金额/状态/商品/时间。分页列表。
GET /api/payment/orders缺少退款操作入口
7.3 提现配置
用户提现档位管理。配置提现金额、手续费率(%)、日限次数、排序权重,支持启用开关。控制用户端可选提现面额。
GET/POST /api/user/admin/withdraw-configPUT /api/user/admin/withdraw-config/:id/toggle
7.4 结算管理(代理结算)
代理佣金结算工作台。展示待结算/已结算记录(代理名称/订单金额/佣金/来源用户/时间),支持 checkbox 多选批量结算。
GET /api/user/channel/settlementPOST /api/user/channel/settlement/batch
优化建议(按优先级排列)
高优 1. 审核流程去重 — 短剧管理与内容审核存在重复审核入口
短剧管理列表页有"通过/拒绝"按钮,内容审核队列也有独立审核流程。建议统一审核入口为内容审核队列,短剧管理仅保留列表查看和上下架操作,避免同一内容两次审核。
高优 2. 支付渠道 API 密钥安全加固
支付渠道配置中 API 密钥以明文传输和存储,存在安全风险。建议:前端仅展示脱敏值(如 wx****a3f2),后端存储加密,编辑时支持"重置密钥"而非回显原文。
高优 3. 黑名单与屏蔽管理功能合并
黑名单(4.3)与屏蔽管理(4.4)功能高度重叠(均支持 DEVICE_ID / IP / OAID 维度封禁),维护两套表增加运营复杂度和数据不一致风险。建议合并为统一的"封禁管理",通过类型字段区分黑名单/屏蔽。
中优 4. 订单列表缺失退款操作
订单列表仅支持查看,无法直接发起退款。建议增加退款按钮,对接支付渠道退款接口,同时记录退款原因和操作人。
中优 5. 仪表盘统计数据对接实时 API
仪表盘(Dashboard)和广告位管理(3.1)目前使用前端硬编码 Mock 数据。建议对接后端实时统计 API,确保管理后台数据与实际业务一致。
中优 6. 消息管理敏感词过滤服务化
消息管理(5.1)的敏感词库和拦截记录为前端静态数据。建议对接后端敏感词过滤服务(可复用风控规则引擎或独立 NLP 服务),实现实时拦截 + 人工复核闭环。
中优 7. CP 审核增加拒绝原因
CP 审核拒绝操作直接调用接口,未提供拒绝原因输入框。建议增加拒绝原因弹窗,理由存入审核日志便于申诉追溯,与内容审核的驳回原因机制保持一致。
低优 8. 菜单分组持续优化
已完成本轮三次菜单调整(渠道管理→平台治理、交易结算→数据BI上方、互动管理→平台治理上方)。后续建议:将"角色权限"从用户管理移至系统设置,将"分类管理"和"Banner管理"从内容管理移至平台治理 CMS 区,使分组语义更清晰。同时关注跨服务 API 调用(如用户管理页调用 /api/user/admin/*,内容管理页调用 /api/content/* 和 /api/cms/admin/*),建议统一 API 前缀。
低优 9. 路由与菜单一致性审计
当前存在路由已定义但菜单未直接展示的页面(如 risk/commissions 佣金扣除、risk/blackcube 黑产检测、agent/children 下级树状图、agent/bank 收款账号、settings/config 全量配置),部分通过子页内嵌访问。建议统一梳理菜单可见性,确保所有功能页面有明确导航路径,避免"隐藏页面"。