功能简介
使用建议与意见收集是一个面向全体登录用户（学生除外）的轻量反馈通道：用户可随时提交对系统的使用建议、问题反馈与复现说明，支持文字描述与图片附件（粘贴截图或本地上传）。提交时系统会自动采集浏览器/操作系统等环境信息，便于管理员复现与排障；提交成功后还会向用户自动发送一条 QQ 回执确认已收到。管理员可在专属列表页集中查看、筛选并导出所有反馈记录。
入口与权限
- 提交入口：首页快捷入口卡片「使用建议与意见收集」（默认置于快捷入口最后一行最右侧），或直接访问
/feedback。 - 可用角色：所有已登录用户均可提交——教师、管理员、超管。学生不可提交：学生账号首页不显示该卡片，直接访问也会被拒绝（403）。
- 管理查看入口：仅管理员 / 超管可见。提交页右上角有「建议与意见列表」按钮，或直接访问
/admin/feedbacks；列表页可按条件导出 Excel（/admin/feedbacks/export）。 - 本功能为系统内置能力，不依赖学院模块开关，无需单独开通。
操作步骤（分角色）
所有用户：提交建议或意见
- 从首页「使用建议与意见收集」卡片进入提交页（页面顶部会显示当前用户姓名与账号，无需手动填写）。
- 在「建议/问题描述」文本框填写建议、问题现象、复现步骤等。
- 如需附图，可：
- 直接在文本框内 粘贴截图；或
- 点击「图片附件」选择本地图片上传。
- 最多附带 3 张 图片，超出会提示。
- 文字与图片至少填写一项（两者都为空无法提交）。
- 点击「提交」。系统先上传图片再提交记录，成功后提示「提交成功，感谢您的反馈！」。
- 如填写有误，可点「重置」清空文本与已选图片重新填写。
管理员 / 超管：查看与导出反馈
- 在提交页点「建议与意见列表」或访问
/admin/feedbacks。 - 列表默认按提交时间倒序展示（最多 200 条），可按以下条件筛选：
- 关键词：匹配账号、姓名或反馈正文；
- 起止日期：按提交日期范围过滤。
- 在列表中查看每条反馈的提交人、姓名、正文、环境信息（操作系统/浏览器/平台/User-Agent/IP）与图片预览。
- 点「导出」按 当前筛选条件 导出 Excel（文件名形如
意见收集_YYYYMMDD_HHMM.xlsx）。
字段与状态口径
| 字段 | 含义 |
|---|
| 提交人 / 姓名 | 自动取自当前登录账号与 central 库 user_profiles.real_name，无需用户填写；姓名缺失时按账号回填显示 |
| 建议/问题描述 | 用户填写的反馈正文（content_text） |
| 图片附件 | 粘贴或上传的截图，最多 3 张，存于上传目录 feedback/ 下，列表页按受控路由预览 |
| 操作系统 / 浏览器 / 平台 / User-Agent | 由前端自动探测填写，用于复现问题环境 |
| IP | 后端按 X-Real-IP / X-Forwarded-For / 远端地址解析记录 |
| 提交时间 | 记录创建时间，列表按其倒序排列、并支持日期范围筛选 |
说明：本功能不设分类/类型字段，反馈为自由文本 + 图片；无审批或状态流转，提交即落库。
常见问题
- 首页没有「使用建议与意见收集」卡片：学生账号不显示该入口；其余角色若仍不可见，请确认已登录。
- 学生提交反馈被拒绝（403）：本功能不向学生开放，学生请通过其它渠道反馈。
- 点提交没有反应/提示至少填写一项：文字与图片均为空时无法提交，请至少填写文字或附一张图片。
- 图片传不上去/超过数量：单次最多 3 张图片，超出会提示；请删减后重试。
- 提交后没收到 QQ 回执：回执依赖可用的 QQ 机器人会话与账号绑定的 QQ 号，发送失败不影响提交成功——记录已正常落库，管理员仍可在列表中看到。
- 管理员看不到列表/导出：列表与导出仅管理员、超管可访问，普通教师无权限。
相关页面
- 首页与导航 首页快捷入口与各模块导航；本反馈卡片位于快捷入口区
- AI客服-小灵 AI客服-小灵助手，可在对话中获取使用帮助，与意见收集互为反馈/答疑渠道