refactor(logging): 迁移日志记录到 Zerolog 并优化错误处理

- 将日志记录库从 Logrus 替换为 Zerolog，提升性能和灵活性
- 更新各个模块的日志记录方式，确保一致性
- 优化错误处理逻辑，确保在发生错误时能够正确记录并传递错误信息
- 移除不再使用的错误处理字段，简化代码结构
- 更新相关文档以反映新的日志记录和错误处理机制

common/error.go

@@ -1,29 +1,59 @@
 package common
 
 import (
-	"github.com/sirupsen/logrus"
+	"code.hoteas.com/golang/hotime/log"
 	"sync"
 )
 
-// Error 框架层处理错误
+// Error 框架基础错误类型 —— 线程安全的 error 封装。
+// 通过组合（嵌入）方式在 Obj、DBError 等结构体中使用，提供统一的错误 API。
+// 也用于 ObjToXxx / Map.GetXxx 等工具函数的可选错误报告参数。
+// 设置 Logger 后，SetError 会自动将非 nil 错误写入日志。
 type Error struct {
-	Logger *logrus.Logger
 	error
-	mu sync.RWMutex
+	mu     sync.RWMutex
+	Logger *log.Logger
 }
 
+// Error 安全实现 error 接口 —— 内部 error 为 nil 时返回 "" 而非 panic
+func (that *Error) Error() string {
+	that.mu.RLock()
+	defer that.mu.RUnlock()
+	if that.error == nil {
+		return ""
+	}
+	return that.error.Error()
+}
+
+// HasError 快捷判断是否存在错误
+func (that *Error) HasError() bool {
+	that.mu.RLock()
+	defer that.mu.RUnlock()
+	return that.error != nil
+}
+
+// Unwrap 支持 errors.Is / errors.As 标准错误链
+func (that *Error) Unwrap() error {
+	that.mu.RLock()
+	defer that.mu.RUnlock()
+	return that.error
+}
+
+// GetError 获取内部 error（nil 表示无错误）
 func (that *Error) GetError() error {
 	that.mu.RLock()
 	defer that.mu.RUnlock()
 	return that.error
 }
 
+// SetError 设置内部 error（传 nil 清除错误）
+// 当 Logger 已设置且 err 非 nil 时，自动写入 ERROR 级别日志
 func (that *Error) SetError(err error) {
 	that.mu.Lock()
 	that.error = err
+	logger := that.Logger
 	that.mu.Unlock()
-
-	if that.Logger != nil && err != nil {
-		that.Logger.Warn(err)
+	if err != nil && logger != nil {
+		logger.Error().Err(err).Msg("")
 	}
 }