refactor: extract magic numbers to named constants for mnd lint compliance

internal/logger/logger.go

@@ -29,6 +29,9 @@ import (
 
 var logger *otelzap.Logger
 
+// ringBufferCapacity 环形缓冲区容量
+const ringBufferCapacity = 5000
+
 // GlobalRingBuffer 全局日志环形缓冲区，供 Admin 日志查询和 WebSocket 推送使用
 var GlobalRingBuffer *LogRingBuffer
 
@@ -39,7 +42,7 @@ func init() {
 	}
 
 	// 初始化 ring buffer（保留最近 5000 行日志）
-	GlobalRingBuffer = NewLogRingBuffer(5000)
+	GlobalRingBuffer = NewLogRingBuffer(ringBufferCapacity)
 
 	// 使用 multi writer 同时写入原始输出和 ring buffer
 	multiWriter := zapcore.NewMultiWriteSyncer(
@@ -60,21 +63,25 @@ func init() {
 	fmt.Printf("[Logger] %s\n", logger.Level())
 }
 
+// DebugF 输出 Debug 级别日志
 func DebugF(ctx context.Context, format string, args ...interface{}) {
 	msg := fmt.Sprintf(format, args...)
 	logger.Ctx(ctx).Debug(msg, getTraceIDFields(ctx)...)
 }
 
+// InfoF 输出 Info 级别日志
 func InfoF(ctx context.Context, format string, args ...interface{}) {
 	msg := fmt.Sprintf(format, args...)
 	logger.Ctx(ctx).Info(msg, getTraceIDFields(ctx)...)
 }
 
+// WarnF 输出 Warn 级别日志
 func WarnF(ctx context.Context, format string, args ...interface{}) {
 	msg := fmt.Sprintf(format, args...)
 	logger.Ctx(ctx).Warn(msg, getTraceIDFields(ctx)...)
 }
 
+// ErrorF 输出 Error 级别日志
 func ErrorF(ctx context.Context, format string, args ...interface{}) {
 	msg := fmt.Sprintf(format, args...)
 	logger.Ctx(ctx).Error(msg, getTraceIDFields(ctx)...)

internal/logger/ringbuffer.go

@@ -163,10 +163,13 @@ func (r *LogRingBuffer) Query(cursor int, limit int) ([]LogEntry, bool) {
 	return ordered[start:cut], hasMore
 }
 
+// subscribeChanSize 订阅者 channel 缓冲区大小
+const subscribeChanSize = 64
+
 // Subscribe 订阅实时日志推送
 // 返回一个 channel，调用者应 defer Unsubscribe
 func (r *LogRingBuffer) Subscribe() chan LogEntry {
-	ch := make(chan LogEntry, 64)
+	ch := make(chan LogEntry, subscribeChanSize)
 	r.subMu.Lock()
 	r.subscribers[ch] = struct{}{}
 	r.subMu.Unlock()

internal/logger/utils.go

@@ -47,6 +47,9 @@ func GetLogWriter() (zapcore.WriteSyncer, error) {
 	return logWriter, initLogWriterErr
 }
 
+// logDirPerm 日志目录权限
+const logDirPerm = 0750
+
 func initWriter() (zapcore.WriteSyncer, error) {
 	logConfig := config.Config.Log
 
@@ -54,7 +57,7 @@ func initWriter() (zapcore.WriteSyncer, error) {
 		// 初始化日志目录
 		logPath := logConfig.FilePath
 		logDir := filepath.Dir(logPath)
-		if err := os.MkdirAll(logDir, 0750); err != nil {
+		if err := os.MkdirAll(logDir, logDirPerm); err != nil {
 			return nil, fmt.Errorf(errCreateLogFileDirFailed, err)
 		}