使用建议与意见收集
系统通用 教师学院管理员超级管理员功能简介
「使用建议与意见收集」是面向全体登录用户（学生除外）的轻量反馈通道：随时提交对系统的使用建议、问题现象与复现说明，支持文字描述与图片附件（直接粘贴截图或选择本地图片）。提交时系统自动记录浏览器、操作系统等环境信息，便于维护人员复现；提交成功后会尝试通过 QQ 给提交人发送一条回执，并通过 QQ 提醒学院管理员有新反馈。管理员可在列表页集中查看、筛选并导出全部反馈。
本功能为系统内置能力，不依赖学院模块开关，无需单独开通。
入口与权限
- 提交入口：首页快捷入口「使用建议与意见收集」卡片（默认在快捷入口最后一行最右侧），或直接访问
/feedback。 - 可提交：教师、学院管理员、超级管理员等所有非学生的登录用户。学生不可用：学生首页不显示该卡片，直接访问返回 403。
- 查看列表与导出：仅学院管理员 / 超级管理员。提交页右上角「建议与意见列表」按钮（非管理员不显示），或访问
/admin/feedbacks；列表页「导出Excel（按当前筛选）」。 - 提醒开关（仅超级管理员）：在「密码重置申请」页下方的「告警接收配置」里，可按学院设置接收提醒的 QQ 和「意见反馈提醒」开启 / 关闭（见 登录与注册）。
操作步骤（分角色）
教师 / 管理员：提交建议或意见
- 点首页「使用建议与意见收集」卡片进入「建议与意见收集」页。顶部「当前用户」自动显示你的姓名和账号，无需填写。
- 在「建议/问题描述」中写明问题现象、操作步骤和期望结果。
- 需要附图时，直接在文本框内粘贴截图，或点「图片附件」选择本地图片；最多 3 张，超出会提示「最多只能附带 3 张图片」。
- 点「提交」。系统先上传图片再保存记录，看到「提交成功，感谢您的反馈！」即表示已收到。
- 需要重填时点「重置」，清空文字和已选图片。
- 文字和图片至少填写一项，两者都为空会提示「请至少填写文字或上传/粘贴图片」。
- 反馈时尽量写清「在哪个页面、点了哪个按钮、出现了什么提示」，并附截图和页脚显示的版本号，处理最快。
学院管理员 / 超级管理员：查看与导出反馈
- 在提交页点「建议与意见列表」，或访问
/admin/feedbacks。 - 列表按提交时间倒序，最多显示最近 200 条；可按以下条件筛选后点「筛选」：
- 关键词：匹配账号（一卡通号）、姓名或反馈内容；
- 开始日期 / 结束日期：按提交日期范围过滤（含结束日期当天）。
- 列表列为：编号、提交时间、姓名、环境（操作系统 / 浏览器、平台）、内容、图片（点击在新窗口预览）。
- 点「导出Excel（按当前筛选）」导出，文件名形如
意见收集_YYYYMMDD_HHMM.xlsx。导出比列表多出一卡通号、IP、User-Agent 等列。 - 点「返回提交页」回到提交页。
字段与状态口径
| 字段 | 含义 |
|---|---|
| 当前用户 / 姓名 | 自动取自当前登录账号与账号资料中的真实姓名，用户不能修改；姓名缺失时按账号显示 |
| 建议/问题描述 | 用户填写的反馈正文 |
| 图片附件 | 粘贴或上传的图片，最多 3 张，只能经系统受控地址预览 |
| 环境（操作系统 / 浏览器 / 平台 / User-Agent） | 由浏览器自动探测填写，用于复现问题环境 |
| IP | 提交时的来源地址（仅导出文件中有） |
| 提交时间 | 记录创建时间，列表按其倒序排列并支持日期筛选 |
- 本功能不设分类字段，也没有处理状态或审批流转，提交即保存。
- 反馈统一存放在全校共用的中心库中，列表不按学院区分：学院管理员与超管看到的都是全部反馈记录。
- 提交人回执：提交成功后系统尝试经学院 QQ 机器人给提交人登记的 QQ 发回执；没收到不影响提交成功。
- 管理员提醒：按提交时所在学院，经该学院 QQ 机器人发送新反馈提醒（默认开启，超管可按学院关闭）；提醒失败同样不影响提交。
常见问题
- 首页没有「使用建议与意见收集」卡片：学生账号不显示；其他角色请确认已登录。
- 学生提交被拒绝（403）：本功能不向学生开放。
- 点提交提示至少填写一项：文字与图片不能都为空。
- 图片传不上去 / 超过数量：最多 3 张，删减后重试。
- 提交后没收到 QQ 回执：回执依赖学院 QQ 机器人在线、账号登记了正确的 QQ 且与机器人可通信；没收到不影响反馈已保存，管理员仍可在列表中看到。
- 看不到「建议与意见列表」按钮 / 访问列表 403：列表与导出仅学院管理员、超级管理员可用。
- 学院管理员在列表里看到了其他学院的反馈：属当前设计，反馈不按学院隔离。