feat: 实现统一错误处理系统 (003-error-handling)

- 新增统一错误码定义和管理 (pkg/errors/codes.go)
- 新增全局错误处理器和中间件 (pkg/errors/handler.go, internal/middleware/error_handler.go)
- 新增错误上下文管理 (pkg/errors/context.go)
- 增强 Panic 恢复中间件 (internal/middleware/recover.go)
- 新增完整的单元测试和集成测试
- 新增功能文档 (docs/003-error-handling/)
- 新增功能规范 (specs/003-error-handling/)
- 更新 CLAUDE.md 和 README.md

README.md

@@ -16,7 +16,7 @@
 - **配置热重载**：运行时配置更新，无需重启服务
 - **请求 ID 追踪**：UUID 跨日志的请求追踪
 - **Panic 恢复**：优雅的 panic 处理和堆栈跟踪日志
-- **统一错误响应**：一致的错误格式和本地化消息
+- **统一错误处理**：全局 ErrorHandler 统一处理所有 API 错误，返回一致的 JSON 格式（包含错误码、消息、时间戳）；Panic 自动恢复防止服务崩溃；错误分类处理（客户端 4xx、服务端 5xx）和日志级别控制；敏感信息自动脱敏保护
 - **数据持久化**：GORM + PostgreSQL 集成，提供完整的 CRUD 操作、事务支持和数据库迁移能力
 - **异步任务处理**：Asynq 任务队列集成，支持任务提交、后台执行、自动重试和幂等性保障，实现邮件发送、数据同步等异步任务
 - **生命周期管理**：物联网卡/号卡的开卡、激活、停机、复机、销户
@@ -466,6 +466,8 @@ rdb.Set(ctx, key, status, time.Hour)
 
 - **[快速开始指南](specs/001-fiber-middleware-integration/quickstart.md)**：详细设置和测试说明
 - **[限流指南](docs/rate-limiting.md)**：全面的限流配置和使用
+- **[错误处理使用指南](docs/003-error-handling/使用指南.md)**：错误码参考、Handler 使用、客户端处理、最佳实践
+- **[错误处理架构说明](docs/003-error-handling/架构说明.md)**：架构设计、性能优化、扩展性说明
 - **[实现计划](specs/001-fiber-middleware-integration/plan.md)**：设计决策和架构
 - **[数据模型](specs/001-fiber-middleware-integration/data-model.md)**：配置结构和 Redis 架构