package contracts

import (
	"log/slog"

	"git.fsdpf.net/go/req"
)

// 日志结构化字段的标准 key：LogKeyKind 标识控制器大类（Http/Cron/Job 等），
// LogKeyComponent 标识具体是哪一个实例/类型。
const (
	LogKeyKind      = "kind"
	LogKeyComponent = "component"
)

type Controller interface {
	// 初始化
	Init() error
	// 获取 Container
	Container() Injector
	// 派遣一个任务
	Dispatch(job string, payload any, u req.User) error
	// Logger 返回当前进程的默认 slog logger
	Logger() *slog.Logger
}