60e6c8f61b
本次提交完成了一项重要的架构重构，将所有外部服务的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` 环境变量，消除了启动时的警告。
这项重构显著提升了系统的可维护性、健壮性和用户体验，为未来的功能扩展奠定了坚实的基础。
|
||
|---|---|---|
| .. | ||
| .cargo | ||
| .sqlx | ||
| assets | ||
| src | ||
| tests | ||
| Cargo.lock | ||
| Cargo.toml | ||
| Dockerfile | ||
| env.sample | ||
| README.md | ||
数据持久化服务 (Data Persistence Service)
本服务是“基本面分析”微服务架构中数据库的唯一所有者，为所有数据持久化需求提供一个 RESTful API。
概览
- 语言: Rust
- 框架: Axum
- 数据库: PostgreSQL (带有 TimescaleDB 扩展)
- 核心任务: 为数据库提供一个稳定、高性能且类型安全的 API 层。
本地开发指南
1. 先决条件
- Rust 工具链 (
rustup) sqlx-cli(cargo install sqlx-cli)- 一个正在运行的、并已启用 TimescaleDB 扩展的 PostgreSQL 实例。
2. 配置
将 env.sample 文件复制为 .env，并根据您的本地环境配置 DATABASE_URL。
cp env.sample .env
您的 .env 文件应如下所示：
# 服务监听的端口
PORT=3000
# 用于 sqlx 连接数据库的 URL
# 请确保用户、密码、主机、端口和数据库名称都正确无误
DATABASE_URL=postgres://user:password@localhost:5432/fundamental_analysis
3. 数据库迁移
在首次运行本服务之前，或在任何数据库结构变更之后，请运行迁移命令以更新数据库：
sqlx migrate run
4. 运行服务
编译并运行本服务：
cargo run
服务将会启动并在您 .env 文件中指定的端口（默认为 3000）上监听。服务的 OpenAPI 规范 (Swagger JSON) 将在 /api-docs/openapi.json 路径下可用。
测试
要运行所有测试（包括数据库集成测试和 API 集成测试），请使用以下命令。请确保您的 .env 文件中的 DATABASE_URL 指向一个有效的、已应用迁移的测试数据库。
cargo test
如果需要查看详细的测试输出，可以使用：
cargo test -- --nocapture