把企业级 Go 服务的常用部分，一次性固化下来

type Service interface {
    Name() string                              // 配置段 key、日志与指标前缀
    Setup(ctx context.Context, env *Env) error // 解码服务段、装配 domain
    BuildRouter(s *httpx.Server) error         // 注册路由
}

func main() {
    if err := verticle.Run(context.Background(), &app.DemoService{}); err != nil {
        log.Fatal(err)
    }
}

基础设施句柄对业务是私有的，一律经 Env 访问器读取：RequireDB() 在未配置时让启动失败，DB() 用逗号-ok 判可用。业务代码里不会出现 if env.DB != nil 这种话。

• 业务代码不 import 驱动库 pgx、go-redis、franz-go、gin… 全部收在 pkg/core/* 之后， 由 golangci-lint 的 depguard 强制，不靠自觉。
• Handler 不碰 ResponseWriter 签名统一 func(ctx, *http.Request) (any, error)：返回 nil 即 204，返回 errs.* 即对应状态码 + {code,msg,data}。
• 配了才建，不配就不存在 只有 http: 段的最小配置也能起服务；db / redis / kafka / tracing / auth 随加随用，未配置时是 no-op，不为它们付任何代价。
• 测试不需要 Docker 纯 Go SQLite、miniredis、kfake、进程内 gRPC·rpcx——make ci 跑的就是全部示例。