martial-admin-mini/doc/如何查看比赛编码和邀请码.md

如何查看比赛编码和邀请码

日期: 2025-12-11 用途: 用于评委登录小程序评分系统

---

📌 概述

评委登录小程序需要两个信息：

1. 比赛编码 (competition_code) - 存储在 martial_competition 表
2. 评委邀请码 (invite_code) - 存储在 martial_judge_invite 表

---

🔍 方式一：通过数据库查询（最直接）

1. 查看比赛编码

-- 查询所有比赛的编码
SELECT
    id AS 比赛ID,
    competition_name AS 比赛名称,
    competition_code AS 比赛编码,
    competition_start_time AS 开始时间,
    competition_end_time AS 结束时间,
    is_deleted AS 是否删除
FROM martial_competition
WHERE is_deleted = 0
ORDER BY create_time DESC;

示例结果:

比赛ID | 比赛名称                          | 比赛编码 | 开始时间            | 结束时间
-------|----------------------------------|---------|--------------------|-----------------
200    | 2025年全国武术散打锦标赛         | WS2025  | 2025-11-06 08:00  | 2025-11-08 18:00

2. 查看评委邀请码

-- 查询某个比赛的所有邀请码
SELECT
    ji.id AS 邀请码ID,
    ji.invite_code AS 邀请码,
    ji.role AS 角色,
    j.name AS 评委姓名,
    j.phone AS 手机号,
    v.venue_name AS 场地名称,
    ji.projects AS 分配项目,
    ji.expire_time AS 过期时间,
    ji.is_used AS 是否已使用,
    ji.use_time AS 使用时间
FROM martial_judge_invite ji
LEFT JOIN martial_judge j ON ji.judge_id = j.id
LEFT JOIN martial_venue v ON ji.venue_id = v.id
WHERE ji.competition_id = 200  -- 替换为实际的比赛ID
  AND ji.is_deleted = 0
ORDER BY ji.role DESC, ji.create_time DESC;

示例结果:

邀请码ID | 邀请码  | 角色        | 评委姓名   | 手机号      | 场地名称  | 过期时间
---------|--------|------------|-----------|------------|----------|------------------
1        | ADMIN01| chief_judge| 张裁判长   | 13800001001| NULL     | 2025-12-18 23:59
2        | JUDGE01| judge      | 李评委     | 13800001002| 一号场地  | 2025-12-18 23:59
3        | JUDGE02| judge      | 王评委     | 13800001003| 二号场地  | 2025-12-18 23:59

3. 组合查询（完整登录信息）

-- 查询完整的登录信息（比赛编码+邀请码）
SELECT
    c.competition_code AS 比赛编码,
    c.competition_name AS 比赛名称,
    ji.invite_code AS 邀请码,
    CASE
        WHEN ji.role = 'chief_judge' THEN '总裁判/裁判长'
        ELSE '普通裁判'
    END AS 角色类型,
    j.name AS 评委姓名,
    v.venue_name AS 场地名称,
    ji.expire_time AS 邀请码过期时间,
    CASE
        WHEN ji.is_used = 1 THEN CONCAT('已使用(', ji.use_time, ')')
        ELSE '未使用'
    END AS 使用状态
FROM martial_competition c
INNER JOIN martial_judge_invite ji ON c.id = ji.competition_id
LEFT JOIN martial_judge j ON ji.judge_id = j.id
LEFT JOIN martial_venue v ON ji.venue_id = v.id
WHERE c.id = 200  -- 替换为实际的比赛ID
  AND c.is_deleted = 0
  AND ji.is_deleted = 0
ORDER BY ji.role DESC, ji.create_time;

示例结果:

比赛编码 | 比赛名称                | 邀请码  | 角色类型      | 评委姓名 | 场地名称
--------|------------------------|--------|--------------|---------|----------
WS2025  | 2025年全国武术散打锦标赛| ADMIN01| 总裁判/裁判长 | 张裁判长 | (全部场地)
WS2025  | 2025年全国武术散打锦标赛| JUDGE01| 普通裁判      | 李评委   | 一号场地
WS2025  | 2025年全国武术散打锦标赛| JUDGE02| 普通裁判      | 王评委   | 二号场地

---

🌐 方式二：通过后端API查询

1. 查询比赛列表

接口: GET http://localhost:8080/martial/competition/list

参数:

{
  "current": 1,
  "size": 10
}

响应:

{
  "code": 200,
  "success": true,
  "data": {
    "records": [
      {
        "id": 200,
        "competitionName": "2025年全国武术散打锦标赛",
        "competitionCode": "WS2025",
        "competitionStartTime": "2025-11-06 08:00:00",
        "competitionEndTime": "2025-11-08 18:00:00"
      }
    ]
  }
}

2. 查询邀请码列表

接口: GET http://localhost:8080/martial/judgeInvite/list

参数:

{
  "current": 1,
  "size": 10,
  "competitionId": 200
}

响应:

{
  "code": 200,
  "success": true,
  "data": {
    "records": [
      {
        "id": 1,
        "inviteCode": "ADMIN01",
        "role": "chief_judge",
        "judgeId": 1,
        "competitionId": 200,
        "venueId": null,
        "projects": "[1001,1002,1003]",
        "expireTime": "2025-12-18 23:59:59",
        "isUsed": 0
      }
    ]
  }
}

---

🖥️ 方式三：通过Swagger API文档查看

访问步骤

1. 启动后端服务

   cd D:\workspace\31.比赛项目\project\martial-master
   # 使用IDEA运行 Application.java
   

2. 访问Swagger文档

   http://localhost:8080/doc.html
   

3. 查看比赛管理接口

   • 找到 "赛事管理" 模块
   • 点击 GET /martial/competition/list 接口
   • 点击 "调试" 按钮
   • 输入参数后点击 "发送"
   • 查看响应中的 competitionCode 字段

4. 查看邀请码管理接口

   • 找到 "裁判邀请码管理" 模块
   • 点击 GET /martial/judgeInvite/list 接口
   • 点击 "调试" 按钮
   • 输入 competitionId 参数
   • 查看响应中的 inviteCode 字段

---

📝 方式四：通过管理后台查看（如果有前端管理系统）

如果您的项目有后台管理系统（通常是另一个前端项目），可以：

1. 登录后台管理系统

   • 访问管理后台地址（例如: http://localhost:8081）
   • 使用管理员账号登录

2. 查看比赛编码

   • 进入 "赛事管理" 菜单
   • 在比赛列表中查看 "赛事编码" 列

3. 查看邀请码

   • 进入 "裁判管理" → "邀请码管理" 菜单
   • 选择对应的比赛
   • 查看邀请码列表

---

🔧 如何生成新的比赛编码和邀请码

1. 创建新比赛（自动生成比赛编码）

INSERT INTO martial_competition (
    competition_name,
    competition_code,  -- 手动指定或自动生成
    competition_start_time,
    competition_end_time,
    venue_address,
    create_time,
    update_time,
    is_deleted
) VALUES (
    '2025年春季武术锦标赛',
    'WS2025SPRING',  -- 比赛编码（建议格式：项目缩写+年份+季节）
    '2025-03-15 08:00:00',
    '2025-03-17 18:00:00',
    '北京体育馆',
    NOW(),
    NOW(),
    0
);

比赛编码命名建议:

• 格式: 项目缩写 + 年份 + 季节/序号
• 示例:
  • WS2025SPRING (武术2025春季)
  • WS2025_01 (武术2025第1场)
  • TJQ2025 (太极拳2025)

2. 生成评委邀请码

-- 为裁判长生成邀请码
INSERT INTO martial_judge_invite (
    competition_id,
    judge_id,
    invite_code,  -- 邀请码（建议随机生成）
    role,         -- chief_judge 或 judge
    venue_id,     -- 裁判长为NULL，普通裁判指定场地
    projects,     -- JSON数组格式: [1001,1002,1003]
    expire_time,
    is_used,
    is_deleted,
    create_time,
    update_time
) VALUES (
    200,          -- 比赛ID
    1,            -- 评委ID
    'ADMIN2025',  -- 邀请码（裁判长）
    'chief_judge',
    NULL,         -- 裁判长不固定场地
    '[1001,1002,1003,1004,1005]',  -- 所有项目
    DATE_ADD(NOW(), INTERVAL 30 DAY),  -- 30天后过期
    0,
    0,
    NOW(),
    NOW()
);

-- 为普通裁判生成邀请码
INSERT INTO martial_judge_invite (
    competition_id,
    judge_id,
    invite_code,
    role,
    venue_id,     -- 指定场地
    projects,
    expire_time,
    is_used,
    is_deleted,
    create_time,
    update_time
) VALUES (
    200,
    2,
    'JUDGE001',   -- 邀请码（普通裁判）
    'judge',
    1,            -- 一号场地
    '[1001,1002]',  -- 分配的项目
    DATE_ADD(NOW(), INTERVAL 30 DAY),
    0,
    0,
    NOW(),
    NOW()
);

邀请码命名建议:

• 裁判长: ADMIN + 年份 或 CHIEF + 编号
  • 示例: ADMIN2025, CHIEF001
• 普通裁判: JUDGE + 编号
  • 示例: JUDGE001, JUDGE002, JUDGE003
• 建议使用随机生成: 6-8位字母数字组合
  • 示例: A3K7M2, P9R4T1

3. 批量生成邀请码的SQL脚本

-- 为一个比赛批量生成评委邀请码（假设已有评委数据）
DELIMITER $$

CREATE PROCEDURE generate_invite_codes(
    IN p_competition_id BIGINT,
    IN p_expire_days INT
)
BEGIN
    DECLARE v_judge_id BIGINT;
    DECLARE v_role VARCHAR(50);
    DECLARE v_venue_id BIGINT;
    DECLARE v_invite_code VARCHAR(50);
    DECLARE v_counter INT DEFAULT 1;
    DECLARE done INT DEFAULT FALSE;

    -- 游标：遍历评委
    DECLARE judge_cursor CURSOR FOR
        SELECT id, role FROM martial_judge WHERE is_deleted = 0;

    DECLARE CONTINUE HANDLER FOR NOT FOUND SET done = TRUE;

    OPEN judge_cursor;

    read_loop: LOOP
        FETCH judge_cursor INTO v_judge_id, v_role;
        IF done THEN
            LEAVE read_loop;
        END IF;

        -- 生成邀请码
        IF v_role = 'chief_judge' THEN
            SET v_invite_code = CONCAT('ADMIN', LPAD(v_counter, 3, '0'));
            SET v_venue_id = NULL;
        ELSE
            SET v_invite_code = CONCAT('JUDGE', LPAD(v_counter, 3, '0'));
            SET v_venue_id = (v_counter % 4) + 1;  -- 循环分配场地
        END IF;

        -- 插入邀请码
        INSERT INTO martial_judge_invite (
            competition_id, judge_id, invite_code, role, venue_id,
            projects, expire_time, is_used, is_deleted, create_time, update_time
        ) VALUES (
            p_competition_id, v_judge_id, v_invite_code, v_role, v_venue_id,
            '[1001,1002,1003]',
            DATE_ADD(NOW(), INTERVAL p_expire_days DAY),
            0, 0, NOW(), NOW()
        );

        SET v_counter = v_counter + 1;
    END LOOP;

    CLOSE judge_cursor;
END$$

DELIMITER ;

-- 使用示例：为比赛ID=200生成邀请码，有效期30天
CALL generate_invite_codes(200, 30);

---

📊 登录测试示例

测试数据准备

假设数据库中有以下数据：

比赛信息:

competition_id: 200
competition_code: WS2025
competition_name: 2025年全国武术散打锦标赛

邀请码信息:

invite_code: ADMIN01  (裁判长)
invite_code: JUDGE01  (普通裁判 - 一号场地)
invite_code: JUDGE02  (普通裁判 - 二号场地)

测试步骤

1. 启动后端服务

   cd D:\workspace\31.比赛项目\project\martial-master
   # 运行 Application.java
   

2. 启动小程序前端

   cd D:\workspace\31.比赛项目\project\martial-admin-mini
   # 使用HBuilderX运行到微信开发者工具
   

3. 测试裁判长登录

   • 访问登录页
   • 输入 比赛编码: WS2025
   • 输入 邀请码: ADMIN01
   • 点击 "立即评分"
   • 预期结果: 跳转到 /pages/score-list-multi/score-list-multi (多场地管理页)

4. 测试普通裁判登录

   • 访问登录页
   • 输入 比赛编码: WS2025
   • 输入 邀请码: JUDGE01
   • 点击 "立即评分"
   • 预期结果: 跳转到 /pages/score-list/score-list (评分列表页)

---

⚠️ 常见问题

问题1: 提示"邀请码不存在"

可能原因:

1. 邀请码输入错误（区分大小写）
2. 邀请码被标记为删除（is_deleted = 1）
3. 数据库中确实不存在该邀请码

解决方法:

-- 检查邀请码是否存在
SELECT * FROM martial_judge_invite
WHERE invite_code = 'YOUR_CODE'
AND is_deleted = 0;

问题2: 提示"比赛编码不匹配"

可能原因:

1. 比赛编码输入错误
2. 邀请码对应的比赛ID与输入的比赛编码不匹配

解决方法:

-- 检查邀请码对应的比赛编码
SELECT
    ji.invite_code,
    c.competition_code,
    c.competition_name
FROM martial_judge_invite ji
INNER JOIN martial_competition c ON ji.competition_id = c.id
WHERE ji.invite_code = 'YOUR_CODE'
AND ji.is_deleted = 0;

问题3: 提示"邀请码已过期"

可能原因: 邀请码的 expire_time 字段已经早于当前时间

解决方法:

-- 延长邀请码有效期
UPDATE martial_judge_invite
SET expire_time = DATE_ADD(NOW(), INTERVAL 30 DAY)
WHERE invite_code = 'YOUR_CODE';

问题4: 登录成功但Token验证失败

可能原因:

1. Token未正确保存到localStorage
2. 请求头中未添加 Blade-Auth
3. Token已过期

解决方法:

// 检查Token是否保存（浏览器控制台）
uni.getStorageSync('token')

// 检查请求头（Network面板）
// 应该有: Blade-Auth: Bearer xxxxx

---

📋 快速查询脚本（复制即用）

-- ============================================
-- 快速查询当前可用的登录信息
-- ============================================

-- 查询所有可用的比赛编码和邀请码
SELECT
    c.competition_code AS '比赛编码（输入到小程序）',
    ji.invite_code AS '邀请码（输入到小程序）',
    c.competition_name AS '比赛名称',
    CASE
        WHEN ji.role = 'chief_judge' THEN '✅ 总裁判/裁判长'
        ELSE '👤 普通裁判'
    END AS '角色',
    j.name AS '评委姓名',
    COALESCE(v.venue_name, '全部场地') AS '负责场地',
    ji.expire_time AS '邀请码过期时间',
    CASE
        WHEN ji.is_used = 1 THEN '❌ 已使用'
        WHEN ji.expire_time < NOW() THEN '⏰ 已过期'
        ELSE '✅ 可用'
    END AS '状态'
FROM martial_competition c
INNER JOIN martial_judge_invite ji ON c.id = ji.competition_id
LEFT JOIN martial_judge j ON ji.judge_id = j.id
LEFT JOIN martial_venue v ON ji.venue_id = v.id
WHERE c.is_deleted = 0
  AND ji.is_deleted = 0
  AND ji.expire_time > NOW()  -- 只显示未过期的
ORDER BY c.id DESC, ji.role DESC, ji.create_time;

---

文档版本: v1.0 最后更新: 2025-12-11 维护者: Claude Code Assistant