实现七月迭代公共技术基础

internal/bootstrap/dependencies.go

@@ -1,7 +1,9 @@
 package bootstrap
 
 import (
+	systemConfigApp "github.com/break/junhong_cmp_fiber/internal/application/systemconfig"
 	"github.com/break/junhong_cmp_fiber/internal/gateway"
+	systemConfigInfra "github.com/break/junhong_cmp_fiber/internal/infrastructure/systemconfig"
 	"github.com/break/junhong_cmp_fiber/internal/service/verification"
 	"github.com/break/junhong_cmp_fiber/pkg/auth"
 	"github.com/break/junhong_cmp_fiber/pkg/queue"
@@ -15,14 +17,16 @@ import (
 // Dependencies 封装所有基础依赖
 // 这些是应用启动时初始化的核心组件
 type Dependencies struct {
-	DB                  *gorm.DB                       // PostgreSQL 数据库连接
-	Redis               *redis.Client                  // Redis 客户端
-	Logger              *zap.Logger                    // 应用日志器
-	JWTManager          *auth.JWTManager               // JWT 管理器（个人客户认证）
-	TokenManager        *auth.TokenManager             // Token 管理器（后台和H5认证）
-	VerificationService *verification.Service          // 验证码服务
-	QueueClient         *queue.Client                  // Asynq 任务队列客户端
-	StorageService      *storage.Service               // 对象存储服务（可选，配置缺失时为 nil）
-	GatewayClient       *gateway.Client                // Gateway API 客户端（可选，配置缺失时为 nil）
-	WechatPayment       wechat.PaymentServiceInterface // 微信支付服务（可选）
+	DB                   *gorm.DB                       // PostgreSQL 数据库连接
+	Redis                *redis.Client                  // Redis 客户端
+	Logger               *zap.Logger                    // 应用日志器
+	JWTManager           *auth.JWTManager               // JWT 管理器（个人客户认证）
+	TokenManager         *auth.TokenManager             // Token 管理器（后台和H5认证）
+	VerificationService  *verification.Service          // 验证码服务
+	QueueClient          *queue.Client                  // Asynq 任务队列客户端
+	StorageService       *storage.Service               // 对象存储服务（可选，配置缺失时为 nil）
+	GatewayClient        *gateway.Client                // Gateway API 客户端（可选，配置缺失时为 nil）
+	WechatPayment        wechat.PaymentServiceInterface // 微信支付服务（可选）
+	SystemConfigRegistry *systemConfigInfra.Registry    // 业务模块共享的受控配置注册表（可选）
+	SystemConfigAudit    systemConfigApp.AuditWriter    // 统一配置变更审计 Port（可选，缺失时更新失败关闭）
 }

internal/bootstrap/handlers.go

@@ -1,15 +1,18 @@
 package bootstrap
 
 import (
+	systemConfigApp "github.com/break/junhong_cmp_fiber/internal/application/systemconfig"
 	"github.com/break/junhong_cmp_fiber/internal/handler/admin"
 	"github.com/break/junhong_cmp_fiber/internal/handler/app"
 	authHandler "github.com/break/junhong_cmp_fiber/internal/handler/auth"
 	"github.com/break/junhong_cmp_fiber/internal/handler/callback"
 	openapiHandler "github.com/break/junhong_cmp_fiber/internal/handler/openapi"
+	systemConfigInfra "github.com/break/junhong_cmp_fiber/internal/infrastructure/systemconfig"
 	pollingPkg "github.com/break/junhong_cmp_fiber/internal/polling"
 	assetQuery "github.com/break/junhong_cmp_fiber/internal/query/asset"
 	exchangeQuery "github.com/break/junhong_cmp_fiber/internal/query/exchange"
 	packageExpiryQuery "github.com/break/junhong_cmp_fiber/internal/query/packageexpiry"
+	systemConfigQuery "github.com/break/junhong_cmp_fiber/internal/query/systemconfig"
 	clientOrderSvc "github.com/break/junhong_cmp_fiber/internal/service/client_order"
 	pollingSvcPkg "github.com/break/junhong_cmp_fiber/internal/service/polling"
 	rechargeOrderSvc "github.com/break/junhong_cmp_fiber/internal/service/recharge_order"
@@ -76,6 +79,20 @@ func initHandlers(svc *services, deps *Dependencies) *Handlers {
 		deps.Redis,
 		deps.Logger,
 	)
+	systemConfigRegistry := deps.SystemConfigRegistry
+	if systemConfigRegistry == nil {
+		systemConfigRegistry = systemConfigInfra.NewRegistry()
+	}
+	systemConfigAlerts := systemConfigInfra.NewLogAlertSink(deps.Logger)
+	var systemConfigCache systemConfigInfra.Cache
+	if deps.Redis != nil {
+		systemConfigCache = systemConfigInfra.NewRedisCache(deps.Redis)
+	}
+	systemConfigReader := systemConfigInfra.NewReader(deps.DB, systemConfigRegistry, systemConfigCache, systemConfigAlerts)
+	systemConfigList := systemConfigQuery.NewListQuery(systemConfigReader)
+	systemConfigUpdate := systemConfigApp.NewUpdateService(
+		deps.DB, systemConfigRegistry, systemConfigCache, deps.SystemConfigAudit, systemConfigAlerts, nil,
+	)
 
 	return &Handlers{
 		Auth:                        authHandler.NewHandler(svc.Auth, validate),
@@ -150,6 +167,7 @@ func initHandlers(svc *services, deps *Dependencies) *Handlers {
 		OrderPackageInvalidate: admin.NewOrderPackageInvalidateHandler(svc.OrderPackageInvalidate),
 		ClientWechat:           app.NewClientWechatHandler(svc.WechatConfig, deps.Redis, deps.Logger),
 		SuperAdmin:             admin.NewSuperAdminHandler(svc.OperationPassword),
+		SystemConfig:           admin.NewSystemConfigHandler(systemConfigList, systemConfigUpdate),
 		AgentOpenAPI:           openapiHandler.NewHandler(svc.AgentOpenAPI, validate),
 	}
 }

internal/bootstrap/types.go

@@ -66,6 +66,7 @@ type Handlers struct {
 	OrderPackageInvalidate      *admin.OrderPackageInvalidateHandler
 	ClientWechat                *app.ClientWechatHandler
 	SuperAdmin                  *admin.SuperAdminHandler
+	SystemConfig                *admin.SystemConfigHandler
 	AgentOpenAPI                *openapiHandler.Handler
 }