17 管理员第一次使用路线：从启动到第一笔业务闭环
本章给第一次接手商城的管理员看。
目标不是讲所有功能，而是让你知道上线前先看哪里、怎么验证商城可用、玩家反馈时从哪里查。
示例视频预留
这里后续可放“管理员第一次启动和检查商城”的视频，例如：/mp4/newwebdoc/17-admin-first-run.mp4
一、启动前确认
覆盖旧后端前，先确认运行目录里有这些关键文件或目录：
| 项目 | 用途 |
|---|---|
数据库配置.ini | 数据库、网站端口、RCON、SFTP/FTP 等核心配置 |
dist | 新版前端页面 |
ScumWebGo.exe | Go 后端主程序 |
启动商城.bat | Windows 一键启动脚本 |
网站/网页 | 旧易语言资源目录，主要用于兼容图片资源 |
家庭用户工具 | FRPC 配置和客户端 |
如果没有 数据库配置.ini，程序会使用默认网站端口 80，但正式服建议保留原配置文件。
二、第一次登录与安全
常见入口：
text
http://你的域名/login.html
http://你的域名/默认管理账号密码以实际部署为准。测试环境常用：
text
dajugame首次进入后台后，建议先做三件事：
- 修改默认管理员密码。
- 确认真正的商城管理员账号。
- 区分商城管理员和 SCUM 服务器管理员。
商城管理员可以登录后台。
SCUM 服务器管理员是 AdminUsers.ini 里的游戏权限。
建家权限用户通常是 user.是否管理员 = 3，这不等于后台管理员。
三、基础连通性检查
进入后台后先看：
text
后台 -> 数据面板重点确认：
| 项目 | 正常表现 |
|---|---|
| 授权状态 | 授权有效，后台 worker 正常运行 |
| RCON 状态 | 已连接或可恢复连接 |
| 发货队列 | 未暂停，队列可消费 |
| 在线玩家 | 能同步到玩家数量和玩家信息 |
| 网站端口 | 后端黑框显示本机监听成功 |
再看：
text
系统 -> 日志命令 -> 日志管理 -> 日志服务器配置确认 SFTP/FTP 能连接，后续网页日志、AdminUsers.ini 同步、配置文件任务都会用到。
四、第一次业务闭环
上线前建议做一次低风险闭环测试。
1. 测试玩家登录
用测试玩家账号登录玩家前端，确认能看到：
- 余额。
- 个人信息。
- 商品或礼包入口。
- 在线人数。
如果开启快捷登录，还要确认 QQ/微信回调域名、协议和端口完全一致。
2. 建一个低价测试商品
路径：
text
商城 -> 商品管理建议先建一个 1 商城币商品，代码使用低风险物品。
购买后检查：
- 玩家余额是否扣除。
- 游戏语句表是否生成发货记录。
- RCON 是否发出命令。
- 玩家游戏内是否收到。
3. 测试礼包
路径：
text
商城 -> 礼包管理测试普通礼包即可。确认网页领取和游戏内 @领取礼包名 逻辑一致。
4. 测试支付或补单
路径：
text
商城 -> 支付设置支付成功不等于到账成功。真正到账以商城收到支付平台回调并写入订单为准。
补单前必须查：
- 支付平台订单。
- 商城订单。
- SteamID。
- 是否已经到账。
不要只凭玩家截图补单。
五、常用后台路径
| 要做什么 | 路径 |
|---|---|
| 修改程序基础设置 | 系统 -> 程序设置 |
| 看运行状态和队列 | 后台 -> 数据面板 |
| 商品配置 | 商城 -> 商品管理 |
| 礼包配置 | 商城 -> 礼包管理 |
| 支付、CDK、建家价格 | 商城 -> 支付设置 |
| 玩家资料和操作 | 玩家 -> 玩家信息 |
| 在线玩家封禁/解封 | 玩家 -> 在线玩家 |
| 建家权限托管 | 系统 -> 日志命令 -> 权限管理 |
| 日志下载与解析 | 系统 -> 日志命令 -> 日志管理 |
| 网页日志查看 | 系统 -> 网页日志 |
| 网页显示控制 | 系统 -> 网页展示 |
| 快捷登录配置 | 系统 -> 快捷登录 |
| 定时内容 | 游戏 -> 定时内容 |
| 区域规则和区域岛 | 游戏 -> 区域规则 |
| 副本挑战 | 游戏 -> 挑战设置 |
六、容易误解的设置
| 设置 | 正确理解 |
|---|---|
| 隐藏微信支付/隐藏支付宝支付 | 勾选是隐藏，不是启用 |
| 数据获取间隔 | 控制在线玩家、坐标、美金、旗帜等同步频率 |
| 发货速度 | 控制 RCON 队列命令发送间隔 |
| 网页日志 UTC+8 | 只影响显示偏移，不改原始日志时间 |
| 建家权限托管 | 开启后商城会管理 AdminUsers.ini |
| 允许空 AdminUsers.ini 上传 | 高风险开关，正式服默认不要开 |
| RCON chatType | 聊天频道，不是任意字体颜色 |
| 游戏美金余额 | 来自 RCON 同步，可能比游戏内慢 |
| CDK 数量字段 | 不同卡类型含义不同，商品卡填商品编号，会员卡填等级 |
七、排障矩阵
网站打不开
检查：
- 黑框是否显示网站监听成功。
- 端口是否被旧进程占用。
- 防火墙是否放行端口。
- FRPC/反代是否指向正确端口。
- 本机
127.0.0.1:端口/healthz是否可访问。
能打开但不能登录
检查：
- 数据库是否连接成功。
- 用户表是否存在。
- 账号密码是否正确。
- 授权是否到期。
- 快捷登录回调地址是否与平台配置一致。
支付不到账
检查：
- 支付平台是否显示成功。
- 商城是否收到回调。
- 订单是否已处理过。
- SteamID 是否匹配。
- 是否需要后台补单。
买了没发货
检查：
- 购买记录是否存在。
- 游戏语句表是否有待发送命令。
- RCON 是否在线。
- 玩家是否在线。
- 发货队列是否暂停。
- 商品代码是否正确。
日志没同步
检查：
- SFTP/FTP 是否可连接。
- 远程目录是否正确。
- 日志文件名是否符合下载范围。
- 日志是否已下载过。
- 解析过程是否报错。
建家权限没写入
检查：
- 建家权限托管是否开启。
- AdminUsers.ini 远程路径是否正确。
- SFTP/FTP 上传是否成功。
- 玩家是否
user.是否管理员 = 3。 - 玩家是否有领地旗坐标。
- 同步状态是否仍在等待。
八、上线建议
正式开放前，至少完成这几项：
- 低价商品购买成功。
- 礼包网页领取成功。
- 游戏内
@领取成功。 - 在线玩家能同步。
- 支付或补单能到账。
- 管理员微信通知可用。
- 日志能下载解析。
- 建家权限能上、能下、能识别初始管理。
完成这些，商城的主链路就基本可控。