parser

type Method struct {
	Name       string
	Input      string
	Output     string
	Doc        string // 方法注释（原始文本）
	Summary    string // swag @Summary（取 Doc 第一行）
	Tags       string // swag @Tags（默认 = ServiceName）
	HTTPMethod string // swag @Router 方法（默认 POST）
	Route      string // swag @Router 路径（默认 /{lower(Name)}）
}

type Model struct {
	Name        string       // struct 名称
	TableName   string       // 数据库表名（snake_case，可被 gorm tag 覆盖）
	Comment     string       // struct 注释
	Fields      []ModelField // 所有字段
	HasGormTags bool         // 是否含 gorm tag（用于判断是否需要生成 model 文件）
}

type ModelField struct {
	Name       string // Go 字段名
	Type       string // Go 类型
	JSONTag    string // json tag 值
	GormTag    string // gorm tag 值
	Comment    string // 行注释
	IsPrimary  bool   // 是否主键
	IsAutoIncr bool   // 是否自增
	IsNotNull  bool   // 是否非空
	IsUnique   bool   // 是否唯一索引
	SwagType   string // swag 类型（integer/string/number/boolean/array/object）
	Example    string // swag 示例值
}

type ParseResult struct {
	PackageName string
	Services    []*Service
	Models      []*Model
	Source      SourceType
}

type Service struct {
	ServiceName string
	PackageName string
	Methods     []Method
	Title       string // swag @title（默认 = ServiceName + " API"）
	Description string // swag @description（取接口注释）
}

type SourceType string