lifecycle

type App interface {
	// Context 返回应用的根 context，可传递给后台任务；关闭时被取消。
	Context() context.Context

	// AddResource 注册需要在优雅关闭时释放的资源，
	// name 用于日志标识，closer 是关闭函数。
	AddResource(name string, closer func(ctx context.Context) error)

	// GoBackground 启动一个带 panic recovery 的后台 goroutine，
	// 关闭时通过 ctx 取消信号通知退出并等待完成。
	GoBackground(name string, fn func(ctx context.Context))

	// RequestShutdown 请求应用进入关闭流程（幂等，可安全并发调用）。
	// 取消根 context 以解除 userFn 中对 Context().Done() 的阻塞，
	// 进而触发正常优雅关闭序列（资源按注册逆序释放）。
	// 典型用途：后台任务检测到不可恢复错误（如 server 端口占用启动失败）
	// 时主动触发关机，避免进程无服务地"假活"。
	RequestShutdown()
}

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

type ManagerOption func(*Manager)