75 lines
3.4 KiB
Markdown
75 lines
3.4 KiB
Markdown
## 2025-11-04 开发日志
|
||
|
||
**今日概览**
|
||
- 关键主题：
|
||
- 新增财务指标支持：在 Tushare 数据源中实现并集成了员工人数、股东户数、研发人员、所得税与利润总额关系等关键指标。
|
||
- 全栈功能贯通：完成了从后端数据获取、API 暴露到前端报告页展示的完整开发链路。
|
||
- 技术债清理：移除了多个陈旧的、功能单一的测试脚本，整合测试逻辑。
|
||
- 文档同步：更新了用户手册，以反映新增功能。
|
||
|
||
---
|
||
|
||
### 后端（FastAPI）
|
||
|
||
**数据源 (Tushare Provider)**
|
||
- `backend/app/data_providers/tushare.py`:
|
||
- 新增 `get_employee_number` 方法，用于获取上市公司员工人数及构成（技术、生产、销售、行政）。
|
||
- 新增 `get_holder_number` 方法，用于获取股东户数及变化。
|
||
- 新增 `get_tax_to_ebt` 方法，用于计算所得税与利润总额的比例，以分析税负情况。
|
||
- 可能对现有财务报表获取逻辑进行了优化，以支持新指标的整合。
|
||
|
||
**API 路由与模型 (Financial Router & Schemas)**
|
||
- `backend/app/routers/financial.py`:
|
||
- 在 `GET /china/{ts_code}` 聚合接口中，新增了对员工人数、股东户数、税收数据的调用和组装逻辑。
|
||
- 确保新指标能够正确地合并到返回给前端的 `series` 数据结构中。
|
||
- `backend/app/schemas/financial.py`:
|
||
- 更新了相关的 Pydantic 模型，加入了 `employee_number`, `holder_number`, `tax_to_ebt` 等字段的定义，确保 API 的类型安全。
|
||
|
||
**数据管理器 (Data Manager)**
|
||
- `backend/app/data_manager.py`:
|
||
- 对 `DataManager` 进行了相应修改，使其能够统一调度 Tushare Provider 提供的新数据接口。
|
||
|
||
---
|
||
|
||
### 前端（Next.js）
|
||
|
||
**财务报告页面**
|
||
- `frontend/src/app/report/[symbol]/page.tsx`:
|
||
- 在报告页中新增了图表或表格，用于可视化展示员工人数变化、股东户数趋势以及所得税与利润总额的关系。
|
||
- 调整了页面布局和组件，以容纳新的数据模块。
|
||
- `frontend/src/app/reports/[id]/page.tsx`:
|
||
- 对已保存的报告页面进行了适配，确保在加载旧报告或包含新指标的报告时能够正确渲染。
|
||
|
||
**工具函数与类型**
|
||
- `frontend/src/lib/financial-utils.ts`:
|
||
- 添加了处理新财务指标（如格式化员工数据、计算股东户数环比变化等）的辅助函数。
|
||
- `frontend/src/types/index.ts`:
|
||
- 更新了 TypeScript 类型定义，增加了与新后端模型对应的接口。
|
||
|
||
**其他**
|
||
- `frontend/package.json`: 可能更新了某些依赖库以支持新的图表或功能。
|
||
- `frontend/src/lib/prisma.ts`: 可能调整了 Prisma 客户端的配置或扩展。
|
||
|
||
---
|
||
|
||
### 脚本与文档
|
||
|
||
**脚本清理**
|
||
- 删除了以下旧测试脚本，相关功能可能已通过单元测试或集成测试覆盖：
|
||
- `scripts/test-employees.py`
|
||
- `scripts/test-holder-number.py`
|
||
- `scripts/test-holder-processing.py`
|
||
- `scripts/test-tax-to-ebt.py`
|
||
- `scripts/test-api-tax-to-ebt.py`
|
||
- `scripts/test-config.py`
|
||
- 删除了 `scripts/tushare_legacy_client.py`，完成了向新 Provider 架构的迁移。
|
||
|
||
**文档**
|
||
- `docs/user-guide.md`: 更新了用户指南，加入了关于如何解读新增财务指标（员工、股东、税收）的说明。
|
||
|
||
---
|
||
|
||
### 备注
|
||
- 本次更新丰富了公司的非财报基本面数据，为分析提供了更多维度。
|
||
- 前端报告页的性能在增加了新图表后需要进一步观察。
|