活动管理

GET /api/open/v1/activities — 活动列表

权限：open:activity:read

查询参数：

参数	类型	必填	说明
page	int	否	页码，默认 1
page_size	int	否	每页条数，默认 20
status	string	否	状态：draft / registering / ongoing / ended
company_id	int	否	按公司筛选

响应示例：

{
    "code": 200,
    "message": "success",
    "data": {
        "list": [
            {
                "id": 50,
                "title": "七夕相亲大会",
                "description": "浪漫七夕，遇见对的你...",
                "cover_url": "https://oss.ailian.com/activity/50.jpg",
                "address": "上海浦东香格里拉酒店",
                "start_time": "2025-08-10 14:00:00",
                "end_time": "2025-08-10 18:00:00",
                "male_quota": 50,
                "female_quota": 50,
                "male_fee": 199.00,
                "female_fee": 199.00,
                "status": "registering",
                "audit_status": "approved",
                "company_id": 5,
                "created_at": "2025-07-01 10:00:00"
            }
        ],
        "total": 12
    }
}

---

POST /api/open/v1/activities — 创建活动

权限：open:activity:write

请求体：

字段	类型	必填	说明
title	string	是	活动标题
description	string	否	活动描述
cover_url	string	否	封面图 URL
address	string	是	活动地点
start_time	string	是	开始时间（YYYY-MM-DD HH:mm:ss）
end_time	string	是	结束时间（YYYY-MM-DD HH:mm:ss）
male_quota	int	否	男方名额
female_quota	int	否	女方名额
male_fee	decimal	否	男方费用，0 表示免费
female_fee	decimal	否	女方费用，0 表示免费
company_id	int	是	所属公司 ID

响应示例：

{
    "code": 200,
    "message": "活动创建成功",
    "data": {
        "id": 51,
        "status": "draft",
        "audit_status": "pending",
        "created_at": "2025-08-05 10:00:00"
    }
}

---

POST /api/open/v1/activities/{id}/register — 活动报名

权限：open:activity:write

路径参数：

参数	类型	说明
id	int	活动 ID

请求体：

字段	类型	必填	说明
guest_id	int	是	报名嘉宾 ID
name	string	否	报名人姓名
phone	string	否	报名人手机号
remark	string	否	报名备注

响应示例：

{
    "code": 200,
    "message": "报名成功",
    "data": {
        "registration_id": 201,
        "activity_id": 50,
        "guest_id": 1001,
        "registered_at": "2025-08-05 10:30:00"
    }
}