会员管理

GET /api/open/v1/memberships — 会员列表

权限：open:membership:read

查询参数：

参数	类型	必填	说明
page	int	否	页码，默认 1
page_size	int	否	每页条数，默认 20
user_id	int	否	按用户 ID 筛选
status	string	否	状态：active / expired / cancelled
company_id	int	否	按公司筛选

响应示例：

{
    "code": 200,
    "message": "success",
    "data": {
        "list": [
            {
                "id": 301,
                "user_id": 1001,
                "guest_id": 1001,
                "plan_name": "年度VIP",
                "plan_id": 2,
                "status": "active",
                "started_at": "2025-06-01 00:00:00",
                "expire_at": "2026-06-01 00:00:00",
                "created_at": "2025-06-01 10:00:00"
            }
        ],
        "total": 88
    }
}

---

POST /api/open/v1/memberships — 创建/续费会员

权限：open:membership:write

请求体：

字段	类型	必填	说明
user_id	int	是	用户 ID
guest_id	int	否	嘉宾 ID
plan_id	int	是	会员套餐 ID

响应示例：

{
    "code": 200,
    "message": "会员开通成功",
    "data": {
        "id": 302,
        "status": "active",
        "expire_at": "2026-08-05 00:00:00"
    }
}