apidoc

type Components struct {
	Schemas map[string]jsonSchema `json:"schemas"`
}

type Config struct {
	Title       string
	Version     string
	Description string
}

type DocStore struct {
	// contains filtered or unexported fields
}

type Info struct {
	Title       string `json:"title"`
	Description string `json:"description"`
	Version     string `json:"version"`
}

type OpenAPISpec struct {
	OpenAPI    string              `json:"openapi"`
	Info       Info                `json:"info"`
	Paths      map[string]PathItem `json:"paths"`
	Components Components          `json:"components"`
}

type Operation struct {
	Method      string       // HTTP 方法(GET/POST/PUT/DELETE)
	Path        string       // 路由路径(如 /api/v1/orders/{id})
	Summary     string       // 摘要
	Description string       // 详细描述
	Tags        []string     // 标签
	Params      []Param      // 参数
	Responses   []Response   // 响应
	Deprecated  bool         // 弃用标记
	RequestBody *RequestBody // 请求体(有 body 参数时)
	HandlerName string       // 处理函数名(调试)
}

type OperationDoc struct {
	Summary     string                 `json:"summary,omitempty"`
	Description string                 `json:"description,omitempty"`
	Tags        []string               `json:"tags,omitempty"`
	Deprecated  bool                   `json:"deprecated,omitempty"`
	Parameters  []ParameterDoc         `json:"parameters,omitempty"`
	RequestBody *RequestBodyDoc        `json:"requestBody,omitempty"`
	Responses   map[string]ResponseDoc `json:"responses"`
	Security    []map[string][]string  `json:"security,omitempty"`
}

type Option func(*Operation)

type Param struct {
	Name     string
	In       string // path / query / header
	Type     string // string/int/int64/float64/bool
	Required bool
	Desc     string
}

type ParameterDoc struct {
	Name        string     `json:"name"`
	In          string     `json:"in"`
	Required    bool       `json:"required"`
	Description string     `json:"description,omitempty"`
	Schema      jsonSchema `json:"schema"`
}

type PathItem map[string]OperationDoc

type RequestBody struct {
	Model    interface{}
	Required bool
	Desc     string
}

type RequestBodyDoc struct {
	Description string `json:"description,omitempty"`
	Required    bool   `json:"required,omitempty"`
	Content     map[string]struct {
		Schema jsonSchema `json:"schema"`
	} `json:"content"`
}

type Response struct {
	Code  int
	Desc  string
	Model interface{} // 响应 data 模型(可选;nil=通用响应)
}

type ResponseDoc struct {
	Description string `json:"description"`
	Content     map[string]struct {
		Schema jsonSchema `json:"schema"`
	} `json:"content,omitempty"`
}