fix: pin scaffold dependencies and handle graceful shutdown

cmd/go-omni/scaffold/templates/README.md.tmpl

@@ -2,6 +2,8 @@
 
 This service was generated with `go-omni new`.
 
+Framework dependency: `git.yuntuo.hk/k2safe/go-omni {{.FrameworkVersion}}`.
+
 ```sh
 go mod tidy
 go run ./cmd/server
@@ -16,6 +18,17 @@ GO_OMNI_ENABLE_LOGGER=true GO_OMNI_LOG_LEVEL=debug go run ./cmd/server
 `GO_OMNI_HTTP_ADDR` 可以修改监听地址。生成项目默认提供 `/health/live` 和
 `/health/ready`，日志、请求 ID 和优雅退出等基础能力由 GoOmni 统一初始化；业务依赖集中放在项目自己的 `internal/servicecontext`。
 
+服务使用 `signal.NotifyContext` 处理 `SIGINT` / `SIGTERM`。部署时构建并运行服务二进制，
+使信号直接到达服务进程：
+
+```sh
+go build -o server ./cmd/server
+./server
+```
+
+`GO_OMNI_SHUTDOWN_TIMEOUT` 控制等待请求完成的时间，默认 `10s`。健康探针目前没有
+数据库依赖检查；接入数据库后需要向 Checker 注册探针。
+
 The generated layout keeps HTTP handlers, business services, repositories,
 models and a project-owned ServiceContext separate. Replace the memory
 repository with a database implementation when the service is ready for

cmd/go-omni/scaffold/templates/cmd-server-main.go.tmpl

@@ -1,8 +1,12 @@
 package main
 
 import (
+	"context"
 	"log"
+	"os"
+	"os/signal"
 	"strings"
+	"syscall"
 
 	omni "git.yuntuo.hk/k2safe/go-omni"
 	"git.yuntuo.hk/k2safe/go-omni/config"
@@ -15,17 +19,27 @@ import (
 )
 
 func main() {
+	if err := run(); err != nil {
+		log.Fatal(err)
+	}
+}
+
+func run() error {
+	ctx, stop := signal.NotifyContext(context.Background(), os.Interrupt, syscall.SIGTERM)
+	defer stop()
+
 	settings, err := config.LoadFromEnv("")
 	if err != nil {
-		log.Fatal(err)
+		return err
 	}
 	if strings.TrimSpace(settings.Log.Service) == "" {
 		settings.Log.Service = "{{.Module}}"
 	}
 	logger, err := logx.New(settings.Log)
 	if err != nil {
-		log.Fatal(err)
+		return err
 	}
+	defer logger.Close()
 	// Access logs and business logs share the same configured sink.
 	logx.SetDefault(logger)
 
@@ -35,7 +49,7 @@ func main() {
 	userHandler := handler.NewUsers(userService)
 	checker, err := health.New()
 	if err != nil {
-		log.Fatal(err)
+		return err
 	}
 
 	application := omni.New(omni.WithConfig(settings))
@@ -43,7 +57,5 @@ func main() {
 	application.GET("/health/live", checker.LivenessHandler())
 	application.GET("/health/ready", checker.ReadinessHandler())
 	userHandler.RegisterRoutes(application)
-	if err := application.Run(settings.Address); err != nil {
-		log.Fatal(err)
-	}
+	return application.RunContext(ctx, settings.Address)
 }

cmd/go-omni/scaffold/templates/go.mod.tmpl

@@ -2,7 +2,7 @@ module {{.Module}}
 
 go 1.22
 
-require git.yuntuo.hk/k2safe/go-omni v0.0.0
+require git.yuntuo.hk/k2safe/go-omni {{.FrameworkVersion}}
 {{- if .FrameworkReplace}}
 replace git.yuntuo.hk/k2safe/go-omni => {{.FrameworkReplace}}
 {{- end}}