swagger

type AggregateConfig struct {
	Enabled                  bool            `mapstructure:"enabled" yaml:"enabled" json:"enabled"`                                                        // 是否启用聚合
	Mode                     string          `mapstructure:"mode" yaml:"mode" json:"mode"`                                                                 // 聚合模式: merge|selector
	Services                 []*ServiceSpec  `mapstructure:"services" yaml:"services" json:"services"`                                                     // 微服务列表
	Documents                []*DocumentSpec `mapstructure:"documents" yaml:"documents" json:"documents"`                                                  // 独立文档列表
	UILayout                 string          `mapstructure:"ui-layout" yaml:"ui-layout" json:"uiLayout"`                                                   // UI布局: tabs|dropdown|list
	SharedDefinitionPrefixes []string        `mapstructure:"shared-definition-prefixes" yaml:"shared-definition-prefixes" json:"sharedDefinitionPrefixes"` // 共享定义前缀列表（不添加服务名前缀）
}

type AuthConfig struct {
	Enabled     bool     `mapstructure:"enabled" yaml:"enabled" json:"enabled"`               // 是否启用认证
	Type        AuthType `mapstructure:"type" yaml:"type" json:"type"`                        // 认证类型
	Username    string   `mapstructure:"username" yaml:"username" json:"username"`            // 用户名（基本认证）
	Password    string   `mapstructure:"password" yaml:"password" json:"password"`            // 密码（基本认证）
	Token       string   `mapstructure:"token" yaml:"token" json:"token"`                     // Token（Bearer认证）
	HeaderName  string   `mapstructure:"header-name" yaml:"header-name" json:"headerName"`    // 自定义header名称
	HeaderValue string   `mapstructure:"header-value" yaml:"header-value" json:"headerValue"` // 自定义header值
}

type AuthType string

type Contact struct {
	Name  string `mapstructure:"name" yaml:"name" json:"name"`    // 联系人姓名
	URL   string `mapstructure:"url" yaml:"url" json:"url"`       // 联系URL
	Email string `mapstructure:"email" yaml:"email" json:"email"` // 联系邮箱
}

type DocumentPathSelector struct {
	Path    string   `mapstructure:"path" yaml:"path" json:"path"`          // Swagger路径，如 /v1/open-platform/apps
	Methods []string `mapstructure:"methods" yaml:"methods" json:"methods"` // 可选的HTTP方法列表，留空表示该路径下全部方法
}

type DocumentSource struct {
	Service string                  `mapstructure:"service" yaml:"service" json:"service"` // 来源服务名，对应 aggregate.services[].name
	Paths   []*DocumentPathSelector `mapstructure:"paths" yaml:"paths" json:"paths"`       // include 的兼容简写，留空表示该服务全部路径
	Include []*DocumentPathSelector `mapstructure:"include" yaml:"include" json:"include"` // 显式包含的路径列表，留空表示该服务全部路径
	Exclude []*DocumentPathSelector `mapstructure:"exclude" yaml:"exclude" json:"exclude"` // 需要排除的路径列表
}

type DocumentSpec struct {
	Name        string            `mapstructure:"name" yaml:"name" json:"name"`                      // 文档名称，同时用于路由标识
	Title       string            `mapstructure:"title" yaml:"title" json:"title"`                   // 文档标题
	Description string            `mapstructure:"description" yaml:"description" json:"description"` // 文档描述
	Version     string            `mapstructure:"version" yaml:"version" json:"version"`             // 文档版本
	Enabled     bool              `mapstructure:"enabled" yaml:"enabled" json:"enabled"`             // 是否启用
	Sources     []*DocumentSource `mapstructure:"sources" yaml:"sources" json:"sources"`             // 文档来源
}

type License struct {
	Name string `mapstructure:"name" yaml:"name" json:"name"` // 许可证名称
	URL  string `mapstructure:"url" yaml:"url" json:"url"`    // 许可证URL
}

type ServiceSpec struct {
	Name        string   `mapstructure:"name" yaml:"name" json:"name"`                      // 服务名称
	Description string   `mapstructure:"description" yaml:"description" json:"description"` // 服务描述
	SpecPath    string   `mapstructure:"spec-path" yaml:"spec-path" json:"specPath"`        // Swagger规范文件路径
	URL         string   `mapstructure:"url" yaml:"url" json:"url"`                         // 远程Swagger文档URL
	Version     string   `mapstructure:"version" yaml:"version" json:"version"`             // 服务版本
	Enabled     bool     `mapstructure:"enabled" yaml:"enabled" json:"enabled"`             // 是否启用
	BasePath    string   `mapstructure:"base-path" yaml:"base-path" json:"basePath"`        // API基础路径前缀
	Tags        []string `mapstructure:"tags" yaml:"tags" json:"tags"`                      // 服务标签
}

type Swagger struct {
	ModuleName  string           `mapstructure:"module-name" yaml:"module-name" json:"moduleName"`  // 模块名称
	Enabled     bool             `mapstructure:"enabled" yaml:"enabled" json:"enabled"`             // 是否启用Swagger
	JSONPath    string           `mapstructure:"json-path" yaml:"json-path" json:"jsonPath"`        // Swagger JSON文件路径
	UIPath      string           `mapstructure:"ui-path" yaml:"ui-path" json:"uiPath"`              // Swagger UI路由路径
	YamlPath    string           `mapstructure:"yaml-path" yaml:"yaml-path" json:"yamlPath"`        // Swagger YAML文件路径
	SpecPath    string           `mapstructure:"spec-path" yaml:"spec-path" json:"specPath"`        // Swagger规范文件路径(自动检测格式)
	Title       string           `mapstructure:"title" yaml:"title" json:"title"`                   // 文档标题
	Description string           `mapstructure:"description" yaml:"description" json:"description"` // 文档描述
	Version     string           `mapstructure:"version" yaml:"version" json:"version"`             // Swagger版本
	Contact     *Contact         `mapstructure:"contact" yaml:"contact" json:"contact"`             // 联系信息
	License     *License         `mapstructure:"license" yaml:"license" json:"license"`             // 许可证信息
	Auth        *AuthConfig      `mapstructure:"auth" yaml:"auth" json:"auth"`                      // 认证配置
	Aggregate   *AggregateConfig `mapstructure:"aggregate" yaml:"aggregate" json:"aggregate"`       // 聚合配置
	HotReload   bool             `mapstructure:"hot-reload" yaml:"hot-reload" json:"hotReload"`     // 是否启用文件热重载

	// CDN 资源配置
	CDNVersion     string `mapstructure:"cdn-version" yaml:"cdn-version" json:"cdnVersion"`               // Swagger UI CDN版本
	CDNBaseURL     string `mapstructure:"cdn-base-url" yaml:"cdn-base-url" json:"cdnBaseURL"`             // CDN基础URL
	CDNCSSURL      string `mapstructure:"cdn-css-url" yaml:"cdn-css-url" json:"cdnCSSURL"`                // CSS文件URL
	CDNBundleJS    string `mapstructure:"cdn-bundle-js" yaml:"cdn-bundle-js" json:"cdnBundleJS"`          // Bundle JS URL
	CDNPresetJS    string `mapstructure:"cdn-preset-js" yaml:"cdn-preset-js" json:"cdnPresetJS"`          // Preset JS URL
	CDNFavicon32   string `mapstructure:"cdn-favicon32" yaml:"cdn-favicon32" json:"cdnFavicon32"`         // 32x32 Favicon URL
	CDNFavicon16   string `mapstructure:"cdn-favicon16" yaml:"cdn-favicon16" json:"cdnFavicon16"`         // 16x16 Favicon URL
	UseCDN         bool   `mapstructure:"use-cdn" yaml:"use-cdn" json:"useCDN"`                           // 是否使用CDN资源
	CDNFallbackURL string `mapstructure:"cdn-fallback-url" yaml:"cdn-fallback-url" json:"cdnFallbackURL"` // CDN备用URL
}