Merge branch 'hermes/hermes-996d586b'

server-rs/crates/shared-contracts/src/admin.rs

@@ -105,3 +105,39 @@ pub struct AdminDebugHttpResponse {
     pub body_text: String,
     pub body_json: Option<Value>,
 }
+
+// 后台埋点明细查询参数只保留运营筛选需要的只读字段。
+#[derive(Clone, Debug, Serialize, Deserialize, Default, PartialEq, Eq)]
+#[serde(rename_all = "camelCase")]
+pub struct AdminTrackingEventListQuery {
+    pub event_key: Option<String>,
+    pub user_id: Option<String>,
+    pub scope_kind: Option<String>,
+    pub scope_id: Option<String>,
+    pub limit: Option<u32>,
+}
+
+// 单条埋点原始事件明细，字段与 tracking_event 表一一对应并补充事件名称。
+#[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq)]
+#[serde(rename_all = "camelCase")]
+pub struct AdminTrackingEventEntryPayload {
+    pub event_id: String,
+    pub event_key: String,
+    pub event_title: String,
+    pub scope_kind: String,
+    pub scope_id: String,
+    pub day_key: i64,
+    pub user_id: Option<String>,
+    pub owner_user_id: Option<String>,
+    pub profile_id: Option<String>,
+    pub module_key: Option<String>,
+    pub metadata_json: String,
+    pub occurred_at: String,
+}
+
+// 后台埋点明细列表响应，前端导出 Excel 时直接使用 entries。
+#[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq)]
+#[serde(rename_all = "camelCase")]
+pub struct AdminTrackingEventListResponse {
+    pub entries: Vec<AdminTrackingEventEntryPayload>,
+}