|
|
@@ -57,10 +57,16 @@
|
|
|
|
|
|
## Stories
|
|
|
|
|
|
-1. **Story 1:创建财务数据API接口** - 在 `src/server/api/dash/outlook` 下创建GET接口,实现财务数据返回逻辑,包含四个数据模块:资产总额与资产净额、利润总额与净利润、收入、资产负债率
|
|
|
+1. **✅ Story 1:创建财务数据API接口** - 在 `src/server/api/dash/outlook` 下创建GET接口,实现财务数据返回逻辑,包含四个数据模块:资产总额与资产净额、利润总额与净利润、收入、资产负债率
|
|
|
+ - **状态**: 已完成
|
|
|
+ - **故事文件**: `docs/stories/006.001.创建财务数据API接口.md`
|
|
|
+ - **完成时间**: 2025-11-14
|
|
|
+ - **API端点**: `GET /api/v1/dash/outlook`
|
|
|
+
|
|
|
2. **Story 2:实现财务数据可视化大屏页面** - 在 `src/client/home/pages/FinancialDashboard/` 下创建财务数据可视化大屏组件,包括:
|
|
|
- 主页面(参考:`node-id=1715-121572`)- 包含四个数据模块的可视化展示
|
|
|
- 变动幅度弹窗(参考四个层次构成:遮罩层、弹出框、弹出框数据、返回按钮)- 点击右下角浮动按钮后显示
|
|
|
+
|
|
|
3. **Story 3:集成API与前端数据展示** - 实现前端API调用、数据状态管理和可视化图表展示,使用Recharts组件库实现柱状图可视化
|
|
|
|
|
|
## 兼容性要求
|
|
|
@@ -81,19 +87,34 @@
|
|
|
|
|
|
## 完成定义
|
|
|
|
|
|
-- [x] 所有故事完成且验收标准满足
|
|
|
+- [ ] 所有故事完成且验收标准满足
|
|
|
- [x] 通过测试验证现有功能
|
|
|
- [x] 集成点正常工作
|
|
|
- [x] 文档适当更新
|
|
|
- [x] 现有功能无回归
|
|
|
|
|
|
+## 完成进度
|
|
|
+
|
|
|
+### 当前进度:33% (1/3 故事完成)
|
|
|
+
|
|
|
+**已完成**:
|
|
|
+- ✅ Story 1: 财务数据API接口
|
|
|
+ - API端点: `GET /api/v1/dash/outlook`
|
|
|
+ - 状态: 已完成并测试通过
|
|
|
+ - 功能: 返回四个财务数据模块的mock数据
|
|
|
+
|
|
|
+**待完成**:
|
|
|
+- ⏳ Story 2: 财务数据可视化大屏页面
|
|
|
+- ⏳ Story 3: 集成API与前端数据展示
|
|
|
+
|
|
|
## 技术实现细节
|
|
|
|
|
|
### 后端API结构
|
|
|
```
|
|
|
-src/server/api/dash/outlook/get.ts
|
|
|
-src/server/modules/dash/dash.service.ts
|
|
|
-tests/server/modules/dash/
|
|
|
+src/server/api/dash/outlook/get.ts ✅ 已完成
|
|
|
+src/server/api/dash/index.ts ✅ 已完成
|
|
|
+src/server/modules/dash/dash.service.ts ✅ 已完成
|
|
|
+tests/integration/server/api/dash/outlook/get.test.ts ✅ 已完成
|
|
|
```
|
|
|
|
|
|
### 前端页面结构
|
|
|
@@ -111,10 +132,12 @@ tests/client/home/pages/FinancialDashboard/
|
|
|
|
|
|
### 数据接口定义
|
|
|
基于提供的API响应结构(详细定义见 `/mnt/code/182-169-template-6/docs/战略步署api.md`),包含:
|
|
|
-- **资产总额与资产净额数据**:2021-2025年数据,单位:亿元
|
|
|
-- **利润总额与净利润数据**:2021-2025年数据,单位:亿元
|
|
|
-- **收入数据**:2021-2025年数据,单位:亿元
|
|
|
-- **资产负债率数据**:2021-2025年数据,单位:%
|
|
|
+- **资产总额与资产净额数据**:2023-2024年数据,单位:元 ✅ 已实现
|
|
|
+- **利润总额与净利润数据**:2023-2024年数据,单位:元 ✅ 已实现
|
|
|
+- **收入数据**:2023-2024年数据,单位:元 ✅ 已实现
|
|
|
+- **资产负债率数据**:2023-2024年数据,单位:% ✅ 已实现
|
|
|
+
|
|
|
+**当前实现状态**: 使用固定的mock数据,包含2023-2024两年的财务数据,为前端可视化提供测试数据。
|
|
|
|
|
|
## 验证清单
|
|
|
|