feat(日志): 新增客户端错误日志收集功能

- 创建 log_message 表用于存储客户端错误日志 - 实现客户端日志上报接口 POST /v1/common/log/message/report - 添加管理端日志查询接口 GET /v1/admin/log/message/error/list 和 GET /v1/admin/log/message/error/detail - 实现日志指纹去重和限流机制 - 完善相关模型、逻辑和文档说明
2025-12-02 20:12:33 -08:00
parent 61cdc0ce23
commit f0439f4f80
15 changed files with 575 additions and 17 deletions
@@ -1234,6 +1234,80 @@ type MessageLog struct {
 	CreatedAt int64       `json:"created_at"`
 }

+type ReportLogMessageRequest struct {
+    Platform   string                 `json:"platform" validate:"required"`
+    AppVersion string                 `json:"appVersion"`
+    OsName     string                 `json:"osName"`
+    OsVersion  string                 `json:"osVersion"`
+    DeviceId   string                 `json:"deviceId"`
+    UserId     int64                  `json:"userId"`
+    SessionId  string                 `json:"sessionId"`
+    Level      uint8                  `json:"level"`
+    ErrorCode  string                 `json:"errorCode"`
+    Message    string                 `json:"message" validate:"required"`
+    Stack      string                 `json:"stack"`
+    Context    map[string]interface{} `json:"context"`
+    OccurredAt int64                  `json:"occurredAt"`
+}
+
+type ReportLogMessageResponse struct {
+    Id int64 `json:"id"`
+}
+
+type GetErrorLogMessageListRequest struct {
+    Page     int    `form:"page"`
+    Size     int    `form:"size"`
+    Platform string `form:"platform"`
+    Level    uint8  `form:"level"`
+    UserId   int64  `form:"user_id"`
+    DeviceId string `form:"device_id"`
+    ErrorCode string `form:"error_code"`
+    Keyword  string `form:"keyword"`
+    Start    int64  `form:"start"`
+    End      int64  `form:"end"`
+}
+
+type ErrorLogMessage struct {
+    Id         int64       `json:"id"`
+    Platform   string      `json:"platform"`
+    AppVersion string      `json:"app_version"`
+    OsName     string      `json:"os_name"`
+    OsVersion  string      `json:"os_version"`
+    DeviceId   string      `json:"device_id"`
+    UserId     int64       `json:"user_id"`
+    SessionId  string      `json:"session_id"`
+    Level      uint8       `json:"level"`
+    ErrorCode  string      `json:"error_code"`
+    Message    string      `json:"message"`
+    CreatedAt  int64       `json:"created_at"`
+}
+
+type GetErrorLogMessageListResponse struct {
+    Total int64             `json:"total"`
+    List  []ErrorLogMessage `json:"list"`
+}
+
+type GetErrorLogMessageDetailResponse struct {
+    Id         int64                  `json:"id"`
+    Platform   string                 `json:"platform"`
+    AppVersion string                 `json:"app_version"`
+    OsName     string                 `json:"os_name"`
+    OsVersion  string                 `json:"os_version"`
+    DeviceId   string                 `json:"device_id"`
+    UserId     int64                  `json:"user_id"`
+    SessionId  string                 `json:"session_id"`
+    Level      uint8                  `json:"level"`
+    ErrorCode  string                 `json:"error_code"`
+    Message    string                 `json:"message"`
+    Stack      string                 `json:"stack"`
+    Context    map[string]interface{} `json:"context"`
+    ClientIP   string                 `json:"client_ip"`
+    UserAgent  string                 `json:"user_agent"`
+    Locale     string                 `json:"locale"`
+    OccurredAt int64                  `json:"occurred_at"`
+    CreatedAt  int64                  `json:"created_at"`
+}
+
 type MigrateServerNodeResponse struct {
 	Succee  uint64 `json:"succee"`
 	Fail    uint64 `json:"fail"`