匹配管理

GET /api/open/v1/matches — 匹配记录列表

权限：open:match:read

查询参数：

参数	类型	必填	说明
page	int	否	页码，默认 1
page_size	int	否	每页条数，默认 20
guest_id	int	否	按嘉宾 ID 筛选
status	string	否	状态：pending / pending_date / dating / completed / rejected / closed
company_id	int	否	按公司筛选
start_date	string	否	开始日期（YYYY-MM-DD）
end_date	string	否	结束日期（YYYY-MM-DD）

响应示例：

{
    "code": 200,
    "message": "success",
    "data": {
        "list": [
            {
                "id": 501,
                "guest_a_id": 1001,
                "guest_b_id": 1002,
                "guest_a_matchmaker_id": 12,
                "guest_b_matchmaker_id": 13,
                "match_score": 85,
                "status": "dating",
                "created_at": "2025-07-25 09:00:00"
            }
        ],
        "total": 42
    }
}

---

POST /api/open/v1/matches — 创建匹配

权限：open:match:write

请求体：

字段	类型	必填	说明
guest_a_id	int	是	嘉宾 A ID
guest_b_id	int	是	嘉宾 B ID
guest_a_matchmaker_id	int	否	嘉宾 A 方红娘 ID
guest_b_matchmaker_id	int	否	嘉宾 B 方红娘 ID

请求示例：

{
    "guest_a_id": 1001,
    "guest_b_id": 1002,
    "guest_a_matchmaker_id": 12,
    "guest_b_matchmaker_id": 13
}

响应示例：

{
    "code": 200,
    "message": "匹配创建成功",
    "data": {
        "id": 502,
        "status": "pending",
        "created_at": "2025-08-05 10:00:00"
    }
}

---

PUT /api/open/v1/matches/{id}/status — 更新匹配状态

权限：open:match:write

路径参数：

参数	类型	说明
id	int	匹配记录 ID

请求体：

字段	类型	必填	说明
status	string	是	目标状态：pending_date / dating / completed / rejected / closed

请求示例：

{
    "status": "dating"
}

响应示例：

{
    "code": 200,
    "message": "状态更新成功",
    "data": {
        "id": 501,
        "status": "dating",
        "updated_at": "2025-08-05 11:00:00"
    }
}