Fundamental_Analysis/services/finnhub-provider-service/src/api.rs
Lv, Qi 60e6c8f61b feat(config): 将服务配置全面迁移至数据库
本次提交完成了一项重要的架构重构,将所有外部服务的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` 环境变量,消除了启动时的警告。

这项重构显著提升了系统的可维护性、健壮性和用户体验,为未来的功能扩展奠定了坚实的基础。
2025-11-18 05:58:18 +08:00

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)
}