反馈系统
VOMS 内置了用户反馈功能,用户提交的反馈会通过 BanyanHub SDK 直接同步到 BanyanHub 中央平台,管理员可在 BanyanHub Dashboard 中统一查看、回复和管理。
功能概述
| 能力 | 说明 |
|---|---|
| 提交反馈 | 用户在 VOMS 中提交 Bug 报告、功能建议或问题咨询 |
| 查看反馈 | 用户可查看自己提交的历史反馈及处理状态 |
| 附件上传 | 支持上传截图、日志等附件辅助描述问题 |
| 管理回复 | 管理员在 BanyanHub Dashboard 中回复和更新反馈状态 |
| 版本关联 | 可将反馈关联到特定版本,追踪修复进度 |
| 发版说明 | 用户可查看版本发布说明及已修复的反馈列表 |
用户操作
提交反馈
登录 VOMS 后,进入反馈页面提交反馈:
- 标题(必填):简要描述问题或建议
- 内容(必填):详细说明
- 分类:Bug 报告 / 功能建议 / 问题咨询
- 联系方式:方便管理员联系(可选)
查看我的反馈
在反馈列表页可查看已提交的所有反馈及其当前状态:
| 状态 | 含义 |
|---|---|
pending | 待处理 |
processing | 处理中 |
resolved | 已解决 |
closed | 已关闭 |
管理员操作
反馈数据存储在 BanyanHub 中央平台(Cloudflare D1),管理员通过 BanyanHub Dashboard 进行管理:
- 查看反馈列表 — 按项目、分类、状态筛选
- 更新状态 — 将反馈标记为处理中/已解决/已关闭
- 回复反馈 — 向用户提供解答或处理进展
- 关联版本 — 将反馈关联到修复该问题的制品版本
- 发布说明 — 版本发布时自动关联已解决的反馈
数据流
用户(VOMS)──提交反馈──> VOMS 后端 ──SDK──> BanyanHub API ──> Cloudflare D1
│
管理员 <──── BanyanHub Dashboard <──── BanyanHub Admin API <────────┘反馈数据通过 BanyanHub SDK 加密传输,携带许可证和机器标识信息,确保数据可追溯。
API 接口
| 端点 | 方法 | 说明 | 认证 |
|---|---|---|---|
/api/v1/feedbacks | POST | 提交反馈 | JWT |
/api/v1/feedbacks/my | GET | 查看我的反馈列表 | JWT |
/api/v1/feedbacks/upload | POST | 上传反馈附件 | JWT |
/api/v1/release-notes | GET | 查看版本发布说明 | JWT |