本次提交完成了一次全面的架构重构,实现了以数据库为中心的、支持多供应商的LLM配置体系。
**核心变更**:
1. **数据库驱动配置**: 废弃了所有基于本地文件的配置方案 (`analysis-config.json`),将LLM Provider和分析模块的配置作为结构化数据存入数据库的`system_config`表中,由`data-persistence-service`统一管理。
2. **Schema-in-Code**: 在`common-contracts`中定义了所有配置的Rust Structs,作为整个系统的“单一事实源”,确保了端到端的类型安全。
3. **服务职责重构**:
* `data-persistence-service`吸收了配置管理功能,成为配置的“守门人”。
* `config-service-rs`服务已被彻底移除。
* `report-generator-service`重构为可以为每个任务动态创建使用不同Provider配置的LLM客户端。
4. **前端功能增强**:
* 新增了独立的`/llm-config`页面,用于对LLM Providers及其可用模型进行完整的CRUD管理,并支持模型自动发现。
* 重构了旧的`/config`页面,为分析模块提供了级联选择器来精确指定所需的Provider和Model。
此次重构极大地提升了系统的灵活性和可扩展性,完全对齐了“配置即数据”的现代化设计原则。
|
||
|---|---|---|
| .. | ||
| .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