refactor: 拆分 gateway 单体为独立 crate，新增 systemd 部署方案

将 gateway 内部的 model-fetch、provider-transport、scheduler-core、 usage-runtime、video-tasks-core 模块提取为独立 crate；重构 gateway 内部模块结构（state/router/cache/data/query 等）；移除大量遗留模块文件；新增 systemd 二进制部署骨架及相关文档；更新前端 usage 相关 API 和组件。
2026-10-10 03:09:50 +08:00 · 2026-04-05 20:23:16 +08:00
parent cbc811f6ce
commit 763ff03a7b
777 changed files with 42654 additions and 21464 deletions
@@ -0,0 +1,124 @@
+use aether_data::DataLayerError;
+
+use super::state::GatewayDataState;
+
+pub(crate) use aether_data::repository::candidates::{
+    RequestCandidateFinalStatus, RequestCandidateTrace,
+};
+
+pub(crate) async fn read_request_candidate_trace(
+    state: &GatewayDataState,
+    request_id: &str,
+    attempted_only: bool,
+) -> Result<Option<RequestCandidateTrace>, DataLayerError> {
+    let all_candidates = state
+        .list_request_candidates_by_request_id(request_id)
+        .await?;
+    Ok(RequestCandidateTrace::from_candidates(
+        request_id,
+        all_candidates,
+        attempted_only,
+    ))
+}
+
+#[cfg(test)]
+mod tests {
+    use super::super::GatewayDataState;
+    use super::{read_request_candidate_trace, RequestCandidateFinalStatus};
+    use aether_data::repository::candidates::{
+        derive_request_candidate_final_status, InMemoryRequestCandidateRepository,
+        RequestCandidateStatus, StoredRequestCandidate,
+    };
+    use std::sync::Arc;
+
+    fn sample_candidate(
+        id: &str,
+        request_id: &str,
+        candidate_index: i32,
+        status: RequestCandidateStatus,
+        started_at_unix_secs: Option<i64>,
+        latency_ms: Option<i32>,
+        status_code: Option<i32>,
+    ) -> StoredRequestCandidate {
+        StoredRequestCandidate::new(
+            id.to_string(),
+            request_id.to_string(),
+            Some("user-1".to_string()),
+            Some("api-key-1".to_string()),
+            Some("alice".to_string()),
+            Some("default".to_string()),
+            candidate_index,
+            0,
+            Some("provider-1".to_string()),
+            Some("endpoint-1".to_string()),
+            Some("provider-key-1".to_string()),
+            status,
+            None,
+            false,
+            status_code,
+            None,
+            None,
+            latency_ms,
+            Some(1),
+            None,
+            None,
+            100 + i64::from(candidate_index),
+            started_at_unix_secs,
+            started_at_unix_secs.map(|value| value + 1),
+        )
+        .expect("candidate should build")
+    }
+
+    #[test]
+    fn derive_final_status_prefers_success() {
+        let candidates = vec![sample_candidate(
+            "cand-1",
+            "req-1",
+            0,
+            RequestCandidateStatus::Success,
+            Some(100),
+            Some(25),
+            Some(200),
+        )];
+
+        assert_eq!(
+            derive_request_candidate_final_status(&candidates),
+            RequestCandidateFinalStatus::Success
+        );
+    }
+
+    #[tokio::test]
+    async fn read_request_candidate_trace_filters_attempted_rows() {
+        let repository = Arc::new(InMemoryRequestCandidateRepository::seed(vec![
+            sample_candidate(
+                "cand-1",
+                "req-1",
+                0,
+                RequestCandidateStatus::Pending,
+                None,
+                None,
+                None,
+            ),
+            sample_candidate(
+                "cand-2",
+                "req-1",
+                1,
+                RequestCandidateStatus::Failed,
+                Some(101),
+                Some(33),
+                Some(502),
+            ),
+        ]));
+        let state = GatewayDataState::with_request_candidate_reader_for_tests(repository);
+
+        let trace = read_request_candidate_trace(&state, "req-1", true)
+            .await
+            .expect("trace should succeed")
+            .expect("trace should exist");
+
+        assert_eq!(trace.total_candidates, 1);
+        assert_eq!(trace.candidates[0].id, "cand-2");
+        assert_eq!(trace.final_status, RequestCandidateFinalStatus::Failed);
+        assert_eq!(trace.total_latency_ms, 33);
+    }
+}