module

type I18n []ResourcesItem

type Migration struct {
	// Name 是迁移模块的稳定标识。
	Name string
	// FS 是迁移脚本所在的文件系统。
	FS fs.FS
	// Path 是迁移版本目录在文件系统中的根路径。
	Path string
	// Dependencies 是当前迁移模块依赖的其他迁移模块名称。
	Dependencies []string
}

type Migrations []Migration

type Models map[string][]interface{}

type Module interface {
	// RegisterGRPC 将模块 gRPC 服务注册到宿主。
	RegisterGRPC(grpc.ServiceRegistrar)
	// RegisterHTTP 将模块 HTTP 服务注册到宿主。
	RegisterHTTP(*http.Server)
	// RegisterMCP 将模块 MCP 工具注册到宿主。
	RegisterMCP(*mcp.Server)
}

type Modules []Module

type OpenAPI []ResourcesItem

type Resource interface {
	// ProjectKey 是宿主项目的稳定标识，用于 OpenAPI 命名空间；留空时使用 kratos-core。
	ProjectKey() string
	// ProjectName 是宿主项目展示名称，留空时使用 ProjectKey。
	ProjectName() string
	// Models 是宿主数据库自动迁移所需的模型。
	Models() Models
	// I18n 是宿主项目语言 JSON 文件系统，文件名应使用 locale 标识。
	I18n() fs.FS
	// OpenAPI 是宿主项目生成的 Swagger/OpenAPI 文件系统集合，包含默认 openapi.yaml 和可选的 openapi.<locale>.yaml。
	OpenAPI() fs.FS
	// Migrations 是宿主提供的数据库迁移资源。
	Migrations() Migrations
}

type Resources []Resource

type ResourcesItem struct {
	// FS 是资源所在的文件系统。
	FS fs.FS
	// ProjectKey 是宿主项目的稳定标识，用于 OpenAPI 命名空间；留空时使用 kratos-core。
	ProjectKey string
	// ProjectName 是宿主项目展示名称，留空时使用 ProjectKey。
	ProjectName string
}