本次提交完成了一项重要的架构重构,将所有外部服务的API凭证管理从环境变量迁移到了中心化的数据库配置中。
主要变更:
1. **统一配置源**:
- `data-persistence-service` 现已提供 `/api/v1/configs/data_sources` 端点,用于统一管理数据源配置。
- 所有配置(LLM 和数据源)现在都通过数据库的 `system_config` 表进行管理,实现了“单一事实源”。
2. **增强服务韧性**:
- 重构了 `finnhub-`, `tushare-`, `alphavantage-provider-service`。
- 这些服务在启动时不再强制要求 API Key。
- 引入了动态配置轮询器 (`config_poller`),服务现在可以定期从数据库获取最新配置。
- 实现了“降级模式”:当配置缺失时,服务会进入 `Degraded` 状态并暂停处理消息,而不是直接崩溃。配置恢复后,服务会自动回到 `Active` 状态。
- `/health` 端点现在能准确反映服务的真实运行状态。
3. **前端易用性提升**:
- 您在 `/config` 页面上增加了“数据源配置”面板,允许用户通过 UI 动态更新所有 API Token。
4. **部署简化**:
- 从 `docker-compose.yml` 中移除了所有已废弃的 `_API_KEY` 环境变量,消除了启动时的警告。
这项重构显著提升了系统的可维护性、健壮性和用户体验,为未来的功能扩展奠定了坚实的基础。
52 lines
1.6 KiB
Rust
52 lines
1.6 KiB
Rust
use std::collections::HashMap;
|
|
use axum::{
|
|
extract::State,
|
|
response::Json,
|
|
routing::get,
|
|
Router,
|
|
};
|
|
use common_contracts::observability::{HealthStatus, ServiceStatus, TaskProgress};
|
|
use crate::state::{AppState, ServiceOperationalStatus};
|
|
|
|
pub fn create_router(app_state: AppState) -> Router {
|
|
Router::new()
|
|
.route("/health", get(health_check))
|
|
.route("/tasks", get(get_current_tasks))
|
|
.with_state(app_state)
|
|
}
|
|
|
|
/// [GET /health]
|
|
/// Provides the current health status of the module.
|
|
async fn health_check(State(state): State<AppState>) -> Json<HealthStatus> {
|
|
let mut details = HashMap::new();
|
|
let operational_status = state.status.read().await;
|
|
|
|
let (service_status, reason) = match &*operational_status {
|
|
ServiceOperationalStatus::Active => (ServiceStatus::Ok, "ok".to_string()),
|
|
ServiceOperationalStatus::Degraded { reason } => {
|
|
(ServiceStatus::Degraded, reason.clone())
|
|
}
|
|
};
|
|
|
|
details.insert("operational_status".to_string(), reason);
|
|
|
|
let status = HealthStatus {
|
|
module_id: "finnhub-provider-service".to_string(),
|
|
status: service_status,
|
|
version: env!("CARGO_PKG_VERSION").to_string(),
|
|
details,
|
|
};
|
|
Json(status)
|
|
}
|
|
|
|
/// [GET /tasks]
|
|
/// Reports all currently processing tasks and their progress.
|
|
async fn get_current_tasks(State(state): State<AppState>) -> Json<Vec<TaskProgress>> {
|
|
let tasks: Vec<TaskProgress> = state
|
|
.tasks
|
|
.iter()
|
|
.map(|entry| entry.value().clone())
|
|
.collect();
|
|
Json(tasks)
|
|
}
|