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 已完成的执行计划文档
This commit is contained in:
fawney19
2026-04-09 00:10:38 +08:00
parent 4fb9882b54
commit 4fc95adfb9
663 changed files with 48471 additions and 40232 deletions
@@ -0,0 +1,196 @@
use crate::handlers::admin::request::AdminAppState;
use crate::handlers::admin::shared::unix_secs_to_rfc3339;
use crate::GatewayError;
use serde_json::json;
#[derive(Clone)]
pub(in super::super) struct AdminWalletOwnerSummary {
pub(in super::super) owner_type: &'static str,
pub(in super::super) owner_name: Option<String>,
}
pub(in super::super) fn build_admin_wallet_payment_order_payload(
order_id: String,
order_no: String,
amount_usd: f64,
payment_method: String,
status: String,
created_at: Option<String>,
credited_at: Option<String>,
) -> serde_json::Value {
json!({
"id": order_id,
"order_no": order_no,
"amount_usd": amount_usd,
"payment_method": payment_method,
"status": status,
"created_at": created_at,
"credited_at": credited_at,
})
}
#[allow(clippy::too_many_arguments)]
pub(in super::super) fn build_admin_wallet_transaction_payload(
wallet: &aether_data::repository::wallet::StoredWalletSnapshot,
owner: &AdminWalletOwnerSummary,
transaction_id: String,
category: &str,
reason_code: &str,
amount: f64,
balance_before: f64,
balance_after: f64,
recharge_balance_before: f64,
recharge_balance_after: f64,
gift_balance_before: f64,
gift_balance_after: f64,
link_type: Option<&str>,
link_id: Option<&str>,
operator_id: Option<&str>,
description: Option<&str>,
created_at: Option<String>,
) -> serde_json::Value {
json!({
"id": transaction_id,
"wallet_id": wallet.id,
"owner_type": owner.owner_type,
"owner_name": owner.owner_name.clone(),
"wallet_status": wallet.status,
"category": category,
"reason_code": reason_code,
"amount": amount,
"balance_before": balance_before,
"balance_after": balance_after,
"recharge_balance_before": recharge_balance_before,
"recharge_balance_after": recharge_balance_after,
"gift_balance_before": gift_balance_before,
"gift_balance_after": gift_balance_after,
"link_type": link_type,
"link_id": link_id,
"operator_id": operator_id,
"operator_name": serde_json::Value::Null,
"operator_email": serde_json::Value::Null,
"description": description,
"created_at": created_at,
})
}
pub(in super::super) fn wallet_owner_summary_from_fields(
user_id: Option<&str>,
user_name: Option<String>,
api_key_id: Option<&str>,
api_key_name: Option<String>,
) -> AdminWalletOwnerSummary {
if user_id.is_some() {
return AdminWalletOwnerSummary {
owner_type: "user",
owner_name: user_name,
};
}
if let Some(api_key_id) = api_key_id {
return AdminWalletOwnerSummary {
owner_type: "api_key",
owner_name: api_key_name
.filter(|value| !value.trim().is_empty())
.or_else(|| Some(format!("Key-{}", &api_key_id[..api_key_id.len().min(8)]))),
};
}
AdminWalletOwnerSummary {
owner_type: "orphaned",
owner_name: None,
}
}
pub(in super::super) async fn resolve_admin_wallet_owner_summary(
state: &AdminAppState<'_>,
wallet: &aether_data::repository::wallet::StoredWalletSnapshot,
) -> Result<AdminWalletOwnerSummary, GatewayError> {
if let Some(user_id) = wallet.user_id.as_deref() {
let user = state.find_user_auth_by_id(user_id).await?;
Ok(AdminWalletOwnerSummary {
owner_type: "user",
owner_name: user.map(|record| record.username),
})
} else if let Some(api_key_id) = wallet.api_key_id.as_deref() {
let api_key_ids = vec![api_key_id.to_string()];
let snapshots = state
.list_auth_api_key_snapshots_by_ids(&api_key_ids)
.await?;
let owner_name = snapshots
.into_iter()
.find(|snapshot| snapshot.api_key_id == api_key_id)
.and_then(|snapshot| snapshot.api_key_name)
.filter(|value| !value.trim().is_empty())
.or_else(|| Some(format!("Key-{}", &api_key_id[..api_key_id.len().min(8)])));
Ok(AdminWalletOwnerSummary {
owner_type: "api_key",
owner_name,
})
} else {
Ok(AdminWalletOwnerSummary {
owner_type: "orphaned",
owner_name: None,
})
}
}
pub(in super::super) fn build_admin_wallet_summary_payload(
wallet: &aether_data::repository::wallet::StoredWalletSnapshot,
owner: &AdminWalletOwnerSummary,
) -> serde_json::Value {
json!({
"id": wallet.id.clone(),
"user_id": wallet.user_id.clone(),
"api_key_id": wallet.api_key_id.clone(),
"owner_type": owner.owner_type,
"owner_name": owner.owner_name.clone(),
"balance": wallet.balance + wallet.gift_balance,
"recharge_balance": wallet.balance,
"gift_balance": wallet.gift_balance,
"refundable_balance": wallet.balance,
"currency": wallet.currency.clone(),
"status": wallet.status.clone(),
"limit_mode": wallet.limit_mode.clone(),
"unlimited": wallet.limit_mode.eq_ignore_ascii_case("unlimited"),
"total_recharged": wallet.total_recharged,
"total_consumed": wallet.total_consumed,
"total_refunded": wallet.total_refunded,
"total_adjusted": wallet.total_adjusted,
"created_at": serde_json::Value::Null,
"updated_at": unix_secs_to_rfc3339(wallet.updated_at_unix_secs),
})
}
pub(in super::super) fn build_admin_wallet_refund_payload(
wallet: &aether_data::repository::wallet::StoredWalletSnapshot,
owner: &AdminWalletOwnerSummary,
refund: &crate::AdminWalletRefundRecord,
) -> serde_json::Value {
json!({
"id": refund.id.clone(),
"refund_no": refund.refund_no.clone(),
"wallet_id": refund.wallet_id.clone(),
"owner_type": owner.owner_type,
"owner_name": owner.owner_name.clone(),
"wallet_status": wallet.status.clone(),
"user_id": refund.user_id.clone(),
"payment_order_id": refund.payment_order_id.clone(),
"source_type": refund.source_type.clone(),
"source_id": refund.source_id.clone(),
"refund_mode": refund.refund_mode.clone(),
"amount_usd": refund.amount_usd,
"status": refund.status.clone(),
"reason": refund.reason.clone(),
"failure_reason": refund.failure_reason.clone(),
"gateway_refund_id": refund.gateway_refund_id.clone(),
"payout_method": refund.payout_method.clone(),
"payout_reference": refund.payout_reference.clone(),
"payout_proof": refund.payout_proof.clone(),
"requested_by": refund.requested_by.clone(),
"approved_by": refund.approved_by.clone(),
"processed_by": refund.processed_by.clone(),
"created_at": unix_secs_to_rfc3339(refund.created_at_unix_secs),
"updated_at": unix_secs_to_rfc3339(refund.updated_at_unix_secs),
"processed_at": refund.processed_at_unix_secs.and_then(unix_secs_to_rfc3339),
"completed_at": refund.completed_at_unix_secs.and_then(unix_secs_to_rfc3339),
})
}