消安行管理平台 - 管理端常见问题

适用对象：机构管理员、教务、运维客服
最后更新：2026-11-08
覆盖系统：消安行管理平台（https://manage.xiaoanxing.net）

---

一、课程权限开通

场景 1：如何给学员开通课程

操作路径：

1. 登录消安行管理平台（https://manage.xiaoanxing.net）
2. 进入「用户管理」→ 找到学员 → 点击「开通套餐」
3. 选择套餐（动态组套餐需勾选具体实操课）→ 确认开通
4. 支持在学员列表勾选多个学员批量开通

到期时间计算规则：

学员当前状态	新开通/续费后到期时间
从未开通或已过期	从当天起算 + 套餐时长
权限仍在有效期内	从现有到期日起算顺延 + 套餐时长（不会浪费剩余天数）

费用规则：

• 机构管理员开通：按套餐定价从机构余额扣费，余额不足会直接拦截并提示
• 超级管理员开通：属平台赠课，不扣费、不产生账单流水

场景 2：开通后学员看不到课程

排查步骤：

1. 确认开通是否成功

   • 「用户管理」→ 找到学员 → 查看「课程权限」
   • 确认对应课程在列表中，且到期时间晚于当前时间

2. 让学员退出小程序重新登录

   • 学员端的课程列表在登录时加载
   • 开通后不重新登录，可能看不到新课程

3. 确认套餐版本

   • 套餐分新旧课纲版本（课改过渡期）
   • 确认开通的套餐版本与学员当前学习版本一致

场景 3：续费后到期时间没有变化

原因：开通时选择的套餐时长较短，或学员权限剩余时间较长，顺延后变化不明显。

排查：

• 查看「课程权限」中该课程行的到期时间是否 = 原到期时间 + 套餐时长
• 如对不上：确认是否重复开通、或由其他管理员开通过其他套餐

---

二、退课与退费逻辑

场景 1：退费的三条路径

路径	适用条件	操作入口
管理端直接退费	消费流水在 3 天内，且非 CRM 订单	「账单管理」→ 找到消费流水 → 退费
CRM 退款审批	CRM 订单收款后 3 天内	CRM 系统 → 订单管理 → 申请退款 → 管理员审批
换版开通	旧课纲学员切换到新版套餐	学员详情 → 换版开通（旧套餐全额退费后开新套餐）

注意：

• CRM 订单只能在 CRM 系统退费，管理端账单页会显示「CRM订单」标签且退费按钮禁用
• 超级管理员退费不受 3 天限制

场景 2：退费后学员的课程权限怎么变

退费类型	权限处理方式
管理端账单退费	按时长反向扣减：套餐内每门课的到期时间回退对应天数，若回退后已过期则该课程失效
CRM 退款审批通过	整批撤销：该订单对应套餐开通的课程权限直接删除
换版开通	旧套餐权限全部作废，新套餐权限重新起算

场景 3：退费按钮是灰色 / 提示无法退费

排查步骤：

1. 查看流水是否带「CRM订单」标签
   • 是 → 必须去 CRM 系统提交退款申请，管理端不允许直接退
2. 查看流水时间是否超过 3 天
   • 超过 → 普通管理员无法退费，请联系超级管理员处理
3. 查看流水状态是否已退费
   • 已退费的流水行显示灰色，不能重复退费

---

三、账单变更的几种场景

机构账单（「账单管理」页面）记录每一笔余额变动，共四种类型：

流水类型	什么时候产生	余额变化
充值	机构充值账户余额（微信支付或线下打款后管理员录入）	➕ 增加
消费	给学员开通套餐扣费（管理端开通、CRM 订单收款确认都会产生）	➖ 减少
退费	账单退费、换版退费、CRM 退款审批通过	➕ 恢复
平移	学员套餐在新旧课纲版本间等值平移（一人一次，不涉及资金）	⭕ 不变（仅留痕）

常见疑问：

Q：为什么有一笔「平移」流水但余额没有变化？ 平移是学员换套餐版本的等值切换，不涉及资金，系统只记录一条平移留痕便于审计。

Q：同一笔消费流水为什么出现了对应的退费流水？ 消费流水被退费后，系统会新增一条退费流水，原消费行标记为「已退费」（灰色显示），两行金额相同、方向相反。

Q：超管开通的课程为什么没有消费流水？ 超级管理员开通属平台赠课，不扣机构余额，因此不产生消费流水。

---

四、课件无法播放排查

课件视频支持两种来源：CC 视频（优先）和七牛云直链（兜底）。学员端播放时优先取 CC 播放地址，取不到时自动回退到七牛云直链；两者都没有时会提示「获取视频信息失败」。

排查总思路

学员反馈某节课无法播放
    ↓
管理端「课件管理」找到该课程 → 对应章节小节
    ↓
查看该小节的「课件视频」和「视频来源」列
    ↓
┌─ 显示「未上传」 → 课件没上传，走【问题 1】
├─ 视频来源含「CC视频」 → 走【问题 2：CC 视频排查】
├─ 视频来源仅「七牛云」 → 走【问题 3：直链排查】
└─ 管理端预览正常、仅学员端不能播 → 走【问题 4】

问题 1：课件显示「未上传」

原因：该小节既没有上传七牛云视频，也没有填写 CC 视频ID。

解决：

• 在「课件管理」→ 对应课程 → 章节 → 小节，点击上传按钮上传视频
• 或在编辑页填写 CC 视频平台的视频ID

问题 2：CC 视频无法播放（重点）

CC 视频按「视频ID」关联播放，逐项排查：

1. 确认视频ID 是否正确

   • 「课件管理」→ 小节编辑页，检查「视频ID」字段
   • 常见错误：ID 复制时带了空格或少了字符、把其他平台的 ID 误填进来
   • 正确的 CC 视频ID 在 CC 视频平台后台可以查到，两边应完全一致

2. 确认 CC 后台视频转码状态

   • CC 视频上传后需要转码，转码完成才能播放
   • 登录 CC 视频平台后台 → 视频列表 → 查看该视频ID 的状态
   • 「转码中」→ 等待转码完成即可，无需处理系统
   • 「审核未通过 / 已删除」→ 需在 CC 后台重新处理，或重新上传并在系统更新视频ID

3. 确认视频是否在 CC 后台被删除

   • 视频被删除后，系统按视频ID 取播放信息会失败
   • 学员端表现为提示「获取视频信息失败，请稍后重试」

4. 确认 CC 账号配置

   • 系统播放 CC 视频依赖账号的「用户ID」和「分组ID」配置
   • 若近期更换过 CC 账号或分组，需技术支持核对配置，业务人员无法自行修改

5. 确认视频有可用清晰度

   • 学员端默认播放「标清」，CC 后台若该视频没有生成标清版本，播放会失败
   • 在 CC 后台检查该视频的清晰度/转码模板配置

快速验证方法：在管理端「课件管理」→ 点击该小节的播放按钮预览，预览弹窗可切换「七牛云 / CC」两个来源对比播放效果：

• CC 源黑屏或报错、七牛云正常 → 问题在 CC 侧（ID/转码/账号配置）
• 两个源都不能播 → 问题在课件本身（未上传成功）

问题 3：七牛云直链视频无法播放

排查步骤：

1. 管理端预览该小节，切换到「七牛云」来源播放验证
2. 如直链失效（文件被清理、存储空间到期），需重新上传课件
3. 检查学员网络环境（弱网下大文件首帧加载慢，表现为长时间黑屏）

问题 4：管理端能播放、仅学员端不能播

排查步骤：

1. 确认学员的课程权限：权限过期后学员无法进入课程页，需先续费
2. 让学员退出小程序重新登录，刷新课程数据
3. 确认学员小程序为最新版本，旧版本可能存在兼容问题
4. 以上都正常仍失败：让学员提供课程名称 + 章节小节名称 + 手机号，联系技术支持处理

---

附录：常用管理入口

功能	入口	地址
消安行管理平台	管理后台	https://manage.xiaoanxing.net
学员管理	管理平台 → 用户管理	https://manage.xiaoanxing.net
课程权限	管理平台 → 用户管理 → 课程权限	https://manage.xiaoanxing.net
账单管理	管理平台 → 账单管理	https://manage.xiaoanxing.net
课件管理	管理平台 → 课程管理 → 课件管理	https://manage.xiaoanxing.net
CRM 系统	消安行 CRM	https://crm.xiaoanxing.net

---

文档版本：v1.0
最后更新：2026-11-08
维护人员：技术支持团队