{
    "swagger": "2.0",
    "info": {
        "title": "mini-chat 接口文档",
        "contact": {},
        "version": "v0.0.1"
    },
    "basePath": "/",
    "paths": {
        "/admin/task_center/simulate/invite_success": {
            "post": {
                "description": "模拟用户邀请成功，触发任务进度更新",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "TaskCenter(Admin)"
                ],
                "summary": "模拟邀请成功(Admin)",
                "parameters": [
                    {
                        "description": "模拟请求",
                        "name": "request",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/taskcenter.simulateInviteSuccessRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "操作成功",
                        "schema": {
                            "type": "object",
                            "additionalProperties": true
                        }
                    }
                }
            }
        },
        "/admin/task_center/simulate/order_paid": {
            "post": {
                "description": "模拟用户支付订单，触发任务进度更新",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "TaskCenter(Admin)"
                ],
                "summary": "模拟订单支付(Admin)",
                "parameters": [
                    {
                        "description": "模拟请求",
                        "name": "request",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/taskcenter.simulateOrderPaidRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "操作成功",
                        "schema": {
                            "type": "object",
                            "additionalProperties": true
                        }
                    }
                }
            }
        },
        "/admin/task_center/tasks": {
            "get": {
                "description": "获取任务管理列表",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "TaskCenter(Admin)"
                ],
                "summary": "任务列表(Admin)",
                "responses": {
                    "200": {
                        "description": "任务列表",
                        "schema": {
                            "type": "object",
                            "additionalProperties": true
                        }
                    }
                }
            },
            "post": {
                "description": "创建一个新的任务",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "TaskCenter(Admin)"
                ],
                "summary": "创建任务(Admin)",
                "parameters": [
                    {
                        "description": "创建任务请求",
                        "name": "request",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/taskcenter.createTaskRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "创建成功",
                        "schema": {
                            "type": "object",
                            "additionalProperties": true
                        }
                    }
                }
            }
        },
        "/admin/task_center/tasks/{id}": {
            "put": {
                "description": "修改指定任务的信息",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "TaskCenter(Admin)"
                ],
                "summary": "修改任务(Admin)",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "任务ID",
                        "name": "id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "description": "修改任务请求",
                        "name": "request",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/taskcenter.modifyTaskRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "修改成功",
                        "schema": {
                            "type": "object",
                            "additionalProperties": true
                        }
                    }
                }
            },
            "delete": {
                "description": "删除指定的任务",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "TaskCenter(Admin)"
                ],
                "summary": "删除任务(Admin)",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "任务ID",
                        "name": "id",
                        "in": "path",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "删除成功",
                        "schema": {
                            "type": "object",
                            "additionalProperties": true
                        }
                    }
                }
            }
        },
        "/admin/task_center/tasks/{id}/rewards": {
            "get": {
                "description": "获取任务层级对应的奖励列表",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "TaskCenter(Admin)"
                ],
                "summary": "获取任务奖励(Admin)",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "任务ID",
                        "name": "id",
                        "in": "path",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "奖励列表",
                        "schema": {
                            "type": "object",
                            "additionalProperties": true
                        }
                    }
                }
            },
            "post": {
                "description": "设置任务层级对应的奖励",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "TaskCenter(Admin)"
                ],
                "summary": "设置任务奖励(Admin)",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "任务ID",
                        "name": "id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "description": "设置奖励请求",
                        "name": "request",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/taskcenter.upsertRewardsRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "设置成功",
                        "schema": {
                            "type": "object",
                            "additionalProperties": true
                        }
                    }
                }
            }
        },
        "/admin/task_center/tasks/{id}/tiers": {
            "get": {
                "description": "获取任务的完成条件层级列表",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "TaskCenter(Admin)"
                ],
                "summary": "获取任务层级(Admin)",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "任务ID",
                        "name": "id",
                        "in": "path",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "层级列表",
                        "schema": {
                            "type": "object",
                            "additionalProperties": true
                        }
                    }
                }
            },
            "post": {
                "description": "设置任务的完成条件层级",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "TaskCenter(Admin)"
                ],
                "summary": "设置任务层级(Admin)",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "任务ID",
                        "name": "id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "description": "设置层级请求",
                        "name": "request",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/taskcenter.upsertTiersRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "设置成功",
                        "schema": {
                            "type": "object",
                            "additionalProperties": true
                        }
                    }
                }
            }
        },
        "/api/admin/activities": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "获取活动列表，支持分类、Boss、状态过滤与分页",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.活动"
                ],
                "summary": "活动列表",
                "parameters": [
                    {
                        "type": "string",
                        "description": "活动名称(模糊)",
                        "name": "name",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "description": "活动分类ID",
                        "name": "category_id",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "description": "是否Boss(0/1)",
                        "name": "is_boss",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "description": "状态(1进行中 2下线)",
                        "name": "status",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "default": 1,
                        "description": "页码",
                        "name": "page",
                        "in": "query",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "default": 20,
                        "description": "每页数量，最多100",
                        "name": "page_size",
                        "in": "query",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.listActivitiesResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            },
            "post": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "创建活动，配置基本信息与分类、Boss标签",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.活动"
                ],
                "summary": "创建活动",
                "parameters": [
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/admin.createActivityRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.simpleMessageResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/activities/{activity_id}": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "查看指定活动的详细信息",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.活动"
                ],
                "summary": "查看活动详情",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "活动ID",
                        "name": "activity_id",
                        "in": "path",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.activityDetailResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            },
            "put": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "修改活动基本信息、分类、Boss标签等",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.活动"
                ],
                "summary": "修改活动",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "活动ID",
                        "name": "activity_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/admin.modifyActivityRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.simpleMessageResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            },
            "delete": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "删除指定活动",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.活动"
                ],
                "summary": "删除活动",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "活动ID",
                        "name": "activity_id",
                        "in": "path",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.simpleMessageResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/activities/{activity_id}/copy": {
            "post": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "根据活动ID深度复制期次与奖品，生成新的活动",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.活动"
                ],
                "summary": "复制活动",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "活动ID",
                        "name": "activity_id",
                        "in": "path",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.copyActivityResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/activities/{activity_id}/game-passes/check": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "检查指定活动是否有用户持有未使用的次数卡，用于下架/删除前校验",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.次数卡"
                ],
                "summary": "检查活动次数卡",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "活动ID",
                        "name": "activity_id",
                        "in": "path",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.checkActivityGamePassesResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/activities/{activity_id}/issues": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "获取指定活动的期数列表，支持分页",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.活动"
                ],
                "summary": "查看活动期数",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "活动ID",
                        "name": "activity_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "default": 1,
                        "description": "页码",
                        "name": "page",
                        "in": "query",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "default": 20,
                        "description": "每页数量，最多100",
                        "name": "page_size",
                        "in": "query",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.listIssuesResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            },
            "post": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "为指定活动创建一个新的期数",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.活动"
                ],
                "summary": "创建活动期数",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "活动ID",
                        "name": "activity_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/admin.createIssueRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.simpleMessage"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/activities/{activity_id}/issues/{issue_id}": {
            "put": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "修改指定期数的信息",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.活动"
                ],
                "summary": "修改活动期数",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "活动ID",
                        "name": "activity_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "description": "期ID",
                        "name": "issue_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/admin.modifyIssueRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.simpleMessage"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            },
            "delete": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "删除指定期数",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.活动"
                ],
                "summary": "删除活动期数",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "活动ID",
                        "name": "activity_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "description": "期ID",
                        "name": "issue_id",
                        "in": "path",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.simpleMessage"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/activities/{activity_id}/issues/{issue_id}/rewards": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "查看指定期数的奖励配置列表",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.活动"
                ],
                "summary": "查看期数奖品",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "活动ID",
                        "name": "activity_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "description": "期ID",
                        "name": "issue_id",
                        "in": "path",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.listRewardsResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            },
            "post": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "为指定期数批量创建奖励配置",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.活动"
                ],
                "summary": "创建期数奖品",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "活动ID",
                        "name": "activity_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "description": "期ID",
                        "name": "issue_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/admin.createRewardsRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.simpleMessageResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/activities/{activity_id}/issues/{issue_id}/rewards/batch": {
            "put": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.活动"
                ],
                "summary": "批量更新期数奖励",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "活动ID",
                        "name": "activity_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "description": "期ID",
                        "name": "issue_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/admin.batchModifyRewardsRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.simpleMessageResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/activities/{activity_id}/issues/{issue_id}/rewards/{reward_id}": {
            "put": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.活动"
                ],
                "summary": "更新期数奖励",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "活动ID",
                        "name": "activity_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "description": "期ID",
                        "name": "issue_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "description": "奖励ID",
                        "name": "reward_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/admin.modifyRewardRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.simpleMessageResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            },
            "delete": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.活动"
                ],
                "summary": "删除期数奖励",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "活动ID",
                        "name": "activity_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "description": "期ID",
                        "name": "issue_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "description": "奖励ID",
                        "name": "reward_id",
                        "in": "path",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.simpleMessageResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/activity_categories": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "获取启用状态的活动分类列表",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.活动"
                ],
                "summary": "活动分类列表",
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.listCategoriesResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/auth/refresh": {
            "post": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.登录"
                ],
                "summary": "管理端令牌刷新",
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.refreshResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/banners": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.运营"
                ],
                "summary": "查看轮播图列表",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "状态",
                        "name": "status",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "default": 1,
                        "description": "页码",
                        "name": "page",
                        "in": "query",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "default": 20,
                        "description": "每页数量",
                        "name": "page_size",
                        "in": "query",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.listBannersResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            },
            "post": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.运营"
                ],
                "summary": "创建轮播图",
                "parameters": [
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/admin.createBannerRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.createBannerResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/banners/{banner_id}": {
            "put": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.运营"
                ],
                "summary": "修改轮播图",
                "parameters": [
                    {
                        "type": "string",
                        "description": "轮播图ID",
                        "name": "banner_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/admin.modifyBannerRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.pcSimpleMessage"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            },
            "delete": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.运营"
                ],
                "summary": "删除轮播图",
                "parameters": [
                    {
                        "type": "string",
                        "description": "轮播图ID",
                        "name": "banner_id",
                        "in": "path",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.pcSimpleMessage"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/game-pass-packages": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "查询次数卡套餐列表",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.次数卡套餐"
                ],
                "summary": "次数卡套餐列表",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "活动ID",
                        "name": "activity_id",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "description": "状态: 1=上架 2=下架",
                        "name": "status",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "description": "页码",
                        "name": "page",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "description": "每页条数",
                        "name": "page_size",
                        "in": "query"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.listGamePassPackagesResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            },
            "post": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "创建可购买的次数卡套餐",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.次数卡套餐"
                ],
                "summary": "创建次数卡套餐",
                "parameters": [
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/admin.createGamePassPackageRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.createGamePassPackageResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/game-pass-packages/{package_id}": {
            "put": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "修改次数卡套餐配置",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.次数卡套餐"
                ],
                "summary": "修改次数卡套餐",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "套餐ID",
                        "name": "package_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/admin.modifyGamePassPackageRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.simpleMessageResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            },
            "delete": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "软删除次数卡套餐",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.次数卡套餐"
                ],
                "summary": "删除次数卡套餐",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "套餐ID",
                        "name": "package_id",
                        "in": "path",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.simpleMessageResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/game-passes/grant": {
            "post": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "管理员为用户发放游戏次数卡",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.次数卡"
                ],
                "summary": "发放次数卡",
                "parameters": [
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/admin.grantGamePassRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.grantGamePassResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/game-passes/list": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "查询用户次数卡列表，支持按用户、活动过滤",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.次数卡"
                ],
                "summary": "次数卡列表",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "description": "活动ID",
                        "name": "activity_id",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "description": "页码",
                        "name": "page",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "description": "每页条数",
                        "name": "page_size",
                        "in": "query"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.listGamePassesResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/login": {
            "post": {
                "description": "管理员登录",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.登录"
                ],
                "summary": "管理员登录",
                "parameters": [
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/admin.loginRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.loginResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/matching/audit/{order_no}": {
            "get": {
                "security": [
                    {
                        "AdminAuth": []
                    }
                ],
                "description": "运营通过单号查询发牌过程",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.对对碰"
                ],
                "summary": "获取对对碰审计数据",
                "parameters": [
                    {
                        "type": "string",
                        "description": "订单号",
                        "name": "order_no",
                        "in": "path",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/activity.MatchingGame"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/matching_card_types": {
            "get": {
                "security": [
                    {
                        "AdminAuth": []
                    }
                ],
                "description": "获取所有卡牌类型配置",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.对对碰"
                ],
                "summary": "列出对对碰卡牌类型",
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.listMatchingCardTypesResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            },
            "post": {
                "security": [
                    {
                        "AdminAuth": []
                    }
                ],
                "description": "创建新的卡牌类型",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.对对碰"
                ],
                "summary": "创建卡牌类型",
                "parameters": [
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/admin.matchingCardTypeRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.matchingCardTypeResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/matching_card_types/{id}": {
            "put": {
                "security": [
                    {
                        "AdminAuth": []
                    }
                ],
                "description": "修改已有的卡牌类型",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.对对碰"
                ],
                "summary": "修改卡牌类型",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "卡牌类型ID",
                        "name": "id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/admin.matchingCardTypeRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.matchingCardTypeResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            },
            "delete": {
                "security": [
                    {
                        "AdminAuth": []
                    }
                ],
                "description": "删除指定的卡牌类型",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.对对碰"
                ],
                "summary": "删除卡牌类型",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "卡牌类型ID",
                        "name": "id",
                        "in": "path",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "type": "object",
                            "additionalProperties": true
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/orders/{order_id}/rollback": {
            "post": {
                "description": "基于快照将用户数据回滚到消费前状态，包括恢复积分、优惠券、道具卡，作废资产，调用微信退款",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "Admin-Audit"
                ],
                "summary": "回滚订单到消费前状态",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "订单ID",
                        "name": "order_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "description": "回滚请求",
                        "name": "request",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/admin.rollbackOrderRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "成功",
                        "schema": {
                            "$ref": "#/definitions/admin.rollbackOrderResponse"
                        }
                    }
                }
            }
        },
        "/api/admin/orders/{order_id}/snapshots": {
            "get": {
                "description": "获取订单消费前后的完整用户状态快照",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "Admin-Audit"
                ],
                "summary": "获取订单审计快照",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "订单ID",
                        "name": "order_id",
                        "in": "path",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "成功",
                        "schema": {
                            "$ref": "#/definitions/admin.getOrderSnapshotsResponse"
                        }
                    }
                }
            }
        },
        "/api/admin/product_categories": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.商品"
                ],
                "summary": "查看商品分类列表",
                "parameters": [
                    {
                        "type": "string",
                        "description": "名称",
                        "name": "name",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "description": "状态",
                        "name": "status",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "default": 1,
                        "description": "页码",
                        "name": "page",
                        "in": "query",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "default": 20,
                        "description": "每页数量",
                        "name": "page_size",
                        "in": "query",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.listProductCategoriesResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            },
            "post": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.商品"
                ],
                "summary": "创建商品分类",
                "parameters": [
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/admin.createProductCategoryRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.createProductCategoryResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/product_categories/{category_id}": {
            "put": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.商品"
                ],
                "summary": "修改商品分类",
                "parameters": [
                    {
                        "type": "string",
                        "description": "分类ID",
                        "name": "category_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/admin.modifyProductCategoryRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.pcSimpleMessage"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            },
            "delete": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.商品"
                ],
                "summary": "删除商品分类",
                "parameters": [
                    {
                        "type": "string",
                        "description": "分类ID",
                        "name": "category_id",
                        "in": "path",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.pcSimpleMessage"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/products": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.商品"
                ],
                "summary": "查看商品列表",
                "parameters": [
                    {
                        "type": "string",
                        "description": "名称",
                        "name": "name",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "description": "分类ID",
                        "name": "category_id",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "description": "状态",
                        "name": "status",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "default": 1,
                        "description": "页码",
                        "name": "page",
                        "in": "query",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "default": 20,
                        "description": "每页数量",
                        "name": "page_size",
                        "in": "query",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.listProductsResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            },
            "post": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.商品"
                ],
                "summary": "创建商品",
                "parameters": [
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/admin.createProductRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.createProductResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/products/batch": {
            "put": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.商品"
                ],
                "summary": "批量更新商品（库存/上下架）",
                "parameters": [
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/admin.batchUpdateProductsRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.batchUpdateProductsResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/products/{product_id}": {
            "put": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.商品"
                ],
                "summary": "修改商品",
                "parameters": [
                    {
                        "type": "string",
                        "description": "商品ID",
                        "name": "product_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/admin.modifyProductRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.pcSimpleMessage"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            },
            "delete": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.商品"
                ],
                "summary": "删除商品",
                "parameters": [
                    {
                        "type": "string",
                        "description": "商品ID",
                        "name": "product_id",
                        "in": "path",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.pcSimpleMessage"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/shipping/orders": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "按批次号或运单号聚合显示发货记录，支持筛选状态、用户、时间等",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.发货管理"
                ],
                "summary": "发货订单列表",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "页码，默认1",
                        "name": "page",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "description": "每页数量，最多100，默认20",
                        "name": "page_size",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "description": "状态：1待发货 2已发货 3已签收 4异常",
                        "name": "status",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "query"
                    },
                    {
                        "type": "string",
                        "description": "批次号",
                        "name": "batch_no",
                        "in": "query"
                    },
                    {
                        "type": "string",
                        "description": "运单号",
                        "name": "express_no",
                        "in": "query"
                    },
                    {
                        "type": "string",
                        "description": "开始日期 2006-01-02",
                        "name": "start_date",
                        "in": "query"
                    },
                    {
                        "type": "string",
                        "description": "结束日期 2006-01-02",
                        "name": "end_date",
                        "in": "query"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.listShippingOrdersResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/shipping/orders/batch": {
            "put": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "为多条发货记录填写运单号或更新状态",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.发货管理"
                ],
                "summary": "批量更新发货信息",
                "parameters": [
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/admin.updateShippingRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.updateShippingResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/shipping/orders/{id}": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "根据发货记录ID获取详情",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.发货管理"
                ],
                "summary": "获取发货订单详情",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "发货记录ID",
                        "name": "id",
                        "in": "path",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/model.ShippingRecords"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/system_item_cards": {
            "get": {
                "description": "管理员获取道具卡列表，支持按名称、状态、类型等条件筛选",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.运营管理"
                ],
                "summary": "获取道具卡列表",
                "parameters": [
                    {
                        "type": "string",
                        "description": "道具卡名称",
                        "name": "name",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "description": "状态：1启用 2禁用",
                        "name": "status",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "description": "道具卡类型：1抽奖卡 2加成卡 3保底卡",
                        "name": "card_type",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "description": "适用范围：1全局 2活动分类 3活动 4期次",
                        "name": "scope_type",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "description": "页码，默认1",
                        "name": "page",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "description": "每页条数，默认10",
                        "name": "page_size",
                        "in": "query"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.listItemCardsResponse"
                        }
                    },
                    "400": {
                        "description": "参数错误",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    },
                    "401": {
                        "description": "未授权",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    },
                    "500": {
                        "description": "服务器内部错误",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            },
            "post": {
                "description": "管理员创建新的道具卡，支持设置类型、效果、有效期等属性",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.运营管理"
                ],
                "summary": "创建道具卡",
                "parameters": [
                    {
                        "description": "创建道具卡请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/admin.createItemCardRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.createItemCardResponse"
                        }
                    },
                    "400": {
                        "description": "参数错误",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    },
                    "401": {
                        "description": "未授权",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    },
                    "403": {
                        "description": "无权限，仅超管可操作",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    },
                    "500": {
                        "description": "服务器内部错误",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/system_item_cards/{item_card_id}": {
            "put": {
                "description": "管理员修改道具卡信息，支持修改名称、价格、有效期等属性",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.运营管理"
                ],
                "summary": "修改道具卡",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "道具卡ID",
                        "name": "item_card_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "description": "修改道具卡请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/admin.modifyItemCardRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.simpleMessageResponse"
                        }
                    },
                    "400": {
                        "description": "参数错误",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    },
                    "401": {
                        "description": "未授权",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    },
                    "403": {
                        "description": "无权限，仅超管可操作",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    },
                    "500": {
                        "description": "服务器内部错误",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            },
            "delete": {
                "description": "管理员删除指定的道具卡",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.运营管理"
                ],
                "summary": "删除道具卡",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "道具卡ID",
                        "name": "item_card_id",
                        "in": "path",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.simpleMessageResponse"
                        }
                    },
                    "400": {
                        "description": "参数错误",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    },
                    "401": {
                        "description": "未授权",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    },
                    "403": {
                        "description": "无权限，仅超管可操作",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    },
                    "500": {
                        "description": "服务器内部错误",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/users": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "查看APP端用户分页列表",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.用户"
                ],
                "summary": "管理端用户列表",
                "parameters": [
                    {
                        "type": "integer",
                        "default": 1,
                        "description": "页码",
                        "name": "page",
                        "in": "query",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "default": 20,
                        "description": "每页数量，最多100",
                        "name": "page_size",
                        "in": "query",
                        "required": true
                    },
                    {
                        "type": "string",
                        "description": "用户昵称",
                        "name": "nickname",
                        "in": "query"
                    },
                    {
                        "type": "string",
                        "description": "邀请码",
                        "name": "inviteCode",
                        "in": "query"
                    },
                    {
                        "type": "string",
                        "description": "开始日期(YYYY-MM-DD)",
                        "name": "startDate",
                        "in": "query"
                    },
                    {
                        "type": "string",
                        "description": "结束日期(YYYY-MM-DD)",
                        "name": "endDate",
                        "in": "query"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.listUsersResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/users/{user_id}/coupons": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "查看指定用户持有的优惠券列表",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.用户"
                ],
                "summary": "查看用户优惠券列表",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "default": 1,
                        "description": "页码",
                        "name": "page",
                        "in": "query",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "default": 20,
                        "description": "每页数量，最多100",
                        "name": "page_size",
                        "in": "query",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.listCouponsResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/users/{user_id}/coupons/add": {
            "post": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "管理端为指定用户发放优惠券",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.用户"
                ],
                "summary": "给用户添加优惠券",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/admin.addCouponRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.addCouponResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/users/{user_id}/game-passes": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "查询指定用户的所有次数卡",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.次数卡"
                ],
                "summary": "查询用户次数卡",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.getUserGamePassesResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/users/{user_id}/game_tickets": {
            "get": {
                "tags": [
                    "管理端.游戏"
                ],
                "summary": "查询用户游戏资格日志",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "description": "页码",
                        "name": "page",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "description": "每页数量",
                        "name": "page_size",
                        "in": "query"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "type": "object",
                            "additionalProperties": true
                        }
                    }
                }
            },
            "post": {
                "tags": [
                    "管理端.游戏"
                ],
                "summary": "发放游戏资格",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/game.grantTicketRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "type": "object",
                            "additionalProperties": true
                        }
                    }
                }
            }
        },
        "/api/admin/users/{user_id}/inventory": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "查看指定用户的资产记录",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.用户"
                ],
                "summary": "查看用户资产列表",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "default": 1,
                        "description": "页码",
                        "name": "page",
                        "in": "query",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "default": 20,
                        "description": "每页数量，最多100",
                        "name": "page_size",
                        "in": "query",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.listInventoryResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/users/{user_id}/invites": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "查看指定用户邀请的用户列表",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.用户"
                ],
                "summary": "查看用户邀请列表",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "default": 1,
                        "description": "页码",
                        "name": "page",
                        "in": "query",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "default": 20,
                        "description": "每页数量，最多100",
                        "name": "page_size",
                        "in": "query",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.listInvitesResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/users/{user_id}/item_cards": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "查看指定用户的道具卡持有记录",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.用户"
                ],
                "summary": "查看用户道具卡列表",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "default": 1,
                        "description": "页码",
                        "name": "page",
                        "in": "query",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "default": 20,
                        "description": "每页数量，最多100",
                        "name": "page_size",
                        "in": "query",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.listUserItemCardsResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            },
            "post": {
                "description": "管理员给指定用户分配道具卡，可指定数量",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.运营管理"
                ],
                "summary": "给用户分配道具卡",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "description": "分配道具卡请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/admin.assignItemCardRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.simpleMessageResponse"
                        }
                    },
                    "400": {
                        "description": "参数错误",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    },
                    "401": {
                        "description": "未授权",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    },
                    "403": {
                        "description": "无权限，仅超管可操作",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    },
                    "500": {
                        "description": "服务器内部错误",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/users/{user_id}/orders": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "查看指定用户的订单记录",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.用户"
                ],
                "summary": "查看用户订单列表",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "default": 1,
                        "description": "页码",
                        "name": "page",
                        "in": "query",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "default": 20,
                        "description": "每页数量，最多100",
                        "name": "page_size",
                        "in": "query",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.listOrdersResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/users/{user_id}/points": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "查看指定用户的积分流水记录",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.用户"
                ],
                "summary": "查看用户积分记录",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "default": 1,
                        "description": "页码",
                        "name": "page",
                        "in": "query",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "default": 20,
                        "description": "每页数量，最多100",
                        "name": "page_size",
                        "in": "query",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.listPointsResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/users/{user_id}/points/add": {
            "post": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "管理端为指定用户发放或扣减积分，正数为增加，负数为扣减",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.用户"
                ],
                "summary": "给用户增加或扣减积分",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/admin.addPointsRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.addPointsResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/users/{user_id}/points/balance": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "查看指定用户当前积分余额（过滤过期）",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.用户"
                ],
                "summary": "查看用户积分余额",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.pointsBalanceResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/users/{user_id}/profile": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "聚合用户基本信息、生命周期财务指标、当前资产快照",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.用户"
                ],
                "summary": "获取用户综合画像",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.UserProfileResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/users/{user_id}/rewards/grant": {
            "post": {
                "description": "管理员给用户发放奖励，支持实物和虚拟奖品，可选择关联活动和奖励配置",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.用户"
                ],
                "summary": "给用户发放奖励",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/admin.GrantRewardRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.GrantRewardResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    },
                    "401": {
                        "description": "Unauthorized",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    },
                    "403": {
                        "description": "Forbidden",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    },
                    "500": {
                        "description": "Internal Server Error",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/users/{user_id}/token": {
            "post": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "仅超级管理员可用，用于测试或紧急场景下为指定用户签发APP令牌",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.用户"
                ],
                "summary": "管理端为APP用户签发令牌",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.issueUserTokenResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/activities": {
            "get": {
                "description": "获取活动列表，支持分类、Boss、状态过滤与分页",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.活动"
                ],
                "summary": "活动列表",
                "parameters": [
                    {
                        "type": "string",
                        "description": "活动名称(模糊)",
                        "name": "name",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "description": "活动分类ID",
                        "name": "category_id",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "description": "是否Boss(0/1)",
                        "name": "is_boss",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "description": "状态(1进行中 2下线)",
                        "name": "status",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "default": 1,
                        "description": "页码",
                        "name": "page",
                        "in": "query",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "default": 20,
                        "description": "每页数量，最多100",
                        "name": "page_size",
                        "in": "query",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.listActivitiesResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/activities/{activity_id}": {
            "get": {
                "description": "获取指定活动的详细信息",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.活动"
                ],
                "summary": "活动详情",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "活动ID",
                        "name": "activity_id",
                        "in": "path",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.activityDetailResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/activities/{activity_id}/issues": {
            "get": {
                "description": "获取指定活动的期列表，支持分页",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.活动"
                ],
                "summary": "活动期列表",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "活动ID",
                        "name": "activity_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "default": 1,
                        "description": "页码",
                        "name": "page",
                        "in": "query",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "default": 20,
                        "description": "每页数量，最多100",
                        "name": "page_size",
                        "in": "query",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.listIssuesResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/activities/{activity_id}/issues/{issue_id}/choices": {
            "get": {
                "description": "返回总位置数量、已占用位置列表以及当前可选位置列表。仅在活动玩法为 ichiban 时可用。",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.活动"
                ],
                "summary": "获取指定活动期的可选位置与已占用位置",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "活动ID",
                        "name": "activity_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "description": "期ID",
                        "name": "issue_id",
                        "in": "path",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.listIssueChoicesResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/activities/{activity_id}/issues/{issue_id}/draw_logs": {
            "get": {
                "description": "查看指定活动期数的抽奖记录，支持等级筛选（默认返回最新的100条，不支持自定义翻页）",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.活动"
                ],
                "summary": "抽奖记录列表",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "活动ID",
                        "name": "activity_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "description": "期ID",
                        "name": "issue_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "description": "奖品等级过滤",
                        "name": "level",
                        "in": "query"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.listDrawLogsResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/activities/{activity_id}/issues/{issue_id}/draw_logs_grouped": {
            "get": {
                "description": "查看指定活动期数的抽奖记录，按奖品等级分组返回",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.活动"
                ],
                "summary": "按奖品等级分类的抽奖记录",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "活动ID",
                        "name": "activity_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "description": "期ID",
                        "name": "issue_id",
                        "in": "path",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.listDrawLogsByLevelResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/activities/{activity_id}/issues/{issue_id}/rewards": {
            "get": {
                "description": "获取指定期的奖励配置列表",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.活动"
                ],
                "summary": "奖励配置列表",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "活动ID",
                        "name": "activity_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "description": "期ID",
                        "name": "issue_id",
                        "in": "path",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.listRewardsResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/address-share/submit": {
            "post": {
                "description": "被邀请者使用分享令牌提交收件信息；服务端校验令牌有效并创建待发货记录（极简方案）",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.用户"
                ],
                "summary": "提交共享地址",
                "parameters": [
                    {
                        "description": "请求参数：令牌与地址信息",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/app.addressShareSubmitRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.addressShareSubmitResponse"
                        }
                    },
                    "400": {
                        "description": "令牌无效/已处理/资产不可用",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/banners": {
            "get": {
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.运营"
                ],
                "summary": "APP端轮播图列表",
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.listAppBannersResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/categories": {
            "get": {
                "description": "获取APP端商品分类列表",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.基础"
                ],
                "summary": "获取分类列表",
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.listAppCategoriesResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/game-passes/available": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "查询当前用户可用的游戏次数卡",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.用户"
                ],
                "summary": "获取用户次数卡",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "活动ID，不传返回所有可用次数卡",
                        "name": "activity_id",
                        "in": "query"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.getGamePassesResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/game-passes/packages": {
            "get": {
                "description": "获取可购买的次数卡套餐列表",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.用户"
                ],
                "summary": "获取次数卡套餐",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "活动ID，不传返回全局套餐",
                        "name": "activity_id",
                        "in": "query"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.getPackagesResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/game-passes/purchase": {
            "post": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "购买次数卡套餐，创建订单等待支付",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.用户"
                ],
                "summary": "购买次数卡套餐",
                "parameters": [
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/app.purchasePackageRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.purchasePackageResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/games/enter": {
            "post": {
                "tags": [
                    "APP端.游戏"
                ],
                "summary": "进入游戏",
                "parameters": [
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/game.enterGameRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/game.enterGameResponse"
                        }
                    }
                }
            }
        },
        "/api/app/lottery/join": {
            "post": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "提交活动ID与期ID创建参与记录与订单，支持积分抵扣，返回参与ID、订单号、抽奖模式及是否进入队列",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.抽奖"
                ],
                "summary": "用户参与抽奖",
                "parameters": [
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/app.joinLotteryRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.joinLotteryResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/lottery/result": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "根据订单号查询抽奖结果与进度，返回结果明细与可验证凭证；需登录",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.抽奖"
                ],
                "summary": "抽奖订单结果查询",
                "parameters": [
                    {
                        "type": "string",
                        "description": "订单号",
                        "name": "order_no",
                        "in": "query",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.orderResultResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/matching/card_types": {
            "get": {
                "description": "获取所有启用的卡牌类型配置，用于App端预览或动画展示",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.活动"
                ],
                "summary": "列出对对碰卡牌类型",
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "type": "array",
                            "items": {
                                "$ref": "#/definitions/activity.CardTypeConfig"
                            }
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/matching/cards": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "只有支付成功后才能获取游戏牌组数据，防止未支付用户获取牌组信息",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.活动"
                ],
                "summary": "获取对对碰游戏数据",
                "parameters": [
                    {
                        "type": "string",
                        "description": "游戏ID",
                        "name": "game_id",
                        "in": "query",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.matchingGameCardsResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/matching/check": {
            "post": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "前端游戏结束后上报结果，服务器发放奖励",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.活动"
                ],
                "summary": "游戏结束结算校验",
                "parameters": [
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/app.matchingGameCheckRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.matchingGameCheckResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/matching/preorder": {
            "post": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "用户下单，服务器扣费并返回全量99张乱序卡牌，前端自行负责游戏流程",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.活动"
                ],
                "summary": "下单并获取对对碰全量数据",
                "parameters": [
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/app.matchingGamePreOrderRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.matchingGamePreOrderResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/matching/state": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "获取当前游戏的完整状态",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.活动"
                ],
                "summary": "获取对对碰游戏状态",
                "parameters": [
                    {
                        "type": "string",
                        "description": "游戏ID",
                        "name": "game_id",
                        "in": "query",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "type": "object",
                            "additionalProperties": true
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/notices": {
            "get": {
                "description": "获取APP首页滚动公告",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.基础"
                ],
                "summary": "获取公告列表",
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.listAppNoticesResponse"
                        }
                    }
                }
            }
        },
        "/api/app/orders/{order_id}": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "获取指定订单的详细信息",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.用户"
                ],
                "summary": "获取订单详情",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "订单ID",
                        "name": "order_id",
                        "in": "path",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/user.OrderWithItems"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/orders/{order_id}/cancel": {
            "post": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "取消指定订单（仅限待付款状态）",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.用户"
                ],
                "summary": "取消订单",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "订单ID",
                        "name": "order_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "description": "取消原因",
                        "name": "body",
                        "in": "body",
                        "schema": {
                            "$ref": "#/definitions/app.cancelOrderRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.cancelOrderResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/pay/wechat/jsapi/preorder": {
            "post": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "根据`order_no`与`openid`创建或复用JSAPI预下单，返回`wx.requestPayment`调起参数；订单需为当前登录用户且状态为待支付",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.支付"
                ],
                "summary": "小程序微信支付预下单",
                "parameters": [
                    {
                        "description": "请求参数：业务订单号与openid",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/app.jsapiPreorderRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.jsapiPreorderResponse"
                        }
                    },
                    "400": {
                        "description": "参数错误/配置缺失/订单不存在或状态不合法/微信预下单失败/签名构建失败",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/products": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "分页查询商品列表，支持分类筛选，返回分页信息与商品数组",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.商品"
                ],
                "summary": "商品列表",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "页码，默认1",
                        "name": "page",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "description": "每页数量，默认20",
                        "name": "page_size",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "description": "分类ID",
                        "name": "category_id",
                        "in": "query"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.listAppProductsResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/products/{id}": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "根据商品ID返回完整商品信息，含相册与同类推荐；校验下架/缺货状态",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.商品"
                ],
                "summary": "商品详情",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "商品ID",
                        "name": "id",
                        "in": "path",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.getAppProductDetailResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/sms/login": {
            "post": {
                "description": "使用短信验证码登录或注册（新手机号自动创建账户）",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.用户"
                ],
                "summary": "短信验证码登录",
                "parameters": [
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/app.smsLoginRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.smsLoginResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/sms/send-code": {
            "post": {
                "description": "发送短信验证码到指定手机号（60秒内不可重复发送，每日最多10次）",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.用户"
                ],
                "summary": "发送短信验证码",
                "parameters": [
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/app.sendSmsCodeRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.sendSmsCodeResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/store/items": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "分页获取积分商城商品列表，支持按类型筛选(product/item_card/coupon)",
                "consumes": [
                    "application/x-www-form-urlencoded"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.积分商城"
                ],
                "summary": "获取积分商城商品列表",
                "parameters": [
                    {
                        "type": "string",
                        "description": "商品类型: product(默认), item_card, coupon",
                        "name": "kind",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "default": 1,
                        "description": "页码",
                        "name": "page",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "default": 20,
                        "description": "每页数量",
                        "name": "page_size",
                        "in": "query"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.listStoreItemsResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/task-center/tasks": {
            "get": {
                "description": "获取当前可用的任务列表，支持分页",
                "consumes": [
                    "application/x-www-form-urlencoded"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "TaskCenter(App)"
                ],
                "summary": "获取任务列表(App)",
                "parameters": [
                    {
                        "type": "integer",
                        "default": 1,
                        "description": "页码",
                        "name": "page",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "default": 20,
                        "description": "每页数量",
                        "name": "page_size",
                        "in": "query"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "任务列表",
                        "schema": {
                            "$ref": "#/definitions/taskcenter.listTasksResponse"
                        }
                    }
                }
            }
        },
        "/api/app/task-center/tasks/{id}/claim/{user_id}": {
            "post": {
                "description": "用户领取指定任务层级的奖励",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "TaskCenter(App)"
                ],
                "summary": "领取任务奖励(App)",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "任务ID",
                        "name": "id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "description": "领取请求",
                        "name": "request",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/taskcenter.claimTaskRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "领取成功",
                        "schema": {
                            "type": "object",
                            "additionalProperties": true
                        }
                    }
                }
            }
        },
        "/api/app/task-center/tasks/{id}/progress/{user_id}": {
            "get": {
                "description": "获取指定用户在特定任务上的进度详情",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "TaskCenter(App)"
                ],
                "summary": "获取用户任务进度(App)",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "任务ID",
                        "name": "id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "任务进度详情",
                        "schema": {
                            "$ref": "#/definitions/taskcenter.taskProgressResponse"
                        }
                    }
                }
            }
        },
        "/api/app/users/douyin/login": {
            "post": {
                "description": "抖音小程序登录（需传递 code 或 anonymous_code）",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.用户"
                ],
                "summary": "抖音登录",
                "parameters": [
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/app.douyinLoginRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.douyinLoginResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/users/profile": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "获取当前登录用户的详细信息",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.用户"
                ],
                "summary": "获取用户信息",
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.userItem"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/users/weixin/login": {
            "post": {
                "description": "微信静默登录（需传递 code；可选 invite_code）",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.用户"
                ],
                "summary": "微信登录",
                "parameters": [
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/app.weixinLoginRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.weixinLoginResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/users/{user_id}": {
            "put": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "修改用户昵称与头像",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.用户"
                ],
                "summary": "修改用户信息",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/app.modifyUserRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.modifyUserResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/users/{user_id}/addresses": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "分页获取当前登录用户的收货地址列表，默认地址优先",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.用户"
                ],
                "summary": "获取用户地址列表",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "description": "页码，默认1",
                        "name": "page",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "description": "每页条数，默认20，最多100",
                        "name": "page_size",
                        "in": "query"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.listAddressesResponse"
                        }
                    },
                    "400": {
                        "description": "参数错误",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    },
                    "401": {
                        "description": "未授权",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    },
                    "500": {
                        "description": "服务器内部错误",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            },
            "post": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "为当前登录用户新增收货地址，可选择设为默认",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.用户"
                ],
                "summary": "新增用户地址",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/app.addAddressRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.addAddressResponse"
                        }
                    },
                    "400": {
                        "description": "参数错误",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    },
                    "401": {
                        "description": "未授权",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    },
                    "500": {
                        "description": "服务器内部错误",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/users/{user_id}/addresses/{address_id}": {
            "put": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "更新当前登录用户的指定收货地址",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.用户"
                ],
                "summary": "更新用户地址",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "description": "地址ID",
                        "name": "address_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/app.updateAddressRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.okResponse"
                        }
                    },
                    "400": {
                        "description": "参数错误",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    },
                    "401": {
                        "description": "未授权",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    },
                    "500": {
                        "description": "服务器内部错误",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            },
            "delete": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "删除当前登录用户的指定收货地址",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.用户"
                ],
                "summary": "删除用户地址",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "description": "地址ID",
                        "name": "address_id",
                        "in": "path",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.okDeleteResponse"
                        }
                    },
                    "400": {
                        "description": "参数错误",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    },
                    "401": {
                        "description": "未授权",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    },
                    "500": {
                        "description": "服务器内部错误",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/users/{user_id}/addresses/{address_id}/default": {
            "put": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "将指定地址设置为当前登录用户的默认地址",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.用户"
                ],
                "summary": "设置默认用户地址",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "description": "地址ID",
                        "name": "address_id",
                        "in": "path",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.okResponse"
                        }
                    },
                    "400": {
                        "description": "参数错误",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    },
                    "401": {
                        "description": "未授权",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    },
                    "500": {
                        "description": "服务器内部错误",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/users/{user_id}/coupons": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "查看用户持有的优惠券列表，支持按状态过滤",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.用户"
                ],
                "summary": "查看用户优惠券",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "default": 1,
                        "description": "页码",
                        "name": "page",
                        "in": "query",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "default": 20,
                        "description": "每页数量，最多100",
                        "name": "page_size",
                        "in": "query",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "description": "状态：1未使用 2已使用 3已过期，不传默认1",
                        "name": "status",
                        "in": "query"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.listCouponsResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/users/{user_id}/coupons/stats": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "获取用户优惠券各状态数量和累计金额",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.用户"
                ],
                "summary": "获取用户优惠券统计",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.couponStatsResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/users/{user_id}/coupons/{user_coupon_id}/usage": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "获取指定优惠券的使用记录，包含优惠券详情、订单号、活动名称",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.用户"
                ],
                "summary": "获取单张优惠券使用记录",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "description": "用户优惠券ID",
                        "name": "user_coupon_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "description": "页码，默认1",
                        "name": "page",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "description": "每页数量，默认20",
                        "name": "page_size",
                        "in": "query"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.listCouponUsageResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/users/{user_id}/douyin/phone/bind": {
            "post": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "使用抖音手机号 code 换取手机号并绑定到指定用户",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.用户"
                ],
                "summary": "抖音绑定手机号",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/app.bindDouyinPhoneRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.bindDouyinPhoneResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/users/{user_id}/game_tickets": {
            "get": {
                "tags": [
                    "APP端.游戏"
                ],
                "summary": "获取我的游戏资格",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "type": "object",
                            "additionalProperties": {
                                "type": "integer"
                            }
                        }
                    }
                }
            }
        },
        "/api/app/users/{user_id}/inventory": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "获取 APP 端当前登录用户在 user_inventory 的资产记录，支持分页",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.用户"
                ],
                "summary": "获取用户资产列表",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "description": "页码，默认1",
                        "name": "page",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "description": "每页数量，最多100，默认20",
                        "name": "page_size",
                        "in": "query"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.listInventoryResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/users/{user_id}/inventory/address-share/create": {
            "post": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "生成一次性分享令牌（不落库），用于邀请他人填写收货地址；令牌默认有效期1小时（无需传过期参数）",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.用户"
                ],
                "summary": "创建共享地址链接",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "description": "请求参数：资产ID（过期参数可不传，默认1小时）",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/app.addressShareCreateRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.addressShareCreateResponse"
                        }
                    },
                    "400": {
                        "description": "参数错误/资产不可用",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/users/{user_id}/inventory/address-share/revoke": {
            "post": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "极简方案下为前端态操作：不落库令牌，撤销仅用于提示与禁用旧链接（可忽略服务端状态）",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.用户"
                ],
                "summary": "撤销共享地址链接",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "description": "请求参数：资产ID",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/app.addressShareRevokeRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.okResponse"
                        }
                    },
                    "400": {
                        "description": "参数错误",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/users/{user_id}/inventory/cancel-shipping": {
            "post": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "取消已提交但未发货的申请；恢复库存状态。支持按单个资产ID取消或按批次号批量取消",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.用户"
                ],
                "summary": "取消发货申请",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "description": "请求参数：资产ID或批次号（二选一）",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/app.cancelShippingRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "成功",
                        "schema": {
                            "$ref": "#/definitions/app.cancelShippingResponse"
                        }
                    },
                    "400": {
                        "description": "参数错误/记录不存在/已处理",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/users/{user_id}/inventory/redeem": {
            "post": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "将资产按规则转换为积分，成功后资产不可再发货；默认兑换比率来自系统配置`points_exchange_per_cent`",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.用户"
                ],
                "summary": "资产兑换为积分",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "description": "请求参数：资产ID",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/app.redeemInventoryRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.redeemInventoryResponse"
                        }
                    },
                    "400": {
                        "description": "参数错误/资产不可用",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/users/{user_id}/inventory/request-shipping": {
            "post": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "用户已有默认地址时，申请对指定资产发货；幂等校验已存在发货记录时返回已处理",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.用户"
                ],
                "summary": "申请发货",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "description": "请求参数：资产ID",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/app.requestShippingRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.requestShippingResponse"
                        }
                    },
                    "400": {
                        "description": "参数错误/未设置默认地址/已处理",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/users/{user_id}/inventory/request-shipping-batch": {
            "post": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "为多个资产申请发货，校验所有权与状态；幂等：已申请的资产跳过",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.用户"
                ],
                "summary": "批量申请发货",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "description": "请求参数：资产ID列表与可选地址ID",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/app.requestShippingBatchRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.requestShippingBatchResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/users/{user_id}/invites": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "查看被该用户邀请的用户列表",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.用户"
                ],
                "summary": "查看用户邀请记录",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "default": 1,
                        "description": "页码",
                        "name": "page",
                        "in": "query",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "default": 20,
                        "description": "每页数量，最多100",
                        "name": "page_size",
                        "in": "query",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.listInvitesResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/users/{user_id}/item_cards": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "获取指定用户的道具卡列表，支持分页和状态过滤",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.用户"
                ],
                "summary": "获取用户道具卡列表",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "description": "页码，默认1",
                        "name": "page",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "description": "每页条数，默认10",
                        "name": "page_size",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "description": "状态：1未使用 2已使用 3已过期，不传默认1",
                        "name": "status",
                        "in": "query"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.listUserItemCardsResponse"
                        }
                    },
                    "400": {
                        "description": "参数错误",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    },
                    "401": {
                        "description": "未授权",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    },
                    "500": {
                        "description": "服务器内部错误",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/users/{user_id}/item_cards/uses": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "获取指定用户的道具卡使用记录，支持分页",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.用户"
                ],
                "summary": "获取用户道具卡使用记录",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "description": "页码，默认1",
                        "name": "page",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "description": "每页条数，默认10",
                        "name": "page_size",
                        "in": "query"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.listUserItemCardUsesResponse"
                        }
                    },
                    "400": {
                        "description": "参数错误",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    },
                    "401": {
                        "description": "未授权",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    },
                    "500": {
                        "description": "服务器内部错误",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/users/{user_id}/orders": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "查看用户抽奖来源订单记录",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.用户"
                ],
                "summary": "查看用户订单记录",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "default": 1,
                        "description": "页码",
                        "name": "page",
                        "in": "query",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "default": 20,
                        "description": "每页数量，最多100",
                        "name": "page_size",
                        "in": "query",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "description": "订单状态：1待支付 2已支付 3已取消 4已退款",
                        "name": "status",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "description": "是否已消耗/履约：0否 1是",
                        "name": "is_consumed",
                        "in": "query"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.listOrdersResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/users/{user_id}/phone/bind": {
            "post": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "使用微信手机号 code 换取手机号并绑定到指定用户",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.用户"
                ],
                "summary": "绑定手机号",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/app.bindPhoneRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.bindPhoneResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/users/{user_id}/points": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "查看用户积分流水记录",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.用户"
                ],
                "summary": "查看用户积分记录",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "default": 1,
                        "description": "页码",
                        "name": "page",
                        "in": "query",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "default": 20,
                        "description": "每页数量，最多100",
                        "name": "page_size",
                        "in": "query",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.listPointsResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/users/{user_id}/points/balance": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "查看用户积分余额（过滤过期积分）",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.用户"
                ],
                "summary": "查看用户积分余额",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.pointsBalanceResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/users/{user_id}/points/redeem-coupon": {
            "post": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "使用积分兑换指定直减金额券，按比率 1积分=1元（券面值为分）",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.积分"
                ],
                "summary": "积分兑换优惠券",
                "parameters": [
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/app.redeemCouponRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.redeemCouponResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/users/{user_id}/points/redeem-item-card": {
            "post": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "使用积分兑换指定数量的道具卡",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.用户"
                ],
                "summary": "积分兑换道具卡",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "description": "兑换请求参数",
                        "name": "request",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/app.redeemItemCardRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.redeemItemCardResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/users/{user_id}/points/redeem-product": {
            "post": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "使用积分按比率1积分=1元兑换商品，生成系统发放订单与用户资产",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.积分"
                ],
                "summary": "积分兑换商品",
                "parameters": [
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/app.redeemProductRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.redeemProductResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/users/{user_id}/shipments": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "按运单号聚合用户的发货记录，支持分页",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.发货"
                ],
                "summary": "获取用户发货分组列表",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "description": "页码，默认1",
                        "name": "page",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "description": "每页数量，最多100，默认20",
                        "name": "page_size",
                        "in": "query"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.listShipmentsResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/users/{user_id}/stats": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "返回当前登录用户的道具卡数量、优惠券数量、积分余额",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.用户"
                ],
                "summary": "获取用户统计",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.userStatsResponse"
                        }
                    },
                    "400": {
                        "description": "参数错误",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    },
                    "401": {
                        "description": "未授权",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    },
                    "500": {
                        "description": "服务器内部错误",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/role/list": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.系统"
                ],
                "summary": "角色列表",
                "parameters": [
                    {
                        "type": "integer",
                        "default": 1,
                        "description": "页码",
                        "name": "current",
                        "in": "query",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "default": 20,
                        "description": "每页数量",
                        "name": "size",
                        "in": "query",
                        "required": true
                    },
                    {
                        "type": "string",
                        "description": "角色名称",
                        "name": "roleName",
                        "in": "query"
                    },
                    {
                        "type": "string",
                        "description": "角色编码",
                        "name": "roleCode",
                        "in": "query"
                    },
                    {
                        "type": "boolean",
                        "description": "是否启用",
                        "name": "enabled",
                        "in": "query"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.roleListResponse"
                        }
                    }
                }
            }
        },
        "/api/user": {
            "post": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "创建新的管理员账号",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.系统"
                ],
                "summary": "创建系统用户",
                "parameters": [
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/admin.createUserRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.createUserResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/user/list": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "返回系统用户分页数据",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.系统"
                ],
                "summary": "系统用户列表",
                "parameters": [
                    {
                        "type": "integer",
                        "default": 1,
                        "description": "页码",
                        "name": "current",
                        "in": "query",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "default": 20,
                        "description": "每页数量",
                        "name": "size",
                        "in": "query",
                        "required": true
                    },
                    {
                        "type": "string",
                        "description": "用户名",
                        "name": "userName",
                        "in": "query"
                    },
                    {
                        "type": "string",
                        "description": "邮箱",
                        "name": "userEmail",
                        "in": "query"
                    },
                    {
                        "type": "string",
                        "description": "手机号",
                        "name": "userPhone",
                        "in": "query"
                    },
                    {
                        "type": "string",
                        "description": "状态",
                        "name": "status",
                        "in": "query"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.userListResponse"
                        }
                    }
                }
            }
        },
        "/api/v3/system/menus/simple": {
            "get": {
                "responses": {}
            }
        },
        "/common/upload/wangeditor": {
            "post": {
                "description": "适配 WangEditor 的图片上传接口",
                "consumes": [
                    "multipart/form-data"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "Common"
                ],
                "summary": "WangEditor图片上传",
                "parameters": [
                    {
                        "type": "file",
                        "description": "图片文件",
                        "name": "file",
                        "in": "formData",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "上传成功",
                        "schema": {
                            "type": "object",
                            "additionalProperties": true
                        }
                    },
                    "400": {
                        "description": "上传失败",
                        "schema": {
                            "type": "object",
                            "additionalProperties": true
                        }
                    }
                }
            }
        },
        "/internal/game/consume-ticket": {
            "post": {
                "tags": [
                    "Internal.游戏"
                ],
                "summary": "扣减游戏次数",
                "parameters": [
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/game.consumeTicketRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/game.consumeTicketResponse"
                        }
                    }
                }
            }
        },
        "/internal/game/minesweeper/config": {
            "get": {
                "tags": [
                    "Internal.游戏"
                ],
                "summary": "获取扫雷配置",
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "type": "object",
                            "additionalProperties": true
                        }
                    }
                }
            }
        },
        "/internal/game/settle": {
            "post": {
                "description": "游戏结束后结算并发放奖励",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "Internal"
                ],
                "summary": "结算游戏",
                "parameters": [
                    {
                        "description": "结算信息",
                        "name": "result",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/minesweeper.SettleGameRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/minesweeper.SettleGameResponse"
                        }
                    }
                }
            }
        },
        "/internal/game/validate-token": {
            "post": {
                "tags": [
                    "Internal.游戏"
                ],
                "summary": "验证GameToken",
                "parameters": [
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/game.validateTokenRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/game.validateTokenResponse"
                        }
                    }
                }
            }
        },
        "/internal/game/verify": {
            "post": {
                "description": "验证游戏票据是否有效",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "Internal"
                ],
                "summary": "验证游戏票据",
                "parameters": [
                    {
                        "description": "票据信息",
                        "name": "ticket",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/minesweeper.VerifyTicketRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/minesweeper.VerifyTicketResponse"
                        }
                    }
                }
            }
        },
        "/pay/wechat/notify": {
            "post": {
                "description": "接收微信支付结果通知，验证签名并处理订单状态",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "Pay"
                ],
                "summary": "微信支付回调通知",
                "responses": {
                    "200": {
                        "description": "处理成功",
                        "schema": {
                            "$ref": "#/definitions/pay.notifyAck"
                        }
                    },
                    "400": {
                        "description": "请求参数错误",
                        "schema": {
                            "$ref": "#/definitions/pay.notifyAck"
                        }
                    },
                    "500": {
                        "description": "服务器内部错误",
                        "schema": {
                            "$ref": "#/definitions/pay.notifyAck"
                        }
                    }
                }
            }
        }
    },
    "definitions": {
        "activity.CardTypeConfig": {
            "type": "object",
            "properties": {
                "code": {
                    "type": "string"
                },
                "image_url": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "quantity": {
                    "type": "integer"
                }
            }
        },
        "activity.MatchingCard": {
            "type": "object",
            "properties": {
                "id": {
                    "type": "string"
                },
                "type": {
                    "type": "string"
                }
            }
        },
        "activity.MatchingGame": {
            "type": "object",
            "properties": {
                "activity_id": {
                    "type": "integer"
                },
                "board": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/activity.MatchingCard"
                    }
                },
                "card_configs": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/activity.CardTypeConfig"
                    }
                },
                "card_id_counter": {
                    "type": "integer"
                },
                "created_at": {
                    "description": "游戏创建时间，用于自动开奖超时判断",
                    "type": "string"
                },
                "deck": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/activity.MatchingCard"
                    }
                },
                "issue_id": {
                    "type": "integer"
                },
                "last_activity": {
                    "type": "string"
                },
                "max_possible_pairs": {
                    "type": "integer"
                },
                "nonce": {
                    "type": "integer"
                },
                "order_id": {
                    "type": "integer"
                },
                "position": {
                    "description": "用户选择的类型，用于服务端验证",
                    "type": "string"
                },
                "server_seed": {
                    "type": "array",
                    "items": {
                        "type": "integer"
                    }
                },
                "server_seed_hash": {
                    "type": "string"
                },
                "total_pairs": {
                    "type": "integer"
                },
                "user_id": {
                    "type": "integer"
                }
            }
        },
        "admin.GrantRewardRequest": {
            "type": "object",
            "required": [
                "product_id"
            ],
            "properties": {
                "activity_id": {
                    "description": "活动ID（可选）",
                    "type": "integer"
                },
                "address_id": {
                    "description": "收货地址ID（可选，实物商品需要）",
                    "type": "integer"
                },
                "points_amount": {
                    "description": "消耗积分",
                    "type": "integer"
                },
                "product_id": {
                    "description": "商品ID",
                    "type": "integer"
                },
                "quantity": {
                    "description": "发放数量",
                    "type": "integer",
                    "minimum": 1
                },
                "remark": {
                    "description": "备注",
                    "type": "string"
                },
                "reward_id": {
                    "description": "奖励配置ID（可选）",
                    "type": "integer"
                }
            }
        },
        "admin.GrantRewardResponse": {
            "type": "object",
            "properties": {
                "inventory_ids": {
                    "type": "array",
                    "items": {
                        "type": "integer"
                    }
                },
                "message": {
                    "type": "string"
                },
                "order_id": {
                    "type": "integer"
                },
                "success": {
                    "type": "boolean"
                }
            }
        },
        "admin.ShippingOrderGroup": {
            "type": "object",
            "properties": {
                "address_id": {
                    "description": "地址ID",
                    "type": "integer"
                },
                "address_info": {
                    "description": "地址信息",
                    "type": "string"
                },
                "batch_no": {
                    "description": "批次号",
                    "type": "string"
                },
                "count": {
                    "description": "商品数量",
                    "type": "integer"
                },
                "created_at": {
                    "type": "string"
                },
                "express_code": {
                    "description": "快递公司编码",
                    "type": "string"
                },
                "express_no": {
                    "description": "运单号",
                    "type": "string"
                },
                "group_key": {
                    "description": "分组键（用于批量操作）",
                    "type": "string"
                },
                "inventory_ids": {
                    "description": "资产ID列表",
                    "type": "array",
                    "items": {
                        "type": "integer"
                    }
                },
                "product_ids": {
                    "description": "商品ID列表",
                    "type": "array",
                    "items": {
                        "type": "integer"
                    }
                },
                "products": {
                    "description": "商品详情列表",
                    "type": "array",
                    "items": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "integer"
                            },
                            "image": {
                                "type": "string"
                            },
                            "name": {
                                "type": "string"
                            },
                            "price": {
                                "type": "integer"
                            }
                        }
                    }
                },
                "received_at": {
                    "type": "string"
                },
                "record_ids": {
                    "description": "发货记录ID列表",
                    "type": "array",
                    "items": {
                        "type": "integer"
                    }
                },
                "shipped_at": {
                    "type": "string"
                },
                "status": {
                    "description": "状态（取最大值）",
                    "type": "integer"
                },
                "total_price": {
                    "description": "总价格",
                    "type": "integer"
                },
                "user_id": {
                    "description": "用户ID",
                    "type": "integer"
                },
                "user_nickname": {
                    "description": "用户昵称",
                    "type": "string"
                }
            }
        },
        "admin.UserProfileResponse": {
            "type": "object",
            "properties": {
                "avatar": {
                    "type": "string"
                },
                "channel_id": {
                    "type": "integer"
                },
                "created_at": {
                    "type": "string"
                },
                "current_assets": {
                    "description": "当前资产快照",
                    "type": "object",
                    "properties": {
                        "coupon_count": {
                            "description": "持有优惠券数",
                            "type": "integer"
                        },
                        "coupon_value": {
                            "description": "持有优惠券价值",
                            "type": "integer"
                        },
                        "inventory_count": {
                            "description": "持有商品数",
                            "type": "integer"
                        },
                        "inventory_value": {
                            "description": "持有商品价值",
                            "type": "integer"
                        },
                        "item_card_count": {
                            "description": "持有道具卡数",
                            "type": "integer"
                        },
                        "item_card_value": {
                            "description": "持有道具卡价值",
                            "type": "integer"
                        },
                        "points_balance": {
                            "description": "积分余额",
                            "type": "integer"
                        },
                        "profit_loss_ratio": {
                            "description": "累计盈亏比",
                            "type": "number"
                        },
                        "total_asset_value": {
                            "description": "总资产估值",
                            "type": "integer"
                        }
                    }
                },
                "douyin_id": {
                    "type": "string"
                },
                "id": {
                    "description": "基本信息",
                    "type": "integer"
                },
                "invite_code": {
                    "type": "string"
                },
                "invite_count": {
                    "description": "邀请统计",
                    "type": "integer"
                },
                "inviter_id": {
                    "type": "integer"
                },
                "lifetime_stats": {
                    "description": "生命周期财务指标",
                    "type": "object",
                    "properties": {
                        "net_cash_cost": {
                            "description": "净现金支出",
                            "type": "integer"
                        },
                        "order_count": {
                            "description": "订单数",
                            "type": "integer"
                        },
                        "total_paid": {
                            "description": "累计支付",
                            "type": "integer"
                        },
                        "total_refunded": {
                            "description": "累计退款",
                            "type": "integer"
                        }
                    }
                },
                "mobile": {
                    "type": "string"
                },
                "nickname": {
                    "type": "string"
                }
            }
        },
        "admin.activityDetailResponse": {
            "type": "object",
            "properties": {
                "activity_category_id": {
                    "type": "integer"
                },
                "allow_coupons": {
                    "type": "boolean"
                },
                "allow_item_cards": {
                    "type": "boolean"
                },
                "banner": {
                    "type": "string"
                },
                "created_at": {
                    "type": "string"
                },
                "draw_mode": {
                    "type": "string"
                },
                "end_time": {
                    "type": "string"
                },
                "gameplay_intro": {
                    "type": "string"
                },
                "id": {
                    "type": "integer"
                },
                "image": {
                    "type": "string"
                },
                "interval_minutes": {
                    "type": "integer"
                },
                "is_boss": {
                    "type": "integer"
                },
                "last_settled_at": {
                    "type": "string"
                },
                "min_participants": {
                    "type": "integer"
                },
                "name": {
                    "type": "string"
                },
                "play_type": {
                    "type": "string"
                },
                "price_draw": {
                    "type": "integer"
                },
                "refund_coupon_id": {
                    "type": "integer"
                },
                "scheduled_time": {
                    "type": "string"
                },
                "start_time": {
                    "type": "string"
                },
                "status": {
                    "type": "integer"
                },
                "updated_at": {
                    "type": "string"
                }
            }
        },
        "admin.activityItem": {
            "type": "object",
            "properties": {
                "activity_category_id": {
                    "type": "integer"
                },
                "banner": {
                    "type": "string"
                },
                "category_name": {
                    "type": "string"
                },
                "id": {
                    "type": "integer"
                },
                "image": {
                    "type": "string"
                },
                "is_boss": {
                    "type": "integer"
                },
                "name": {
                    "type": "string"
                },
                "price_draw": {
                    "type": "integer"
                },
                "status": {
                    "type": "integer"
                }
            }
        },
        "admin.activitysvcIssueData": {
            "type": "object",
            "properties": {
                "id": {
                    "type": "integer"
                },
                "issue_number": {
                    "type": "string"
                },
                "prize_count": {
                    "type": "integer"
                },
                "sort": {
                    "type": "integer"
                },
                "status": {
                    "type": "integer"
                }
            }
        },
        "admin.addCouponRequest": {
            "type": "object",
            "required": [
                "coupon_id"
            ],
            "properties": {
                "coupon_id": {
                    "type": "integer"
                }
            }
        },
        "admin.addCouponResponse": {
            "type": "object",
            "properties": {
                "success": {
                    "type": "boolean"
                }
            }
        },
        "admin.addPointsRequest": {
            "type": "object",
            "properties": {
                "kind": {
                    "type": "string"
                },
                "points": {
                    "description": "正数=增加，负数=扣减",
                    "type": "integer"
                },
                "remark": {
                    "type": "string"
                },
                "valid_days": {
                    "type": "integer"
                }
            }
        },
        "admin.addPointsResponse": {
            "type": "object",
            "properties": {
                "success": {
                    "type": "boolean"
                }
            }
        },
        "admin.adminUserCouponItem": {
            "type": "object",
            "properties": {
                "balance_amount": {
                    "type": "integer"
                },
                "coupon_id": {
                    "type": "integer"
                },
                "discount_type": {
                    "type": "integer"
                },
                "discount_value": {
                    "type": "integer"
                },
                "id": {
                    "type": "integer"
                },
                "min_spend": {
                    "type": "integer"
                },
                "name": {
                    "type": "string"
                },
                "scope_type": {
                    "type": "integer"
                },
                "status": {
                    "type": "integer"
                },
                "used_at": {
                    "type": "string"
                },
                "used_order_id": {
                    "type": "integer"
                },
                "valid_end": {
                    "type": "string"
                },
                "valid_start": {
                    "type": "string"
                }
            }
        },
        "admin.adminUserItem": {
            "type": "object",
            "properties": {
                "avatar": {
                    "type": "string"
                },
                "channel_code": {
                    "type": "string"
                },
                "channel_name": {
                    "type": "string"
                },
                "coupons_count": {
                    "type": "integer"
                },
                "created_at": {
                    "type": "string"
                },
                "douyin_id": {
                    "type": "string"
                },
                "id": {
                    "type": "integer"
                },
                "invite_code": {
                    "type": "string"
                },
                "inviter_id": {
                    "type": "integer"
                },
                "item_cards_count": {
                    "type": "integer"
                },
                "nickname": {
                    "type": "string"
                },
                "points_balance": {
                    "type": "integer"
                },
                "seven_day_consume": {
                    "type": "integer"
                },
                "today_consume": {
                    "type": "integer"
                }
            }
        },
        "admin.assignItemCardRequest": {
            "type": "object",
            "required": [
                "card_id"
            ],
            "properties": {
                "card_id": {
                    "type": "integer"
                },
                "quantity": {
                    "type": "integer"
                }
            }
        },
        "admin.bannerItem": {
            "type": "object",
            "properties": {
                "id": {
                    "type": "integer"
                },
                "image_url": {
                    "type": "string"
                },
                "link_url": {
                    "type": "string"
                },
                "sort": {
                    "type": "integer"
                },
                "status": {
                    "type": "integer"
                },
                "title": {
                    "type": "string"
                }
            }
        },
        "admin.batchModifyRewardItem": {
            "type": "object",
            "required": [
                "reward_id"
            ],
            "properties": {
                "reward_id": {
                    "type": "integer"
                },
                "weight": {
                    "type": "number",
                    "minimum": 0
                }
            }
        },
        "admin.batchModifyRewardsRequest": {
            "type": "object",
            "required": [
                "rewards"
            ],
            "properties": {
                "rewards": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/admin.batchModifyRewardItem"
                    }
                }
            }
        },
        "admin.batchUpdateProductsRequest": {
            "type": "object",
            "required": [
                "ids"
            ],
            "properties": {
                "ids": {
                    "type": "array",
                    "items": {
                        "type": "integer"
                    }
                },
                "status": {
                    "type": "integer"
                },
                "stock": {
                    "type": "integer"
                }
            }
        },
        "admin.batchUpdateProductsResponse": {
            "type": "object",
            "properties": {
                "message": {
                    "type": "string"
                },
                "updated_count": {
                    "type": "integer"
                }
            }
        },
        "admin.categoryItem": {
            "type": "object",
            "properties": {
                "id": {
                    "type": "integer"
                },
                "name": {
                    "type": "string"
                }
            }
        },
        "admin.checkActivityGamePassesResponse": {
            "type": "object",
            "properties": {
                "activity_id": {
                    "type": "integer"
                },
                "can_delete": {
                    "type": "boolean"
                },
                "message": {
                    "type": "string"
                },
                "total_remaining": {
                    "type": "integer"
                },
                "user_count": {
                    "type": "integer"
                }
            }
        },
        "admin.copyActivityResponse": {
            "type": "object",
            "properties": {
                "new_activity_id": {
                    "type": "integer"
                },
                "status": {
                    "type": "string"
                }
            }
        },
        "admin.createActivityRequest": {
            "type": "object",
            "required": [
                "activity_category_id",
                "name"
            ],
            "properties": {
                "activity_category_id": {
                    "type": "integer"
                },
                "allow_coupons": {
                    "type": "integer"
                },
                "allow_item_cards": {
                    "type": "integer"
                },
                "banner": {
                    "type": "string"
                },
                "draw_mode": {
                    "type": "string"
                },
                "end_time": {
                    "type": "string"
                },
                "gameplay_intro": {
                    "type": "string"
                },
                "image": {
                    "type": "string"
                },
                "interval_minutes": {
                    "type": "integer"
                },
                "is_boss": {
                    "type": "integer"
                },
                "min_participants": {
                    "type": "integer"
                },
                "name": {
                    "type": "string"
                },
                "play_type": {
                    "type": "string"
                },
                "price_draw": {
                    "type": "integer"
                },
                "refund_coupon_amount": {
                    "type": "number"
                },
                "refund_coupon_id": {
                    "type": "integer"
                },
                "refund_coupon_type": {
                    "type": "string"
                },
                "scheduled_delay_minutes": {
                    "type": "integer"
                },
                "scheduled_time": {
                    "type": "string"
                },
                "start_time": {
                    "type": "string"
                },
                "status": {
                    "type": "integer"
                }
            }
        },
        "admin.createBannerRequest": {
            "type": "object",
            "required": [
                "image_url",
                "title"
            ],
            "properties": {
                "image_url": {
                    "type": "string"
                },
                "link_url": {
                    "type": "string"
                },
                "sort": {
                    "type": "integer"
                },
                "status": {
                    "type": "integer"
                },
                "title": {
                    "type": "string"
                }
            }
        },
        "admin.createBannerResponse": {
            "type": "object",
            "properties": {
                "id": {
                    "type": "integer"
                },
                "message": {
                    "type": "string"
                }
            }
        },
        "admin.createGamePassPackageRequest": {
            "type": "object",
            "required": [
                "name",
                "pass_count",
                "price"
            ],
            "properties": {
                "activity_id": {
                    "type": "integer"
                },
                "name": {
                    "type": "string"
                },
                "original_price": {
                    "type": "integer"
                },
                "pass_count": {
                    "type": "integer",
                    "minimum": 1
                },
                "price": {
                    "type": "integer",
                    "minimum": 0
                },
                "sort_order": {
                    "type": "integer"
                },
                "status": {
                    "description": "1=上架 2=下架",
                    "type": "integer"
                },
                "valid_days": {
                    "type": "integer"
                }
            }
        },
        "admin.createGamePassPackageResponse": {
            "type": "object",
            "properties": {
                "id": {
                    "type": "integer"
                },
                "message": {
                    "type": "string"
                }
            }
        },
        "admin.createIssueRequest": {
            "type": "object",
            "required": [
                "issue_number"
            ],
            "properties": {
                "issue_number": {
                    "type": "string"
                },
                "sort": {
                    "type": "integer"
                },
                "status": {
                    "type": "integer"
                }
            }
        },
        "admin.createItemCardRequest": {
            "type": "object",
            "required": [
                "card_type",
                "effect_type",
                "name",
                "price",
                "scope_type"
            ],
            "properties": {
                "activity_category_id": {
                    "type": "integer"
                },
                "activity_id": {
                    "type": "integer"
                },
                "boost_rate_x1000": {
                    "type": "integer"
                },
                "card_type": {
                    "type": "integer"
                },
                "effect_type": {
                    "type": "integer"
                },
                "issue_id": {
                    "type": "integer"
                },
                "max_effect_value_x1000": {
                    "type": "integer"
                },
                "name": {
                    "type": "string"
                },
                "price": {
                    "type": "integer"
                },
                "remark": {
                    "type": "string"
                },
                "reward_multiplier_x1000": {
                    "type": "integer"
                },
                "scope_type": {
                    "type": "integer"
                },
                "stacking_strategy": {
                    "type": "integer"
                },
                "status": {
                    "type": "integer"
                },
                "valid_end_unix": {
                    "type": "integer"
                },
                "valid_start_unix": {
                    "type": "integer"
                }
            }
        },
        "admin.createItemCardResponse": {
            "type": "object",
            "properties": {
                "id": {
                    "type": "integer"
                },
                "message": {
                    "type": "string"
                }
            }
        },
        "admin.createProductCategoryRequest": {
            "type": "object",
            "required": [
                "name"
            ],
            "properties": {
                "name": {
                    "type": "string"
                },
                "parent_id": {
                    "type": "integer"
                },
                "status": {
                    "type": "integer"
                }
            }
        },
        "admin.createProductCategoryResponse": {
            "type": "object",
            "properties": {
                "id": {
                    "type": "integer"
                },
                "message": {
                    "type": "string"
                }
            }
        },
        "admin.createProductRequest": {
            "type": "object",
            "required": [
                "category_id",
                "name",
                "price",
                "stock"
            ],
            "properties": {
                "category_id": {
                    "type": "integer"
                },
                "description": {
                    "type": "string"
                },
                "images_json": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "price": {
                    "type": "integer"
                },
                "status": {
                    "type": "integer"
                },
                "stock": {
                    "type": "integer"
                }
            }
        },
        "admin.createProductResponse": {
            "type": "object",
            "properties": {
                "id": {
                    "type": "integer"
                },
                "message": {
                    "type": "string"
                }
            }
        },
        "admin.createRewardsRequest": {
            "type": "object",
            "required": [
                "rewards"
            ],
            "properties": {
                "rewards": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/admin.rewardItem"
                    }
                }
            }
        },
        "admin.createUserRequest": {
            "type": "object",
            "required": [
                "password",
                "username"
            ],
            "properties": {
                "avatar": {
                    "type": "string"
                },
                "mobile": {
                    "type": "string"
                },
                "nickname": {
                    "type": "string"
                },
                "password": {
                    "type": "string"
                },
                "username": {
                    "type": "string"
                }
            }
        },
        "admin.createUserResponse": {
            "type": "object",
            "properties": {
                "message": {
                    "type": "string"
                },
                "success": {
                    "type": "boolean"
                }
            }
        },
        "admin.gamePassItem": {
            "type": "object",
            "properties": {
                "activity_id": {
                    "type": "integer"
                },
                "activity_name": {
                    "type": "string"
                },
                "created_at": {
                    "type": "string"
                },
                "expired_at": {
                    "type": "string"
                },
                "id": {
                    "type": "integer"
                },
                "remaining": {
                    "type": "integer"
                },
                "remark": {
                    "type": "string"
                },
                "source": {
                    "type": "string"
                },
                "total_granted": {
                    "type": "integer"
                },
                "total_used": {
                    "type": "integer"
                },
                "user_id": {
                    "type": "integer"
                },
                "user_name": {
                    "type": "string"
                }
            }
        },
        "admin.gamePassPackageItem": {
            "type": "object",
            "properties": {
                "activity_id": {
                    "type": "integer"
                },
                "activity_name": {
                    "type": "string"
                },
                "created_at": {
                    "type": "string"
                },
                "id": {
                    "type": "integer"
                },
                "name": {
                    "type": "string"
                },
                "original_price": {
                    "type": "integer"
                },
                "pass_count": {
                    "type": "integer"
                },
                "price": {
                    "type": "integer"
                },
                "sort_order": {
                    "type": "integer"
                },
                "status": {
                    "type": "integer"
                },
                "valid_days": {
                    "type": "integer"
                }
            }
        },
        "admin.getOrderSnapshotsResponse": {
            "type": "object",
            "properties": {
                "after_snapshot": {
                    "$ref": "#/definitions/snapshot.UserStateSnapshot"
                },
                "before_snapshot": {
                    "$ref": "#/definitions/snapshot.UserStateSnapshot"
                },
                "diff": {
                    "$ref": "#/definitions/snapshot.SnapshotDiff"
                },
                "has_snapshots": {
                    "type": "boolean"
                },
                "order": {
                    "type": "object",
                    "properties": {
                        "actual_amount": {
                            "type": "integer"
                        },
                        "id": {
                            "type": "integer"
                        },
                        "order_no": {
                            "type": "string"
                        },
                        "paid_at": {
                            "type": "string"
                        },
                        "status": {
                            "type": "integer"
                        },
                        "user_id": {
                            "type": "integer"
                        }
                    }
                }
            }
        },
        "admin.getUserGamePassesResponse": {
            "type": "object",
            "properties": {
                "activity_passes": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/admin.gamePassItem"
                    }
                },
                "global_remaining": {
                    "type": "integer"
                },
                "total_remaining": {
                    "type": "integer"
                },
                "user_id": {
                    "type": "integer"
                }
            }
        },
        "admin.grantGamePassRequest": {
            "type": "object",
            "required": [
                "count",
                "user_id"
            ],
            "properties": {
                "activity_id": {
                    "description": "可选，NULL表示全局通用",
                    "type": "integer"
                },
                "count": {
                    "type": "integer",
                    "minimum": 1
                },
                "remark": {
                    "type": "string"
                },
                "user_id": {
                    "type": "integer"
                },
                "valid_days": {
                    "description": "可选，NULL表示永久有效",
                    "type": "integer"
                }
            }
        },
        "admin.grantGamePassResponse": {
            "type": "object",
            "properties": {
                "id": {
                    "type": "integer"
                },
                "message": {
                    "type": "string"
                }
            }
        },
        "admin.issueUserTokenResponse": {
            "type": "object",
            "properties": {
                "expires_in": {
                    "type": "integer"
                },
                "token": {
                    "type": "string"
                }
            }
        },
        "admin.itemCardListItem": {
            "type": "object",
            "properties": {
                "activity_category_id": {
                    "type": "integer"
                },
                "activity_id": {
                    "type": "integer"
                },
                "boost_rate_x1000": {
                    "type": "integer"
                },
                "card_type": {
                    "type": "integer"
                },
                "created_at": {
                    "type": "string"
                },
                "effect_type": {
                    "type": "integer"
                },
                "id": {
                    "type": "integer"
                },
                "issue_id": {
                    "type": "integer"
                },
                "max_effect_value_x1000": {
                    "type": "integer"
                },
                "name": {
                    "type": "string"
                },
                "price": {
                    "type": "integer"
                },
                "remark": {
                    "type": "string"
                },
                "reward_multiplier_x1000": {
                    "type": "integer"
                },
                "scope_type": {
                    "type": "integer"
                },
                "stacking_strategy": {
                    "type": "integer"
                },
                "status": {
                    "type": "integer"
                },
                "updated_at": {
                    "type": "string"
                },
                "valid_end": {
                    "type": "string"
                },
                "valid_start": {
                    "type": "string"
                }
            }
        },
        "admin.listActivitiesResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/admin.activityItem"
                    }
                },
                "page": {
                    "type": "integer"
                },
                "page_size": {
                    "type": "integer"
                },
                "total": {
                    "type": "integer"
                }
            }
        },
        "admin.listBannersResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/admin.bannerItem"
                    }
                },
                "page": {
                    "type": "integer"
                },
                "page_size": {
                    "type": "integer"
                },
                "total": {
                    "type": "integer"
                }
            }
        },
        "admin.listCategoriesResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/admin.categoryItem"
                    }
                }
            }
        },
        "admin.listCouponsResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/admin.adminUserCouponItem"
                    }
                },
                "page": {
                    "type": "integer"
                },
                "page_size": {
                    "type": "integer"
                },
                "total": {
                    "type": "integer"
                }
            }
        },
        "admin.listGamePassPackagesResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/admin.gamePassPackageItem"
                    }
                },
                "page": {
                    "type": "integer"
                },
                "page_size": {
                    "type": "integer"
                },
                "total": {
                    "type": "integer"
                }
            }
        },
        "admin.listGamePassesResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/admin.gamePassItem"
                    }
                },
                "page": {
                    "type": "integer"
                },
                "page_size": {
                    "type": "integer"
                },
                "total": {
                    "type": "integer"
                }
            }
        },
        "admin.listInventoryResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/user.InventoryWithProduct"
                    }
                },
                "page": {
                    "type": "integer"
                },
                "page_size": {
                    "type": "integer"
                },
                "total": {
                    "type": "integer"
                }
            }
        },
        "admin.listInvitesResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/admin.adminUserItem"
                    }
                },
                "page": {
                    "type": "integer"
                },
                "page_size": {
                    "type": "integer"
                },
                "total": {
                    "type": "integer"
                }
            }
        },
        "admin.listIssuesResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/admin.activitysvcIssueData"
                    }
                },
                "page": {
                    "type": "integer"
                },
                "page_size": {
                    "type": "integer"
                },
                "total": {
                    "type": "integer"
                }
            }
        },
        "admin.listItemCardsResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/admin.itemCardListItem"
                    }
                },
                "page": {
                    "type": "integer"
                },
                "page_size": {
                    "type": "integer"
                },
                "total": {
                    "type": "integer"
                }
            }
        },
        "admin.listMatchingCardTypesResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/admin.matchingCardTypeResponse"
                    }
                },
                "total": {
                    "type": "integer"
                }
            }
        },
        "admin.listOrdersResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/user.OrderWithItems"
                    }
                },
                "page": {
                    "type": "integer"
                },
                "page_size": {
                    "type": "integer"
                },
                "total": {
                    "type": "integer"
                }
            }
        },
        "admin.listPointsResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/model.UserPointsLedger"
                    }
                },
                "page": {
                    "type": "integer"
                },
                "page_size": {
                    "type": "integer"
                },
                "total": {
                    "type": "integer"
                }
            }
        },
        "admin.listProductCategoriesResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/admin.productCategoryListItem"
                    }
                },
                "page": {
                    "type": "integer"
                },
                "page_size": {
                    "type": "integer"
                },
                "total": {
                    "type": "integer"
                }
            }
        },
        "admin.listProductsResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/admin.productItem"
                    }
                },
                "page": {
                    "type": "integer"
                },
                "page_size": {
                    "type": "integer"
                },
                "total": {
                    "type": "integer"
                }
            }
        },
        "admin.listRewardsResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/admin.rewardItem"
                    }
                }
            }
        },
        "admin.listShippingOrdersResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/admin.ShippingOrderGroup"
                    }
                },
                "page": {
                    "type": "integer"
                },
                "page_size": {
                    "type": "integer"
                },
                "total": {
                    "type": "integer"
                }
            }
        },
        "admin.listUserItemCardsResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/user.ItemCardWithTemplate"
                    }
                },
                "page": {
                    "type": "integer"
                },
                "page_size": {
                    "type": "integer"
                },
                "total": {
                    "type": "integer"
                }
            }
        },
        "admin.listUsersResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/admin.adminUserItem"
                    }
                },
                "page": {
                    "type": "integer"
                },
                "page_size": {
                    "type": "integer"
                },
                "total": {
                    "type": "integer"
                }
            }
        },
        "admin.loginRequest": {
            "type": "object",
            "required": [
                "password",
                "username"
            ],
            "properties": {
                "password": {
                    "description": "密码 (MD5加密后的密码)",
                    "type": "string"
                },
                "username": {
                    "description": "用户名",
                    "type": "string"
                }
            }
        },
        "admin.loginResponse": {
            "type": "object",
            "properties": {
                "is_super": {
                    "description": "是否是超级管理员(1:是 0:否)",
                    "type": "integer"
                },
                "token": {
                    "description": "登录成功后颁发的 Token",
                    "type": "string"
                }
            }
        },
        "admin.matchingCardTypeRequest": {
            "type": "object",
            "required": [
                "code",
                "name"
            ],
            "properties": {
                "code": {
                    "type": "string"
                },
                "image_url": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "quantity": {
                    "type": "integer"
                },
                "sort": {
                    "type": "integer"
                },
                "status": {
                    "type": "integer"
                }
            }
        },
        "admin.matchingCardTypeResponse": {
            "type": "object",
            "properties": {
                "code": {
                    "type": "string"
                },
                "created_at": {
                    "type": "string"
                },
                "id": {
                    "type": "integer"
                },
                "image_url": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "quantity": {
                    "type": "integer"
                },
                "sort": {
                    "type": "integer"
                },
                "status": {
                    "type": "integer"
                }
            }
        },
        "admin.modifyActivityRequest": {
            "type": "object",
            "properties": {
                "activity_category_id": {
                    "type": "integer"
                },
                "allow_coupons": {
                    "type": "integer"
                },
                "allow_item_cards": {
                    "type": "integer"
                },
                "banner": {
                    "type": "string"
                },
                "draw_mode": {
                    "type": "string"
                },
                "end_time": {
                    "type": "string"
                },
                "force": {
                    "type": "boolean"
                },
                "gameplay_intro": {
                    "type": "string"
                },
                "image": {
                    "type": "string"
                },
                "interval_minutes": {
                    "type": "integer"
                },
                "is_boss": {
                    "type": "integer"
                },
                "min_participants": {
                    "type": "integer"
                },
                "name": {
                    "type": "string"
                },
                "play_type": {
                    "type": "string"
                },
                "price_draw": {
                    "type": "integer"
                },
                "refund_coupon_amount": {
                    "type": "number"
                },
                "refund_coupon_id": {
                    "type": "integer"
                },
                "refund_coupon_type": {
                    "type": "string"
                },
                "scheduled_delay_minutes": {
                    "type": "integer"
                },
                "scheduled_time": {
                    "type": "string"
                },
                "start_time": {
                    "type": "string"
                },
                "status": {
                    "type": "integer"
                }
            }
        },
        "admin.modifyBannerRequest": {
            "type": "object",
            "properties": {
                "image_url": {
                    "type": "string"
                },
                "link_url": {
                    "type": "string"
                },
                "sort": {
                    "type": "integer"
                },
                "status": {
                    "type": "integer"
                },
                "title": {
                    "type": "string"
                }
            }
        },
        "admin.modifyGamePassPackageRequest": {
            "type": "object",
            "properties": {
                "activity_id": {
                    "type": "integer"
                },
                "name": {
                    "type": "string"
                },
                "original_price": {
                    "type": "integer"
                },
                "pass_count": {
                    "type": "integer"
                },
                "price": {
                    "type": "integer"
                },
                "sort_order": {
                    "type": "integer"
                },
                "status": {
                    "type": "integer"
                },
                "valid_days": {
                    "type": "integer"
                }
            }
        },
        "admin.modifyIssueRequest": {
            "type": "object",
            "properties": {
                "issue_number": {
                    "type": "string"
                },
                "sort": {
                    "type": "integer"
                },
                "status": {
                    "type": "integer"
                }
            }
        },
        "admin.modifyItemCardRequest": {
            "type": "object",
            "properties": {
                "activity_category_id": {
                    "type": "integer"
                },
                "activity_id": {
                    "type": "integer"
                },
                "boost_rate_x1000": {
                    "type": "integer"
                },
                "card_type": {
                    "type": "integer"
                },
                "effect_type": {
                    "type": "integer"
                },
                "issue_id": {
                    "type": "integer"
                },
                "max_effect_value_x1000": {
                    "type": "integer"
                },
                "name": {
                    "type": "string"
                },
                "price": {
                    "type": "integer"
                },
                "remark": {
                    "type": "string"
                },
                "reward_multiplier_x1000": {
                    "type": "integer"
                },
                "scope_type": {
                    "type": "integer"
                },
                "stacking_strategy": {
                    "type": "integer"
                },
                "status": {
                    "type": "integer"
                },
                "valid_end_unix": {
                    "type": "integer"
                },
                "valid_start_unix": {
                    "type": "integer"
                }
            }
        },
        "admin.modifyProductCategoryRequest": {
            "type": "object",
            "properties": {
                "name": {
                    "type": "string"
                },
                "parent_id": {
                    "type": "integer"
                },
                "status": {
                    "type": "integer"
                }
            }
        },
        "admin.modifyProductRequest": {
            "type": "object",
            "properties": {
                "category_id": {
                    "type": "integer"
                },
                "description": {
                    "type": "string"
                },
                "images_json": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "price": {
                    "type": "integer"
                },
                "status": {
                    "type": "integer"
                },
                "stock": {
                    "type": "integer"
                }
            }
        },
        "admin.modifyRewardRequest": {
            "type": "object",
            "properties": {
                "is_boss": {
                    "type": "integer"
                },
                "level": {
                    "type": "integer"
                },
                "min_score": {
                    "type": "integer"
                },
                "original_qty": {
                    "type": "integer"
                },
                "product_id": {
                    "type": "integer"
                },
                "quantity": {
                    "type": "integer"
                },
                "sort": {
                    "type": "integer"
                },
                "weight": {
                    "type": "number"
                }
            }
        },
        "admin.pcSimpleMessage": {
            "type": "object",
            "properties": {
                "message": {
                    "type": "string"
                }
            }
        },
        "admin.pointsBalanceResponse": {
            "type": "object",
            "properties": {
                "balance": {
                    "type": "integer"
                }
            }
        },
        "admin.productCategoryListItem": {
            "type": "object",
            "properties": {
                "id": {
                    "type": "integer"
                },
                "name": {
                    "type": "string"
                },
                "parent_id": {
                    "type": "integer"
                },
                "status": {
                    "type": "integer"
                }
            }
        },
        "admin.productItem": {
            "type": "object",
            "properties": {
                "category_id": {
                    "type": "integer"
                },
                "description": {
                    "type": "string"
                },
                "id": {
                    "type": "integer"
                },
                "images_json": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "price": {
                    "type": "integer"
                },
                "sales": {
                    "type": "integer"
                },
                "status": {
                    "type": "integer"
                },
                "stock": {
                    "type": "integer"
                }
            }
        },
        "admin.refreshResponse": {
            "type": "object",
            "properties": {
                "expires_in": {
                    "type": "integer"
                },
                "token": {
                    "type": "string"
                }
            }
        },
        "admin.rewardItem": {
            "type": "object",
            "required": [
                "level",
                "original_qty",
                "quantity",
                "weight"
            ],
            "properties": {
                "id": {
                    "type": "integer"
                },
                "is_boss": {
                    "type": "integer"
                },
                "level": {
                    "type": "integer"
                },
                "min_score": {
                    "type": "integer"
                },
                "original_qty": {
                    "type": "integer"
                },
                "product_id": {
                    "type": "integer"
                },
                "product_image_url": {
                    "type": "string"
                },
                "product_name": {
                    "type": "string"
                },
                "product_price": {
                    "type": "number"
                },
                "quantity": {
                    "type": "integer"
                },
                "sort": {
                    "type": "integer"
                },
                "weight": {
                    "type": "number"
                }
            }
        },
        "admin.roleItem": {
            "type": "object",
            "properties": {
                "createTime": {
                    "type": "string"
                },
                "description": {
                    "type": "string"
                },
                "enabled": {
                    "type": "boolean"
                },
                "roleCode": {
                    "type": "string"
                },
                "roleId": {
                    "type": "integer"
                },
                "roleName": {
                    "type": "string"
                }
            }
        },
        "admin.roleListResponse": {
            "type": "object",
            "properties": {
                "current": {
                    "type": "integer"
                },
                "records": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/admin.roleItem"
                    }
                },
                "size": {
                    "type": "integer"
                },
                "total": {
                    "type": "integer"
                }
            }
        },
        "admin.rollbackOrderRequest": {
            "type": "object",
            "properties": {
                "confirm": {
                    "type": "boolean"
                },
                "reason": {
                    "type": "string"
                }
            }
        },
        "admin.rollbackOrderResponse": {
            "type": "object",
            "properties": {
                "coupons_restored": {
                    "type": "integer"
                },
                "error_msg": {
                    "type": "string"
                },
                "inventory_revoked": {
                    "type": "integer"
                },
                "item_cards_restored": {
                    "type": "integer"
                },
                "points_restored": {
                    "type": "integer"
                },
                "refund_amount": {
                    "type": "integer"
                },
                "rollback_log_id": {
                    "type": "integer"
                },
                "success": {
                    "type": "boolean"
                }
            }
        },
        "admin.simpleMessage": {
            "type": "object",
            "properties": {
                "message": {
                    "type": "string"
                }
            }
        },
        "admin.simpleMessageResponse": {
            "type": "object",
            "properties": {
                "message": {
                    "type": "string"
                }
            }
        },
        "admin.updateShippingRequest": {
            "type": "object",
            "properties": {
                "express_code": {
                    "description": "快递公司编码",
                    "type": "string"
                },
                "express_no": {
                    "description": "运单号",
                    "type": "string"
                },
                "record_ids": {
                    "description": "发货记录ID列表",
                    "type": "array",
                    "items": {
                        "type": "integer"
                    }
                },
                "status": {
                    "description": "状态",
                    "type": "integer"
                }
            }
        },
        "admin.updateShippingResponse": {
            "type": "object",
            "properties": {
                "success": {
                    "type": "boolean"
                },
                "updated_count": {
                    "type": "integer"
                }
            }
        },
        "admin.userListItem": {
            "type": "object",
            "properties": {
                "avatar": {
                    "type": "string"
                },
                "createBy": {
                    "type": "string"
                },
                "createTime": {
                    "type": "string"
                },
                "id": {
                    "type": "integer"
                },
                "nickName": {
                    "type": "string"
                },
                "status": {
                    "type": "string"
                },
                "updateBy": {
                    "type": "string"
                },
                "updateTime": {
                    "type": "string"
                },
                "userEmail": {
                    "type": "string"
                },
                "userGender": {
                    "type": "string"
                },
                "userName": {
                    "type": "string"
                },
                "userPhone": {
                    "type": "string"
                },
                "userRoles": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    }
                }
            }
        },
        "admin.userListResponse": {
            "type": "object",
            "properties": {
                "current": {
                    "type": "integer"
                },
                "records": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/admin.userListItem"
                    }
                },
                "size": {
                    "type": "integer"
                },
                "total": {
                    "type": "integer"
                }
            }
        },
        "app.MatchingRewardInfo": {
            "type": "object",
            "properties": {
                "level": {
                    "type": "integer"
                },
                "name": {
                    "type": "string"
                },
                "product_image": {
                    "description": "商品图片",
                    "type": "string"
                },
                "product_name": {
                    "description": "商品原始名称",
                    "type": "string"
                },
                "reward_id": {
                    "type": "integer"
                }
            }
        },
        "app.activityDetailResponse": {
            "type": "object",
            "properties": {
                "activity_category_id": {
                    "type": "integer"
                },
                "allow_coupons": {
                    "type": "boolean"
                },
                "allow_item_cards": {
                    "type": "boolean"
                },
                "banner": {
                    "type": "string"
                },
                "created_at": {
                    "type": "string"
                },
                "draw_mode": {
                    "type": "string"
                },
                "end_time": {
                    "type": "string"
                },
                "gameplay_intro": {
                    "type": "string"
                },
                "id": {
                    "type": "integer"
                },
                "image": {
                    "type": "string"
                },
                "interval_minutes": {
                    "type": "integer"
                },
                "is_boss": {
                    "type": "integer"
                },
                "last_settled_at": {
                    "type": "string"
                },
                "min_participants": {
                    "type": "integer"
                },
                "name": {
                    "type": "string"
                },
                "play_type": {
                    "type": "string"
                },
                "price_draw": {
                    "type": "integer"
                },
                "refund_coupon_id": {
                    "type": "integer"
                },
                "scheduled_time": {
                    "type": "string"
                },
                "start_time": {
                    "type": "string"
                },
                "status": {
                    "type": "integer"
                },
                "updated_at": {
                    "type": "string"
                }
            }
        },
        "app.activityItem": {
            "type": "object",
            "properties": {
                "activity_category_id": {
                    "type": "integer"
                },
                "banner": {
                    "type": "string"
                },
                "category_name": {
                    "type": "string"
                },
                "id": {
                    "type": "integer"
                },
                "image": {
                    "type": "string"
                },
                "is_boss": {
                    "type": "integer"
                },
                "name": {
                    "type": "string"
                },
                "price_draw": {
                    "type": "integer"
                },
                "status": {
                    "type": "integer"
                }
            }
        },
        "app.addAddressRequest": {
            "type": "object",
            "properties": {
                "address": {
                    "type": "string"
                },
                "city": {
                    "type": "string"
                },
                "district": {
                    "type": "string"
                },
                "is_default": {
                    "type": "boolean"
                },
                "mobile": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "province": {
                    "type": "string"
                }
            }
        },
        "app.addAddressResponse": {
            "type": "object",
            "properties": {
                "id": {
                    "type": "integer"
                }
            }
        },
        "app.addressShareCreateRequest": {
            "type": "object",
            "properties": {
                "expires_at": {
                    "type": "string"
                },
                "expires_in_minutes": {
                    "type": "integer"
                },
                "inventory_id": {
                    "type": "integer"
                }
            }
        },
        "app.addressShareCreateResponse": {
            "type": "object",
            "properties": {
                "expires_at": {
                    "type": "string"
                },
                "share_token": {
                    "type": "string"
                },
                "share_url": {
                    "type": "string"
                },
                "short_link": {
                    "type": "string"
                }
            }
        },
        "app.addressShareRevokeRequest": {
            "type": "object",
            "properties": {
                "inventory_id": {
                    "type": "integer"
                }
            }
        },
        "app.addressShareSubmitRequest": {
            "type": "object",
            "properties": {
                "address": {
                    "type": "string"
                },
                "city": {
                    "type": "string"
                },
                "district": {
                    "type": "string"
                },
                "mobile": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "province": {
                    "type": "string"
                },
                "share_token": {
                    "type": "string"
                }
            }
        },
        "app.addressShareSubmitResponse": {
            "type": "object",
            "properties": {
                "address_id": {
                    "type": "integer"
                }
            }
        },
        "app.appBannerItem": {
            "type": "object",
            "properties": {
                "id": {
                    "type": "integer"
                },
                "image_url": {
                    "type": "string"
                },
                "link_url": {
                    "type": "string"
                },
                "sort": {
                    "type": "integer"
                },
                "title": {
                    "type": "string"
                }
            }
        },
        "app.appCategoryItem": {
            "type": "object",
            "properties": {
                "id": {
                    "type": "integer"
                },
                "name": {
                    "type": "string"
                }
            }
        },
        "app.appNoticeItem": {
            "type": "object",
            "properties": {
                "content": {
                    "type": "string"
                }
            }
        },
        "app.bindDouyinPhoneRequest": {
            "type": "object",
            "properties": {
                "code": {
                    "type": "string"
                }
            }
        },
        "app.bindDouyinPhoneResponse": {
            "type": "object",
            "properties": {
                "mobile": {
                    "type": "string"
                },
                "success": {
                    "type": "boolean"
                }
            }
        },
        "app.bindPhoneRequest": {
            "type": "object",
            "properties": {
                "code": {
                    "type": "string"
                }
            }
        },
        "app.bindPhoneResponse": {
            "type": "object",
            "properties": {
                "mobile": {
                    "type": "string"
                },
                "success": {
                    "type": "boolean"
                }
            }
        },
        "app.cancelOrderRequest": {
            "type": "object",
            "properties": {
                "reason": {
                    "type": "string"
                }
            }
        },
        "app.cancelOrderResponse": {
            "type": "object",
            "properties": {
                "cancelled_at": {
                    "type": "string"
                },
                "order_id": {
                    "type": "integer"
                },
                "order_no": {
                    "type": "string"
                },
                "status": {
                    "type": "integer"
                }
            }
        },
        "app.cancelShippingRequest": {
            "type": "object",
            "properties": {
                "batch_no": {
                    "description": "批次号（与inventory_id二选一，取消整批）",
                    "type": "string"
                },
                "inventory_id": {
                    "description": "单个资产ID（与batch_no二选一）",
                    "type": "integer"
                }
            }
        },
        "app.cancelShippingResponse": {
            "type": "object",
            "properties": {
                "cancelled_count": {
                    "description": "成功取消的数量",
                    "type": "integer"
                }
            }
        },
        "app.couponDetail": {
            "type": "object",
            "properties": {
                "amount": {
                    "description": "原始面值",
                    "type": "integer"
                },
                "id": {
                    "type": "integer"
                },
                "name": {
                    "type": "string"
                },
                "remaining": {
                    "description": "剩余额度",
                    "type": "integer"
                },
                "status": {
                    "type": "integer"
                },
                "use_count": {
                    "description": "使用次数",
                    "type": "integer"
                },
                "used_amount": {
                    "description": "累计已使用金额",
                    "type": "integer"
                },
                "valid_end": {
                    "type": "string"
                },
                "valid_start": {
                    "type": "string"
                }
            }
        },
        "app.couponItem": {
            "type": "object",
            "properties": {
                "amount": {
                    "type": "integer"
                },
                "id": {
                    "type": "integer"
                },
                "name": {
                    "type": "string"
                },
                "remaining": {
                    "type": "integer"
                },
                "rules": {
                    "type": "string"
                },
                "status": {
                    "type": "integer"
                },
                "used_at": {
                    "description": "使用时间（已使用时返回）",
                    "type": "string"
                },
                "valid_end": {
                    "type": "string"
                },
                "valid_start": {
                    "type": "string"
                }
            }
        },
        "app.couponStatsResponse": {
            "type": "object",
            "properties": {
                "expired_count": {
                    "description": "已过期优惠券数量",
                    "type": "integer"
                },
                "total_remaining": {
                    "description": "可用优惠券总余额（分）",
                    "type": "integer"
                },
                "total_saved": {
                    "description": "累计节省金额（分）",
                    "type": "integer"
                },
                "unused_count": {
                    "description": "可用优惠券数量",
                    "type": "integer"
                },
                "used_count": {
                    "description": "已使用优惠券数量",
                    "type": "integer"
                }
            }
        },
        "app.couponUsageItem": {
            "type": "object",
            "properties": {
                "activity_name": {
                    "description": "活动名称",
                    "type": "string"
                },
                "amount": {
                    "description": "本次使用金额（正数）",
                    "type": "integer"
                },
                "created_at": {
                    "type": "string"
                },
                "id": {
                    "type": "integer"
                },
                "order_no": {
                    "description": "订单号",
                    "type": "string"
                }
            }
        },
        "app.douyinLoginRequest": {
            "type": "object",
            "properties": {
                "anonymous_code": {
                    "type": "string"
                },
                "channel_code": {
                    "type": "string"
                },
                "code": {
                    "type": "string"
                },
                "invite_code": {
                    "type": "string"
                }
            }
        },
        "app.douyinLoginResponse": {
            "type": "object",
            "properties": {
                "avatar": {
                    "type": "string"
                },
                "invite_code": {
                    "type": "string"
                },
                "nickname": {
                    "type": "string"
                },
                "token": {
                    "type": "string"
                },
                "user_id": {
                    "type": "integer"
                }
            }
        },
        "app.drawLogGroup": {
            "type": "object",
            "properties": {
                "level": {
                    "type": "integer"
                },
                "level_name": {
                    "type": "string"
                },
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/app.drawLogItem"
                    }
                }
            }
        },
        "app.drawLogItem": {
            "type": "object",
            "properties": {
                "avatar": {
                    "type": "string"
                },
                "created_at": {
                    "type": "string"
                },
                "current_level": {
                    "type": "integer"
                },
                "id": {
                    "type": "integer"
                },
                "is_winner": {
                    "type": "integer"
                },
                "issue_id": {
                    "type": "integer"
                },
                "level": {
                    "type": "integer"
                },
                "order_id": {
                    "type": "integer"
                },
                "reward_id": {
                    "type": "integer"
                },
                "reward_image": {
                    "type": "string"
                },
                "reward_name": {
                    "type": "string"
                },
                "user_id": {
                    "type": "integer"
                },
                "user_name": {
                    "type": "string"
                }
            }
        },
        "app.getAppProductDetailResponse": {
            "type": "object",
            "properties": {
                "album": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    }
                },
                "description": {
                    "type": "string"
                },
                "id": {
                    "type": "integer"
                },
                "name": {
                    "type": "string"
                },
                "points_required": {
                    "type": "integer"
                },
                "price": {
                    "type": "integer"
                },
                "recommendations": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/app.listAppProductsItem"
                    }
                },
                "sales": {
                    "type": "integer"
                },
                "service": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    }
                },
                "stock": {
                    "type": "integer"
                }
            }
        },
        "app.getGamePassesResponse": {
            "type": "object",
            "properties": {
                "global_remaining": {
                    "description": "全局通用次数",
                    "type": "integer"
                },
                "passes": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/app.userGamePassItem"
                    }
                },
                "total_remaining": {
                    "type": "integer"
                }
            }
        },
        "app.getPackagesResponse": {
            "type": "object",
            "properties": {
                "packages": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/app.packageItem"
                    }
                }
            }
        },
        "app.inviteUserItem": {
            "type": "object",
            "properties": {
                "avatar": {
                    "type": "string"
                },
                "id": {
                    "type": "integer"
                },
                "invite_code": {
                    "type": "string"
                },
                "nickname": {
                    "type": "string"
                }
            }
        },
        "app.issueItem": {
            "type": "object",
            "properties": {
                "id": {
                    "type": "integer"
                },
                "issue_number": {
                    "type": "string"
                },
                "remaining_prize_quantity": {
                    "type": "integer"
                },
                "sort": {
                    "type": "integer"
                },
                "status": {
                    "type": "integer"
                },
                "total_prize_quantity": {
                    "type": "integer"
                }
            }
        },
        "app.joinLotteryRequest": {
            "type": "object",
            "properties": {
                "activity_id": {
                    "type": "integer"
                },
                "channel": {
                    "type": "string"
                },
                "count": {
                    "type": "integer"
                },
                "coupon_id": {
                    "type": "integer"
                },
                "issue_id": {
                    "type": "integer"
                },
                "item_card_id": {
                    "type": "integer"
                },
                "slot_index": {
                    "type": "array",
                    "items": {
                        "type": "integer"
                    }
                },
                "use_game_pass": {
                    "type": "boolean"
                },
                "use_points": {
                    "type": "integer"
                }
            }
        },
        "app.joinLotteryResponse": {
            "type": "object",
            "properties": {
                "actual_amount": {
                    "type": "integer"
                },
                "draw_mode": {
                    "type": "string"
                },
                "join_id": {
                    "type": "string"
                },
                "order_no": {
                    "type": "string"
                },
                "queued": {
                    "type": "boolean"
                },
                "reward_id": {
                    "type": "integer"
                },
                "reward_name": {
                    "type": "string"
                },
                "status": {
                    "type": "integer"
                }
            }
        },
        "app.jsapiPreorderRequest": {
            "type": "object",
            "properties": {
                "openid": {
                    "type": "string"
                },
                "order_no": {
                    "type": "string"
                }
            }
        },
        "app.jsapiPreorderResponse": {
            "type": "object",
            "properties": {
                "nonceStr": {
                    "type": "string"
                },
                "package": {
                    "type": "string"
                },
                "paySign": {
                    "type": "string"
                },
                "signType": {
                    "type": "string"
                },
                "timeStamp": {
                    "type": "string"
                }
            }
        },
        "app.listActivitiesResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/app.activityItem"
                    }
                },
                "page": {
                    "type": "integer"
                },
                "page_size": {
                    "type": "integer"
                },
                "total": {
                    "type": "integer"
                }
            }
        },
        "app.listAddressesResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/model.UserAddresses"
                    }
                },
                "page": {
                    "type": "integer"
                },
                "page_size": {
                    "type": "integer"
                },
                "total": {
                    "type": "integer"
                }
            }
        },
        "app.listAppBannersResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/app.appBannerItem"
                    }
                }
            }
        },
        "app.listAppCategoriesResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/app.appCategoryItem"
                    }
                }
            }
        },
        "app.listAppNoticesResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/app.appNoticeItem"
                    }
                }
            }
        },
        "app.listAppProductsItem": {
            "type": "object",
            "properties": {
                "id": {
                    "type": "integer"
                },
                "in_stock": {
                    "type": "boolean"
                },
                "main_image": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "points_required": {
                    "type": "integer"
                },
                "price": {
                    "type": "integer"
                },
                "sales": {
                    "type": "integer"
                }
            }
        },
        "app.listAppProductsResponse": {
            "type": "object",
            "properties": {
                "currentPage": {
                    "type": "integer"
                },
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/app.listAppProductsItem"
                    }
                },
                "pageSize": {
                    "type": "integer"
                },
                "total": {
                    "type": "integer"
                }
            }
        },
        "app.listCouponUsageResponse": {
            "type": "object",
            "properties": {
                "coupon": {
                    "$ref": "#/definitions/app.couponDetail"
                },
                "page": {
                    "type": "integer"
                },
                "page_size": {
                    "type": "integer"
                },
                "records": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/app.couponUsageItem"
                    }
                },
                "total": {
                    "type": "integer"
                }
            }
        },
        "app.listCouponsResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/app.couponItem"
                    }
                },
                "page": {
                    "type": "integer"
                },
                "page_size": {
                    "type": "integer"
                },
                "total": {
                    "type": "integer"
                }
            }
        },
        "app.listDrawLogsByLevelResponse": {
            "type": "object",
            "properties": {
                "groups": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/app.drawLogGroup"
                    }
                }
            }
        },
        "app.listDrawLogsResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/app.drawLogItem"
                    }
                },
                "page": {
                    "type": "integer"
                },
                "page_size": {
                    "type": "integer"
                },
                "total": {
                    "type": "integer"
                }
            }
        },
        "app.listInventoryResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/user.AggregatedInventory"
                    }
                },
                "page": {
                    "type": "integer"
                },
                "page_size": {
                    "type": "integer"
                },
                "total": {
                    "type": "integer"
                }
            }
        },
        "app.listInvitesResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/app.inviteUserItem"
                    }
                },
                "page": {
                    "type": "integer"
                },
                "page_size": {
                    "type": "integer"
                },
                "total": {
                    "type": "integer"
                }
            }
        },
        "app.listIssueChoicesResponse": {
            "type": "object",
            "properties": {
                "available": {
                    "type": "array",
                    "items": {
                        "type": "integer"
                    }
                },
                "claimed": {
                    "type": "array",
                    "items": {
                        "type": "integer"
                    }
                },
                "total_slots": {
                    "type": "integer"
                }
            }
        },
        "app.listIssuesResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/app.issueItem"
                    }
                },
                "page": {
                    "type": "integer"
                },
                "page_size": {
                    "type": "integer"
                },
                "total": {
                    "type": "integer"
                }
            }
        },
        "app.listOrdersResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/user.OrderWithItems"
                    }
                },
                "page": {
                    "type": "integer"
                },
                "page_size": {
                    "type": "integer"
                },
                "total": {
                    "type": "integer"
                }
            }
        },
        "app.listPointsResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/model.UserPointsLedger"
                    }
                },
                "page": {
                    "type": "integer"
                },
                "page_size": {
                    "type": "integer"
                },
                "total": {
                    "type": "integer"
                }
            }
        },
        "app.listRewardsResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/app.rewardItem"
                    }
                },
                "play_type": {
                    "description": "活动类型",
                    "type": "string"
                }
            }
        },
        "app.listShipmentsResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/user.ShipmentGroup"
                    }
                },
                "page": {
                    "type": "integer"
                },
                "page_size": {
                    "type": "integer"
                },
                "total": {
                    "type": "integer"
                }
            }
        },
        "app.listStoreItem": {
            "type": "object",
            "properties": {
                "discount_type": {
                    "type": "integer"
                },
                "discount_value": {
                    "type": "integer"
                },
                "id": {
                    "type": "integer"
                },
                "in_stock": {
                    "type": "boolean"
                },
                "kind": {
                    "type": "string"
                },
                "main_image": {
                    "type": "string"
                },
                "min_spend": {
                    "type": "integer"
                },
                "name": {
                    "type": "string"
                },
                "points_required": {
                    "type": "integer"
                },
                "price": {
                    "type": "integer"
                },
                "status": {
                    "type": "integer"
                },
                "supported": {
                    "type": "boolean"
                }
            }
        },
        "app.listStoreItemsResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/app.listStoreItem"
                    }
                },
                "page": {
                    "type": "integer"
                },
                "page_size": {
                    "type": "integer"
                },
                "total": {
                    "type": "integer"
                }
            }
        },
        "app.listUserItemCardUsesResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/model.ActivityDrawEffects"
                    }
                },
                "page": {
                    "type": "integer"
                },
                "page_size": {
                    "type": "integer"
                },
                "total": {
                    "type": "integer"
                }
            }
        },
        "app.listUserItemCardsResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/user.ItemCardWithTemplate"
                    }
                },
                "page": {
                    "type": "integer"
                },
                "page_size": {
                    "type": "integer"
                },
                "total": {
                    "type": "integer"
                }
            }
        },
        "app.matchingGameCardsResponse": {
            "type": "object",
            "properties": {
                "all_cards": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/activity.MatchingCard"
                    }
                },
                "game_id": {
                    "type": "string"
                }
            }
        },
        "app.matchingGameCheckRequest": {
            "type": "object",
            "required": [
                "game_id"
            ],
            "properties": {
                "game_id": {
                    "type": "string"
                },
                "total_pairs": {
                    "description": "客户端上报的消除总对数",
                    "type": "integer"
                }
            }
        },
        "app.matchingGameCheckResponse": {
            "type": "object",
            "properties": {
                "finished": {
                    "type": "boolean"
                },
                "game_id": {
                    "type": "string"
                },
                "reward": {
                    "$ref": "#/definitions/app.MatchingRewardInfo"
                },
                "total_pairs": {
                    "type": "integer"
                }
            }
        },
        "app.matchingGamePreOrderRequest": {
            "type": "object",
            "properties": {
                "coupon_id": {
                    "type": "integer"
                },
                "issue_id": {
                    "type": "integer"
                },
                "item_card_id": {
                    "type": "integer"
                },
                "position": {
                    "type": "string"
                },
                "use_game_pass": {
                    "description": "新增：是否使用次数卡",
                    "type": "boolean"
                }
            }
        },
        "app.matchingGamePreOrderResponse": {
            "type": "object",
            "properties": {
                "game_id": {
                    "type": "string"
                },
                "order_no": {
                    "type": "string"
                },
                "pay_status": {
                    "description": "1=Pending, 2=Paid",
                    "type": "integer"
                },
                "server_seed_hash": {
                    "type": "string"
                }
            }
        },
        "app.modifyUserRequest": {
            "type": "object",
            "properties": {
                "avatar": {
                    "type": "string"
                },
                "nickname": {
                    "type": "string"
                }
            }
        },
        "app.modifyUserResponse": {
            "type": "object",
            "properties": {
                "user": {
                    "$ref": "#/definitions/app.userItem"
                }
            }
        },
        "app.okDeleteResponse": {
            "type": "object",
            "properties": {
                "ok": {
                    "type": "boolean"
                }
            }
        },
        "app.okResponse": {
            "type": "object",
            "properties": {
                "ok": {
                    "type": "boolean"
                }
            }
        },
        "app.orderResultItem": {
            "type": "object",
            "properties": {
                "draw_index": {
                    "type": "integer"
                },
                "image": {
                    "type": "string"
                },
                "level": {
                    "type": "integer"
                },
                "reward_id": {
                    "type": "integer"
                },
                "reward_name": {
                    "type": "string"
                }
            }
        },
        "app.orderResultResponse": {
            "type": "object",
            "properties": {
                "completed": {
                    "type": "integer"
                },
                "count": {
                    "type": "integer"
                },
                "draw_mode": {
                    "type": "string"
                },
                "nextPollMs": {
                    "type": "integer"
                },
                "next_draw_time": {
                    "type": "string"
                },
                "receipt": {
                    "type": "object",
                    "additionalProperties": {}
                },
                "results": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/app.orderResultItem"
                    }
                },
                "seed_hex": {
                    "type": "string"
                },
                "status": {
                    "type": "string"
                }
            }
        },
        "app.packageItem": {
            "type": "object",
            "properties": {
                "activity_id": {
                    "type": "integer"
                },
                "id": {
                    "type": "integer"
                },
                "name": {
                    "type": "string"
                },
                "original_price": {
                    "type": "integer"
                },
                "pass_count": {
                    "type": "integer"
                },
                "price": {
                    "type": "integer"
                },
                "valid_days": {
                    "type": "integer"
                }
            }
        },
        "app.pointsBalanceResponse": {
            "type": "object",
            "properties": {
                "balance": {
                    "type": "integer"
                }
            }
        },
        "app.purchasePackageRequest": {
            "type": "object",
            "required": [
                "package_id"
            ],
            "properties": {
                "count": {
                    "description": "购买数量",
                    "type": "integer"
                },
                "package_id": {
                    "type": "integer"
                }
            }
        },
        "app.purchasePackageResponse": {
            "type": "object",
            "properties": {
                "message": {
                    "type": "string"
                },
                "order_no": {
                    "type": "string"
                }
            }
        },
        "app.redeemCouponRequest": {
            "type": "object",
            "properties": {
                "coupon_id": {
                    "type": "integer"
                }
            }
        },
        "app.redeemCouponResponse": {
            "type": "object",
            "properties": {
                "coupon_id": {
                    "type": "integer"
                },
                "ledger_id": {
                    "type": "integer"
                },
                "message": {
                    "type": "string"
                },
                "success": {
                    "type": "boolean"
                }
            }
        },
        "app.redeemInventoryRequest": {
            "type": "object",
            "properties": {
                "inventory_ids": {
                    "type": "array",
                    "items": {
                        "type": "integer"
                    }
                }
            }
        },
        "app.redeemInventoryResponse": {
            "type": "object",
            "properties": {
                "points": {
                    "type": "integer"
                }
            }
        },
        "app.redeemItemCardRequest": {
            "type": "object",
            "properties": {
                "card_id": {
                    "type": "integer"
                },
                "quantity": {
                    "type": "integer"
                }
            }
        },
        "app.redeemItemCardResponse": {
            "type": "object",
            "properties": {
                "card_id": {
                    "type": "integer"
                },
                "ledger_id": {
                    "type": "integer"
                },
                "message": {
                    "type": "string"
                },
                "success": {
                    "type": "boolean"
                }
            }
        },
        "app.redeemProductRequest": {
            "type": "object",
            "properties": {
                "product_id": {
                    "type": "integer"
                },
                "quantity": {
                    "type": "integer"
                }
            }
        },
        "app.redeemProductResponse": {
            "type": "object",
            "properties": {
                "inventory_ids": {
                    "type": "array",
                    "items": {
                        "type": "integer"
                    }
                },
                "ledger_id": {
                    "type": "integer"
                },
                "message": {
                    "type": "string"
                },
                "order_id": {
                    "type": "integer"
                },
                "success": {
                    "type": "boolean"
                }
            }
        },
        "app.requestShippingBatchRequest": {
            "type": "object",
            "properties": {
                "address_id": {
                    "type": "integer"
                },
                "inventory_ids": {
                    "type": "array",
                    "items": {
                        "type": "integer"
                    }
                }
            }
        },
        "app.requestShippingBatchResponse": {
            "type": "object",
            "properties": {
                "address_id": {
                    "type": "integer"
                },
                "batch_no": {
                    "type": "string"
                },
                "failed": {
                    "type": "array",
                    "items": {
                        "type": "object",
                        "additionalProperties": {}
                    }
                },
                "skipped": {
                    "type": "array",
                    "items": {
                        "type": "object",
                        "additionalProperties": {}
                    }
                },
                "success_ids": {
                    "type": "array",
                    "items": {
                        "type": "integer"
                    }
                }
            }
        },
        "app.requestShippingRequest": {
            "type": "object",
            "properties": {
                "inventory_id": {
                    "type": "integer"
                }
            }
        },
        "app.requestShippingResponse": {
            "type": "object",
            "properties": {
                "address_id": {
                    "type": "integer"
                }
            }
        },
        "app.resultResponse": {
            "type": "object",
            "properties": {
                "receipt": {
                    "type": "object",
                    "additionalProperties": {}
                },
                "result": {
                    "type": "object",
                    "additionalProperties": {}
                },
                "results": {
                    "type": "array",
                    "items": {
                        "type": "object",
                        "additionalProperties": {}
                    }
                }
            }
        },
        "app.rewardItem": {
            "type": "object",
            "properties": {
                "id": {
                    "type": "integer"
                },
                "is_boss": {
                    "type": "integer"
                },
                "level": {
                    "type": "integer"
                },
                "min_score": {
                    "type": "integer"
                },
                "name": {
                    "type": "string"
                },
                "original_qty": {
                    "type": "integer"
                },
                "prize_level": {
                    "description": "兼容部分前端逻辑",
                    "type": "integer"
                },
                "product_id": {
                    "type": "integer"
                },
                "product_image": {
                    "type": "string"
                },
                "quantity": {
                    "type": "integer"
                },
                "sort": {
                    "type": "integer"
                },
                "weight": {
                    "type": "integer"
                }
            }
        },
        "app.sendSmsCodeRequest": {
            "type": "object",
            "required": [
                "mobile"
            ],
            "properties": {
                "mobile": {
                    "type": "string"
                }
            }
        },
        "app.sendSmsCodeResponse": {
            "type": "object",
            "properties": {
                "expire_seconds": {
                    "type": "integer"
                },
                "success": {
                    "type": "boolean"
                }
            }
        },
        "app.smsLoginRequest": {
            "type": "object",
            "required": [
                "code",
                "mobile"
            ],
            "properties": {
                "code": {
                    "type": "string"
                },
                "invite_code": {
                    "type": "string"
                },
                "mobile": {
                    "type": "string"
                }
            }
        },
        "app.smsLoginResponse": {
            "type": "object",
            "properties": {
                "avatar": {
                    "type": "string"
                },
                "invite_code": {
                    "type": "string"
                },
                "is_new_user": {
                    "type": "boolean"
                },
                "mobile": {
                    "type": "string"
                },
                "nickname": {
                    "type": "string"
                },
                "openid": {
                    "type": "string"
                },
                "token": {
                    "type": "string"
                },
                "user_id": {
                    "type": "integer"
                }
            }
        },
        "app.updateAddressRequest": {
            "type": "object",
            "properties": {
                "address": {
                    "type": "string"
                },
                "city": {
                    "type": "string"
                },
                "district": {
                    "type": "string"
                },
                "is_default": {
                    "type": "boolean"
                },
                "mobile": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "province": {
                    "type": "string"
                }
            }
        },
        "app.userGamePassItem": {
            "type": "object",
            "properties": {
                "activity_id": {
                    "type": "integer"
                },
                "activity_name": {
                    "type": "string"
                },
                "expired_at": {
                    "type": "string"
                },
                "id": {
                    "type": "integer"
                },
                "remaining": {
                    "type": "integer"
                },
                "source": {
                    "type": "string"
                }
            }
        },
        "app.userItem": {
            "type": "object",
            "properties": {
                "avatar": {
                    "type": "string"
                },
                "balance": {
                    "description": "Points",
                    "type": "integer"
                },
                "id": {
                    "type": "integer"
                },
                "invite_code": {
                    "type": "string"
                },
                "inviter_id": {
                    "type": "integer"
                },
                "mobile": {
                    "type": "string"
                },
                "nickname": {
                    "type": "string"
                }
            }
        },
        "app.userStatsResponse": {
            "type": "object",
            "properties": {
                "coupon_count": {
                    "type": "integer"
                },
                "item_card_count": {
                    "type": "integer"
                },
                "points_balance": {
                    "type": "integer"
                }
            }
        },
        "app.weixinLoginRequest": {
            "type": "object",
            "properties": {
                "code": {
                    "type": "string"
                },
                "douyin_id": {
                    "type": "string"
                },
                "invite_code": {
                    "type": "string"
                }
            }
        },
        "app.weixinLoginResponse": {
            "type": "object",
            "properties": {
                "avatar": {
                    "type": "string"
                },
                "invite_code": {
                    "type": "string"
                },
                "nickname": {
                    "type": "string"
                },
                "openid": {
                    "type": "string"
                },
                "token": {
                    "type": "string"
                },
                "user_id": {
                    "type": "integer"
                }
            }
        },
        "code.Failure": {
            "type": "object",
            "properties": {
                "code": {
                    "description": "业务码",
                    "type": "integer"
                },
                "message": {
                    "description": "描述信息",
                    "type": "string"
                }
            }
        },
        "game.consumeTicketRequest": {
            "type": "object",
            "properties": {
                "game_code": {
                    "type": "string"
                },
                "ticket": {
                    "type": "string"
                },
                "user_id": {
                    "type": "string"
                }
            }
        },
        "game.consumeTicketResponse": {
            "type": "object",
            "properties": {
                "error": {
                    "type": "string"
                },
                "success": {
                    "type": "boolean"
                }
            }
        },
        "game.enterGameRequest": {
            "type": "object",
            "required": [
                "game_code"
            ],
            "properties": {
                "game_code": {
                    "type": "string"
                }
            }
        },
        "game.enterGameResponse": {
            "type": "object",
            "properties": {
                "client_url": {
                    "type": "string"
                },
                "expires_at": {
                    "type": "string"
                },
                "game_token": {
                    "type": "string"
                },
                "nakama_key": {
                    "type": "string"
                },
                "nakama_server": {
                    "type": "string"
                },
                "remaining_times": {
                    "type": "integer"
                }
            }
        },
        "game.grantTicketRequest": {
            "type": "object",
            "required": [
                "amount",
                "game_code"
            ],
            "properties": {
                "amount": {
                    "type": "integer",
                    "minimum": 1
                },
                "game_code": {
                    "type": "string"
                },
                "remark": {
                    "type": "string"
                }
            }
        },
        "game.settleRequest": {
            "type": "object",
            "properties": {
                "match_id": {
                    "type": "string"
                },
                "score": {
                    "type": "integer"
                },
                "ticket": {
                    "type": "string"
                },
                "user_id": {
                    "type": "string"
                },
                "win": {
                    "type": "boolean"
                }
            }
        },
        "game.settleResponse": {
            "type": "object",
            "properties": {
                "reward": {
                    "type": "string"
                },
                "success": {
                    "type": "boolean"
                }
            }
        },
        "game.validateTokenRequest": {
            "type": "object",
            "required": [
                "game_token"
            ],
            "properties": {
                "game_token": {
                    "type": "string"
                }
            }
        },
        "game.validateTokenResponse": {
            "type": "object",
            "properties": {
                "avatar": {
                    "type": "string"
                },
                "error": {
                    "type": "string"
                },
                "game_type": {
                    "type": "string"
                },
                "ticket": {
                    "type": "string"
                },
                "user_id": {
                    "type": "integer"
                },
                "username": {
                    "type": "string"
                },
                "valid": {
                    "type": "boolean"
                }
            }
        },
        "game.verifyRequest": {
            "type": "object",
            "properties": {
                "ticket": {
                    "type": "string"
                },
                "user_id": {
                    "type": "string"
                }
            }
        },
        "game.verifyResponse": {
            "type": "object",
            "properties": {
                "game_config": {
                    "type": "object",
                    "additionalProperties": {}
                },
                "user_id": {
                    "type": "string"
                },
                "valid": {
                    "type": "boolean"
                }
            }
        },
        "minesweeper.SettleGameRequest": {
            "type": "object",
            "properties": {
                "match_id": {
                    "type": "string"
                },
                "metadata": {
                    "type": "string"
                },
                "score": {
                    "type": "integer"
                },
                "ticket": {
                    "type": "string"
                },
                "user_id": {
                    "type": "string"
                },
                "win": {
                    "type": "boolean"
                }
            }
        },
        "minesweeper.SettleGameResponse": {
            "type": "object",
            "properties": {
                "reward": {
                    "type": "string"
                },
                "success": {
                    "type": "boolean"
                }
            }
        },
        "minesweeper.VerifyTicketRequest": {
            "type": "object",
            "properties": {
                "ticket": {
                    "type": "string"
                },
                "user_id": {
                    "type": "string"
                }
            }
        },
        "minesweeper.VerifyTicketResponse": {
            "type": "object",
            "properties": {
                "remaining_times": {
                    "type": "integer"
                },
                "user_id": {
                    "type": "string"
                },
                "valid": {
                    "type": "boolean"
                }
            }
        },
        "model.ActivityDrawEffects": {
            "type": "object",
            "properties": {
                "activity_category_id": {
                    "description": "范围快照-活动分类ID",
                    "type": "integer"
                },
                "activity_id": {
                    "description": "范围快照-活动ID",
                    "type": "integer"
                },
                "applied": {
                    "description": "是否生效：0否 1是",
                    "type": "integer"
                },
                "card_type": {
                    "description": "卡类型快照",
                    "type": "integer"
                },
                "created_at": {
                    "description": "创建时间",
                    "type": "string"
                },
                "draw_log_id": {
                    "description": "抽奖日志ID（activity_draw_logs.id）",
                    "type": "integer"
                },
                "effect_type": {
                    "description": "效果类型快照",
                    "type": "integer"
                },
                "id": {
                    "description": "主键ID",
                    "type": "integer"
                },
                "issue_id": {
                    "description": "范围快照-期ID",
                    "type": "integer"
                },
                "probability_delta_x1000": {
                    "description": "概率相对增益（千分比）",
                    "type": "integer"
                },
                "remark": {
                    "description": "备注",
                    "type": "string"
                },
                "reward_multiplier_x1000": {
                    "description": "奖励倍数（千分比）",
                    "type": "integer"
                },
                "scope_type": {
                    "description": "适用范围快照",
                    "type": "integer"
                },
                "system_item_card_id": {
                    "description": "卡模板ID（system_item_cards.id）",
                    "type": "integer"
                },
                "user_id": {
                    "description": "用户ID（users.id）",
                    "type": "integer"
                },
                "user_item_card_id": {
                    "description": "用户卡实例ID（user_item_cards.id）",
                    "type": "integer"
                }
            }
        },
        "model.OrderItems": {
            "type": "object",
            "properties": {
                "created_at": {
                    "description": "创建时间",
                    "type": "string"
                },
                "id": {
                    "description": "主键ID",
                    "type": "integer"
                },
                "order_id": {
                    "description": "订单ID（orders.id）",
                    "type": "integer"
                },
                "price": {
                    "description": "成交单价（分）",
                    "type": "integer"
                },
                "product_id": {
                    "description": "商品ID（products.id）",
                    "type": "integer"
                },
                "product_images": {
                    "description": "商品图片快照（JSON）",
                    "type": "string"
                },
                "quantity": {
                    "description": "购买数量",
                    "type": "integer"
                },
                "status": {
                    "description": "行状态：1正常 2取消",
                    "type": "integer"
                },
                "title": {
                    "description": "商品标题快照",
                    "type": "string"
                },
                "total_amount": {
                    "description": "行应付总额（分）",
                    "type": "integer"
                }
            }
        },
        "model.ShippingRecords": {
            "type": "object",
            "properties": {
                "address_id": {
                    "description": "收货地址ID（user_addresses.id）",
                    "type": "integer"
                },
                "batch_no": {
                    "description": "批次号（批量发货时用于聚合）",
                    "type": "string"
                },
                "created_at": {
                    "description": "创建时间",
                    "type": "string"
                },
                "express_code": {
                    "description": "快递公司编码",
                    "type": "string"
                },
                "express_no": {
                    "description": "运单号",
                    "type": "string"
                },
                "id": {
                    "description": "主键ID",
                    "type": "integer"
                },
                "inventory_id": {
                    "description": "资产ID（抽奖产物发货时使用）",
                    "type": "integer"
                },
                "order_id": {
                    "description": "关联订单ID（orders.id，抽奖产物可为空）",
                    "type": "integer"
                },
                "order_item_id": {
                    "description": "订单行ID（商城直发时使用）",
                    "type": "integer"
                },
                "price": {
                    "description": "行价格（分，可选）",
                    "type": "integer"
                },
                "product_id": {
                    "description": "商品ID（统计/冗余）",
                    "type": "integer"
                },
                "quantity": {
                    "description": "发货数量",
                    "type": "integer"
                },
                "received_at": {
                    "description": "签收时间",
                    "type": "string"
                },
                "remark": {
                    "description": "备注",
                    "type": "string"
                },
                "shipped_at": {
                    "description": "发货时间",
                    "type": "string"
                },
                "status": {
                    "description": "发货状态：1待发货 2已发货 3已签收 4异常",
                    "type": "integer"
                },
                "updated_at": {
                    "description": "更新时间",
                    "type": "string"
                },
                "user_id": {
                    "description": "收件用户ID（user_members.id）",
                    "type": "integer"
                }
            }
        },
        "model.UserAddresses": {
            "type": "object",
            "properties": {
                "address": {
                    "description": "详细地址",
                    "type": "string"
                },
                "city": {
                    "description": "市",
                    "type": "string"
                },
                "created_at": {
                    "description": "创建时间",
                    "type": "string"
                },
                "default_user_unique": {
                    "description": "用于唯一约束的生成列：默认地址→user_id",
                    "type": "integer"
                },
                "district": {
                    "description": "区/县",
                    "type": "string"
                },
                "id": {
                    "description": "主键ID",
                    "type": "integer"
                },
                "is_default": {
                    "description": "是否默认地址：0否 1是",
                    "type": "integer"
                },
                "mobile": {
                    "description": "收件人手机号",
                    "type": "string"
                },
                "name": {
                    "description": "收件人姓名",
                    "type": "string"
                },
                "province": {
                    "description": "省",
                    "type": "string"
                },
                "updated_at": {
                    "description": "更新时间",
                    "type": "string"
                },
                "user_id": {
                    "description": "用户ID（user_members.id）",
                    "type": "integer"
                }
            }
        },
        "model.UserPointsLedger": {
            "type": "object",
            "properties": {
                "action": {
                    "description": "变更动作：signin/order_deduct/refund_restore/manual",
                    "type": "string"
                },
                "created_at": {
                    "description": "创建时间",
                    "type": "string"
                },
                "id": {
                    "description": "主键ID",
                    "type": "integer"
                },
                "points": {
                    "description": "积分变动值（正增负减）",
                    "type": "integer"
                },
                "ref_id": {
                    "description": "关联ID（如订单号/记录ID）",
                    "type": "string"
                },
                "ref_table": {
                    "description": "关联表名（如orders/payment_refund）",
                    "type": "string"
                },
                "remark": {
                    "description": "备注",
                    "type": "string"
                },
                "user_id": {
                    "description": "用户ID（user_members.id）",
                    "type": "integer"
                }
            }
        },
        "pay.notifyAck": {
            "type": "object",
            "properties": {
                "code": {
                    "type": "string"
                },
                "message": {
                    "type": "string"
                }
            }
        },
        "snapshot.CouponInfo": {
            "type": "object",
            "properties": {
                "balance_amount": {
                    "type": "integer"
                },
                "coupon_id": {
                    "type": "integer"
                },
                "coupon_name": {
                    "type": "string"
                },
                "status": {
                    "type": "integer"
                },
                "user_coupon_id": {
                    "type": "integer"
                },
                "valid_end": {
                    "type": "string"
                }
            }
        },
        "snapshot.ItemCardInfo": {
            "type": "object",
            "properties": {
                "card_id": {
                    "type": "integer"
                },
                "card_name": {
                    "type": "string"
                },
                "status": {
                    "type": "integer"
                },
                "user_item_card_id": {
                    "type": "integer"
                },
                "valid_end": {
                    "type": "string"
                }
            }
        },
        "snapshot.PointsInfo": {
            "type": "object",
            "properties": {
                "balance": {
                    "type": "integer"
                },
                "version": {
                    "type": "integer"
                }
            }
        },
        "snapshot.SnapshotDiff": {
            "type": "object",
            "properties": {
                "coupons_used": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/snapshot.CouponInfo"
                    }
                },
                "inventory_added": {
                    "type": "integer"
                },
                "item_cards_used": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/snapshot.ItemCardInfo"
                    }
                },
                "points_changed": {
                    "type": "integer"
                }
            }
        },
        "snapshot.UserInfo": {
            "type": "object",
            "properties": {
                "id": {
                    "type": "integer"
                },
                "mobile": {
                    "type": "string"
                },
                "nickname": {
                    "type": "string"
                }
            }
        },
        "snapshot.UserStateSnapshot": {
            "type": "object",
            "properties": {
                "coupons": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/snapshot.CouponInfo"
                    }
                },
                "inventory_count": {
                    "type": "integer"
                },
                "item_cards": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/snapshot.ItemCardInfo"
                    }
                },
                "points": {
                    "$ref": "#/definitions/snapshot.PointsInfo"
                },
                "snapshot_time": {
                    "type": "string"
                },
                "user": {
                    "$ref": "#/definitions/snapshot.UserInfo"
                }
            }
        },
        "taskcenter.claimTaskRequest": {
            "type": "object",
            "properties": {
                "tier_id": {
                    "type": "integer"
                }
            }
        },
        "taskcenter.createTaskRequest": {
            "type": "object",
            "properties": {
                "description": {
                    "type": "string"
                },
                "end_time": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "start_time": {
                    "type": "string"
                },
                "status": {
                    "type": "integer"
                },
                "visibility": {
                    "type": "integer"
                }
            }
        },
        "taskcenter.listTasksResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/taskcenter.taskItem"
                    }
                },
                "page": {
                    "type": "integer"
                },
                "page_size": {
                    "type": "integer"
                },
                "total": {
                    "type": "integer"
                }
            }
        },
        "taskcenter.modifyTaskRequest": {
            "type": "object",
            "properties": {
                "description": {
                    "type": "string"
                },
                "end_time": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "start_time": {
                    "type": "string"
                },
                "status": {
                    "type": "integer"
                },
                "visibility": {
                    "type": "integer"
                }
            }
        },
        "taskcenter.simulateInviteSuccessRequest": {
            "type": "object",
            "properties": {
                "invitee_id": {
                    "type": "integer"
                },
                "inviter_id": {
                    "type": "integer"
                }
            }
        },
        "taskcenter.simulateOrderPaidRequest": {
            "type": "object",
            "properties": {
                "order_id": {
                    "type": "integer"
                },
                "user_id": {
                    "type": "integer"
                }
            }
        },
        "taskcenter.taskItem": {
            "type": "object",
            "properties": {
                "description": {
                    "type": "string"
                },
                "end_time": {
                    "type": "integer"
                },
                "id": {
                    "type": "integer"
                },
                "name": {
                    "type": "string"
                },
                "rewards": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/taskcenter.taskRewardItem"
                    }
                },
                "start_time": {
                    "type": "integer"
                },
                "status": {
                    "type": "integer"
                },
                "tiers": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/taskcenter.taskTierItem"
                    }
                }
            }
        },
        "taskcenter.taskProgressResponse": {
            "type": "object",
            "properties": {
                "claimed_tiers": {
                    "type": "array",
                    "items": {
                        "type": "integer"
                    }
                },
                "first_order": {
                    "type": "boolean"
                },
                "invite_count": {
                    "type": "integer"
                },
                "order_amount": {
                    "type": "integer"
                },
                "order_count": {
                    "type": "integer"
                },
                "task_id": {
                    "type": "integer"
                },
                "user_id": {
                    "type": "integer"
                }
            }
        },
        "taskcenter.taskRewardItem": {
            "type": "object",
            "properties": {
                "id": {
                    "type": "integer"
                },
                "quantity": {
                    "type": "integer"
                },
                "reward_name": {
                    "type": "string"
                },
                "reward_payload": {
                    "type": "object",
                    "additionalProperties": {}
                },
                "reward_type": {
                    "type": "string"
                },
                "tier_id": {
                    "type": "integer"
                }
            }
        },
        "taskcenter.taskTierItem": {
            "type": "object",
            "properties": {
                "id": {
                    "type": "integer"
                },
                "metric": {
                    "type": "string"
                },
                "operator": {
                    "type": "string"
                },
                "priority": {
                    "type": "integer"
                },
                "repeatable": {
                    "type": "integer"
                },
                "threshold": {
                    "type": "integer"
                },
                "window": {
                    "type": "string"
                }
            }
        },
        "taskcenter.upsertRewardsRequest": {
            "type": "object",
            "properties": {
                "rewards": {
                    "type": "array",
                    "items": {
                        "type": "object",
                        "properties": {
                            "quantity": {
                                "type": "integer"
                            },
                            "reward_payload": {
                                "type": "array",
                                "items": {
                                    "type": "integer"
                                }
                            },
                            "reward_type": {
                                "type": "string"
                            },
                            "tier_id": {
                                "type": "integer"
                            }
                        }
                    }
                }
            }
        },
        "taskcenter.upsertTiersRequest": {
            "type": "object",
            "properties": {
                "tiers": {
                    "type": "array",
                    "items": {
                        "type": "object",
                        "properties": {
                            "activity_id": {
                                "type": "integer"
                            },
                            "extra_params": {
                                "type": "array",
                                "items": {
                                    "type": "integer"
                                }
                            },
                            "metric": {
                                "type": "string"
                            },
                            "operator": {
                                "type": "string"
                            },
                            "priority": {
                                "type": "integer"
                            },
                            "repeatable": {
                                "type": "integer"
                            },
                            "threshold": {
                                "type": "integer"
                            },
                            "window": {
                                "type": "string"
                            }
                        }
                    }
                }
            }
        },
        "user.AggregatedInventory": {
            "type": "object",
            "properties": {
                "count": {
                    "type": "integer"
                },
                "has_shipment": {
                    "type": "boolean"
                },
                "inventory_ids": {
                    "type": "array",
                    "items": {
                        "type": "integer"
                    }
                },
                "product_id": {
                    "type": "integer"
                },
                "product_images": {
                    "type": "string"
                },
                "product_name": {
                    "type": "string"
                },
                "product_price": {
                    "type": "integer"
                },
                "shipping_status": {
                    "type": "integer"
                },
                "status": {
                    "description": "用于区分 1持有 3已处理",
                    "type": "integer"
                },
                "updated_at": {
                    "type": "string"
                }
            }
        },
        "user.CouponSimpleInfo": {
            "type": "object",
            "properties": {
                "name": {
                    "type": "string"
                },
                "type": {
                    "description": "1:满减 2:折扣",
                    "type": "integer"
                },
                "user_coupon_id": {
                    "type": "integer"
                },
                "value": {
                    "type": "integer"
                }
            }
        },
        "user.DrawReceiptInfo": {
            "type": "object",
            "properties": {
                "algo_version": {
                    "type": "string"
                },
                "client_id": {
                    "type": "integer"
                },
                "client_seed": {
                    "type": "string"
                },
                "draw_id": {
                    "type": "integer"
                },
                "draw_index": {
                    "type": "integer"
                },
                "draw_log_id": {
                    "type": "integer"
                },
                "items_root": {
                    "type": "string"
                },
                "items_snapshot": {
                    "type": "string"
                },
                "nonce": {
                    "type": "integer"
                },
                "rand_proof": {
                    "type": "string"
                },
                "reward_id": {
                    "type": "integer"
                },
                "round_id": {
                    "type": "integer"
                },
                "selected_index": {
                    "type": "integer"
                },
                "server_seed_hash": {
                    "type": "string"
                },
                "server_sub_seed": {
                    "type": "string"
                },
                "signature": {
                    "type": "string"
                },
                "timestamp": {
                    "type": "integer"
                },
                "weights_total": {
                    "type": "integer"
                }
            }
        },
        "user.InventoryWithProduct": {
            "type": "object",
            "properties": {
                "activity_id": {
                    "description": "来源活动ID",
                    "type": "integer"
                },
                "created_at": {
                    "description": "创建时间",
                    "type": "string"
                },
                "has_shipment": {
                    "type": "boolean"
                },
                "id": {
                    "description": "主键ID",
                    "type": "integer"
                },
                "order_id": {
                    "description": "来源订单ID",
                    "type": "integer"
                },
                "product_id": {
                    "description": "资产对应商品ID（实物奖/商品）",
                    "type": "integer"
                },
                "product_images": {
                    "type": "string"
                },
                "product_name": {
                    "type": "string"
                },
                "product_price": {
                    "description": "新增价格字段",
                    "type": "integer"
                },
                "remark": {
                    "description": "备注",
                    "type": "string"
                },
                "reward_id": {
                    "description": "来源奖励ID（activity_reward_settings.id）",
                    "type": "integer"
                },
                "shipping_no": {
                    "description": "发货单号",
                    "type": "string"
                },
                "shipping_status": {
                    "type": "integer"
                },
                "status": {
                    "description": "状态：1持有 2作废 3已使用/发货",
                    "type": "integer"
                },
                "updated_at": {
                    "description": "更新时间",
                    "type": "string"
                },
                "user_id": {
                    "description": "资产归属用户ID",
                    "type": "integer"
                }
            }
        },
        "user.ItemCardSimpleInfo": {
            "type": "object",
            "properties": {
                "effect_type": {
                    "type": "integer"
                },
                "name": {
                    "type": "string"
                },
                "user_card_id": {
                    "type": "integer"
                }
            }
        },
        "user.ItemCardWithTemplate": {
            "type": "object",
            "properties": {
                "card_id": {
                    "description": "卡模板ID（system_item_cards.id）",
                    "type": "integer"
                },
                "card_type": {
                    "type": "integer"
                },
                "count": {
                    "type": "integer"
                },
                "created_at": {
                    "description": "创建时间",
                    "type": "string"
                },
                "effect_type": {
                    "type": "integer"
                },
                "id": {
                    "description": "主键ID",
                    "type": "integer"
                },
                "name": {
                    "type": "string"
                },
                "remark": {
                    "type": "string"
                },
                "scope_type": {
                    "type": "integer"
                },
                "stacking_strategy": {
                    "type": "integer"
                },
                "status": {
                    "description": "状态：1未使用 2已使用 3已过期",
                    "type": "integer"
                },
                "updated_at": {
                    "description": "更新时间",
                    "type": "string"
                },
                "used_activity_id": {
                    "description": "使用时活动ID",
                    "type": "integer"
                },
                "used_activity_name": {
                    "type": "string"
                },
                "used_at": {
                    "description": "使用时间",
                    "type": "string"
                },
                "used_draw_log_id": {
                    "description": "使用关联抽奖日志ID（activity_draw_logs.id）",
                    "type": "integer"
                },
                "used_issue_id": {
                    "description": "使用时期ID",
                    "type": "integer"
                },
                "used_issue_number": {
                    "type": "string"
                },
                "used_reward_name": {
                    "type": "string"
                },
                "user_id": {
                    "description": "用户ID（users.id）",
                    "type": "integer"
                },
                "valid_end": {
                    "description": "有效期结束",
                    "type": "string"
                },
                "valid_start": {
                    "description": "有效期开始",
                    "type": "string"
                }
            }
        },
        "user.OrderWithItems": {
            "type": "object",
            "properties": {
                "activity_id": {
                    "type": "integer"
                },
                "activity_name": {
                    "type": "string"
                },
                "actual_amount": {
                    "description": "实际支付金额（分）",
                    "type": "integer"
                },
                "cancelled_at": {
                    "description": "取消时间",
                    "type": "string"
                },
                "category_id": {
                    "type": "integer"
                },
                "category_name": {
                    "type": "string"
                },
                "coupon_id": {
                    "description": "使用的优惠券ID",
                    "type": "integer"
                },
                "coupon_info": {
                    "$ref": "#/definitions/user.CouponSimpleInfo"
                },
                "created_at": {
                    "description": "创建时间",
                    "type": "string"
                },
                "discount_amount": {
                    "description": "优惠券抵扣金额（分）",
                    "type": "integer"
                },
                "draw_receipts": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/user.DrawReceiptInfo"
                    }
                },
                "id": {
                    "description": "主键ID",
                    "type": "integer"
                },
                "is_consumed": {
                    "description": "是否已履约/消耗（对虚拟资产）",
                    "type": "integer"
                },
                "is_draw": {
                    "type": "boolean"
                },
                "is_winner": {
                    "type": "boolean"
                },
                "issue_number": {
                    "type": "string"
                },
                "item_card_id": {
                    "description": "使用的道具卡ID",
                    "type": "integer"
                },
                "item_card_info": {
                    "$ref": "#/definitions/user.ItemCardSimpleInfo"
                },
                "items": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/model.OrderItems"
                    }
                },
                "order_no": {
                    "description": "业务订单号（唯一）",
                    "type": "string"
                },
                "paid_at": {
                    "description": "支付完成时间",
                    "type": "string"
                },
                "pay_preorder_id": {
                    "description": "关联预支付单ID（payment_preorder.id）",
                    "type": "integer"
                },
                "play_type": {
                    "type": "string"
                },
                "points_amount": {
                    "description": "积分抵扣金额（分）",
                    "type": "integer"
                },
                "points_ledger_id": {
                    "description": "积分扣减流水ID（user_points_ledger.id）",
                    "type": "integer"
                },
                "remark": {
                    "description": "备注",
                    "type": "string"
                },
                "reward_level": {
                    "type": "integer"
                },
                "source_type": {
                    "description": "来源：1商城直购 2抽奖票据 3其他",
                    "type": "integer"
                },
                "status": {
                    "description": "订单状态：1待支付 2已支付 3已取消 4已退款",
                    "type": "integer"
                },
                "total_amount": {
                    "description": "订单总金额（分）",
                    "type": "integer"
                },
                "updated_at": {
                    "description": "更新时间",
                    "type": "string"
                },
                "user_address_id": {
                    "description": "收货地址ID（user_addresses.id）",
                    "type": "integer"
                },
                "user_id": {
                    "description": "下单用户ID（user_members.id）",
                    "type": "integer"
                }
            }
        },
        "user.ProductInfo": {
            "type": "object",
            "properties": {
                "id": {
                    "type": "integer"
                },
                "image": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "price": {
                    "type": "integer"
                }
            }
        },
        "user.ShipmentGroup": {
            "type": "object",
            "properties": {
                "batch_no": {
                    "type": "string"
                },
                "count": {
                    "type": "integer"
                },
                "express_code": {
                    "type": "string"
                },
                "express_no": {
                    "type": "string"
                },
                "inventory_ids": {
                    "type": "array",
                    "items": {
                        "type": "integer"
                    }
                },
                "product_ids": {
                    "type": "array",
                    "items": {
                        "type": "integer"
                    }
                },
                "products": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/user.ProductInfo"
                    }
                },
                "received_at": {
                    "type": "string"
                },
                "shipped_at": {
                    "type": "string"
                },
                "status": {
                    "type": "integer"
                }
            }
        }
    },
    "securityDefinitions": {
        "LoginVerifyToken": {
            "type": "apiKey",
            "name": "Authorization",
            "in": "header"
        }
    }
}