refactor: replace standard log with zap logger and optimize code patterns

- Migrate all log.Printf/log.Println calls to structured zap logging
- Use cmp.Or for cleaner default value handling
- Replace manual loops with slices.ContainsFunc/IndexFunc
- Add batch query methods (IsLikedBatch, IsFavoritedBatch) to solve N+1 problem
- Update JSON tags from omitempty to omitzero for numeric fields
- Use errgroup-style wg.Go for worker goroutines
- Remove duplicate casbin/v2 dependency (keeping v3)
- Add plans/ to gitignore

cmd/migrate/main.go

@@ -1,10 +1,12 @@
 package main
 
 import (
+	"errors"
 	"flag"
 	"fmt"
 	"log"
 
+	"go.uber.org/zap"
 	"gorm.io/driver/postgres"
 	"gorm.io/gorm"
 )
@@ -73,17 +75,17 @@ func main() {
 	defer sqlDB.Close()
 
 	if err := sqlDB.Ping(); err != nil {
-		log.Fatalf("Failed to ping database: %v", err)
+		zap.L().Fatal("Failed to ping database", zap.Error(err))
 	}
 
-	log.Println("Connected to database")
+	zap.L().Info("Connected to database")
 
 	// 运行迁移
 	if err := runMigration(db); err != nil {
-		log.Fatalf("Migration failed: %v", err)
+		zap.L().Fatal("Migration failed", zap.Error(err))
 	}
 
-	log.Println("Migration completed successfully")
+	zap.L().Info("Migration completed successfully")
 }
 
 func runMigration(db *gorm.DB) error {
@@ -105,26 +107,31 @@ func runMigration(db *gorm.DB) error {
 	}
 
 	if hasPreviewURL && hasPreviewURLLarge {
-		log.Println("Columns already exist, skipping migration")
+		zap.L().Info("Columns already exist, skipping migration")
 		return nil
 	}
 
 	// 添加字段
+	var errs []error
 	if !hasPreviewURL {
-		log.Println("Adding preview_url column...")
+		zap.L().Info("Adding preview_url column...")
 		if err := db.Exec("ALTER TABLE post_images ADD COLUMN preview_url TEXT").Error; err != nil {
-			return fmt.Errorf("failed to add preview_url column: %w", err)
+			errs = append(errs, fmt.Errorf("failed to add preview_url column: %w", err))
 		}
 	}
 
 	if !hasPreviewURLLarge {
-		log.Println("Adding preview_url_large column...")
+		zap.L().Info("Adding preview_url_large column...")
 		if err := db.Exec("ALTER TABLE post_images ADD COLUMN preview_url_large TEXT").Error; err != nil {
-			return fmt.Errorf("failed to add preview_url_large column: %w", err)
+			errs = append(errs, fmt.Errorf("failed to add preview_url_large column: %w", err))
 		}
 	}
 
-	log.Println("Migration completed successfully")
+	if len(errs) > 0 {
+		return errors.Join(errs...)
+	}
+
+	zap.L().Info("Migration completed successfully")
 	return nil
 }
 

cmd/server/app.go

@@ -3,7 +3,6 @@ package main
 import (
 	"context"
 	"fmt"
-	"log"
 	"net/http"
 
 	"carrot_bbs/internal/config"
@@ -11,6 +10,7 @@ import (
 	"carrot_bbs/internal/router"
 	"carrot_bbs/internal/service"
 
+	"go.uber.org/zap"
 	"gorm.io/gorm"
 )
 
@@ -22,6 +22,7 @@ type App struct {
 	PushService service.PushService
 	GRPCServer  *runner.Server
 	Server      *http.Server
+	Logger      *zap.Logger
 }
 
 // NewApp 创建应用程序
@@ -31,6 +32,7 @@ func NewApp(
 	r *router.Router,
 	pushService service.PushService,
 	grpcServer *runner.Server,
+	logger *zap.Logger,
 ) *App {
 	return &App{
 		Config:      cfg,
@@ -38,6 +40,7 @@ func NewApp(
 		Router:      r,
 		PushService: pushService,
 		GRPCServer:  grpcServer,
+		Logger:      logger,
 	}
 }
 
@@ -45,7 +48,7 @@ func NewApp(
 func (a *App) Start(ctx context.Context) error {
 	// 1. 启动 gRPC 服务器（在 HTTP 服务器之前）
 	if a.GRPCServer != nil {
-		log.Println("Starting gRPC server...")
+		a.Logger.Info("Starting gRPC server")
 		if err := a.GRPCServer.Start(); err != nil {
 			return fmt.Errorf("failed to start gRPC server: %w", err)
 		}
@@ -56,7 +59,9 @@ func (a *App) Start(ctx context.Context) error {
 
 	// 3. 创建 HTTP 服务器
 	addr := fmt.Sprintf("%s:%d", a.Config.Server.Host, a.Config.Server.Port)
-	log.Printf("Starting HTTP server at %s", addr)
+	a.Logger.Info("Starting HTTP server",
+		zap.String("address", addr),
+	)
 
 	a.Server = &http.Server{
 		Addr:    addr,
@@ -66,7 +71,9 @@ func (a *App) Start(ctx context.Context) error {
 	// 4. 启动 HTTP 服务器
 	go func() {
 		if err := a.Server.ListenAndServe(); err != nil && err != http.ErrServerClosed {
-			log.Fatalf("listen: %s\n", err)
+			a.Logger.Fatal("HTTP server listen error",
+				zap.Error(err),
+			)
 		}
 	}()
 
@@ -75,33 +82,35 @@ func (a *App) Start(ctx context.Context) error {
 
 // Stop 停止应用程序
 func (a *App) Stop(ctx context.Context) error {
-	log.Println("Shutting down server...")
+	a.Logger.Info("Shutting down server")
 
 	// 1. 停止 HTTP 服务器
 	if a.Server != nil {
-		log.Println("Stopping HTTP server...")
+		a.Logger.Info("Stopping HTTP server")
 		if err := a.Server.Shutdown(ctx); err != nil {
-			log.Printf("HTTP server forced to shutdown: %v", err)
+			a.Logger.Error("HTTP server forced to shutdown",
+				zap.Error(err),
+			)
 		}
 	}
 
 	// 2. 停止 gRPC 服务器
 	if a.GRPCServer != nil {
-		log.Println("Stopping gRPC server...")
+		a.Logger.Info("Stopping gRPC server")
 		a.GRPCServer.Stop()
 	}
 
 	// 3. 停止推送 Worker
-	log.Println("Stopping push worker...")
+	a.Logger.Info("Stopping push worker")
 	a.PushService.StopPushWorker()
 
 	// 4. 关闭数据库连接
-	log.Println("Closing database connection...")
+	a.Logger.Info("Closing database connection")
 	sqlDB, err := a.DB.DB()
 	if err == nil {
 		sqlDB.Close()
 	}
 
-	log.Println("Server exited")
+	a.Logger.Info("Server exited")
 	return nil
 }

cmd/server/main.go

@@ -2,24 +2,29 @@ package main
 
 import (
 	"context"
-	"log"
 	"os"
 	"os/signal"
 	"syscall"
 	"time"
+
+	"go.uber.org/zap"
 )
 
 func main() {
 	// 初始化应用程序（Wire 自动生成）
 	app, err := InitializeApp()
 	if err != nil {
-		log.Fatalf("failed to initialize app: %v", err)
+		zap.L().Fatal("failed to initialize app",
+			zap.Error(err),
+		)
 	}
 
 	// 启动应用程序
 	ctx := context.Background()
 	if err := app.Start(ctx); err != nil {
-		log.Fatalf("failed to start app: %v", err)
+		app.Logger.Fatal("failed to start app",
+			zap.Error(err),
+		)
 	}
 
 	// 优雅关闭
@@ -31,6 +36,8 @@ func main() {
 	defer cancel()
 
 	if err := app.Stop(shutdownCtx); err != nil {
-		log.Printf("Error during shutdown: %v", err)
+		app.Logger.Error("Error during shutdown",
+			zap.Error(err),
+		)
 	}
 }

cmd/server/wire_gen.go

@@ -109,7 +109,7 @@ func InitializeApp() (*App, error) {
 	adminDashboardHandler := handler.NewAdminDashboardHandler(adminDashboardService)
 	adminLogHandler := handler.NewAdminLogHandler(operationLogService, loginLogService, dataChangeLogService)
 	router := ProvideRouter(userHandler, postHandler, commentHandler, messageHandler, notificationHandler, uploadHandler, jwtService, pushHandler, systemMessageHandler, groupHandler, stickerHandler, gorseHandler, voteHandler, scheduleHandler, roleHandler, adminUserHandler, adminPostHandler, adminCommentHandler, adminGroupHandler, adminDashboardHandler, adminLogHandler, logService, userActivityService, casbinService)
-	app := NewApp(config, db, router, pushService, server)
+	app := NewApp(config, db, router, pushService, server, logger)
 	return app, nil
 }