子能家校平台 · 区管理后台操作指引
面向「区管理员」账号的实操手册 —— 仅展示该账号权限范围内的功能模块
1. 登录与退出
区管理员使用专属账号 admin1 登录后台，登录后仅能看到本区数据范围内的功能与记录。
注意：区管理员账号不具备「官网设置」「课程管理 / 阅读管理 / 成果管理 / 资源管理」等超管模块权限，登录后侧边栏不会出现这些菜单。
2. 工作台（首页）
工作台汇聚本区运营概览：关键统计卡片、待办与近期动态，进入系统后的默认首页。
核心内容
- 数据概览卡片：本区学校数、教师数、线下研修活动数、报名人数等汇总指标。
- 快捷入口：常用模块一键跳转。
- 待办 / 动态：需要跟进的事项与近期操作记录。
刷新数据
点击工作台右上角「刷新」按钮：按钮进入旋转加载态（最短展示 500ms 以防无感知），刷新完成后弹出「数据已刷新」提示。
提示：工作台数据按当前账号的数据域过滤，区管理员看到的是本区汇总，而非全平台数据。
3. 用户管理
管理本区后台账号（运营人员、学校管理员等），支持新增、编辑、删除，并分配角色与归属学校。
列表与字段
| 字段 | 说明 |
|---|---|
| 用户名 | 登录账号，唯一。 |
| 昵称 | 展示名称。 |
| 角色 | 关联角色（见第 4 章），决定可操作范围。 |
| 归属学校 | 三类角色须选择学校，并可关联一名本校教师。 |
| 状态 | 启用 / 禁用。 |
关键操作
说明：用户列表不下发「关联教师」字段，编辑时需单独请求用户详情接口回显；归属学校按数据域锁定，区管理员只能在本区学校范围内选择。
4. 权限管理 · 角色管理
通过角色控制各账号能看到的菜单与按钮。区管理员可维护本区所需的角色及菜单授权。
角色与菜单授权
- 新增角色：填写角色名称，勾选该角色可访问的菜单与按钮权限（全量覆盖式保存）。
- 编辑角色：调整角色名称或菜单权限范围。
- 删除角色：移除不再使用的角色。
注意：菜单授权为「全量覆盖」——保存时提交该角色拥有的全部 menuId，未勾选的菜单将从该角色权限中移除，请确认勾选完整后再保存。
提示：超管（admin）在角色写入时后端返回的是角色 ID 整数，前端以
created.id 取值，勿按对象处理。5. 学校管理
维护本区下辖学校的基础信息，是教师与线下研修活动的数据归属单位。
列表与字段
| 字段 | 说明 |
|---|---|
| 学校名称 | 学校全称。 |
| 学段 / 类型 | 学校所属学段或类型。 |
| 联系人 / 电话 | 学校对接人信息。 |
| 状态 | 正常 / 禁用。 |
关键操作
说明：学校是教师与活动的归属维度；区管理员只能管理本区学校，跨区学校不可见、不可改。
6. 教师管理
管理本区教师档案，含任教学科与「是否可参加线下研修活动」开关。
列表与字段
| 字段 | 说明 |
|---|---|
| 姓名 / 工号 | 教师基本信息。 |
| 归属学校 | 教师所属学校（按数据域锁定，区管理员默认本区且不可改）。 |
| 学段 | 培训对象（学段）数字 ID。 |
| 任教学科 | 学科 ID 多选（逗号串存储），列表按字典翻译为中文显示。 |
| 可参加线下研修活动 | 是 / 否（后端字段 participateActivity：1=可参加，0=不能参加）。 |
| 状态 | 启用 / 禁用。 |
关键操作
联动规则：当「可参加线下研修活动 = 是」时，学段与任教学科为必填；切换学段会清空已选学科并重新联动该学段下的学科选项。
说明：任教学科存的是学科 ID（如
3,5），列表展示时翻译为「数学、英语」；空值或脏数据回退显示原始串。7. 线下研修管理
管理本区线下研修活动（培训），含活动创建、报名、签到与统计。
列表与统计
- 统计卡片：活动总数、进行中数量、总报名人数（
stats → {total, inProgress, totalRegistration}）。 - 列表字段：活动名称、学段、时间、地点、状态、报名人数等。
关键操作
yyyy-MM-ddTHH:mm:ss，结束时间建议带 23:59:59）、地点、简介等并保存。GET /activity/{id}/qrcode），用于现场扫码签到。提示：活动列表为服务端筛选 + 服务端分页，筛选与翻页均在后端完成，无需前端二次切片；学段选项来自培训对象接口。
说明：区管理员创建的活动归属本区学校/教师；统计口径为本区数据。
8. 公司管理
区管理员可见并管理所属公司（机构）信息。公司是学校与教师的上级归属单位，是平台组织层级中的「区/机构」节点。
列表与字段
| 字段 | 说明 |
|---|---|
| 公司名称 | 机构 / 公司全称。 |
| 统一社会信用代码 | 机构信用代码（creditCode）。 |
| 联系人 / 电话 | 机构对接人信息。 |
| 地址 | 机构地址。 |
| 状态 | 正常 / 禁用。 |
关键操作
说明：「公司管理」是区管理员侧边栏中的常驻入口（虽不出现在权限菜单树
/permission/my-menu 中，但区管理员实际可见、可访问）。其数据同样按本区范围过滤。9. 附录：数据域与权限说明
平台按「数据域」控制账号可见的数据范围，区管理员处于 district 层级。
| 数据域 | 含义 | 区管理员可见性 |
|---|---|---|
| school | 单校范围 | 为本区学校的数据之和 |
| district | 本区范围（区管理员） | 当前账号层级，可见本区全部学校/教师/活动 |
| all | 全平台（超管） | 超管可见，区管理员不可见 |
区管理员与超管的区别
- 区管理员看得到：工作台、用户管理、权限管理（角色）、学校管理、教师管理、线下研修管理、公司管理。
- 区管理员看不到：官网设置、课程管理、阅读管理、成果管理、资源管理（这些为超管或特定角色模块）。
- 所有增删改操作均受本区数据域约束，跨区数据不可见、不可改。
账号安全：请妥善保管 admin1 密码（123456789），离职或转岗请及时在「用户管理」中禁用或删除对应账号。