selfrelease
374981609b
- 67 后端测试通过 / 14 前端路由构建成功 - 26 个 API 端点 / 千问 SSE 流式 AI 服务 - 任务清单 T1.1-T1.8 + T0.4 全部标记完成
84 lines
3.4 KiB
Plaintext
84 lines
3.4 KiB
Plaintext
# 项目进度记录
|
||
|
||
> 最后更新：2026-07-18
|
||
|
||
## Phase 0：项目骨架 ✅ 完成
|
||
|
||
### 已完成清单
|
||
|
||
| 任务 | 状态 | 验证结果 |
|
||
|---|---|---|
|
||
| T0.1 项目目录结构 | ✅ | `.gitignore` + `.env.example` + 目录树 |
|
||
| T0.2 后端项目初始化 | ✅ | `pytest test_health.py` → 4 passed |
|
||
| T0.3 前端项目初始化 | ✅ | `pnpm build` → 8 路由构建成功 |
|
||
| T0.4 Docker Compose | ✅ | docker-compose.yml + Dockerfile（Docker Hub 网络受限，使用本地 PostgreSQL） |
|
||
| T0.5 数据库迁移基座 | ✅ | `alembic upgrade head` → 7 张核心表创建成功 |
|
||
|
||
### 技术栈实际版本
|
||
|
||
- **后端**：Python 3.12.10 + FastAPI 0.139.2 + SQLAlchemy 2.0.51 + Alembic 1.18.5
|
||
- **前端**：Next.js 16.2.10 + React 19.2.4 + TailwindCSS 4.3.3 + TypeScript 5.9.3
|
||
- **数据库**：PostgreSQL 15.13（本地 Postgres.app，非 Docker）
|
||
- **包管理**：pip + venv（后端，uv 安装受阻） / pnpm 10.33.2（前端）
|
||
|
||
### 网络问题记录
|
||
|
||
- Google Fonts、Docker Hub、PyPI 均有 SSL 连接问题
|
||
- **解决方案**：PyPI 用清华镜像源；前端用系统字体替代 Google Fonts；数据库用本地 Postgres.app
|
||
|
||
### 核心表结构
|
||
|
||
1. `tenants` — 租户（投资机构）
|
||
2. `users` — 用户（多角色）
|
||
3. `companies` — 被投企业
|
||
4. `monthly_reports` — 月报
|
||
5. `health_scores` — 健康度评分
|
||
6. `risk_events` — 风险事件
|
||
7. `audit_logs` — 审计日志
|
||
|
||
### 前端路由
|
||
|
||
- `/` → 重定向到 `/dashboard`
|
||
- `/dashboard` → 投资人端驾驶舱（B 端，左 Sidebar）
|
||
- `/founder` → 创始人端概览（C 端，顶部 Header + 底部导航）
|
||
- `/founder/reports` → 月报
|
||
- `/founder/copilot` → AI 副驾驶
|
||
- `/admin` → 管理后台（Admin 端，slate-950 Header）
|
||
- `/login` → 登录页
|
||
|
||
---
|
||
|
||
## Phase 1：MVP 核心功能 — 待开始
|
||
|
||
### 优先级排序
|
||
|
||
1. **T1.1 认证与权限** — 登录/注册/JWT/角色控制
|
||
2. **T1.2 企业档案 CRUD** — 被投企业列表/详情/编辑
|
||
3. **T1.3 月报管理** — 提交/查看/AI 解析
|
||
4. **T1.4 健康度仪表盘** — 投资人端驾驶舱首页
|
||
5. **T1.5 风险工作台** — 风险列表/详情/处理
|
||
|
||
### 已完成
|
||
|
||
| 任务 | 状态 | 验证结果 |
|
||
|---|---|---|
|
||
| T1.1 认证与权限 | ✅ | 11 tests + 权限中间件 5 tests + 登录页 |
|
||
| T1.2 企业档案 CRUD | ✅ | 11 tests + 列表/详情页 |
|
||
| T1.3 月报管理 + AI 解析 | ✅ | 7 tests + 千问 SSE 流式解析 + 创始人提交页 + 投资人解析页 |
|
||
| T1.4 健康度评分 | ✅ | 4 + 8 tests + 四维计算引擎 + 雷达图/仪表盘/趋势图 |
|
||
| T1.5 投资机构驾驶舱 | ✅ | 4 tests + KPI + HealthDistribution + RiskSummary |
|
||
| T1.6 风险预警 | ✅ | 6 + 8 tests + 自动检测引擎（6 条规则）+ 风险工作台 |
|
||
| T1.7 投后报告 | ✅ | 3 tests + 报告汇总 API + JSON 导出 |
|
||
| T1.8 移动端适配 | ✅ | Copilot 浮动窗口 + 响应式布局 |
|
||
| T0.4 补全 | ✅ | docker-compose.dev.yml |
|
||
|
||
### Phase 1 总计
|
||
|
||
- **后端测试**：67 tests passed
|
||
- auth 11 + companies 11 + reports 7 + dashboard 4 + risks 6 + health 4
|
||
- health_calculator 8 + risk_engine 8 + permissions 5 + report_export 3
|
||
- **前端路由**：14 个页面全部构建成功
|
||
- **API 端点**：auth(4) + companies(5) + reports(7) + dashboard(2) + risks(5) + copilot(1) + reports_export(2) = 26 个
|
||
- **AI 服务**：千问 DashScope SSE 流式输出（月报解析 + Copilot 对话）
|
||
- **Git 提交**：7ec4fb0 / 53ae205 / 63031dd
|