refactor: 大规模模块拆分与重组，新增 aether-admin crate

- 新建独立 aether-admin crate 承载 admin 相关共享契约与纯辅助函数 - 拆分 ai_pipeline 下 kiro/private_envelope/conversion/planner 等大文件为子模块目录 - 重组 admin handlers 各业务域（billing/oauth/provider/system/users 等）为目录结构，移除 shared.rs/builders.rs 等反模式 - 移除 ai_pipeline runtime adapters 旧实现（claude/openai/gemini/kiro/vertex/antigravity 等），改由 provider transport 统一承载 - 移除 control_facade/execution_facade/auth_snapshot_facade 等冗余 facade 层 - 拆分 query/billing 与 query/monitoring 模块、state/runtime/payments 与 security 模块 - 扩展架构测试覆盖 admin_billing/admin_model/admin_users 等新模块 - 删除 docs/architecture/refactor-execution-plan.md 已完成的执行计划文档
2026-10-12 04:09:48 +08:00 · 2026-04-09 00:10:38 +08:00
parent 4fb9882b54
commit 4fc95adfb9
663 changed files with 48471 additions and 40232 deletions
@@ -0,0 +1,102 @@
+use crate::handlers::admin::request::AdminAppState;
+use crate::handlers::admin::system::shared::modules as admin_system_modules;
+use crate::handlers::shared::module_available_from_env;
+use crate::GatewayError;
+use axum::{body::Bytes, http};
+use serde_json::json;
+
+impl<'a> AdminAppState<'a> {
+    pub(crate) async fn build_admin_modules_status_payload(
+        &self,
+    ) -> Result<serde_json::Value, GatewayError> {
+        admin_system_modules::build_admin_modules_status_payload(self).await
+    }
+
+    pub(crate) async fn build_admin_module_status_payload(
+        &self,
+        module_name: &str,
+    ) -> Result<Result<serde_json::Value, (http::StatusCode, serde_json::Value)>, GatewayError>
+    {
+        let Some(module) = admin_system_modules::admin_module_by_name(module_name) else {
+            return Ok(Err((
+                http::StatusCode::NOT_FOUND,
+                json!({ "detail": format!("模块 '{module_name}' 不存在") }),
+            )));
+        };
+        let runtime = admin_system_modules::build_admin_module_runtime_state(self).await?;
+        Ok(Ok(admin_system_modules::build_admin_module_status_payload(
+            self, module, &runtime,
+        )
+        .await?))
+    }
+
+    pub(crate) async fn set_admin_module_enabled_payload(
+        &self,
+        module_name: &str,
+        request_body: &Bytes,
+    ) -> Result<Result<serde_json::Value, (http::StatusCode, serde_json::Value)>, GatewayError>
+    {
+        let Some(module) = admin_system_modules::admin_module_by_name(module_name) else {
+            return Ok(Err((
+                http::StatusCode::NOT_FOUND,
+                json!({ "detail": format!("模块 '{module_name}' 不存在") }),
+            )));
+        };
+        let available = module_available_from_env(module.env_key, module.default_available);
+        if !available {
+            return Ok(Err((
+                http::StatusCode::BAD_REQUEST,
+                json!({
+                    "detail": format!(
+                        "模块 '{}' 不可用，无法启用。请检查环境变量 {} 和依赖库。",
+                        module.name, module.env_key
+                    )
+                }),
+            )));
+        }
+        let payload = match serde_json::from_slice::<
+            admin_system_modules::AdminSetModuleEnabledRequest,
+        >(request_body)
+        {
+            Ok(payload) => payload,
+            Err(_) => {
+                return Ok(Err((
+                    http::StatusCode::BAD_REQUEST,
+                    json!({ "detail": "请求体格式错误，需要 enabled 字段" }),
+                )));
+            }
+        };
+
+        let runtime = admin_system_modules::build_admin_module_runtime_state(self).await?;
+        if payload.enabled {
+            let (config_validated, config_error) =
+                admin_system_modules::build_admin_module_validation_result(module, &runtime);
+            if !config_validated {
+                return Ok(Err((
+                    http::StatusCode::BAD_REQUEST,
+                    json!({
+                        "detail": format!(
+                            "模块配置未验证通过: {}",
+                            config_error.unwrap_or_else(|| "未知错误".to_string())
+                        )
+                    }),
+                )));
+            }
+        }
+
+        let _ = self
+            .upsert_system_config_json_value(
+                &format!("module.{}.enabled", module.name),
+                &json!(payload.enabled),
+                Some(&format!("模块 [{}] 启用状态", module.display_name)),
+            )
+            .await?;
+        let updated_runtime = admin_system_modules::build_admin_module_runtime_state(self).await?;
+        Ok(Ok(admin_system_modules::build_admin_module_status_payload(
+            self,
+            module,
+            &updated_runtime,
+        )
+        .await?))
+    }
+}