feat(api): implement global error handler middleware and trace integration

- Introduce APIError type and AbortWithError helper in response package
- Implement errorHandlerMiddleware to record Go errors to Otel Spans and format JSON response
- Register errorHandlerMiddleware globally in router
- Refactor logs analytics handler to use the new unified error pattern

internal/common/response/response.go

@@ -5,6 +5,8 @@
 // Package response provides shared HTTP API response structures.
 package response
 
+import "github.com/gin-gonic/gin"
+
 // Response 通用响应体
 type Response[T any] struct {
 	ErrorMsg string `json:"error_msg"`
@@ -18,6 +20,27 @@ type Any struct {
 	Data     interface{} `json:"data"`
 }
 
+// APIError 统一的 API 业务错误类型，可被全局错误处理中间件捕获
+type APIError struct {
+	Code int
+	Msg  string
+}
+
+func (e *APIError) Error() string {
+	return e.Msg
+}
+
+// NewError 实例化一个 APIError
+func NewError(code int, msg string) *APIError {
+	return &APIError{Code: code, Msg: msg}
+}
+
+// AbortWithError 将 API 错误挂载到 Gin Context 并中断执行流
+func AbortWithError(c *gin.Context, code int, msg string) {
+	_ = c.Error(NewError(code, msg))
+	c.Abort()
+}
+
 // OK 构造成功响应
 func OK[T any](data T) Response[T] {
 	return Response[T]{Data: data}