martial/martial-web
4
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
a6768c394a3c225ec35244d1e102967303a71378
martial-web/doc/裁判邀请功能使用说明.md
宅房 d8730cc2c2 fix bugs
2025-12-17 09:31:14 +08:00

5.2 KiB
Raw Blame History

裁判邀请功能使用说明

功能概述

裁判邀请模块用于为武术赛事邀请裁判，通过生成邀请码的方式让裁判登录系统并回复邀请。

完整操作流程

1. 准备工作

1.1 创建赛事

  • 进入"赛事管理"模块
  • 创建新的赛事
  • 确保赛事状态为"进行中"

1.2 添加裁判

  • 进入"评委管理"模块
  • 点击"新增评委"按钮
  • 填写裁判基本信息：
    • 姓名、性别、手机号、身份证号
    • 裁判类型（主裁判/普通裁判）
    • 等级/职称
    • 擅长项目
  • 保存裁判信息

2. 生成邀请码

方式一：从评委库导入（推荐）

这是为新裁判生成邀请码的主要方式。

操作步骤：

  1. 进入"裁判邀请"页面
  2. 选择赛事（页面顶部下拉框）
  3. 点击"从评委库导入"按钮
  4. 在弹出的对话框中：
    • 可以搜索裁判（按姓名、手机号、类型）
    • 勾选需要邀请的裁判（支持多选）
    • 查看已选择的裁判数量
  5. 点击"确定导入"按钮
  6. 系统自动为选中的裁判批量生成邀请码
  7. 生成成功后，邀请列表会自动刷新

特点：

  • ✅ 支持批量操作
  • ✅ 可以搜索和筛选裁判
  • ✅ 自动生成邀请码
  • ✅ 适合首次邀请裁判

方式二：批量生成邀请码

用于为已有邀请记录但未生成邀请码的裁判批量生成。

操作步骤：

  1. 在邀请列表中勾选需要生成邀请码的记录
  2. 点击"批量生成邀请码"按钮
  3. 确认操作
  4. 系统为选中的裁判生成邀请码

注意：

  • ⚠️ 只能为已有邀请记录的裁判生成
  • ⚠️ 如果是新裁判，请使用"从评委库导入"

方式三：单个生成邀请码

用于为单个裁判生成或重新生成邀请码。

操作步骤：

  1. 在邀请列表中找到目标裁判
  2. 如果未生成邀请码：点击"生成邀请码"按钮
  3. 如果已有邀请码：点击邀请码旁边的刷新图标"重新生成"
  4. 邀请码会自动复制到剪贴板

3. 发送邀请

生成邀请码后，需要将邀请码发送给裁判：

发送方式：

  • 📧 邮件：将邀请码通过邮件发送
  • 📱 短信：将邀请码通过短信发送
  • 💬 微信/其他：通过即时通讯工具发送

邀请码使用：

  • 裁判收到邀请码后，访问系统登录页面
  • 输入邀请码进行登录
  • 查看赛事信息并回复邀请（接受/拒绝）

4. 管理邀请

4.1 查看邀请状态

邀请状态说明：

  • 🟡 待回复：已发送邀请，裁判尚未回复
  • 🟢 已接受：裁判已接受邀请
  • 🔴 已拒绝：裁判已拒绝邀请
  • ⚪ 已取消：管理员已取消邀请

4.2 邀请操作

对于"待回复"状态的邀请：

  • 重发：重新发送邀请通知
  • 提醒：发送提醒消息催促裁判回复
  • 取消：取消邀请（需填写取消原因）

对于"已接受"状态的邀请：

  • 确认：确认裁判参与（可进行后续的场地、项目分配）

所有邀请：

  • 查看：查看邀请详细信息
  • 复制邀请码：点击邀请码即可复制

5. 统计信息

页面顶部显示四个统计卡片：

  • 📊 总邀请数：已发送的邀请总数
  • ⏰ 待回复：等待裁判回复的邀请数
  • ✅ 已接受：裁判已接受的邀请数
  • ❌ 已拒绝：裁判已拒绝的邀请数

6. 导出数据

点击"导出数据"按钮可以导出当前筛选条件下的邀请列表为Excel文件。

常见问题

Q1: 为什么"批量生成邀请码"按钮是灰色的？

A: 可能的原因：

  1. 未选择赛事
  2. 赛事列表正在加载
  3. 未勾选任何邀请记录

Q2: 如何为新裁判生成邀请码？

A: 使用"从评委库导入"功能：

  1. 先在"评委管理"中添加裁判
  2. 在"裁判邀请"页面点击"从评委库导入"
  3. 选择裁判并确认导入

Q3: 邀请码可以重复使用吗？

A: 不可以。每个邀请码只能使用一次。如果需要重新邀请，请使用"重新生成"功能。

Q4: 邀请码有效期是多久？

A: 默认有效期为30天。过期后需要重新生成。

Q5: 如何知道裁判是否收到邀请？

A:

  • 查看邀请状态，如果裁判已登录并回复，状态会更新
  • 可以使用"提醒"功能发送提醒消息
  • 建议通过电话或其他方式确认裁判是否收到

技术说明

邀请码生成规则

  • 每个赛事+裁判组合生成唯一邀请码
  • 邀请码包含角色信息（主裁判/普通裁判）
  • 可以预分配场地和项目

数据关联

赛事 (Competition)
  ↓
邀请记录 (JudgeInvite)
  ↓
裁判 (Judge)

API接口

  • 生成邀请码：POST /api/blade-martial/judgeInvite/generate
  • 批量生成：POST /api/blade-martial/judgeInvite/generate/batch
  • 重新生成：PUT /api/blade-martial/judgeInvite/regenerate/{inviteId}
  • 邀请列表：GET /api/blade-martial/judgeInvite/list
  • 邀请统计：GET /api/blade-martial/judgeInvite/statistics

更新日志

2025-12-13

  • ✨ 新增"从评委库导入"功能
  • ✨ 支持裁判搜索和筛选
  • ✨ 优化邀请码生成流程
  • 🐛 修复按钮禁用逻辑问题
  • 🐛 修复赛事选择初始化问题
  • 💄 优化用户界面和交互体验
Reference in New Issue View Git Blame Copy Permalink