初次提交

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,124 @@
+name: 🐛 问题反馈
+description: 报告VoiceHub系统中的问题或错误
+title: '[Bug]: '
+labels: ['bug', '需要确认']
+assignees: []
+body:
+  - type: markdown
+    attributes:
+      value: |
+        感谢您报告问题！请详细描述遇到的问题，这将帮助我们更快地定位和解决问题。
+
+  - type: dropdown
+    id: bug-type
+    attributes:
+      label: 问题类型
+      description: 请选择最符合的问题类型
+      options:
+        - 音乐播放相关
+        - 用户登录/注册
+        - 点歌功能
+        - 通知系统
+        - 管理员功能
+        - 界面显示
+        - 性能问题
+        - 其他
+    validations:
+      required: true
+
+  - type: textarea
+    id: bug-description
+    attributes:
+      label: 问题描述
+      description: 请详细描述遇到的问题
+      placeholder: 请清楚地描述问题的具体表现...
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps-to-reproduce
+    attributes:
+      label: 复现步骤
+      description: 请提供详细的复现步骤
+      placeholder: |
+        1. 进入...
+        2. 点击...
+        3. 看到错误...
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected-behavior
+    attributes:
+      label: 期望行为
+      description: 描述您期望发生的正确行为
+      placeholder: 应该显示/执行...
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual-behavior
+    attributes:
+      label: 实际行为
+      description: 描述实际发生的错误行为
+      placeholder: 实际显示/执行了...
+    validations:
+      required: true
+
+  - type: dropdown
+    id: browser
+    attributes:
+      label: 浏览器
+      description: 使用的浏览器类型
+      options:
+        - Chrome
+        - Firefox
+        - Safari
+        - Edge
+        - 其他
+    validations:
+      required: false
+
+  - type: input
+    id: browser-version
+    attributes:
+      label: 浏览器版本
+      description: 浏览器的具体版本号
+      placeholder: 例如：Chrome 120.0.0.0
+    validations:
+      required: false
+
+  - type: dropdown
+    id: device-type
+    attributes:
+      label: 设备类型
+      description: 使用的设备类型
+      options:
+        - 桌面电脑
+        - 笔记本电脑
+        - 平板电脑
+        - 手机
+    validations:
+      required: false
+
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: 附加信息
+      description: 任何其他有助于理解问题的信息
+      placeholder: 截图、错误日志、相关配置等...
+    validations:
+      required: false
+
+  - type: checkboxes
+    id: terms
+    attributes:
+      label: 确认事项
+      description: 请确认以下事项
+      options:
+        - label: 我已经搜索了现有的Issues，确认这不是重复问题
+          required: true
+        - label: 我已经尝试刷新页面或重新登录
+          required: false
+        - label: 问题可以稳定复现
+          required: false

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,14 @@
+blank_issues_enabled: true
+contact_links:
+  - name: 📚 使用文档
+    url: https://docs.voicehub.lao-shui.top
+    about: 查看VoiceHub的使用文档和常见问题解答
+  - name: 💬 讨论区
+    url: https://github.com/laoshuikaixue/VoiceHub/discussions
+    about: 在讨论区提问、分享经验或参与社区讨论
+  - name: 🔒 安全问题私密报告
+    url: mailto:contact@lao-shui.top
+    about: 对于严重的安全漏洞，请通过邮件私密报告
+  - name: 📧 联系我们
+    url: mailto:contact@lao-shui.top
+    about: 如果您需要技术支持或有其他问题，可以直接联系我们

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,139 @@
+name: ✨ 功能建议
+description: 为VoiceHub系统提出新功能或改进建议
+title: '[Feature]: '
+labels: ['enhancement', '功能建议']
+assignees: []
+body:
+  - type: markdown
+    attributes:
+      value: |
+        感谢您为VoiceHub提出功能建议！您的想法将帮助我们改进系统，为用户提供更好的体验。
+
+  - type: dropdown
+    id: feature-category
+    attributes:
+      label: 功能类别
+      description: 请选择建议功能所属的类别
+      options:
+        - 音乐播放功能
+        - 点歌系统
+        - 用户管理
+        - 通知系统
+        - 管理员工具
+        - 用户界面
+        - 数据统计
+        - 安全功能
+        - API接口
+        - 其他
+    validations:
+      required: true
+
+  - type: textarea
+    id: feature-summary
+    attributes:
+      label: 功能概述
+      description: 简要描述您建议的功能
+      placeholder: 用一两句话概括您的功能建议...
+    validations:
+      required: true
+
+  - type: textarea
+    id: problem-statement
+    attributes:
+      label: 问题描述
+      description: 描述当前存在的问题或不便之处
+      placeholder: 目前在使用VoiceHub时遇到了什么问题或不便？
+    validations:
+      required: false
+
+  - type: textarea
+    id: proposed-solution
+    attributes:
+      label: 建议方案
+      description: 详细描述您建议的解决方案
+      placeholder: |
+        请详细描述您的功能建议：
+        - 功能如何工作
+        - 用户如何使用
+        - 预期效果
+    validations:
+      required: false
+
+  - type: textarea
+    id: user-stories
+    attributes:
+      label: 用户场景
+      description: 描述用户在什么情况下会使用这个功能
+      placeholder: |
+        作为一个[用户角色]，我希望[功能描述]，这样我就可以[预期收益]。
+
+        例如：
+        - 作为学生，我希望能够预约点歌时间，这样我就可以在特定时间播放我的歌曲
+        - 作为管理员，我希望能够批量管理歌曲，这样我就可以更高效地维护歌曲库
+    validations:
+      required: false
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: 替代方案
+      description: 是否考虑过其他解决方案？
+      placeholder: 描述您考虑过的其他可能的解决方案...
+    validations:
+      required: false
+
+  - type: dropdown
+    id: priority
+    attributes:
+      label: 优先级
+      description: 您认为这个功能的重要程度如何？
+      options:
+        - 高 - 非常重要，急需实现
+        - 中 - 重要，希望尽快实现
+        - 低 - 有了更好，不急
+    validations:
+      required: true
+
+  - type: dropdown
+    id: user-type
+    attributes:
+      label: 目标用户
+      description: 这个功能主要面向哪类用户？
+      options:
+        - 所有用户
+        - 普通学生用户
+        - 管理员
+        - 特定用户群体
+    validations:
+      required: true
+
+  - type: textarea
+    id: technical-considerations
+    attributes:
+      label: 技术考虑
+      description: 如果您有技术背景，可以提供一些技术实现的想法
+      placeholder: 实现思路、技术栈建议、性能考虑等...
+    validations:
+      required: false
+
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: 附加信息
+      description: 任何其他有助于理解功能需求的信息
+      placeholder: 参考资料、类似功能的例子、设计草图等...
+    validations:
+      required: false
+
+  - type: checkboxes
+    id: terms
+    attributes:
+      label: 确认事项
+      description: 请确认以下事项
+      options:
+        - label: 我已经搜索了现有的Issues，确认这不是重复建议
+          required: true
+        - label: 我愿意参与功能的讨论和测试
+          required: false
+        - label: 如果有能力，我愿意协助开发这个功能
+          required: false

.github/ISSUE_TEMPLATE/question.yml

@@ -0,0 +1,112 @@
+name: '❓ 提问 / Question'
+description: '遇到问题需要帮助？在这里提问，我们会尽快为您解答！'
+title: '[Question]: '
+labels: ['question', '需要帮助']
+assignees: []
+body:
+  - type: markdown
+    attributes:
+      value: |
+        感谢您使用 VoiceHub 校园广播点歌系统！如果您在使用过程中遇到任何问题，请填写以下信息，我们会尽快为您提供帮助。
+
+        💡 **提示**：提问前建议先查看已有的 Issues。
+
+  - type: dropdown
+    id: question-type
+    attributes:
+      label: '问题类型'
+      description: '请选择您遇到的问题类型'
+      options:
+        - '使用问题 - 不知道如何操作某个功能'
+        - '技术问题 - 功能无法正常工作'
+        - '配置问题 - 系统设置相关'
+        - '账户问题 - 登录、权限等'
+        - '音频问题 - 播放、上传相关'
+        - '界面问题 - 显示异常或操作困难'
+        - '其他问题'
+    validations:
+      required: true
+
+  - type: textarea
+    id: question-description
+    attributes:
+      label: '问题描述'
+      description: '请详细描述您遇到的问题，包括具体的操作步骤和现象'
+      placeholder: |
+        例如：
+        1. 我在尝试点歌时...
+        2. 点击"添加到播放列表"按钮后...
+        3. 期望的结果是...，但实际发生的是...
+    validations:
+      required: true
+
+  - type: dropdown
+    id: user-role
+    attributes:
+      label: '用户角色'
+      description: '您在系统中的角色是什么？'
+      options:
+        - '学生用户'
+        - '教师用户'
+        - '管理员'
+        - '超级管理员'
+        - '访客'
+    validations:
+      required: true
+
+  - type: input
+    id: environment
+    attributes:
+      label: '使用环境'
+      description: '请提供您的使用环境信息'
+      placeholder: '例如：Chrome 120, Windows 11, 移动端Safari等'
+    validations:
+      required: false
+
+  - type: textarea
+    id: attempted-solutions
+    attributes:
+      label: '已尝试的解决方法'
+      description: '请描述您已经尝试过的解决方法（如果有的话）'
+      placeholder: |
+        例如：
+        - 刷新了页面
+        - 清除了浏览器缓存
+        - 尝试了不同的浏览器
+        - 重新登录了账户
+    validations:
+      required: false
+
+  - type: dropdown
+    id: urgency
+    attributes:
+      label: '紧急程度'
+      description: '这个问题对您的使用影响有多大？'
+      options:
+        - '低 - 不影响正常使用，有时间时解决即可'
+        - '中 - 影响部分功能，希望尽快解决'
+        - '高 - 严重影响使用，需要紧急处理'
+    validations:
+      required: true
+
+  - type: textarea
+    id: additional-info
+    attributes:
+      label: '补充信息'
+      description: '任何其他可能有帮助的信息，如截图、错误信息等'
+      placeholder: '您可以在这里添加截图、错误截图或其他相关信息'
+    validations:
+      required: false
+
+  - type: checkboxes
+    id: confirmation
+    attributes:
+      label: '确认事项'
+      description: '请确认以下事项'
+      options:
+        - label: '我已经搜索了现有的 Issues，确认这不是重复问题'
+          required: true
+        # - label: "我已经查看了项目文档和常见问题"
+        #   required: false
+        - label: '我愿意提供更多信息来帮助解决这个问题'
+          required: false

.github/ISSUE_TEMPLATE/security_report.yml

@@ -0,0 +1,149 @@
+name: 🔒 安全问题报告
+description: 报告VoiceHub系统中的安全漏洞或安全相关问题
+title: '[Security]: '
+labels: ['security', '高优先级']
+assignees: []
+body:
+  - type: markdown
+    attributes:
+      value: |
+        ⚠️ **重要提醒**：如果您发现了严重的安全漏洞，请不要在公开的Issue中详细描述。
+        请发送邮件至 `contact@lao-shui.top` 。
+
+        感谢您帮助我们保护VoiceHub系统的安全！
+
+  - type: dropdown
+    id: security-type
+    attributes:
+      label: 安全问题类型
+      description: 请选择最符合的安全问题类型
+      options:
+        - 身份认证问题
+        - 权限控制问题
+        - 数据泄露风险
+        - 跨站脚本攻击(XSS)
+        - SQL注入
+        - 跨站请求伪造(CSRF)
+        - 文件上传安全
+        - 会话管理问题
+        - 密码安全
+        - API安全
+        - 其他安全问题
+    validations:
+      required: true
+
+  - type: dropdown
+    id: severity
+    attributes:
+      label: 严重程度
+      description: 请评估安全问题的严重程度
+      options:
+        - 严重 - 可能导致系统完全被攻破
+        - 高 - 可能导致重要数据泄露
+        - 中 - 可能影响部分用户或功能
+        - 低 - 轻微的安全改进建议
+    validations:
+      required: true
+
+  - type: textarea
+    id: security-summary
+    attributes:
+      label: 安全问题概述
+      description: 简要描述发现的安全问题（避免详细的攻击步骤）
+      placeholder: 简要说明发现的安全问题类型和影响范围...
+    validations:
+      required: true
+
+  - type: textarea
+    id: affected-components
+    attributes:
+      label: 受影响的组件
+      description: 列出可能受到影响的系统组件或功能模块
+      placeholder: |
+        例如：
+        - 用户登录模块
+        - 文件上传功能
+        - 管理员面板
+        - API接口
+    validations:
+      required: true
+
+  - type: textarea
+    id: potential-impact
+    attributes:
+      label: 潜在影响
+      description: 描述这个安全问题可能造成的影响
+      placeholder: |
+        可能的影响包括：
+        - 用户数据泄露
+        - 未授权访问
+        - 系统功能被滥用
+        - 其他安全风险
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction-info
+    attributes:
+      label: 复现信息
+      description: 提供必要的复现信息（请避免详细的攻击步骤）
+      placeholder: |
+        请提供：
+        - 发现问题的环境
+        - 触发条件
+        - 观察到的异常行为
+
+        注意：请不要提供完整的攻击代码或详细攻击步骤
+    validations:
+      required: false
+
+  - type: textarea
+    id: mitigation-suggestions
+    attributes:
+      label: 缓解建议
+      description: 如果您有安全方面的建议，请提供
+      placeholder: |
+        可能的解决方案：
+        - 输入验证改进
+        - 权限检查加强
+        - 安全配置调整
+        - 其他安全措施
+    validations:
+      required: false
+
+  - type: dropdown
+    id: disclosure-timeline
+    attributes:
+      label: 披露时间线
+      description: 您希望的问题处理时间线
+      options:
+        - 立即处理 - 严重安全问题
+        - 1周内 - 重要安全问题
+        - 2周内 - 一般安全问题
+        - 1个月内 - 安全改进建议
+    validations:
+      required: true
+
+  - type: textarea
+    id: additional-info
+    attributes:
+      label: 附加信息
+      description: 其他有助于理解和解决安全问题的信息
+      placeholder: 相关文档、参考资料、类似案例等...
+    validations:
+      required: false
+
+  - type: checkboxes
+    id: security-terms
+    attributes:
+      label: 安全报告确认
+      description: 请确认以下事项
+      options:
+        - label: 我理解这是一个安全相关的问题报告
+          required: true
+        - label: 我已经避免在公开Issue中透露详细的攻击方法
+          required: true
+        - label: 我愿意配合安全团队进行问题验证和修复
+          required: true
+        - label: 我同意遵循负责任的安全披露原则
+          required: true