XShop 总平台 · 管理后台操作手册

平台运营 / 财务 / 审核人员操作指南 ｜ 入口：https://xyd.xyanda.cn/admin/ （旧域 https://xyd.findhere.cn/admin/ 并存）

商家维度多租户 RBAC 权限体系 高危操作需密码二次验证 版本：2026-09-10

一、平台概述

总平台（admin）是平台方运营管理核心，负责会员、商品、商家、订单、支付、奖励、财务全链路管控；与「商家独立后台」（/merchant/）平行、独立登录态。

概平台定位与技术架构

  • 多商户电商中台：平台（总控端）+ 商家（merchant 独立后台）+ 区域代理（agent）三层角色；商家维度隔离（非租户 tid 模式）。
  • 技术栈：后端 ThinkPHP 8（8000 端口）+ 前端 Vite + Vue3（admin-web，9999 端口开发）+ C 端 uni-app（H5 / 小程序 / APP）。
  • 双线部署：测试线 xyd.findhere.cn（库 xshop）/ 正式线 xyd.xyanda.cn（库 xydshop），两域并存，本手册以正式线为主。
  • RBAC 权限：角色 → 权限点（menu:xxx 菜单 + 操作码）两级控制，SUPER_ADMIN 全权限。
  • 操作分级：operation_level 1 查看 / 2 操作 / 3 高危（资金类，需 X-Verify-Password 密码二次验证）。
  • 全链路：商品审核 → 订单 → 支付 → 奖励结算 → 分红发放 → 提现审核。

单菜单总览（按侧边栏分组）

工作台（独立）

模块权限码核心功能
工作台menu:dashboard核心指标、图表、待办快捷入口

运营管理

模块权限码核心功能
公告管理menu:announcement公告发布 / 编辑 / 删除 / 推送
访问报表menu:visit用户页面访问记录与自定义页面控件统计
商家管理menu:shop商家审核、让利比例、代建商家
区域代理menu:agent代理资质 / 业绩 / 经费发放
会员管理menu:user会员列表、状态、推荐关系
积分管理menu:point手动充值 / 扣减（高危）
兑换权益menu:equity_apply积分余额兑换权益的审核与记录
股票兑换审核menu:stockD5 上市股票数据资产兑换审核
任务中心menu:task平台任务配置与执行记录（cron 调度）

财务管理

模块权限码核心功能
财务数据menu:finance:data资金流水、提现审核、备付金兑付
对账中心menu:reconcile资金 / 积分守恒校验
奖励结算menu:reward三大加速奖、分红计提 / 审批 / 发放

商城管理

模块权限码核心功能
分类管理menu:mall:category商品分类树维护
商品管理menu:goods商品 / SKU / 相册 / 供应商 / 运费
商品审核menu:goods:review商家商品审核通过 / 驳回
商品治理menu:goods:governance违规商品强制下架（高危）
订单管理menu:order订单查询 / 编辑 / 奖励流向
物流管理menu:logistics发货单、物流单号、轨迹

系统管理

模块权限码核心功能
权限管理menu:permission角色、管理员、权限树
操作日志menu:log操作记录、高危审计
页面装修menu:page首页装修（banner / 金刚区 / 分类 / 资产区块）
支付配置menu:pay渠道、商户绑定、健康检测、对账
系统配置menu:config参数、存储（七牛云）、短信

V6 专属（独立）

模块权限码核心功能
V6 专属v6:dashboardV6+ 高等级会员 / 锁仓 / 分红池

二、登录

平台运营账号登录，独立于商家账号体系（商家走 /merchant/login）。

登登录说明

1
访问 https://xyd.xyanda.cn/admin/（SPA，自动进入登录页；旧域 xyd.findhere.cn/admin/ 并存）
2
输入平台账号与密码（如 admin / 初始 初始密码（首登后请修改），建议首登修改）
3
登录后进入工作台；侧边栏菜单按角色权限动态显示（来自后端 auth/info）
提示：权限变更后需重新登录生效；如提示「无权限」请确认账号已被授予对应 menu:xxx 权限点。

三、工作台

登录首页，全局数据总览与待办提醒。

台内容

  • 核心指标：会员数、订单数、销售额、待办数等
  • 图表：销售趋势、会员增长等可视化
  • 待办：待审核商品、待审核商家、待审核提现等快捷入口

四、运营管理

会员、商家、代理、积分、公告、任务、报表等日常运营模块集合。

员会员管理（menu:user）

功能权限说明
会员列表menu:user分页 / 关键词 / 状态筛选
会员详情menu:user资料、级别、推荐关系、积分 / 余额
启用 / 禁用user:edit禁用后无法登录 / 下单
调整推荐关系user:adjust修复推荐链（高危）
手动调整级别user:level人工升降级（高危）

积积分管理（menu:point）

  • 统计条：总积分、本月充值 / 扣减
  • 积分充值（point:recharge 高危）：给会员手动加积分
  • 积分扣减（point:deduct 高危）：手动扣积分
  • 标记每日行为（point:set_behavior）：签到 / 广告行为标记（影响每日释放）
高危操作：充值 / 扣减涉及资金，需管理员密码二次验证，操作前请核对会员与金额。

兑兑换权益 / 股票兑换审核（menu:equity_apply · menu:stock）

  • 兑换权益：会员用积分余额兑换权益（如股票数据资产）的申请审核与记录。
  • 股票兑换审核：D5 上市股票数据资产兑换专项审核（积分余额 → 股票数据资产），审核通过 / 驳回并附原因。

商商家管理（menu:shop）

功能权限说明
商家列表menu:shop商家 / 代理筛选、状态筛选
新建商家shop:create代建商家（自动初始化 5 角色）
编辑 / 启停shop:edit / status基础资料、禁用后商家后台不可登录
让利比例shop:rate调整让利比例（影响奖励）
入驻审核shop:approve自助申请审核：通过 → 开通；驳回 → 附原因
注意：让利比例调整影响奖励结算，修改后应通知商家并核对后续结算数据。

代区域代理（menu:agent）

功能权限说明
代理列表menu:agent区域代理档案、业绩
资质审核agent:approve代理入驻审核
启停agent:status状态控制
经费发放agent:funds代理经费 / 佣金发放（高危）

务公告 / 访问报表 / 任务中心

  • 公告管理（menu:announcement）：发布 / 编辑 / 删除 / 推送（announcement:publish）。
  • 访问报表（menu:visit）：用户页面访问记录与自定义页面控件统计。
  • 任务中心（menu:task）：平台任务（admin_task / admin_task_log）配置与执行记录，cron（/etc/cron.d/xshop，task:run --key）调度。

五、财务管理

财务数据、对账中心、奖励结算三大模块，资金类操作均为高危（需密码二次验证）。

财财务数据（menu:finance:data）

功能权限说明
资金流水menu:finance:data全平台资金变动明细
提现审核withdraw:approve待审核 / 已通过 / 已驳回列表
通过提现withdraw:approve高危：确认打款后通过
拒绝提现withdraw:reject附驳回原因
备付金兑付finance:reserve查看 T+1 兑付进度
高危：提现通过 = 实际打款确认，务必核对提现单与会员收款信息后再操作。

核对账中心（menu:reconcile）

  • 资金守恒：会员钱包合计 vs 末笔流水余额合计
  • 积分守恒：消费 / 兑换 / 锁仓 / 红包 四池校验
  • 计提一致性：奖励 / 分红应发 vs 实发
  • 备付金：T+1 兑付进度

奖奖励结算（menu:reward）

页签内容操作
分享加速奖分享奖励明细查看 / 对账
团队加速奖团队业绩奖励明细查看 / 对账
推荐人加速奖推荐链奖励明细查看 / 对账
分红结算线上 / 线下分红记录审批（dividend:approve）→ 发放（dividend:pay）
1
计提（reward:settle / dividend:accrue）：手动触发某日 / 某批结算（高危，密码验证）
2
审批：核对应发金额
3
发放（dividend:pay）：批量发放到会员钱包 / 链上
高危：结算与发放均涉及资金，需管理员密码二次验证；发放不可逆，务必核对批次金额。

六、商城管理

商品、分类、审核、订单、物流全链路管控。

品商品管理（menu:goods）

功能权限说明
分类管理menu:mall:category商品分类树维护（独立模块）
商品列表menu:goods全平台商品（含商家）筛选
新增 / 编辑goods:save平台自营或代商家维护
删除goods:delete高危
上下架goods:status控制公域可见性
导出 / 导入goods:export / import批量操作（导入高危）
SKU / 相册 / 详情 / 视频goods:sku / gallery商品扩展素材
供应商 / 运费模板goods:supplier / shipping供应商档案、运费规则

审商品审核（menu:goods:review）

1
商家提交商品 → 进入「待审核」
2
查看审核详情（商品资料 / 图片 / 价格）
3
通过（goods:review:decision）→ 商品可上架；驳回 → 商家修改后重新提交

治商品治理（menu:goods:governance）

违规商品（涉假 / 违禁 / 投诉）查看与 强制下架（goods:governance:off，高危）——绕过商家操作直接下架。

单订单管理（menu:order）

功能权限说明
订单列表menu:order全平台订单，类型（礼包 / 普通）、状态筛选
订单详情menu:order商品明细、支付信息、奖励信息
编辑订单order:edit修改收货信息等（已完成 / 已取消不可编辑）
取消订单order:close高危
奖励流向menu:order由列表「奖励流向」按钮进入专用页，实时展示该订单奖励发放链路（分享 / 团队 / 推荐人加速奖）

流物流管理（menu:logistics）

  • 发货单、物流单号录入（logistics:create / express）
  • 物流轨迹查询

七、系统管理

权限、日志、装修、支付、配置等平台级基础设施。

权权限管理（menu:permission）

功能权限说明
角色列表permission:role:manage新增 / 编辑 / 删除角色（系统内置角色不可删）
管理员列表permission:admin:manage平台账号管理（新增 / 编辑）
权限树permission:role:manage角色授权（菜单 + 操作点勾选）
提示：SUPER_ADMIN 全权限；角色授权变更后相关账号需重新登录。

志操作日志（menu:log）

  • 日志列表：全部操作记录（操作人 / 动作 / 对象 / IP）
  • 高危日志（log:highrisk）：资金类操作专项审计

装页面装修（menu:page）

首页装修：维护 banner 轮播、金刚区（C 端 page_widget.params 快照）、商品分类、资产区块等；注意可见性条件 review_status=2 AND status=1，分类不向下聚合须补祖先。

配系统配置（menu:config）

页签说明
参数配置系统参数（config:edit，高危）
存储配置存储驱动：本地 / 七牛云（bucket / 密钥 / region z2 华南）/ 阿里云 OSS
短信配置driver：mock（开发回显验证码）/ aliyun（真实下发，AccessKey / 签名 / 模板）
注意：存储 / 短信密钥在生产后台配置后以掩码显示，修改需重新输入完整密钥。

八、V6 专属模块

面向高等级（V6+）会员的锁仓与分红池管理；会员等级体系为 8 级 VIP（V1→V8，级差 2%，V1 直推 4 单门槛 2% 提成，V2–V8 团队业绩 10W–5000W 对应 4%–16%）。

V6功能

功能说明
V6 概览V6+ 会员数、锁仓积分余额、分红待发 / 已发
V6 会员列表高等级会员明细
配置 V6 级别v6:level:configure，级别参数（高危）
锁仓积分锁仓明细、已解冻
分红池分红池余额与发放进度
团队积分调配v6:team:allocate，团队积分调配（高危）

九、支付渠道详解

总平台「支付配置」管理全部后台渠道；C 端收银台（xshop-multipay）仅路由四类渠道。

付后台渠道配置（menu:pay）

渠道说明
微信 / 支付宝微信支付（APPID wxdd60106fcbdc5c13 / 商户号 1113202093）、支付宝企业付款（app_id 2021006166617109）
快付 Gdkf库内 channel_code=kuaifu，KuaiFuGateway；含商户进件（反向注册）
汇聚 JoinPayJoinPayGateway，签约卡 #440–#447；子商户 + 分账
数字人民币 EcnyEcnyGateway，fp001 网关，平台代收 + 下游结算（mode=2）
银联 UnionPayUnionPayGateway，独立渠道（复用 fp001 网关 YtPay paytype）
余额 / Mockbalance 余额支付；mock 开发联调（?channel=mock）
  • 密钥脱敏：商户号 / 密钥 / 环境 / 优先级 / 状态，密钥类字段加密存储、掩码显示。
  • 健康检测：手动触发渠道健康检查，异常渠道自动容灾跳过。
  • 商户绑定：子商户入驻绑定（分账 / 代收模式）。
  • 对账报表：按日期 + 渠道汇总交易、差异告警。

路C 端收银台四渠道路由（xshop-multipay）

路由标识渠道
xpay官方支付（微信 + 支付宝）
joinpay汇聚支付（签约卡）
gdkf快付（KuaiFu）
ecny数字人民币
注意：银联 / 余额 / Mock 等是后台已配置的渠道，不在 C 端四渠道路由内；收银台竖向列表仅展示上述四类。

十、积分与奖励体系

四池积分 + 8 级 VIP + 三大加速奖 + 分红；奖励引擎自动计提，人工复核发放。

池四池积分

池含义
consume（消费池）消费赠送，主释放来源（每日 0.2% 前置 signed&ad_done）
exchange（兑换池）兑换权益对应积分
lock / lock_released（锁仓池）锁仓积分及已释放部分
red_packet（红包池）红包类发放

积分公式：实付 × 让利比% × 5；礼包全进消费池；普通 / 线下按比例拆分 consume / exchange。每日释放 0.2%，9-3 兑换权益释放，9-4 消费→红包 6% 扣税，分红 V1+ 全员叠加低级池（consume_point 加权 5:5）。

级8 级 VIP 等级

等级级差 / 权益
V1直推 4 单门槛，2% 提成
V2 – V8团队业绩 10W – 5000W 对应 4% – 16%（每级差 2%）

级联模式自动向上一级累积（send_ab_level_diff() 由 send_ab() 调用，user_relation 表 c1 为直推上级）。奖励发放含资格烧伤（status≠1 归平台 uid=0）与差额烧伤（消费积分余额不足时差额蒸发）；恒等式 should = 实发 + burn。

对账：用 should − burn 核对，详见「对账中心」。

十一、权限与操作日志

RBAC 权限体系与全量操作审计，详见第七章「权限管理 / 操作日志」。

安安全要点

  • 二次验证：operation_level=3 的资金类操作须输入当前管理员密码（X-Verify-Password 头）。
  • 最小权限：按岗位分配角色，避免授予过多高危操作码。
  • 审计：所有高危操作留痕于「操作日志 → 高危日志」，可溯源到操作人 / IP。
  • 分级发布：SUPER_ADMIN 全权限；角色授权变更后相关账号需重新登录生效。

十二、常见问题（FAQ）

问Q&A

问题解答
菜单缺失 / 权限不足？权限管理 → 角色授权，勾选对应 menu:xxx 权限点；SUPER_ADMIN 自动全权限。变更后重新登录。
高危操作提示密码验证？operation_level=3 操作需输入当前管理员密码（X-Verify-Password）。
商家商品为什么看不到？商品需先通过「商品审核」，再检查商家侧是否已上架且 review_status=2 AND status=1。
奖励结算流程？计提（reward:settle / dividend:accrue）→ 审批 → 发放（dividend:pay），全程高危。
对账不一致？对账中心查看守恒校验；资金类以 pay_trade + 流水为准，差异查提现 / 退款。
支付渠道异常？支付配置 → 健康检测，异常渠道自动容灾跳过；检查密钥配置。
C 端收银台看不到某渠道？收银台仅路由 xpay / joinpay / gdkf / ecny 四类，银联 / 余额 / Mock 仅后台配置。
积分公式怎么算？实付 × 让利比% × 5；礼包全进消费池，普通 / 线下按比例拆分。
两个后台入口区别？总平台 /admin/ 管全平台；商家独立后台 /merchant/ 仅管本店，登录态平行独立。
XShop 总平台操作手册 ｜ 商家维度多租户 · RBAC 权限 · 高危操作二次验证 ｜ 生成于 2026-09-10（依据 admin-web 实际路由与后端网关核验）