Appearance
系统配置、应用与设备管理
Campus
适用角色
系统管理员、应用管理员、具备相应权限的运维人员。数据字典、系统应用、设备等页面的新增、编辑、删除按角色控制，普通业务用户通常只能查看。
功能说明
本页覆盖「系统管理」下的一组基础配置与运维功能：系统配置（含 App 配置、App 启动页、图片文件上传等）、系统应用（App 版本发布）、数据字典、用户设备、报名设备。这些配置面向全局或多个业务模块生效，属于底层设置，变更前应评估影响范围并做好记录。
操作入口
text
系统管理 > 系统配置
系统管理 > 系统应用
系统管理 > 数据字典
系统管理 > 用户设备
系统管理 > 报名设备截图待补：各功能页面截图。菜单名称与是否显示以本单位实际下发的客户环境为准。
一、系统配置
系统配置页顶部为「系统管理配置」标题，右上角有「重置」和「提交」两个按钮。配置项按「分组」以顶部标签页展示，切换标签即切换分组。
1. 编辑与提交
- 进入「系统配置」，在顶部标签中选择要维护的分组。
- 逐项修改配置。不同配置项会以不同控件呈现（见下「配置项控件类型」）。
- 全部改完后点击右上角「提交」。系统对所有分组的配置一次性保存，成功后提示「成功」并重新加载最新配置。
提交是整页统一保存，会覆盖当前页面上所有分组的配置值。请确认所有标签页内的改动都符合预期后再提交。
2. 重置缓存配置
右上角「重置」按钮用于在配置出现异常时重置缓存配置（按钮悬浮提示为「重置缓存配置(请在配置异常时使用)」）。
- 仅在配置显示异常、疑似缓存不一致时使用。
- 点击后系统执行重置并重新加载配置，成功后提示「成功」。
- 属于运维性操作，正常维护参数值时不需要点它。
3. 配置项控件类型
配置项由后台下发的类型决定展示方式，常见类型包括：
- 文本 / 数字：单行输入框，数字类型只接受数值。
- 开关：显示「开启／关闭」切换。开启对应「true」，关闭对应「false」（历史数据中的「1」也按开启识别）。
- 单选 / 多选：以按钮组形式在若干预设选项中选择，选项由后台下发。
- 时间段：用「开始时间 至 结束时间」的时间选择器维护一个时段。
- 日期时间：选择具体到时分秒的日期时间。
- 图片上传：见下「图片文件上传」。
- 对话框选择 / 标签：通过点击搜索按钮弹出选择框（如公司、用户、库存类别等），选中后回填；标签类型可添加多项并逐个移除。
- 学校位置表格：以表格维护多所学校，每行可填学校名称、通过地图选点设置经纬度位置、设置考勤范围（单位：米）。表头「+」新增行，行尾「删除」移除行。
- 考勤时间表格：以表格维护多个考勤时间段，每行是一个「开始时间 至 结束时间」，表头「+」新增，行尾「删除」移除。
部分配置项右侧会显示灰色备注说明，用于解释该项用途，以实际下发内容为准。
4. 图片文件上传
图片类配置项（如启动页图片）提供上传能力：
- 点击「上传图片」选择本地图片。
- 上传成功后地址会自动回填到旁边的输入框，也可直接粘贴已有图片地址。
- 回填后下方显示缩略预览。
上传校验规则（提交前强制）：
- 格式仅支持 JPG、PNG、WEBP，否则提示「图片只能是 JPG、PNG 或 WEBP 格式」。
- 大小不超过 5MB，否则提示「图片大小不能超过 5MB」。
- 界面建议尺寸为 1080×1920，至少 720×1280。
上传成功提示「上传成功」；若上传成功但未返回地址会提示「上传成功但未返回图片地址」；上传失败会提示失败原因。
5. App 配置与启动页
「App 配置」分组在左侧以子分类进一步细分（如「个人信息」「启动页」等），选中子分类查看对应配置项。
「启动页」子分类提供专门的编辑面板，左侧是配置项、右侧是手机样式的实时预览：
- 预览会根据配置动态呈现：是否启用（未启用时预览置灰）、启动图、「跳过 N 秒」角标、时长（毫秒）、以及是否显示「点击跳转」。
- 启动页涉及的配置项包括：是否启用、启动图、展示时长（毫秒）、是否显示跳过、跳转链接、生效开始时间、生效结束时间。
- 若这些配置项在当前环境尚未初始化，面板顶部会显示黄色告警「启动页配置项未初始化」，并列出缺失的配置项名称；已存在的配置项仍可正常编辑。此时需要先初始化缺失项。
- 预览下方提示「预览用于检查比例和主要元素，真机效果以 App 为准」。启动页时长默认按 1500 毫秒展示。
App 配置与启动页的具体配置项是否存在、以及默认值，取决于本单位实际下发的客户环境。缺失项以面板告警为准，不要臆造。
二、系统应用（App 版本）
「系统应用」用于发布和管理 App 版本更新。列表按版本号、类型、范围、下载地址、更新说明、是否强制更新、创建时间展示，顶部可按「类型」（全部／老师端／学生端）筛选。
新增 / 编辑版本
- 点击工具栏「新增」（或在行「编辑」）打开表单。
- 填写字段：
- 版本（必填）：为空时提示「版本号不能为空」。
- 下载地址（必填）：为空时提示「下载地址不能为空」。
- 对象：老师端 / 学生端。
- 范围（必填）：全部 / 安卓端 / 苹果端；未选择时提示「请选择更新范围」。
- 强制更新（必填）：是 / 否；未选择时提示「请选择是否强制更新」。
- 更新说明：多行文本，填写本次更新内容。
- 点击「提交」保存，成功后提示「更新成功」并刷新列表。
范围与平台的对应关系：选「全部」对同时对 iOS 和安卓生效；选「安卓端」仅安卓；选「苹果端」仅 iOS。列表「范围」列据此显示为「全部／iOS／Android」，两端都未设置时显示「未设置」。
强制更新会影响用户是否可以跳过升级。发布强制更新版本前，确认下载地址可用、版本号正确、更新说明清晰。
三、数据字典
「数据字典」维护系统中各类下拉选项和枚举值。列表按字典类别、字典名称、字典值、排序、描述、创建时间展示，顶部可按字典类别、字典名称、描述筛选。
新增 / 编辑字典
- 点击工具栏「新增」，或在行「编辑」。若在列表上已按某类别筛选，新增时会默认带入该类别。
- 填写字段：
- 字典类别（必填）：从已有类别中选择；未选择时提示「请选择字典类别」。
- 字典名称（必填）：为空时提示「字典名称不能为空」。
- 字典值（必填）：为空时提示「字典值不能为空」。
- 排序：数字，默认 1，值越小越靠前。
- 描述：选填说明。
- 保存方式：
- 「提交」：保存并关闭，成功提示「创建成功」。
- 「继续提交」：保存后不关闭弹窗，自动清空名称/值等字段、保留当前类别、排序自动加 1，便于连续录入同一类别的多条字典。
- 编辑态只有「提交」，成功提示「更新成功」。
字典值被业务模块引用，修改或删除已在使用的字典值前，应评估对相关业务的影响。
四、用户设备
「用户设备」展示用户 App 登录/绑定的设备信息，用于设备核查与解绑。顶部可按用户姓名、手机号查询。
- 列表列：用户、手机号、设备 ID、CPU、主板、设备品牌、产品名称、设备名称、设备型号、绑定时间。
- 行「查看」可打开设备详情，展示用户、手机号、设备 ID、CPU 厂商、主板、设备品牌、产品名称、设备名称、设备型号、绑定时间等信息。
- 该页只支持查看和删除，不支持在此新增设备（设备由用户端绑定生成）。删除按角色控制。
删除设备记录会解除该用户与设备的绑定关系。若业务依赖设备绑定（如单设备登录、考勤校验），删除前应确认影响。
五、报名设备
「报名设备」维护允许用于报名的设备白名单。顶部可按用户姓名、手机号查询，列表按用户、手机号、设备 ID、绑定时间展示。行「查看」可看到用户、手机号、设备 ID、绑定时间。
新增 / 编辑报名设备
- 点击工具栏「新增」（或在行「编辑」）打开表单。
- 填写字段：
- 用户（必填）：点击输入框右侧搜索按钮，从用户选择框中选择；未选择时提示「请选择用户」。
- 设备 ID（必填）：手工输入；为空时提示「请输入设备ID」。
- 点击「提交」保存，新增成功提示「创建成功」，编辑成功提示「更新成功」，并刷新列表。
报名设备直接影响用户能否在指定设备上报名。绑定或删除前，核对用户与设备 ID 的对应关系无误。
关键规则与注意事项
- 系统配置的「提交」是整页统一保存，会覆盖当前所有分组的配置值；「重置」仅用于配置异常时重置缓存，属运维操作。
- 图片上传仅支持 JPG/PNG/WEBP、不超过 5MB，建议尺寸 1080×1920（至少 720×1280）。
- App 启动页预览仅供检查比例和主要元素，真机效果以 App 为准；启动页配置项若未初始化，需先按面板提示初始化缺失项。
- App 版本的版本、下载地址、范围、强制更新为必填；强制更新会限制用户跳过升级，发布前务必核对。
- 数据字典的类别、名称、值为必填；字典值被业务引用，改动前评估影响。
- 用户设备只可查看/删除，设备由用户端绑定生成；删除即解除绑定。
- 新增、编辑、删除等操作按角色控制，普通用户通常只能查看。
- App 配置、启动页、菜单显示等是否在当前环境上线，以本单位实际下发的客户环境为准。
常见问题
系统配置改了没生效
先确认是否点了右上角「提交」（整页统一保存）。若提交后仍异常，可能是缓存不一致，可在「配置异常时」使用右上角「重置」重置缓存配置后再查看。部分配置可能需要重新登录或刷新。
启动页面板提示"配置项未初始化"
说明该环境缺少对应的启动页配置项，面板会列出缺失项名称。需要先初始化这些配置项；已存在的项可以正常编辑，缺失项不会臆造默认值。
图片上传失败或不显示
检查图片格式是否为 JPG/PNG/WEBP、大小是否超过 5MB。上传成功会自动回填地址并显示预览；若提示「上传成功但未返回图片地址」，可手工粘贴图片地址到输入框。
App 版本无法提交
检查必填项：版本号、下载地址不能为空，范围和是否强制更新必须选择。全部填齐后再提交。
报名设备无法保存
确认已通过搜索选择了「用户」，且「设备 ID」已填写，两者均为必填。
版本记录
| 版本 | 日期 | 修改说明 |
|---|---|---|
| v1.0 | 2026-07-27 | 首次建立 |
| v1.1 | 2026-07-27 | 依据前端源码完善内容 |