module

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

type ConfigField struct {
	Key         string      `json:"key"`
	Label       string      `json:"label"`
	Type        string      `json:"type"` // string/number/bool/select
	Default     interface{} `json:"default"`
	Options     []string    `json:"options,omitempty"` // select 选项
	Description string      `json:"description,omitempty"`
	Required    bool        `json:"required,omitempty"`
}

type ConfigProvider interface {
	Get(key string) interface{}
	GetString(key string) string
	GetInt(key string) int
	GetBool(key string) bool
	GetStringSlice(key string) []string
}

type Context struct {
	// DB 是共享的数据库连接
	DB *gorm.DB

	// Config 提供配置读取能力
	Config ConfigProvider

	// EventBus 用于模块间异步通信
	EventBus EventBus

	// Logger 是模块专用的日志记录器
	Logger *zap.Logger

	// GetModule 获取其他已加载的模块
	// 用于模块间同步调用
	GetModule func(id string) Module

	// Extra 扩展数据（用于传递 TokenManager 等核心组件）
	Extra map[string]interface{}
}

type Event struct {
	Type      string      // 事件类型，如 "user.created", "file.uploaded"
	Source    string      // 来源模块 ID
	Data      interface{} // 事件数据
	Timestamp int64       // Unix 时间戳
}

type EventBus interface {
	// Publish 发布事件
	Publish(eventType string, data interface{})

	// Subscribe 订阅事件
	Subscribe(eventType string, handler EventHandler)

	// Unsubscribe 取消订阅
	Unsubscribe(eventType string, handler EventHandler)
}

type EventHandler func(event Event)

type Module interface {
	// ID 返回模块的唯一标识符，如 "files", "users"
	ID() string

	// Name 返回模块的显示名称
	Name() string

	// Version 返回模块版本
	Version() string

	// Dependencies 返回此模块依赖的其他模块 ID 列表
	// 模块加载器会确保依赖的模块先初始化
	Dependencies() []string

	// Init 初始化模块，传入核心上下文
	// 在此阶段应该：创建数据库表、初始化内部状态
	Init(ctx *Context) error

	// Start 启动模块
	// 在所有模块 Init 完成后调用
	// 在此阶段可以：启动后台任务、订阅事件
	Start() error

	// Stop 停止模块
	// 在应用关闭时调用
	// 在此阶段应该：清理资源、停止后台任务
	Stop() error

	// RegisterRoutes 注册模块的 HTTP 路由
	// router 是带有 /api/v1 前缀的路由组
	RegisterRoutes(router *gin.RouterGroup)
}

type ModuleInfo struct {
	ID           string   `json:"id"`
	Name         string   `json:"name"`
	Version      string   `json:"version"`
	Dependencies []string `json:"dependencies"`
	Status       string   `json:"status"` // "stopped", "starting", "running", "error"
}

type OptionalModule interface {
	Module

	// IsOptional 返回模块是否可被用户禁用
	// 核心模块返回 false，可选模块返回 true
	IsOptional() bool

	// Description 返回模块描述
	Description() string

	// DefaultConfig 返回模块的默认配置定义
	// 用于前端渲染配置表单
	DefaultConfig() []ConfigField
}

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