feat(M3): 申请审批 + 邮件队列 — 公开申请、管理员审批自动建号、mail_logs 落库重试

internal/api/handler.go

@@ -1,6 +1,7 @@
 // Package api 为 HTTP handler 层（RESTful v1）。
 // M1 覆盖认证（管理员/外部用户登录、会话、OTP）与用户管理 CRUD；
-// M2 覆盖 SSH 公钥管理（上传/重命名/吊销/列表）。
+// M2 覆盖 SSH 公钥管理（上传/重命名/吊销/列表）；
+// M3 覆盖申请审批（公开提交 + 管理员审批 + 邮件通知）。
 package api
 
 import (
@@ -18,17 +19,18 @@ import (
 
 // Handler 聚合各模块 handler，作为路由注册的挂载点。
 type Handler struct {
-	Health *HealthHandler
-	Auth   *AuthHandler
-	User   *UserHandler
-	Key    *KeyHandler
+	Health   *HealthHandler
+	Auth     *AuthHandler
+	User     *UserHandler
+	Key      *KeyHandler
+	Approval *ApprovalHandler
 
 	authSvc  *service.AuthService
 	auditSvc *service.AuditService
 }
 
 // New 创建 handler 集合。
-func New(cfg *config.Config, authSvc *service.AuthService, userSvc *service.UserService, keySvc *service.KeyService, auditSvc *service.AuditService) *Handler {
+func New(cfg *config.Config, authSvc *service.AuthService, userSvc *service.UserService, keySvc *service.KeyService, approvalSvc *service.ApprovalService, auditSvc *service.AuditService) *Handler {
 	h := &Handler{
 		Health:   &HealthHandler{startedAt: time.Now()},
 		authSvc:  authSvc,
@@ -37,6 +39,7 @@ func New(cfg *config.Config, authSvc *service.AuthService, userSvc *service.User
 	h.Auth = &AuthHandler{svc: authSvc, cfg: cfg}
 	h.User = &UserHandler{svc: userSvc, cfg: cfg, h: h}
 	h.Key = &KeyHandler{svc: keySvc, cfg: cfg, h: h}
+	h.Approval = &ApprovalHandler{svc: approvalSvc, cfg: cfg, h: h}
 	return h
 }
 
@@ -63,7 +66,7 @@ type HealthHandler struct {
 func (h *HealthHandler) Healthz(c *gin.Context) {
 	c.JSON(http.StatusOK, gin.H{
 		"status":    "ok",
-		"version":   "0.3.0-m2",
+		"version":   "0.3.0-m3",
 		"uptime":    time.Since(h.startedAt).String(),
 		"go":        runtime.Version(),
 		"timestamp": time.Now().UTC().Format(time.RFC3339),