fix bugs
This commit is contained in:
181
doc/裁判邀请功能使用说明.md
Normal file
181
doc/裁判邀请功能使用说明.md
Normal file
@@ -0,0 +1,181 @@
|
||||
# 裁判邀请功能使用说明
|
||||
|
||||
## 功能概述
|
||||
|
||||
裁判邀请模块用于为武术赛事邀请裁判，通过生成邀请码的方式让裁判登录系统并回复邀请。
|
||||
|
||||
## 完整操作流程
|
||||
|
||||
### 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
Block a user