子能家校平台 · 后台操作指引使用手册

一、手册说明与适用范围

本手册用于指导运营、管理员在「子能家校平台管理后台」中完成日常操作，涵盖登录、各业务模块的增删改查、状态流转与特殊功能。

• 适用角色：超级管理员、平台管理员、区/公司管理员、校方管理员（可见范围由数据域决定，详见第三章）。
• 操作原则：所有写操作（新增/编辑/删除/状态切换）均会在按钮上做权限校验；无权限的按钮对您不可见或不可点击。
• 阅读建议：首次使用请先阅读第二、三、四章；后续按业务模块索引查阅。

二、登录与基础操作

2.1 登录

1. 打开后台登录地址，输入用户名与密码。
2. 点击「登录」；成功后自动进入工作台。
3. 登录失败请确认账号密码；若提示「账号已在其他设备登录」，说明该账号被新设备挤下线（互斥登录机制），旧会话已失效。

2.2 修改密码

位于工作台右上角「修改密码」按钮（弹层）。

2.3 登出

点击右上角头像区域可退出登录（视具体版本入口）。退出后回到登录页。

三、界面布局与权限模型

3.1 界面布局

• 顶部固定区：工作台标题、刷新数据、修改密码、当前角色与昵称、头像。
• 左侧边栏：工作台固定置顶，其余菜单按后端配置渲染（目录可折叠二级）。
• 主内容区：统计卡 / 列表 / 表单弹层。

3.2 权限模型（超级管理员 bypass）

按钮级权限标识形如 xxx:create / xxx:update / xxx:delete。满足权限才显示对应按钮；超级管理员（角色含「超级管理员 / superadmin / admin」）绕过所有细粒度校验，拥有全部操作权限。

3.3 数据域（决定可见范围）

右上角会显示「昵称 · 角色 · 数据域（本校数据 / 全区数据 / 平台数据）」，操作时请注意当前范围。

四、通用操作约定

以下规则在大多数模块通用，遇到时不再单独说明。

4.1 列表与筛选

• 各列表支持关键词搜索 / 下拉筛选 + 服务端分页；输入后点「查询」或回车触发。
• 筛选条件下的分页由后端计算，翻页、增删改后保留当前筛选条件。
• 统计卡（如总数 / 进行中）为全局计数，不随筛选变化。

4.2 新增 / 编辑

• 带 必填 或红色 * 的字段必须填写，否则无法提交。
• 联动字段：如「学段 → 任教学科」「公司 → 学校 → 教师」，先选上级再出现下级选项；修改上级会清空下级已选值。
• 编辑已有数据点击「编辑」会拉取详情回填；部分字段（如身份证、关联）需进入详情才完整。

4.3 删除与状态切换

• 删除通常为逻辑删除（不物理抹除），部分模块有下级依赖时后端会拒绝（如菜单含子节点、公司含学校）。
• 状态切换（草稿 ⇄ 已发布、跟进中等）多为单行按钮，写回后列表即时刷新。

4.4 导入 / 导出

• 导入：先下载模板 → 填写 → 上传文件（multipart）；结果页展示成功 / 失败明细。
• 导出：多数按勾选行或「全部匹配」导出 xlsx；研修活动支持按勾选导出多工作表 / 方案 zip。

4.5 文件上传

统一走上传组件（选完即传，回填地址）。图片一般 ≤ 10MB（jpg/png/gif/webp），视频按模块上限（新闻 ≤ 100MB）。删除已上传文件请在对应控件内操作。

五、工作台（首页）

运营概览页，只读，无需新增。

• 统计卡：在册教师数、进行中活动数（受当前数据域影响，提示「当前数据域可见范围」）。
• 最新活动：按发布时间倒序展示 5 条（活动名、状态、日期、已报名人数），点「查看全部」跳转活动管理。
• 刷新数据：右上角旋转图标按钮；加载时图标旋转且按钮禁用，完成后提示「数据已刷新」。
• 修改密码：见第二章。

六、客户案例管理

6.1 列表操作

• 筛选：案例标题、分类、状态。
• 行操作：编辑、删除、状态切换（草稿 ⇄ 已发布）、前台预览。

6.2 新增 / 编辑要点

七、新闻管理

• 筛选：标题、分类、状态、是否置顶。
• 行操作：编辑、删除、置顶、前台预览。

新增 / 编辑要点

八、产品管理

• 筛选：产品名称、分类、状态。
• 行操作：编辑、删除、状态切换（草稿 ⇄ 已发布）、预览。

编辑为整页多区块表单，可拖拽重排内容块：

九、留言管理

留言来自官网前台，后台为只读处理（无新增）。侧边栏红点 = 未处理 + 待处理数量，处理后会自动刷新。

9.1 筛选与统计

• 筛选：工单号、客户名称、手机号、状态。
• 统计：总数 / 未处理 / 待处理 / 跟进中 / 已处理。

9.2 状态流转（核心操作）

十、站点设置

站点配置全局唯一，保存即更新（部分更新，未填字段保持原值；要清空须显式传空）。

十一、教师管理

11.1 列表操作

• 筛选：姓名、手机号、学校（校管员锁定本校）。
• 支持跨页勾选、本页全选、按勾选 / 全部匹配导出。
• 导入：下载模板 → 填写（学校 / 姓名 / 身份证 / 手机号 / 任教学科 / 入职时间 / 部门职务 / 学段）→ 上传。

11.2 新增 / 编辑要点

十二、线下研修（活动）管理

12.1 列表操作

• 筛选：关键词（研修名称）、起止日期、月份、状态 tab（全部 / 报名中 / 已结束）。
• 统计卡：全部研修 / 报名中 / 总报名人数（全量权威口径）。
• 导出：按勾选导出（每个活动一工作表）、导出方案 zip、按「学校+教师+日期」导出教师维度概览。

12.2 发布 / 编辑要点

12.3 特殊功能

• 签到二维码：编辑态可查看当前签到码；「重新生成」会使旧码作废；支持下载 PNG、复制签到链接。新增未保存时请先保存研修。
• 补签（补签到 / 补签退）：选类型后逐位提交，已完成的教师置灰不可重复补。
• 操作指引：页面内抽屉可查看活动操作说明。

十三、学校管理

• 筛选：名称、状态；统计：总数 / 在册教师 / 正常 / 禁用；支持导出。
• 行操作：详情（抽屉）、编辑、删除、企业微信授权。

企业微信授权（特殊流程）

1. 未授权学校出现橙色「授权」按钮（需有 school:update 权限）。
2. 点击后系统取授权链接并自动打开企业微信扫码页，用「扫一扫」完成授权。
3. 授权完成后返回本页会自动刷新授权状态。

十四、用户管理

• 筛选：用户名、昵称、状态；统计来自 /user/stats。
• 行操作：编辑、删除（权限组合，同组显隐）。

十五、角色管理

• 筛选：角色名、状态；服务端分页 + 统计卡。
• 行操作：编辑、删除（仅超级管理员可写；非超管仅能管理本公司角色）。

十六、菜单管理

树形表格（无分页），支持展开 / 收起。

十七、公司管理

• 筛选：名称、状态；分页 + 统计。
• 行操作：编辑、删除（逻辑删除；含下属学校时后端拒绝）。

十八、内容与资源管理

以下模块前端未做按钮级权限拦截，可见性由后端数据域 / 角色控制；菜单入口仍由权限下发决定。

十九、常见问题与注意事项

Q1. 看不到某个菜单 / 按钮？

菜单由后端按账号权限下发；按钮受 xxx:create/update/delete 权限控制。先确认账号角色与数据域（右上角显示）。无权限的项目对您不可见。

Q2. 点刷新没反应 / 看不到加载？

工作台刷新按钮在加载时图标旋转并禁用，完成后提示「数据已刷新」。若感觉一闪而过，属接口过快，系统已强制 loading 至少展示 500ms 以保证可感知。

Q3. 删除按钮点了没生效？

多为后端拒绝了有下级依赖的记录（如菜单含子节点、公司含学校、角色正在使用中）。请先处理依赖再删除。

Q4. 编辑后数据没更新？

检查是否漏填必填项（表单会拦截提交）；部分字段（如站点配置）为部分更新，未填字段保持原值，要清空须显式传空。

Q5. 被挤下线 / 自动跳登录？

同一账号互斥登录，或 token 过期。重新登录即可；如频繁发生，确认是否多人在用同一账号。