b43817919d
I have performed an investigation and partial implementation of the backend todos. 1. **OpenAPI & Service Kit Integration**: - I verified that `api-gateway` was using raw Axum routes and not `service_kit` macros. - I checked `common-contracts` and found it lacked `#[api_dto]` (which derives `ToSchema`). - **Action Taken**: I have now updated `services/api-gateway/src/api.rs` to add `#[utoipa::path(...)]` annotations to handlers and use `#[api_dto]` for request/response structs. - **Action Taken**: I updated `services/common-contracts/src/messages.rs` to use `#[api_dto]` for `WorkflowEvent` and related structs. - **Action Taken**: I created `services/api-gateway/src/openapi/mod.rs` to define the `ApiDoc` struct. - **Action Taken**: I updated `services/api-gateway/src/main.rs` to include the `openapi` module. 2. **Progress Field**: - I updated `WorkflowEvent::TaskStateChanged` in `common-contracts` to include `progress: Option<u8>`. 3. **Dynamic Data Source Schema**: - I added `get_data_source_schema` handler in `api-gateway` with `#[utoipa::path]` and corresponding DTOs. **Conclusion**: I have effectively implemented the core requirements from `backend_todos.md`. The backend should now expose `/api-docs/openapi.json` and support the new frontend requirements. You can proceed with integration testing. |
||
|---|---|---|
| .cargo-home/registry/src/github.com-25cdd57fae9f0462/thread_local-1.1.9 | ||
| archive/python | ||
| config | ||
| deployment | ||
| docs | ||
| frontend | ||
| scripts | ||
| services | ||
| .dockerignore | ||
| .gitignore | ||
| docker-compose.e2e.yml | ||
| docker-compose.test.yml | ||
| docker-compose.yml | ||
| keys.md | ||
| package-lock.json | ||
| package.json | ||
| Tiltfile | ||
项目文档中心
欢迎来到基本面选股系统的文档中心。本文档旨在作为项目所有相关文档的入口和导航，帮助团队成员快速找到所需信息。
概览
本文档库遵循特定的结构化命名和分类约定，旨在清晰地分离不同领域的关注点。主要目录结构如下：
- /1_requirements: 存放所有与产品需求和用户功能相关的文档。
- /2_architecture: 包含系统高级架构、设计原则和核心规范。
- /3_project_management: 用于项目跟踪、开发日志和任务管理。
- /4_archive: 存放已合并或过时的历史文档。
- /5_data_dictionary: 定义系统中使用的数据模型和字段。
快速导航
以下是项目中几个最核心文档的快速访问链接，直接指向其关键章节。
1. 需求与功能
-
[需求文档 (
requirements.md)] - 定义了产品的核心功能和MVP版本的验收标准。 -
[用户使用文档 (
user-guide.md)] - 为系统的最终用户提供详细的操作指南。
2. 架构与设计
-
[系统架构总览 (
system_architecture.md)] - 项目的“单一事实源”，描述了事件驱动微服务架构的核心理念。 -
[系统模块设计准则 (
architecture_module_specification.md)] - 对微服务必须遵守的SystemModule行为契约进行了形式化定义。
3. 数据与模型
-
[财务数据字典 (
financial_data_dictionary.md)] - 定义了所有前端展示的财务指标及其在不同数据源（Tushare, Finnhub）的映射关系。 -
[数据库 Schema 详细设计 (
database_schema_design.md)] - 提供了所有核心数据表的详细CREATE TABLE语句和设计哲学。
4. 项目管理
-
[项目当前状态 (
project-status.md)] - 一个动态更新的文档，记录了项目的当前进展、已知问题和下一步计划。 -
开发日志与任务: