refactor: 大规模模块拆分与代码精简，新增 ai-pipeline/data-contracts 独立 crate

- 新增 aether-ai-pipeline 和 aether-data-contracts crate，将 pipeline 逻辑与数据契约从 gateway 中解耦 - 重构 admin handlers：拆分单体模块为 auth/billing/endpoint/features/model/observability/provider/system 等独立子模块 - 合并 chat/cli 重复代码路径：精简 conversion、finalize、planner 中的 sync/chat/cli 分支 - 重构 scheduler/executor/data 层，引入 facade 模式降低模块间耦合 - 移除冗余的 intent 模块，将 plan_fallback/policy/stream_path/sync_path 迁移至 executor - 前端适配：调整 admin API 调用和 provider 模型测试对话框
2026-09-03 01:40:21 +08:00 · 2026-04-07 02:50:19 +08:00
parent 763ff03a7b
commit 5d96d6673b
732 changed files with 28593 additions and 20666 deletions
--- a/apps/aether-gateway/src/tests/video/data_read.rs
+++ b/apps/aether-gateway/src/tests/video/data_read.rs
@@ -1,7 +1,8 @@
 use std::sync::{Arc, Mutex};

-use aether_data::repository::video_tasks::{
-    InMemoryVideoTaskRepository, UpsertVideoTask, VideoTaskWriteRepository,
+use aether_data::repository::video_tasks::InMemoryVideoTaskRepository;
+use aether_data_contracts::repository::video_tasks::{
+    UpsertVideoTask, VideoTaskStatus, VideoTaskWriteRepository,
 };
 use axum::body::Body;
 use axum::routing::any;
@@ -72,7 +73,7 @@ async fn gateway_reads_openai_video_task_via_data_read_side_without_hitting_publ
            resolution: Some("720p".to_string()),
            aspect_ratio: Some("16:9".to_string()),
            size: Some("1280x720".to_string()),
-            status: aether_data::repository::video_tasks::VideoTaskStatus::Processing,
+            status: VideoTaskStatus::Processing,
            progress_percent: 45,
            progress_message: Some("working".to_string()),
            retry_count: 0,
@@ -177,7 +178,7 @@ async fn gateway_reads_gemini_video_task_via_data_read_side_without_hitting_publ
            resolution: Some("720p".to_string()),
            aspect_ratio: Some("16:9".to_string()),
            size: Some("720p".to_string()),
-            status: aether_data::repository::video_tasks::VideoTaskStatus::Completed,
+            status: VideoTaskStatus::Completed,
            progress_percent: 100,
            progress_message: None,
            retry_count: 0,
--- a/apps/aether-gateway/src/tests/video/gemini_sync_create.rs
+++ b/apps/aether-gateway/src/tests/video/gemini_sync_create.rs
@@ -2,16 +2,17 @@ use aether_crypto::{encrypt_python_fernet_plaintext, DEVELOPMENT_ENCRYPTION_KEY}
 use aether_data::repository::auth::{
    InMemoryAuthApiKeySnapshotRepository, StoredAuthApiKeySnapshot,
 };
-use aether_data::repository::candidate_selection::{
-    InMemoryMinimalCandidateSelectionReadRepository, StoredMinimalCandidateSelectionRow,
-    StoredProviderModelMapping,
+use aether_data::repository::candidate_selection::InMemoryMinimalCandidateSelectionReadRepository;
+use aether_data::repository::candidates::InMemoryRequestCandidateRepository;
+use aether_data::repository::provider_catalog::InMemoryProviderCatalogReadRepository;
+use aether_data_contracts::repository::candidate_selection::{
+    StoredMinimalCandidateSelectionRow, StoredProviderModelMapping,
 };
-use aether_data::repository::candidates::{
-    InMemoryRequestCandidateRepository, RequestCandidateReadRepository, RequestCandidateStatus,
+use aether_data_contracts::repository::candidates::{
+    RequestCandidateReadRepository, RequestCandidateStatus,
 };
-use aether_data::repository::provider_catalog::{
-    InMemoryProviderCatalogReadRepository, StoredProviderCatalogEndpoint, StoredProviderCatalogKey,
-    StoredProviderCatalogProvider,
+use aether_data_contracts::repository::provider_catalog::{
+    StoredProviderCatalogEndpoint, StoredProviderCatalogKey, StoredProviderCatalogProvider,
 };
 use axum::body::{to_bytes, Body};
 use axum::routing::any;
--- a/apps/aether-gateway/src/tests/video/gemini_sync_task.rs
+++ b/apps/aether-gateway/src/tests/video/gemini_sync_task.rs
@@ -1,13 +1,15 @@
 use aether_crypto::{encrypt_python_fernet_plaintext, DEVELOPMENT_ENCRYPTION_KEY};
-use aether_data::repository::candidates::{
-    InMemoryRequestCandidateRepository, RequestCandidateReadRepository, RequestCandidateStatus,
+use aether_data::repository::candidates::InMemoryRequestCandidateRepository;
+use aether_data::repository::provider_catalog::InMemoryProviderCatalogReadRepository;
+use aether_data::repository::video_tasks::InMemoryVideoTaskRepository;
+use aether_data_contracts::repository::candidates::{
+    RequestCandidateReadRepository, RequestCandidateStatus,
 };
-use aether_data::repository::provider_catalog::{
-    InMemoryProviderCatalogReadRepository, StoredProviderCatalogEndpoint, StoredProviderCatalogKey,
-    StoredProviderCatalogProvider,
+use aether_data_contracts::repository::provider_catalog::{
+    StoredProviderCatalogEndpoint, StoredProviderCatalogKey, StoredProviderCatalogProvider,
 };
-use aether_data::repository::video_tasks::{
-    InMemoryVideoTaskRepository, UpsertVideoTask, VideoTaskWriteRepository,
+use aether_data_contracts::repository::video_tasks::{
+    UpsertVideoTask, VideoTaskStatus, VideoTaskWriteRepository,
 };
 use axum::body::{to_bytes, Body};
 use axum::response::Response;
@@ -18,9 +20,7 @@ use http::StatusCode;
 use serde_json::json;
 use std::sync::{Arc, Mutex};

-use crate::constants::{
-    CONTROL_EXECUTED_HEADER, CONTROL_EXECUTE_FALLBACK_HEADER, TRACE_ID_HEADER,
-};
+use crate::constants::{CONTROL_EXECUTED_HEADER, CONTROL_EXECUTE_FALLBACK_HEADER, TRACE_ID_HEADER};

 use super::{
    build_router_with_state, build_state_with_execution_runtime_override, start_server,
@@ -180,7 +180,7 @@ async fn gateway_executes_gemini_video_cancel_via_data_backed_local_follow_up_wi
            resolution: Some("720p".to_string()),
            aspect_ratio: Some("16:9".to_string()),
            size: Some("720p".to_string()),
-            status: aether_data::repository::video_tasks::VideoTaskStatus::Submitted,
+            status: VideoTaskStatus::Submitted,
            progress_percent: 0,
            progress_message: None,
            retry_count: 0,
@@ -244,9 +244,8 @@ async fn gateway_executes_gemini_video_cancel_via_data_backed_local_follow_up_wi

    let (upstream_url, upstream_handle) = start_server(upstream).await;
    let (execution_runtime_url, execution_runtime_handle) = start_server(execution_runtime).await;
-    let gateway_state =
-        build_state_with_execution_runtime_override(execution_runtime_url)
-    .with_data_state_for_tests(
+    let gateway_state = build_state_with_execution_runtime_override(execution_runtime_url)
+        .with_data_state_for_tests(
        crate::data::GatewayDataState::with_video_task_and_request_candidate_repository_for_tests(
            repository,
            Arc::clone(&request_candidate_repository),
@@ -544,7 +543,7 @@ async fn gateway_executes_gemini_video_cancel_via_reconstructed_data_backed_loca
            resolution: Some("720p".to_string()),
            aspect_ratio: Some("16:9".to_string()),
            size: None,
-            status: aether_data::repository::video_tasks::VideoTaskStatus::Processing,
+            status: VideoTaskStatus::Processing,
            progress_percent: 50,
            progress_message: None,
            retry_count: 0,
--- a/apps/aether-gateway/src/tests/video/mod.rs
+++ b/apps/aether-gateway/src/tests/video/mod.rs
@@ -1,8 +1,8 @@
 use std::sync::{Arc, Mutex};

-use aether_data::repository::video_tasks::{
-    InMemoryVideoTaskRepository, UpsertVideoTask, VideoTaskLookupKey, VideoTaskReadRepository,
-    VideoTaskWriteRepository,
+use aether_data::repository::video_tasks::InMemoryVideoTaskRepository;
+use aether_data_contracts::repository::video_tasks::{
+    UpsertVideoTask, VideoTaskLookupKey, VideoTaskReadRepository, VideoTaskWriteRepository,
 };
 use axum::body::{to_bytes, Body, Bytes};
 use axum::response::Response;
--- a/apps/aether-gateway/src/tests/video/openai_sync_create.rs
+++ b/apps/aether-gateway/src/tests/video/openai_sync_create.rs
@@ -2,19 +2,21 @@ use aether_crypto::{encrypt_python_fernet_plaintext, DEVELOPMENT_ENCRYPTION_KEY}
 use aether_data::repository::auth::{
    InMemoryAuthApiKeySnapshotRepository, StoredAuthApiKeySnapshot,
 };
-use aether_data::repository::candidate_selection::{
-    InMemoryMinimalCandidateSelectionReadRepository, StoredMinimalCandidateSelectionRow,
-    StoredProviderModelMapping,
+use aether_data::repository::candidate_selection::InMemoryMinimalCandidateSelectionReadRepository;
+use aether_data::repository::candidates::InMemoryRequestCandidateRepository;
+use aether_data::repository::provider_catalog::InMemoryProviderCatalogReadRepository;
+use aether_data::repository::video_tasks::InMemoryVideoTaskRepository;
+use aether_data_contracts::repository::candidate_selection::{
+    StoredMinimalCandidateSelectionRow, StoredProviderModelMapping,
 };
-use aether_data::repository::candidates::{
-    InMemoryRequestCandidateRepository, RequestCandidateReadRepository, RequestCandidateStatus,
+use aether_data_contracts::repository::candidates::{
+    RequestCandidateReadRepository, RequestCandidateStatus,
 };
-use aether_data::repository::provider_catalog::{
-    InMemoryProviderCatalogReadRepository, StoredProviderCatalogEndpoint, StoredProviderCatalogKey,
-    StoredProviderCatalogProvider,
+use aether_data_contracts::repository::provider_catalog::{
+    StoredProviderCatalogEndpoint, StoredProviderCatalogKey, StoredProviderCatalogProvider,
 };
-use aether_data::repository::video_tasks::{
-    InMemoryVideoTaskRepository, UpsertVideoTask, VideoTaskWriteRepository,
+use aether_data_contracts::repository::video_tasks::{
+    UpsertVideoTask, VideoTaskStatus, VideoTaskWriteRepository,
 };
 use axum::body::{to_bytes, Body};
 use axum::routing::any;
@@ -661,7 +663,7 @@ async fn gateway_executes_openai_video_remix_via_data_backed_local_follow_up_wit
            resolution: Some("720p".to_string()),
            aspect_ratio: Some("16:9".to_string()),
            size: Some("1280x720".to_string()),
-            status: aether_data::repository::video_tasks::VideoTaskStatus::Completed,
+            status: VideoTaskStatus::Completed,
            progress_percent: 100,
            progress_message: None,
            retry_count: 0,
@@ -732,9 +734,8 @@ async fn gateway_executes_openai_video_remix_via_data_backed_local_follow_up_wit

    let (upstream_url, upstream_handle) = start_server(upstream).await;
    let (execution_runtime_url, execution_runtime_handle) = start_server(execution_runtime).await;
-    let gateway_state =
-        build_state_with_execution_runtime_override(execution_runtime_url)
-    .with_data_state_for_tests(
+    let gateway_state = build_state_with_execution_runtime_override(execution_runtime_url)
+        .with_data_state_for_tests(
        crate::data::GatewayDataState::with_video_task_and_request_candidate_repository_for_tests(
            repository,
            Arc::clone(&request_candidate_repository),
--- a/apps/aether-gateway/src/tests/video/openai_sync_task.rs
+++ b/apps/aether-gateway/src/tests/video/openai_sync_task.rs
@@ -1,13 +1,15 @@
 use aether_crypto::{encrypt_python_fernet_plaintext, DEVELOPMENT_ENCRYPTION_KEY};
-use aether_data::repository::candidates::{
-    InMemoryRequestCandidateRepository, RequestCandidateReadRepository, RequestCandidateStatus,
+use aether_data::repository::candidates::InMemoryRequestCandidateRepository;
+use aether_data::repository::provider_catalog::InMemoryProviderCatalogReadRepository;
+use aether_data::repository::video_tasks::InMemoryVideoTaskRepository;
+use aether_data_contracts::repository::candidates::{
+    RequestCandidateReadRepository, RequestCandidateStatus,
 };
-use aether_data::repository::provider_catalog::{
-    InMemoryProviderCatalogReadRepository, StoredProviderCatalogEndpoint, StoredProviderCatalogKey,
-    StoredProviderCatalogProvider,
+use aether_data_contracts::repository::provider_catalog::{
+    StoredProviderCatalogEndpoint, StoredProviderCatalogKey, StoredProviderCatalogProvider,
 };
-use aether_data::repository::video_tasks::{
-    InMemoryVideoTaskRepository, UpsertVideoTask, VideoTaskWriteRepository,
+use aether_data_contracts::repository::video_tasks::{
+    UpsertVideoTask, VideoTaskStatus, VideoTaskWriteRepository,
 };
 use axum::body::{to_bytes, Body};
 use axum::response::Response;
@@ -18,9 +20,7 @@ use http::StatusCode;
 use serde_json::json;
 use std::sync::{Arc, Mutex};

-use crate::constants::{
-    CONTROL_EXECUTED_HEADER, CONTROL_EXECUTE_FALLBACK_HEADER, TRACE_ID_HEADER,
-};
+use crate::constants::{CONTROL_EXECUTED_HEADER, CONTROL_EXECUTE_FALLBACK_HEADER, TRACE_ID_HEADER};

 use super::{
    build_router_with_state, build_state_with_execution_runtime_override, start_server,
@@ -260,7 +260,7 @@ async fn gateway_executes_openai_video_delete_via_reconstructed_data_backed_loca
            resolution: Some("720p".to_string()),
            aspect_ratio: Some("16:9".to_string()),
            size: Some("1280x720".to_string()),
-            status: aether_data::repository::video_tasks::VideoTaskStatus::Completed,
+            status: VideoTaskStatus::Completed,
            progress_percent: 100,
            progress_message: None,
            retry_count: 0,
--- a/apps/aether-gateway/src/tests/video/registry_poller.rs
+++ b/apps/aether-gateway/src/tests/video/registry_poller.rs
@@ -1,7 +1,8 @@
 use std::sync::{Arc, Mutex};

-use aether_data::repository::video_tasks::{
-    InMemoryVideoTaskRepository, UpsertVideoTask, VideoTaskLookupKey, VideoTaskReadRepository,
+use aether_data::repository::video_tasks::InMemoryVideoTaskRepository;
+use aether_data_contracts::repository::video_tasks::{
+    UpsertVideoTask, VideoTaskLookupKey, VideoTaskReadRepository, VideoTaskStatus,
    VideoTaskWriteRepository,
 };
 use axum::body::to_bytes;
@@ -36,7 +37,7 @@ fn sample_due_openai_task(upstream_base_url: &str) -> UpsertVideoTask {
        resolution: Some("720p".to_string()),
        aspect_ratio: Some("16:9".to_string()),
        size: Some("1280x720".to_string()),
-        status: aether_data::repository::video_tasks::VideoTaskStatus::Submitted,
+        status: VideoTaskStatus::Submitted,
        progress_percent: 0,
        progress_message: None,
        retry_count: 0,
@@ -194,10 +195,7 @@ async fn gateway_background_video_task_poller_refreshes_due_openai_task_from_rep
        }
    };

-    assert_eq!(
-        stored.status,
-        aether_data::repository::video_tasks::VideoTaskStatus::Processing
-    );
+    assert_eq!(stored.status, VideoTaskStatus::Processing);
    assert_eq!(stored.progress_percent, 37);
    assert_eq!(stored.poll_count, 1);
    assert!(
@@ -305,10 +303,7 @@ async fn gateway_background_video_task_poller_refreshes_due_openai_task_from_rep
        }
    };

-    assert_eq!(
-        stored.status,
-        aether_data::repository::video_tasks::VideoTaskStatus::Processing
-    );
+    assert_eq!(stored.status, VideoTaskStatus::Processing);
    assert_eq!(stored.progress_percent, 37);
    assert_eq!(stored.poll_count, 1);
    assert!(
--- a/apps/aether-gateway/src/tests/video/stream.rs
+++ b/apps/aether-gateway/src/tests/video/stream.rs
@@ -1,11 +1,12 @@
 use aether_contracts::{StreamFrame, StreamFramePayload, StreamFrameType};
 use aether_crypto::{encrypt_python_fernet_plaintext, DEVELOPMENT_ENCRYPTION_KEY};
-use aether_data::repository::provider_catalog::{
-    InMemoryProviderCatalogReadRepository, StoredProviderCatalogEndpoint, StoredProviderCatalogKey,
-    StoredProviderCatalogProvider,
+use aether_data::repository::provider_catalog::InMemoryProviderCatalogReadRepository;
+use aether_data::repository::video_tasks::InMemoryVideoTaskRepository;
+use aether_data_contracts::repository::provider_catalog::{
+    StoredProviderCatalogEndpoint, StoredProviderCatalogKey, StoredProviderCatalogProvider,
 };
-use aether_data::repository::video_tasks::{
-    InMemoryVideoTaskRepository, UpsertVideoTask, VideoTaskWriteRepository,
+use aether_data_contracts::repository::video_tasks::{
+    UpsertVideoTask, VideoTaskStatus, VideoTaskWriteRepository,
 };
 use axum::body::{to_bytes, Body, Bytes};
 use axum::response::Response;
@@ -17,9 +18,7 @@ use http::StatusCode;
 use serde_json::json;
 use std::sync::{Arc, Mutex};

-use crate::constants::{
-    CONTROL_EXECUTED_HEADER, CONTROL_EXECUTE_FALLBACK_HEADER, TRACE_ID_HEADER,
-};
+use crate::constants::{CONTROL_EXECUTED_HEADER, CONTROL_EXECUTE_FALLBACK_HEADER, TRACE_ID_HEADER};

 use super::{
    build_router_with_state, build_state_with_execution_runtime_override, start_server,
@@ -280,7 +279,7 @@ async fn gateway_executes_openai_video_content_from_reconstructed_data_task_with
            resolution: Some("720p".to_string()),
            aspect_ratio: Some("16:9".to_string()),
            size: Some("1280x720".to_string()),
-            status: aether_data::repository::video_tasks::VideoTaskStatus::Completed,
+            status: VideoTaskStatus::Completed,
            progress_percent: 100,
            progress_message: None,
            retry_count: 0,