feat: complete contract-driven business development and MySQL integration

examples/managedService/internal/svc/close.go

@@ -1,39 +0,0 @@
-package svc
-
-import "errors"
-
-// Close is idempotent, including startup failure and graceful shutdown.
-func (c *ServiceContext) Close() error {
-	if c == nil {
-		return nil
-	}
-	c.closeOnce.Do(func() {
-		if c.Lifecycle != nil {
-			c.Lifecycle.RequestShutdown(nil)
-		}
-		c.closeMu.Lock()
-		c.closed = true
-		cleanups := c.cleanups
-		c.cleanups = nil
-		c.closeMu.Unlock()
-		for i := len(cleanups) - 1; i >= 0; i-- {
-			c.closeErr = errors.Join(c.closeErr, cleanups[i]())
-		}
-
-	})
-	return c.closeErr
-}
-
-// OnClose transfers a resource cleanup to this context immediately after creation.
-// Hooks run once in reverse order, also when later initialization fails.
-func (c *ServiceContext) OnClose(cleanup func() error) {
-	if cleanup == nil {
-		return
-	}
-	c.closeMu.Lock()
-	defer c.closeMu.Unlock()
-	if c.closed {
-		panic("svc: register cleanup after Close")
-	}
-	c.cleanups = append(c.cleanups, cleanup)
-}

examples/managedService/internal/svc/runtimeGen.go

@@ -0,0 +1,56 @@
+// Code generated by go-omni api. DO NOT EDIT.
+package svc
+
+import (
+	"context"
+	"errors"
+	"git.yuntuo.hk/k2safe/go-omni/health"
+	"git.yuntuo.hk/k2safe/go-omni/lifecycle"
+	"git.yuntuo.hk/k2safe/go-omni/logx"
+
+	"example.com/managed/internal/config"
+	"example.com/managed/internal/middleware"
+)
+
+// New is generator-owned. Customize dependencies in ServiceContext.Init.
+func New(ctx context.Context, logger *logx.Logger, configs ...config.Config) (result *ServiceContext, err error) {
+	if ctx == nil {
+		ctx = context.Background()
+	}
+	if err = ctx.Err(); err != nil {
+		return nil, errors.Join(err, lifecycle.Cause(ctx))
+	}
+	if logger == nil {
+		return nil, errors.New("service context requires a logger")
+	}
+	if len(configs) > 1 {
+		return nil, errors.New("expected at most one configuration")
+	}
+	cfg := config.Default()
+	if len(configs) == 1 {
+		cfg = configs[0]
+	}
+	if err = cfg.Validate(); err != nil {
+		return nil, err
+	}
+	checker, err := health.New()
+	if err != nil {
+		return nil, err
+	}
+	c := &ServiceContext{Config: cfg, Logger: logger, Health: checker, Middlewares: middleware.Defaults(), Runtime: lifecycle.NewRuntime(ctx)}
+	ctx = logx.WithLogger(c.Context(), logger)
+	defer func() {
+		if p := recover(); p != nil {
+			_ = c.Close()
+			panic(p)
+		}
+		if err != nil {
+			err = c.Finish(err)
+		}
+	}()
+
+	if err = c.Init(ctx); err != nil {
+		return nil, err
+	}
+	return c, nil
+}

examples/managedService/internal/svc/serviceContext.go

@@ -2,66 +2,25 @@ package svc
 
 import (
 	"context"
-	"errors"
-	"sync"
 
 	"example.com/managed/internal/config"
-	"example.com/managed/internal/middleware"
 	"git.yuntuo.hk/k2safe/go-omni/health"
 	"git.yuntuo.hk/k2safe/go-omni/httpx"
 	"git.yuntuo.hk/k2safe/go-omni/lifecycle"
 	"git.yuntuo.hk/k2safe/go-omni/logx"
 )
 
-// Context owns infrastructure, while Logger is borrowed from main.
-// Add business repositories here; HTTP contracts do not define database tables.
+// Context holds project dependencies. Runtime owns cleanup and shutdown.
+// Logger is borrowed; the generated entry closes it after dependencies.
 type ServiceContext struct {
-	Lifecycle   *lifecycle.Controller
+	*lifecycle.Runtime
 	Config      config.Config
-	cleanups    []func() error
 	Logger      *logx.Logger
 	Health      *health.Checker
 	Middlewares map[string]httpx.Middleware
-
-	closeMu   sync.Mutex
-	closed    bool
-	closeOnce sync.Once
-	closeErr  error
 }
 
-// Pass the settings loaded by main. The optional form supports lightweight
-// tests without infrastructure; selected adapters still require valid config.
-func New(ctx context.Context, logger *logx.Logger, configs ...config.Config) (result *ServiceContext, err error) {
-	if ctx == nil {
-		ctx = context.Background()
-	}
-	if err = ctx.Err(); err != nil {
-		return nil, errors.Join(err, lifecycle.Cause(ctx))
-	}
-	if len(configs) > 1 {
-		return nil, errors.New("expected at most one configuration")
-	}
-	cfg := config.Default()
-	if len(configs) == 1 {
-		cfg = configs[0]
-	}
-	_ = cfg
-	checker, err := health.New()
-	if err != nil {
-		return nil, err
-	}
-	c := &ServiceContext{Config: cfg, Logger: logger, Health: checker, Middlewares: middleware.Defaults(), Lifecycle: lifecycle.New(ctx)}
-	ctx = c.Lifecycle.Context()
-	defer func() {
-		if err != nil {
-			err = errors.Join(err, c.Close())
-			if cause := c.Lifecycle.Err(); cause != nil && !errors.Is(err, cause) {
-				err = errors.Join(err, cause)
-			}
-		}
-	}()
-
-	return c, nil
-}
-
-func (c *ServiceContext) RequestShutdown(err error) { c.Lifecycle.RequestShutdown(err) }
+// Init is project-owned. Add dependencies here and immediately register each
+// cleanup with c.OnClose. Returning an error automatically rolls everything back.
+// Generated infrastructure is ready here. Never create another App or logger.
+func (c *ServiceContext) Init(ctx context.Context) error { return nil }