dinfra

type App interface {
	// 启动
	Run() error
}

type AppBuilder interface {
	// 依赖注入
	ConfigService(configFuncs ...ServiceConfigFunc)

	// 构建一个全新的应用
	Build() (App, error)
}

type CanToMap interface {
	ToMap() map[string]any
}

type Config interface {
	// 将配置绑定到结构体
	BindStruct(path string, dst any) error
}

type Database struct {
	*gorm.DB // 简单内嵌 Gorm
}

type DatabaseProvider interface {
	// 通过服务 name 获取对应的数据库实例访问对象
	Provide(name string) (*Database, error)
}

type HttpMiddleware interface {
	Handle(context echo.Context, next echo.HandlerFunc) error
}

type HttpServer struct {
	*echo.Echo
}

type ID int64

type IdProvider interface {
	Provide() ID
}

type JsonProperty struct {
	Name        string           `json:"name"` // 为了方便使用，兼容数组和 MAP 的存储形式
	Type        JsonPropertyType `json:"type"`
	Title       *string          `json:"title"`       // 最好是简短的
	Description *string          `json:"description"` // 说明，更长更加详细

	MaxLength *int64  `json:"maxLength"` // string 最大长度，非负
	MinLength *int64  `json:"minLength"` // string 最小长度，非负
	Pattern   *string `json:"pattern"`   // string 必须符合对应的正则表达式

	MultipleOf *int64 `json:"multipleOf"` // number integer 给定数字的倍数
	Minimum    *int64 `json:"minimum"`    // number integer 最小值 >=
	Maximum    *int64 `json:"maximum"`    // number integer 最大值 <=

	Properties map[string]*JsonProperty `json:"properties"`
	Required   []string                 `json:"required"`   // object 必须属性
	Updateable []string                 `json:"updateable"` // object 可以被更新的属性

	Items       *JsonPropertyType `json:"items"`       // array 列表项的说明
	MinItems    *int64            `json:"minItems"`    // array 数组最小长度
	MaxItems    *int64            `json:"maxItems"`    // array 数组最大长度
	UniqueItems *bool             `json:"uniqueItems"` // array 数组每个元素唯一

	Enum    []any `json:"enum"`
	Default any   `json:"default"` // 该值不用于在验证过程中填充缺失值。文档生成器或表单生成器等非验证工具可能会使用此值提示用户如何使用该值。
	Const   any   `json:"const"`   // 常量，固定值
}

type JsonPropertyType string // json schema 支持的属性类型

type JsonSchema struct {
	*JsonProperty

	Schema *string `json:"$schema"` // 使用的 schema 版本
	ID     *string `json:"$id"`     //
}

type Logger interface {
	WithField(key string, value interface{}) *logrus.Entry
	WithFields(fields logrus.Fields) *logrus.Entry
	WithError(err error) *logrus.Entry

	Trace(args ...interface{})
	Debug(args ...interface{})
	Info(args ...interface{})
	Print(args ...interface{})
	Warn(args ...interface{})
	Warning(args ...interface{})
	Error(args ...interface{})
	Fatal(args ...interface{})
	Panic(args ...interface{})
}

type MicroService struct {
	ID       string            // 实例唯一 ID
	Name     string            // 服务名称
	Address  string            // 可访问地址
	Port     int               // 可访问端口
	Env      string            // 归属的环境
	Tags     []string          // 标签
	Metadata map[string]string // 服务注册时附加数据
}

type OnChangeFunc func() error

type Options interface {
	// option 的使用者可以通过注册 listener 来响应 config 的运行时变更
	OnChange(listener OnChangeFunc)
}

type Result struct {
	Code int    `json:"code"`
	Data any    `json:"data,omitempty"`
	Msg  string `json:"msg,omitempty"`
}

type ServiceConfigFunc func(di.ServiceCollector)

type ServiceRegister interface {
	// 获取 name 服务对应的信息
	Get(name string) (*MicroService, error)

	// 向注册中心注册服务
	Register(service *MicroService) error
}