菜单位置：数据面板（/admin/userData）。这是登录后默认进入的首页，全部内容为只读统计，没有筛选条件与操作按钮，用于一屏掌握平台当日经营与设备运行状况。客服角色看不到本页，登录后直接进入「设备信息」。

概览指标

图表与运行状态

快捷入口

菜单位置：数据统计。用于按代理、按套餐做经营分析，两个页面都是纯统计报表，均可导出。

代理激活统计（/admin/AgentActivationStatistics）

按代理维度统计其名下设备的激活与在网情况，用于评估代理活跃度与利润贡献。

操作：点「导出」把当前统计结果导出为表格文件，方便做 Excel 二次分析或发给财务。

设备套餐统计（/admin/DevicePackageOrderStatistics）

按设备套餐统计累计被充值（订购）的次数，用于判断哪些套餐受欢迎。

操作：同样支持点「导出」下载统计结果。

菜单位置：通信管理 → SIM 卡通道（/admin/CardChannel）。通道是平台与上游运营商/卡商之间的接口配置，设备卡的上游状态、流量、实名等信息都靠通道去查询与下发指令。新增通道前请先向上游索取接口文档（账号、密钥、请求地址、对接平台与版本）。

筛选条件

列表字段

操作按钮

新增/编辑通道字段

验证通道

在列表中点「验证通道」，弹窗显示通道名称（不可修改），输入一个卡号后提交，系统会用该通道去上游查询这张卡。若能正常返回卡信息，说明账号、密钥、地址配置正确；若报错，请对照上游接口文档逐项核对参数。

菜单位置：设备管理。这是平台使用频率最高的模块，按「先配置、后运营」的顺序使用：

一、活码配置（/admin/LivceCode）

活码是「一个固定地址、内容可随时更换」的二维码入口。本页维护活码使用的主域名与分发域名，是所有活码地址的生成基础。

二、活码列表（/admin/LivceCodeList）

为具体设备号生成活码，并指定扫码后的跳转行为。支持单条新增、连号批量新增与表格导入三种方式。

三、设备卡片（/admin/deviceCard）

设备卡片即物联网卡本身（ICCID / 虚拟号 / 接入号）。使用前需先通过「通信管理 → SIM 卡通道」把卡入库，平台才能查询到卡的状态与流量。

批量与工具按钮

四、设备列表（/admin/deviceLs）

设备台账主页面，管理所有随身 WiFi 设备：设备号、内置卡、流量、在线状态一屏可见，日常运维操作基本都在这里完成。

在线判定规则：设备最近心跳时间距今小于 11 分钟显示「在线」，否则显示「离线」。

顶部批量按钮

行内「常用操作」

其他表单字段：修改余额（当前余额、修改金额、修改方式 1 增加 / 2 扣除、备注）、限制多卡（1 限制 / 2 解除）、设置备注、设备信息转移（旧设备号、新设备号）、充值套餐（选择套餐、生效类型、订购周期）。

五、设备信息（/admin/deviceDetails）

按设备号查询单台设备的完整档案：状态、卡槽、流量、WIFI、套餐记录与所有可执行操作。客服角色登录后默认进入本页。

页面结构

可执行操作

套餐记录

操作：每条记录可点「编辑」，修改实际总流量(GB)、开始时间、结束时间与套餐包状态（设备号与套餐不可改）。

六、实名规则（/admin/realNameRule）

实名规则决定「设备/卡什么时候要求实名、实名从哪里进」，在「设备规则」中按卡槽绑定，最终作用于用户扫码充值的流程。

操作：新增规则、修改规则（弹窗回填）、删除规则（确认后删除）。
联动规则：选「无需实名」时不显示实名链接等字段；选「自定义填写」需填自定义地址；选「自定义对接」需填请求地址与账号/密码/密钥。

七、设备规则（/admin/deviceRule）

设备规则描述「某一款设备能做什么」：几个网、几个卡槽、是否支持改 WIFI 名/密码、是否支持重启、主卡是哪个运营商、每个卡槽用哪条实名规则等。设备入库时选择规则，用户端充值页面也按规则渲染。

八、设备通道（/admin/deviceChannel）

设备通道是平台与设备厂家（不是运营商）之间的对接配置，负责设备信息的查询与远程指令（重启、改密、停机等）的下发。设备规则必须绑定设备通道。

九、计费组（/admin/Charging）

计费组是「套餐的价格分组」：套餐必须绑定一个计费组，只有与设备所属计费组一致的套餐，才能被该设备（或其代理）订购。代理的售价/成本差异也通过「分配计费组」实现。

菜单位置：用户管理 → 角色管理 / 用户列表。角色决定「谁能看到哪些菜单」，用户列表管理所有代理客户账号及其余额、佣金、计费组与套餐。

一、角色管理（/admin/role）

用于新增后台角色，并为角色勾选可见的菜单，实现按岗位分权。

操作：点「新增角色」创建，点「导出角色」导出角色清单，行内「修改角色」可调整名称与权限。

二、用户列表（/admin/Agent）

以卡片方式展示所有代理（客户）账号，是本平台的核心用户管理入口。

卡片上显示：用户姓名、用户账号、用户佣金、用户余额、用户状态（正常 / 禁止登录）、是否实名。

按钮与行操作

新增/修改代理表单

菜单位置：套餐管理。套餐是平台的主要收入来源，套餐必须先绑定计费组，才能被对应计费组的设备订购。

一、套餐分类（/admin/devicePackageClass）

给套餐分组，便于用户端按分类浏览套餐（如「包月」「加油包」）。

操作：新增分类、修改分类、删除分类（删除前请先把该分类下的套餐改到其他分类）。

二、设备套餐（/admin/devicePackage）

套餐表单字段（节选重点）

菜单位置：订单管理。三个页面对应三类资金流：设备订单（买套餐）、预存订单（代理充值余额）、余额订单（设备余额充值）。三个订单页共用同一套「订单状态」枚举。

通用枚举（三页一致）

余额订单另有「支付方式」子集：1 微信支付 / 2 支付宝 / 3 斗拱聚合 / 4 火脸 / 5 斗拱汇付 / 6 小马哥。

一、设备订单（/admin/DevicePackageOrder）

设备订购套餐的订单，是平台最主要的收入订单。

二、预存订单（/admin/AgentDeposit）

代理给自己的账户充值余额（预存）产生的订单，可在本页对已支付订单退款。

退款操作：仅当订单状态为「成功」且未退款时显示「退款」按钮。弹窗标题为「余额订单退款」，输入框提示「请输入退款金额(可退:{实付金额}元)」，默认填入可退全额。

三、余额订单（/admin/DeviceBlanceOrder）

设备余额（预存）充值订单，只读查询页，没有退款与删除操作。

菜单位置：财务管理。这里记录平台所有资金往来：代理余额与佣金的每一笔变动、提现申请的审核打款，以及发票与客户投诉的处理。

一、余额明细（/admin/balanceList）

代理账户余额的变动流水，每笔都记录变动前后的余额，是核对账目的第一手依据。

操作：点「导出账户余额明细」导出流水；本页不提供修改或退款操作，如需调账请到「用户管理 → 用户列表」的佣金余额调整，或通过订单退款流程处理。

二、佣金明细（/admin/moneyList）

佣金（返佣）的发放与撤回流水，含手续费与到账金额，并可直接发起提现申请。

三、提现记录（/admin/AgentExtractList）

代理提现申请的审核与打款登记页，顶部有 7 张统计卡片（待审核金额/数量、已审核金额/数量、已审核到账金额、已拒绝金额/数量）。

四、发票配置（/admin/invoiceConfig）

配置电子发票平台的对接参数，配置正确后用户端才能申请开票。

操作：新增配置、修改配置、删除配置（确认框显示开票员姓名）。

五、抬头管理（/admin/invoiceHead）

维护可用的开票抬头：抬头类型（1 个人 / 2 企业 / 3 非企业单位）、抬头内容、税号、开户行与银行账号、电话、地址、备注。

六、投诉建议（/admin/complaintList）

C 端用户通过小程序/充值页提交的问题与建议，在这里查看并回复处理（仅系统管理员可见）。

处理流程：点行内「处理」打开「处理投诉建议」弹窗（顶部显示号码、联系电话与内容）→ 选择处理状态（待处理 / 处理中 / 处理完成；待处理不可选）→ 填写处理结果 → 点「保存」。

菜单位置：任务中心。系统有大量后台定时任务在无人值守地跑（流量轮询、达量停机、异常复机、套餐更新、余额预警、通知推送等）。本模块用于查看任务执行记录、单独启停任务，以及定位轮询失败的卡与设备。

一、系统任务（/admin/TaskList）

查看后台异步任务/批量任务的执行记录（例如批量充值、批量导出这类耗时操作）。

操作：「点击下载」下载反馈文件（批量导入/导出结果）；底部「提交」「重置」为查询与清空条件。

二、任务管理（/admin/taskManage）

单独启停每一个后台定时轮询任务。列表展示所有任务开关，无筛选条件，只有「刷新」按钮。

三、轮询失败卡（/admin/errorCard）

列出接口轮询失败的卡片，用于发现上游通道异常或卡状态异常。

操作：支持「导出」与查询/重置。

四、轮询失败设备（/admin/errorDevice）

列出接口轮询失败的设备，用于发现设备通道异常（设备离线、厂家接口报错等）。

操作：支持「导出」与查询/重置。

菜单位置：系统日志。所有页面通用按钮为「提交（查询）」与「重置（清空条件）」，部分页面提供「导出」。日志是排查问题、追溯责任与核对资金的依据，请勿随意删除。

菜单位置：支付配置。这里决定用户「能不能付款、付到哪个商户、提现怎么打款」。配置错误会直接导致支付失败或资金流向错误，修改前请确认账号与商户信息，改完后建议立刻做一笔小额支付与提现验证。

一、公众号配置（/admin/wxPublic）

配置用于微信网页授权/支付的公众号信息，一个平台可配置多套（按归属用户区分）。

操作：新增公众号配置、上传微信公众号支付授权文件、行内修改 / 删除；列表支持按公众号名称、APPID、密钥、归属用户查询，并显示创建/修改日期。

二、微信商户配置（/admin/wxPay）

配置微信支付商户号（收款账户），订单收款与退款都走这里配置的商户。

操作：新增商户、配置教程（跳转官方配置文档）、行内修改商户 / 删除商户。列表另显示商户名称、商户号、APIV3 密钥、关联公众号、开启状态、证书序列号、手续费与创建/修改日期。

三、微信小程序（/admin/WeChatApplet）

配置小程序 AppID / Secret，用于小程序端登录、支付与通知。

操作：新增小程序、行内修改 / 删除；列表显示 APPID、SECRET、状态、备注与创建/修改时间。

四、提现配置（/admin/Withdraw）

统一控制代理提现的规则与通道（间隔、手续费、金额上下限、验证方式等）。

操作：新增配置、行内修改配置 / 删除配置；列表显示全部字段与创建/修改时间。

五、综合配置（/admin/paymentConfig）

配置支付名称（用户支付页显示的商品名）与商户模式。

操作：新增配置、行内修改配置 / 删除配置；列表可显示支付名称、随机减、商户模式、配置状态与创建/修改时间。

菜单位置：风险防控。用于满足实名制合规要求、管理用户协议版本，并限制在高风险地区使用。

一、代理实名（/admin/agentRealName）

查看代理提交的实名认证信息，只读列表，不支持在本页修改或删除。

二、协议管理（/admin/agreement）

维护用户需签署的协议（如入网协议、套餐说明、隐私政策），用户在注册或充值时会看到并签署对应版本。

三、风险地区（/admin/areaTemplate）

维护「禁止发货/禁止激活」的地区模板，模板下按省、市、区三级维护具体地区，套餐或设备可按模板限制使用范围。

菜单位置：通知任务。通过短信与微信向用户推送「流量用尽、充值成功、套餐到期、余额不足、轮询异常」等提醒，可显著减少客服咨询量。使用前需先完成「系统配置 → 短信配置」与「支付配置 → 公众号配置」。

一、短信通知（/admin/SMSNotification）

配置各类短信通知所使用的模板 ID（模板需先在短信服务商后台申请并通过审核）。

操作：添加短信通知、行内修改短信通知 / 删除短信通知；列表显示上述模板 ID 与创建/修改时间。

二、通知计划（/admin/NoticePlan）

设置「什么时候、给谁、发哪些提醒」，可全局生效，也可只针对指定通道或指定客户。

操作：新增通知计划、行内修改通知计划（列表显示应用方式、通道、客户、微信/短信模板、提前提醒、手机号获取方式、提醒阈值、代理余额提醒与状态）。

三、微信通知模板（/admin/WeChatNotice）

管理微信公众号模板消息模板：模板名称、跳转链接（用户点击通知后跳转的页面）、模板 ID（公众号后台申请获得）。

操作：新增模板、行内修改模板 / 删除模板；列表显示模板名称、跳转链接、模板 ID 与创建时间。

四、微信通知计划（/admin/WeChatNoticePlan）

把不同的微信通知模板组合成一个计划，并设置通知间隔。

五、微信通知日志（/admin/WeChatNoticeLogs）

查看微信通知的实际发送情况，用于核实「用户说没收到通知」这类问题。

菜单位置：自动化规则。这里都是「模板」，本身不直接对用户生效，而是被套餐、设备、计费组引用后才起作用。模板的使用方式统一为：先建模板 → 再建子规则 → 最后在套餐/设备中引用。

一、预存模板（/admin/PackagePrestore）

定义「充多少钱、送多少余额/优惠券」的预存规则以及充值说明，用于用户端余额充值页的档位展示。

「批量分配／分配给设备」用于把模板应用到一批设备，设备在用户端充值余额时即按该模板展示档位与赠送。

二、收款额度（/admin/ReceivePaymentTemplate）

码支付/固定金额收款的额度模板，配合面额使用（如「充 100 得 120」）。

三、限速模板（/admin/limitation）

定义「用到多少流量后限速到多少」的规则，在套餐中按卡槽引用。

四、虚量模板（/admin/imaginary）

定义「用户看到的使用量」与「实际使用量」之间的比例关系（虚量），用于成本控制。

五、周期模板（/admin/Cycle）

定义套餐的周期个数规则（如每月一期、两月一期），在套餐的「周期规则」中选择使用。

六、套餐模板（/admin/PackageTemplate）

把若干套餐组合成一个模板，便于批量分配给代理或在特定场景整体上架。

菜单位置：系统配置。这里放的是「与具体业务无关、但影响全站展示与通道是否可用」的基础参数。修改后一般需要用户端（充值端/小程序/APP）刷新或重新进入页面才会生效。

一、系统配置（/admin/setManage）

用于维护站点名称、Logo、备案号等信息，并可通过「绑定域名」为不同代理生成独立站点样式（多站点）。

二、轮播推广（/admin/banner）

向用户端首页投放轮播广告图，可按「充值端 / 商城端 / 代理端」分别投放。

三、短信配置（/admin/MsgConfig）

接入腾讯云短信，用于「注册/登录验证码」以及各类通知短信。若不配置或状态为关闭，用户端将收不到任何短信。

四、预存面额（/admin/APIdenomination）

配置余额充值的面额档位（充多少、送多少），既用于用户端选择档位，也用于后台代充值。

五、前端配置（/admin/phoneRecharge）

配置用户充值端（APP / 小程序 / H5）的标题、客服入口、温馨提示、登录与支付验证方式。一条记录对应一个「应用充值端」。

六、公告配置（/admin/SystemNotice）

发布文字公告，分为「后台公告」（给后台/代理看）与「充值端公告」（给终端用户看）。

七、设备公告（/admin/DevicePhoneNotice）

以海报图片形式在设备端（用户端）弹窗展示的公告，可配跳转链接，适合「新套餐上线」「实名提醒」等运营投放。

菜单位置：素材管理。用于集中上传、分类、复用图片资源（商品图、活动图、公告图等）。素材库中的图片可被商城、公告、活动等模块直接引用，避免反复上传。

一、素材库（/admin/MaterialLibrary）

图片上传与浏览页，以网格形式展示图片，支持按分类筛选、放大预览、删除。

二、图片类型（/admin/GalleryClass）

维护素材库的图片分类，便于按用途归档与检索。

菜单位置：客服管理。用于为不同客户（代理）配置用户端「联系客服」的打开方式，可指向外链网页、平台内置客服页，或企微客服。

一、客服配置（/admin/ServiceConfig）

二、企业微信（客服配置页「企业微信」按钮）

点击列表上方的「企业微信」按钮，弹出企业微信参数维护弹层。参数来自企业微信管理后台的「客户联系 / 自建应用」。