跳到主要内容

首次运行

恭喜您成功安装了 VoiceHub！本指南将帮助您完成首次设置和配置。

启动应用​

开发模式启动​

npm run dev

应用将在 http://localhost:3000 启动。您应该能看到 VoiceHub 的欢迎页面。

验证安装​

  1. 打开浏览器访问 http://localhost:3000
  2. 确认页面正常加载，没有错误信息
  3. 检查浏览器控制台是否有错误

初始设置​

1. 管理员账户登录​

点击页面右上角的"登录"按钮，使用之前创建的管理员账户：

  • 用户名：admin
  • 密码：admin123（或您自定义的密码）

2. 修改管理员密码​

登录后，点击右上角的后台管理，就会自动跳转密码设置页面。

3. 站点基本配置​

进入管理后台，点击"站点配置"标签：

基本信息设置​

  • 站点标题：设置您的广播站名称（如"XX学校广播站"）
  • 站点描述：添加广播站的简介
  • 站点Logo：上传您的广播站Logo

播放时段配置​

设置广播播放的时间段：

  1. 点击"添加时段"
  2. 输入时段名称（如"午间播放"）
  3. 设置开始时间（如"12:00"）（可选）
  4. 设置结束时间（如"13:00"）（可选）
  5. 点击"保存"

您可以添加多个播放时段，系统会自动按时间排序。

4. 学期管理设置​

在"学期管理"标签中创建当前学期：

  1. 点击"创建学期"
  2. 输入学期名称（如"2024-2025学年上学期"）
  3. 设置学期开始和结束日期
  4. 点击"保存"
  5. 将新创建的学期设为"当前学期"

5. 用户管理​

添加用户​

在"用户管理"标签中添加用户：

单个添加：

  1. 点击"添加用户"
  2. 填写用户信息：
    • 姓名
    • 用户名（登录账号）
    • 年级
    • 班级
    • 初始密码
  3. 选择用户角色（普通用户/管理员）
  4. 点击"保存"

批量导入：

  1. 按模板格式填写用户信息
  2. 点击"批量导入"
  3. 选择填写好的Excel文件
  4. 确认导入

权限设置​

为不同用户分配适当的权限：

  • 普通用户：点歌、投票、查看排期
  • 管理员：用户管理、排期管理、歌曲管理
  • 超级管理员：所有权限，包括系统配置

数据备份设置​

建议在正式使用前设置数据备份：

1. 创建初始备份​

在"备份管理"中：

  1. 点击"创建备份"
  2. 选择"完整备份"
  3. 添加备份描述
  4. 点击"开始备份"

性能优化​

1. 数据库优化​

运行数据库检查和优化：

cd scripts && npm run check-db

2. 清理测试数据​

如果需要清理测试数据：

# 谨慎使用，会删除所有数据
node scripts/clear-database.js

下一步​

首次设置完成后，您可以：

获取帮助​

如果在设置过程中遇到问题：

祝您使用愉快！🎵