{
    "swagger": "2.0",
    "info": {
        "title": "mini-chat 接口文档",
        "contact": {},
        "version": "v0.0.1"
    },
    "basePath": "/",
    "paths": {
        "/api/admin/activities": {
            "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/model.Activities"
                        }
                    },
                    "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}/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/{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/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/create": {
            "post": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "新增客服",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.客服管理"
                ],
                "summary": "新增客服",
                "parameters": [
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/admin.createAdminRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.createAdminResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/delete": {
            "post": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "删除客服",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.客服管理"
                ],
                "summary": "删除客服",
                "parameters": [
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/admin.deleteAdminRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.deleteAdminResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/guilds": {
            "post": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "创建工会并将首位成员设为会长",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.工会"
                ],
                "summary": "创建工会",
                "parameters": [
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/admin.createGuildRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.createGuildResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/guilds/{guild_id}": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "查看指定工会详情",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.工会"
                ],
                "summary": "查看工会详情",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "工会ID",
                        "name": "guild_id",
                        "in": "path",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/model.Guild"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            },
            "put": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "修改指定工会信息",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.工会"
                ],
                "summary": "修改工会",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "工会ID",
                        "name": "guild_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/admin.modifyGuildRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.modifyGuildResponse"
                        }
                    },
                    "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": "guild_id",
                        "in": "path",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.deleteGuildResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/guilds/{guild_id}/members": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "查看指定工会的成员列表",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.工会"
                ],
                "summary": "查看工会成员",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "工会ID",
                        "name": "guild_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.listGuildMembersResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/admin/list": {
            "get": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "客服列表",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.客服管理"
                ],
                "summary": "客服列表",
                "parameters": [
                    {
                        "type": "string",
                        "description": "用户名",
                        "name": "username",
                        "in": "query"
                    },
                    {
                        "type": "string",
                        "description": "昵称",
                        "name": "nickname",
                        "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.listResponse"
                        }
                    },
                    "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/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/{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/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}/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}/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/{id}": {
            "put": {
                "security": [
                    {
                        "LoginVerifyToken": []
                    }
                ],
                "description": "编辑客服",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "管理端.客服管理"
                ],
                "summary": "编辑客服",
                "parameters": [
                    {
                        "type": "string",
                        "description": "编号ID",
                        "name": "id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/admin.modifyAdminRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/admin.modifyAdminResponse"
                        }
                    },
                    "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/model.Activities"
                        }
                    },
                    "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}/draw_logs": {
            "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
                    },
                    {
                        "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.listDrawLogsResponse"
                        }
                    },
                    "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/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/guilds": {
            "get": {
                "description": "获取工会列表，支持公开与状态过滤以及分页",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.工会"
                ],
                "summary": "浏览工会列表",
                "parameters": [
                    {
                        "type": "string",
                        "description": "工会名称(模糊)",
                        "name": "name",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "description": "是否公开(1公开 2私有)",
                        "name": "is_open",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "description": "状态(1正常 2解散)",
                        "name": "status",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "description": "加入方式(1审核 2自动 3消费流水)",
                        "name": "join_mode",
                        "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.listGuildsResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/guilds/{guild_id}": {
            "get": {
                "description": "查看指定工会详情",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.工会"
                ],
                "summary": "查看工会详情",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "工会ID",
                        "name": "guild_id",
                        "in": "path",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/model.Guild"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/guilds/{guild_id}/members": {
            "get": {
                "description": "查看指定工会的成员列表",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.工会"
                ],
                "summary": "查看工会成员",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "工会ID",
                        "name": "guild_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.listMembersResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            },
            "post": {
                "description": "用户加入指定工会",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.工会"
                ],
                "summary": "加入工会",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "工会ID",
                        "name": "guild_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "description": "请求参数",
                        "name": "RequestBody",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/app.joinGuildRequest"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.simpleMessageResponse"
                        }
                    },
                    "400": {
                        "description": "Bad Request",
                        "schema": {
                            "$ref": "#/definitions/code.Failure"
                        }
                    }
                }
            }
        },
        "/api/app/guilds/{guild_id}/members/{user_id}": {
            "delete": {
                "description": "用户离开指定工会",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "APP端.工会"
                ],
                "summary": "离开工会",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "工会ID",
                        "name": "guild_id",
                        "in": "path",
                        "required": true
                    },
                    {
                        "type": "integer",
                        "description": "用户ID",
                        "name": "user_id",
                        "in": "path",
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.simpleMessageResponse"
                        }
                    },
                    "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}": {
            "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
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/app.listCouponsResponse"
                        }
                    },
                    "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"
                    }
                ],
                "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
                    }
                ],
                "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}/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/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": {}
            }
        }
    },
    "definitions": {
        "admin.GrantRewardRequest": {
            "type": "object",
            "required": [
                "product_id"
            ],
            "properties": {
                "activity_id": {
                    "description": "活动ID（可选）",
                    "type": "integer"
                },
                "address_id": {
                    "description": "收货地址ID（可选，实物商品需要）",
                    "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.activitysvcIssueData": {
            "type": "object",
            "properties": {
                "id": {
                    "type": "integer"
                },
                "issue_number": {
                    "type": "string"
                },
                "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",
            "required": [
                "points"
            ],
            "properties": {
                "kind": {
                    "type": "string"
                },
                "points": {
                    "type": "integer"
                },
                "remark": {
                    "type": "string"
                },
                "valid_days": {
                    "type": "integer"
                }
            }
        },
        "admin.addPointsResponse": {
            "type": "object",
            "properties": {
                "success": {
                    "type": "boolean"
                }
            }
        },
        "admin.adminUserCouponItem": {
            "type": "object",
            "properties": {
                "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"
                },
                "created_at": {
                    "type": "string"
                },
                "id": {
                    "type": "integer"
                },
                "invite_code": {
                    "type": "string"
                },
                "inviter_id": {
                    "type": "integer"
                },
                "nickname": {
                    "type": "string"
                }
            }
        },
        "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.categoryItem": {
            "type": "object",
            "properties": {
                "id": {
                    "type": "integer"
                },
                "name": {
                    "type": "string"
                }
            }
        },
        "admin.createActivityRequest": {
            "type": "object",
            "required": [
                "activity_category_id",
                "name"
            ],
            "properties": {
                "activity_category_id": {
                    "type": "integer"
                },
                "banner": {
                    "type": "string"
                },
                "end_time": {
                    "type": "string"
                },
                "is_boss": {
                    "type": "integer"
                },
                "name": {
                    "type": "string"
                },
                "price_draw": {
                    "type": "integer"
                },
                "start_time": {
                    "type": "string"
                },
                "status": {
                    "type": "integer"
                }
            }
        },
        "admin.createAdminRequest": {
            "type": "object",
            "required": [
                "nickname",
                "password",
                "username"
            ],
            "properties": {
                "avatar": {
                    "description": "头像",
                    "type": "string"
                },
                "mobile": {
                    "description": "手机号",
                    "type": "string"
                },
                "nickname": {
                    "description": "昵称",
                    "type": "string"
                },
                "password": {
                    "description": "密码",
                    "type": "string"
                },
                "username": {
                    "description": "用户名",
                    "type": "string"
                }
            }
        },
        "admin.createAdminResponse": {
            "type": "object",
            "properties": {
                "message": {
                    "description": "提示信息",
                    "type": "string"
                }
            }
        },
        "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.createGuildRequest": {
            "type": "object",
            "required": [
                "name",
                "owner_id"
            ],
            "properties": {
                "avatar_url": {
                    "type": "string"
                },
                "consume_limit": {
                    "type": "integer"
                },
                "description": {
                    "type": "string"
                },
                "is_open": {
                    "type": "integer"
                },
                "join_mode": {
                    "type": "integer"
                },
                "name": {
                    "type": "string"
                },
                "owner_id": {
                    "type": "integer"
                }
            }
        },
        "admin.createGuildResponse": {
            "type": "object",
            "properties": {
                "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"
                },
                "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.deleteAdminRequest": {
            "type": "object",
            "required": [
                "ids"
            ],
            "properties": {
                "ids": {
                    "description": "编号(多个用,分割)",
                    "type": "string"
                }
            }
        },
        "admin.deleteAdminResponse": {
            "type": "object",
            "properties": {
                "message": {
                    "description": "提示信息",
                    "type": "string"
                }
            }
        },
        "admin.deleteGuildResponse": {
            "type": "object",
            "properties": {
                "message": {
                    "type": "string"
                }
            }
        },
        "admin.itemCardListItem": {
            "type": "object",
            "properties": {
                "activity_category_id": {
                    "description": "指定活动分类ID（可空）",
                    "type": "integer"
                },
                "activity_id": {
                    "description": "指定活动ID（可空）",
                    "type": "integer"
                },
                "boost_rate_x1000": {
                    "description": "概率提升（千分比，+20%=200）",
                    "type": "integer"
                },
                "card_type": {
                    "description": "卡类型：1双倍奖励 2概率提升 等",
                    "type": "integer"
                },
                "created_at": {
                    "description": "创建时间",
                    "type": "string"
                },
                "effect_type": {
                    "description": "效果类型：1奖励倍数 2概率提升 等",
                    "type": "integer"
                },
                "id": {
                    "description": "主键ID",
                    "type": "integer"
                },
                "issue_id": {
                    "description": "指定期ID（可空）",
                    "type": "integer"
                },
                "max_effect_value_x1000": {
                    "description": "效果上限（千分比）",
                    "type": "integer"
                },
                "name": {
                    "description": "卡名称",
                    "type": "string"
                },
                "price": {
                    "description": "售卖价格（分）",
                    "type": "integer"
                },
                "remark": {
                    "description": "备注",
                    "type": "string"
                },
                "reward_multiplier_x1000": {
                    "description": "奖励倍数（千分比，×2=2000）",
                    "type": "integer"
                },
                "scope_type": {
                    "description": "适用范围：1全局 2活动分类 3活动 4期",
                    "type": "integer"
                },
                "stacking_strategy": {
                    "description": "叠加策略：1禁止 2同类叠加-上限 3取最大值 4乘法叠加",
                    "type": "integer"
                },
                "status": {
                    "description": "状态：1启用 2停用",
                    "type": "integer"
                },
                "updated_at": {
                    "description": "更新时间",
                    "type": "string"
                },
                "valid_end": {
                    "description": "有效期结束",
                    "type": "string"
                },
                "valid_start": {
                    "description": "有效期开始",
                    "type": "string"
                }
            }
        },
        "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.listData": {
            "type": "object",
            "properties": {
                "avatar": {
                    "description": "头像",
                    "type": "string"
                },
                "created_at": {
                    "description": "创建时间",
                    "type": "string"
                },
                "id": {
                    "description": "编号",
                    "type": "integer"
                },
                "mobile": {
                    "description": "手机号",
                    "type": "string"
                },
                "nickname": {
                    "description": "昵称",
                    "type": "string"
                },
                "updated_at": {
                    "description": "更新时间",
                    "type": "string"
                },
                "username": {
                    "description": "用户名",
                    "type": "string"
                }
            }
        },
        "admin.listGuildMembersResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/admin.memberItem"
                    }
                },
                "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.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.listResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/admin.listData"
                    }
                },
                "page": {
                    "description": "当前页码",
                    "type": "integer"
                },
                "page_size": {
                    "description": "每页返回的数据量",
                    "type": "integer"
                },
                "total": {
                    "description": "符合查询条件的总记录数",
                    "type": "integer"
                }
            }
        },
        "admin.listRewardsResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/admin.rewardItem"
                    }
                }
            }
        },
        "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.memberItem": {
            "type": "object",
            "properties": {
                "id": {
                    "type": "integer"
                },
                "role": {
                    "type": "string"
                },
                "start_time": {
                    "type": "string"
                },
                "user_id": {
                    "type": "integer"
                }
            }
        },
        "admin.modifyActivityRequest": {
            "type": "object",
            "properties": {
                "activity_category_id": {
                    "type": "integer"
                },
                "banner": {
                    "type": "string"
                },
                "end_time": {
                    "type": "string"
                },
                "is_boss": {
                    "type": "integer"
                },
                "name": {
                    "type": "string"
                },
                "price_draw": {
                    "type": "integer"
                },
                "start_time": {
                    "type": "string"
                },
                "status": {
                    "type": "integer"
                }
            }
        },
        "admin.modifyAdminRequest": {
            "type": "object",
            "required": [
                "nickname",
                "username"
            ],
            "properties": {
                "avatar": {
                    "description": "头像",
                    "type": "string"
                },
                "mobile": {
                    "description": "手机号",
                    "type": "string"
                },
                "nickname": {
                    "description": "昵称",
                    "type": "string"
                },
                "password": {
                    "description": "密码",
                    "type": "string"
                },
                "username": {
                    "description": "用户名",
                    "type": "string"
                }
            }
        },
        "admin.modifyAdminResponse": {
            "type": "object",
            "properties": {
                "message": {
                    "description": "提示信息",
                    "type": "string"
                }
            }
        },
        "admin.modifyBannerRequest": {
            "type": "object",
            "properties": {
                "image_url": {
                    "type": "string"
                },
                "link_url": {
                    "type": "string"
                },
                "sort": {
                    "type": "integer"
                },
                "status": {
                    "type": "integer"
                },
                "title": {
                    "type": "string"
                }
            }
        },
        "admin.modifyGuildRequest": {
            "type": "object",
            "properties": {
                "avatar_url": {
                    "type": "string"
                },
                "consume_limit": {
                    "type": "integer"
                },
                "description": {
                    "type": "string"
                },
                "is_open": {
                    "type": "integer"
                },
                "join_mode": {
                    "type": "integer"
                },
                "name": {
                    "type": "string"
                },
                "status": {
                    "type": "integer"
                }
            }
        },
        "admin.modifyGuildResponse": {
            "type": "object",
            "properties": {
                "message": {
                    "type": "string"
                }
            }
        },
        "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"
                },
                "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"
                },
                "name": {
                    "type": "string"
                },
                "original_qty": {
                    "type": "integer"
                },
                "product_id": {
                    "type": "integer"
                },
                "quantity": {
                    "type": "integer"
                },
                "sort": {
                    "type": "integer"
                },
                "weight": {
                    "type": "integer"
                }
            }
        },
        "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"
                },
                "id": {
                    "type": "integer"
                },
                "images_json": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "price": {
                    "type": "integer"
                },
                "sales": {
                    "type": "integer"
                },
                "status": {
                    "type": "integer"
                },
                "stock": {
                    "type": "integer"
                }
            }
        },
        "admin.rewardItem": {
            "type": "object",
            "required": [
                "level",
                "name",
                "original_qty",
                "quantity",
                "weight"
            ],
            "properties": {
                "id": {
                    "type": "integer"
                },
                "is_boss": {
                    "type": "integer"
                },
                "level": {
                    "type": "integer"
                },
                "name": {
                    "type": "string"
                },
                "original_qty": {
                    "type": "integer"
                },
                "product_id": {
                    "type": "integer"
                },
                "quantity": {
                    "type": "integer"
                },
                "sort": {
                    "type": "integer"
                },
                "weight": {
                    "type": "integer"
                }
            }
        },
        "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.simpleMessage": {
            "type": "object",
            "properties": {
                "message": {
                    "type": "string"
                }
            }
        },
        "admin.simpleMessageResponse": {
            "type": "object",
            "properties": {
                "message": {
                    "type": "string"
                }
            }
        },
        "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.activityItem": {
            "type": "object",
            "properties": {
                "activity_category_id": {
                    "type": "integer"
                },
                "banner": {
                    "type": "string"
                },
                "category_name": {
                    "type": "string"
                },
                "id": {
                    "type": "integer"
                },
                "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.appBannerItem": {
            "type": "object",
            "properties": {
                "id": {
                    "type": "integer"
                },
                "image_url": {
                    "type": "string"
                },
                "link_url": {
                    "type": "string"
                },
                "sort": {
                    "type": "integer"
                },
                "title": {
                    "type": "string"
                }
            }
        },
        "app.bindPhoneRequest": {
            "type": "object",
            "properties": {
                "code": {
                    "type": "string"
                }
            }
        },
        "app.bindPhoneResponse": {
            "type": "object",
            "properties": {
                "mobile": {
                    "type": "string"
                },
                "success": {
                    "type": "boolean"
                }
            }
        },
        "app.couponItem": {
            "type": "object",
            "properties": {
                "amount": {
                    "type": "integer"
                },
                "id": {
                    "type": "integer"
                },
                "name": {
                    "type": "string"
                },
                "rules": {
                    "type": "string"
                },
                "status": {
                    "type": "integer"
                },
                "valid_end": {
                    "type": "string"
                },
                "valid_start": {
                    "type": "string"
                }
            }
        },
        "app.drawLogItem": {
            "type": "object",
            "properties": {
                "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"
                },
                "user_id": {
                    "type": "integer"
                }
            }
        },
        "app.guildItem": {
            "type": "object",
            "properties": {
                "avatar_url": {
                    "type": "string"
                },
                "consume_limit": {
                    "type": "integer"
                },
                "description": {
                    "type": "string"
                },
                "id": {
                    "type": "integer"
                },
                "is_open": {
                    "type": "integer"
                },
                "join_mode": {
                    "type": "integer"
                },
                "name": {
                    "type": "string"
                },
                "owner_id": {
                    "type": "integer"
                },
                "status": {
                    "type": "integer"
                }
            }
        },
        "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"
                },
                "sort": {
                    "type": "integer"
                },
                "status": {
                    "type": "integer"
                }
            }
        },
        "app.joinGuildRequest": {
            "type": "object",
            "required": [
                "user_id"
            ],
            "properties": {
                "user_id": {
                    "type": "integer"
                }
            }
        },
        "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.listCouponsResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/app.couponItem"
                    }
                },
                "page": {
                    "type": "integer"
                },
                "page_size": {
                    "type": "integer"
                },
                "total": {
                    "type": "integer"
                }
            }
        },
        "app.listDrawLogsResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/app.drawLogItem"
                    }
                },
                "page": {
                    "type": "integer"
                },
                "page_size": {
                    "type": "integer"
                },
                "total": {
                    "type": "integer"
                }
            }
        },
        "app.listGuildsResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/app.guildItem"
                    }
                },
                "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.listIssuesResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/app.issueItem"
                    }
                },
                "page": {
                    "type": "integer"
                },
                "page_size": {
                    "type": "integer"
                },
                "total": {
                    "type": "integer"
                }
            }
        },
        "app.listMembersResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/app.memberItem"
                    }
                },
                "page": {
                    "type": "integer"
                },
                "page_size": {
                    "type": "integer"
                },
                "total": {
                    "type": "integer"
                }
            }
        },
        "app.listOrdersResponse": {
            "type": "object",
            "properties": {
                "list": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/model.Orders"
                    }
                },
                "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"
                    }
                }
            }
        },
        "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.memberItem": {
            "type": "object",
            "properties": {
                "id": {
                    "type": "integer"
                },
                "role": {
                    "type": "string"
                },
                "start_time": {
                    "type": "string"
                },
                "user_id": {
                    "type": "integer"
                }
            }
        },
        "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.pointsBalanceResponse": {
            "type": "object",
            "properties": {
                "balance": {
                    "type": "integer"
                }
            }
        },
        "app.rewardItem": {
            "type": "object",
            "properties": {
                "is_boss": {
                    "type": "integer"
                },
                "level": {
                    "type": "integer"
                },
                "name": {
                    "type": "string"
                },
                "original_qty": {
                    "type": "integer"
                },
                "product_id": {
                    "type": "integer"
                },
                "quantity": {
                    "type": "integer"
                },
                "sort": {
                    "type": "integer"
                },
                "weight": {
                    "type": "integer"
                }
            }
        },
        "app.simpleMessageResponse": {
            "type": "object",
            "properties": {
                "message": {
                    "type": "string"
                }
            }
        },
        "app.userItem": {
            "type": "object",
            "properties": {
                "avatar": {
                    "type": "string"
                },
                "id": {
                    "type": "integer"
                },
                "invite_code": {
                    "type": "string"
                },
                "inviter_id": {
                    "type": "integer"
                },
                "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"
                },
                "invite_code": {
                    "type": "string"
                }
            }
        },
        "app.weixinLoginResponse": {
            "type": "object",
            "properties": {
                "avatar": {
                    "type": "string"
                },
                "invite_code": {
                    "type": "string"
                },
                "nickname": {
                    "type": "string"
                },
                "token": {
                    "type": "string"
                },
                "user_id": {
                    "type": "integer"
                }
            }
        },
        "code.Failure": {
            "type": "object",
            "properties": {
                "code": {
                    "description": "业务码",
                    "type": "integer"
                },
                "message": {
                    "description": "描述信息",
                    "type": "string"
                }
            }
        },
        "model.Activities": {
            "type": "object",
            "properties": {
                "activity_category_id": {
                    "description": "活动所属分类ID（activity_categories.id，可空）",
                    "type": "integer"
                },
                "banner": {
                    "description": "活动横幅/海报URL",
                    "type": "string"
                },
                "created_at": {
                    "description": "创建时间",
                    "type": "string"
                },
                "end_time": {
                    "description": "结束时间",
                    "type": "string"
                },
                "id": {
                    "description": "主键ID",
                    "type": "integer"
                },
                "is_boss": {
                    "description": "Boss: 1 是 0 不是",
                    "type": "integer"
                },
                "name": {
                    "description": "活动名称",
                    "type": "string"
                },
                "price_draw": {
                    "description": "活动门票价格",
                    "type": "integer"
                },
                "start_time": {
                    "description": "开始时间",
                    "type": "string"
                },
                "status": {
                    "description": "状态：1进行中 2下线",
                    "type": "integer"
                },
                "updated_at": {
                    "description": "更新时间",
                    "type": "string"
                }
            }
        },
        "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.Guild": {
            "type": "object",
            "properties": {
                "avatar_url": {
                    "description": "工会头像",
                    "type": "string"
                },
                "consume_limit": {
                    "description": "加入工会消费流水最低限额(分)",
                    "type": "integer"
                },
                "created_at": {
                    "description": "创建时间",
                    "type": "string"
                },
                "description": {
                    "description": "工会描述",
                    "type": "string"
                },
                "id": {
                    "description": "主键ID",
                    "type": "integer"
                },
                "is_open": {
                    "description": "1 公开 2 私有",
                    "type": "integer"
                },
                "join_mode": {
                    "description": "加入方式 1: 审核通过 2: 自动通过 3. 消费流水",
                    "type": "integer"
                },
                "name": {
                    "description": "公会名称",
                    "type": "string"
                },
                "owner_id": {
                    "description": "会长用户ID",
                    "type": "integer"
                },
                "status": {
                    "description": "状态：1正常 2解散",
                    "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.Orders": {
            "type": "object",
            "properties": {
                "actual_amount": {
                    "description": "实际支付金额（分）",
                    "type": "integer"
                },
                "cancelled_at": {
                    "description": "取消时间",
                    "type": "string"
                },
                "created_at": {
                    "description": "创建时间",
                    "type": "string"
                },
                "discount_amount": {
                    "description": "优惠券抵扣金额（分）",
                    "type": "integer"
                },
                "id": {
                    "description": "主键ID",
                    "type": "integer"
                },
                "is_consumed": {
                    "description": "是否已履约/消耗（对虚拟资产）",
                    "type": "integer"
                },
                "order_no": {
                    "description": "业务订单号（唯一）",
                    "type": "string"
                },
                "paid_at": {
                    "description": "支付完成时间",
                    "type": "string"
                },
                "pay_preorder_id": {
                    "description": "关联预支付单ID（payment_preorder.id）",
                    "type": "integer"
                },
                "points_amount": {
                    "description": "积分抵扣金额（分）",
                    "type": "integer"
                },
                "points_ledger_id": {
                    "description": "积分扣减流水ID（user_points_ledger.id）",
                    "type": "integer"
                },
                "remark": {
                    "description": "备注",
                    "type": "string"
                },
                "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"
                }
            }
        },
        "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"
                }
            }
        },
        "user.InventoryWithProduct": {
            "type": "object",
            "properties": {
                "activity_id": {
                    "description": "来源活动ID",
                    "type": "integer"
                },
                "created_at": {
                    "description": "创建时间",
                    "type": "string"
                },
                "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"
                },
                "remark": {
                    "description": "备注",
                    "type": "string"
                },
                "reward_id": {
                    "description": "来源奖励ID（activity_reward_settings.id）",
                    "type": "integer"
                },
                "status": {
                    "description": "状态：1持有 2作废 3已使用/发货",
                    "type": "integer"
                },
                "updated_at": {
                    "description": "更新时间",
                    "type": "string"
                },
                "user_id": {
                    "description": "资产归属用户ID",
                    "type": "integer"
                }
            }
        },
        "user.ItemCardWithTemplate": {
            "type": "object",
            "properties": {
                "card_id": {
                    "description": "卡模板ID（system_item_cards.id）",
                    "type": "integer"
                },
                "card_type": {
                    "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_at": {
                    "description": "使用时间",
                    "type": "string"
                },
                "used_draw_log_id": {
                    "description": "使用关联抽奖日志ID（activity_draw_logs.id）",
                    "type": "integer"
                },
                "used_issue_id": {
                    "description": "使用时期ID",
                    "type": "integer"
                },
                "user_id": {
                    "description": "用户ID（users.id）",
                    "type": "integer"
                },
                "valid_end": {
                    "description": "有效期结束",
                    "type": "string"
                },
                "valid_start": {
                    "description": "有效期开始",
                    "type": "string"
                }
            }
        },
        "user.OrderWithItems": {
            "type": "object",
            "properties": {
                "actual_amount": {
                    "description": "实际支付金额（分）",
                    "type": "integer"
                },
                "cancelled_at": {
                    "description": "取消时间",
                    "type": "string"
                },
                "created_at": {
                    "description": "创建时间",
                    "type": "string"
                },
                "discount_amount": {
                    "description": "优惠券抵扣金额（分）",
                    "type": "integer"
                },
                "id": {
                    "description": "主键ID",
                    "type": "integer"
                },
                "is_consumed": {
                    "description": "是否已履约/消耗（对虚拟资产）",
                    "type": "integer"
                },
                "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"
                },
                "points_amount": {
                    "description": "积分抵扣金额（分）",
                    "type": "integer"
                },
                "points_ledger_id": {
                    "description": "积分扣减流水ID（user_points_ledger.id）",
                    "type": "integer"
                },
                "remark": {
                    "description": "备注",
                    "type": "string"
                },
                "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"
                }
            }
        }
    },
    "securityDefinitions": {
        "LoginVerifyToken": {
            "type": "apiKey",
            "name": "Authorization",
            "in": "header"
        }
    }
}