5.2 KiB
5.2 KiB
裁判邀请功能使用说明
功能概述
裁判邀请模块用于为武术赛事邀请裁判，通过生成邀请码的方式让裁判登录系统并回复邀请。
完整操作流程
1. 准备工作
1.1 创建赛事
- 进入"赛事管理"模块
- 创建新的赛事
- 确保赛事状态为"进行中"
1.2 添加裁判
- 进入"评委管理"模块
- 点击"新增评委"按钮
- 填写裁判基本信息：
- 姓名、性别、手机号、身份证号
- 裁判类型（主裁判/普通裁判）
- 等级/职称
- 擅长项目
- 保存裁判信息
2. 生成邀请码
方式一：从评委库导入（推荐）
这是为新裁判生成邀请码的主要方式。
操作步骤：
- 进入"裁判邀请"页面
- 选择赛事（页面顶部下拉框）
- 点击"从评委库导入"按钮
- 在弹出的对话框中：
- 可以搜索裁判（按姓名、手机号、类型）
- 勾选需要邀请的裁判（支持多选）
- 查看已选择的裁判数量
- 点击"确定导入"按钮
- 系统自动为选中的裁判批量生成邀请码
- 生成成功后，邀请列表会自动刷新
特点：
- ✅ 支持批量操作
- ✅ 可以搜索和筛选裁判
- ✅ 自动生成邀请码
- ✅ 适合首次邀请裁判
方式二：批量生成邀请码
用于为已有邀请记录但未生成邀请码的裁判批量生成。
操作步骤：
- 在邀请列表中勾选需要生成邀请码的记录
- 点击"批量生成邀请码"按钮
- 确认操作
- 系统为选中的裁判生成邀请码
注意：
- ⚠️ 只能为已有邀请记录的裁判生成
- ⚠️ 如果是新裁判，请使用"从评委库导入"
方式三：单个生成邀请码
用于为单个裁判生成或重新生成邀请码。
操作步骤：
- 在邀请列表中找到目标裁判
- 如果未生成邀请码：点击"生成邀请码"按钮
- 如果已有邀请码：点击邀请码旁边的刷新图标"重新生成"
- 邀请码会自动复制到剪贴板
3. 发送邀请
生成邀请码后，需要将邀请码发送给裁判：
发送方式：
- 📧 邮件：将邀请码通过邮件发送
- 📱 短信：将邀请码通过短信发送
- 💬 微信/其他：通过即时通讯工具发送
邀请码使用：
- 裁判收到邀请码后，访问系统登录页面
- 输入邀请码进行登录
- 查看赛事信息并回复邀请（接受/拒绝）
4. 管理邀请
4.1 查看邀请状态
邀请状态说明：
- 🟡 待回复：已发送邀请，裁判尚未回复
- 🟢 已接受：裁判已接受邀请
- 🔴 已拒绝：裁判已拒绝邀请
- ⚪ 已取消：管理员已取消邀请
4.2 邀请操作
对于"待回复"状态的邀请：
- 重发：重新发送邀请通知
- 提醒：发送提醒消息催促裁判回复
- 取消：取消邀请（需填写取消原因）
对于"已接受"状态的邀请：
- 确认：确认裁判参与（可进行后续的场地、项目分配）
所有邀请：
- 查看：查看邀请详细信息
- 复制邀请码：点击邀请码即可复制
5. 统计信息
页面顶部显示四个统计卡片：
- 📊 总邀请数：已发送的邀请总数
- ⏰ 待回复：等待裁判回复的邀请数
- ✅ 已接受：裁判已接受的邀请数
- ❌ 已拒绝：裁判已拒绝的邀请数
6. 导出数据
点击"导出数据"按钮可以导出当前筛选条件下的邀请列表为Excel文件。
常见问题
Q1: 为什么"批量生成邀请码"按钮是灰色的？
A: 可能的原因：
- 未选择赛事
- 赛事列表正在加载
- 未勾选任何邀请记录
Q2: 如何为新裁判生成邀请码？
A: 使用"从评委库导入"功能：
- 先在"评委管理"中添加裁判
- 在"裁判邀请"页面点击"从评委库导入"
- 选择裁判并确认导入
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
- ✨ 新增"从评委库导入"功能
- ✨ 支持裁判搜索和筛选
- ✨ 优化邀请码生成流程
- 🐛 修复按钮禁用逻辑问题
- 🐛 修复赛事选择初始化问题
- 💄 优化用户界面和交互体验