From 2c429ca1a20f530cd1c9c148a6ece7cf280e6f91 Mon Sep 17 00:00:00 2001
From: selfrelease <freedak.ipad@gmail.com>
Date: Sat, 18 Jul 2026 22:31:16 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20Phase=202=20+=20Phase=203=20=E5=AE=8C?=
 =?UTF-8?q?=E6=95=B4=E8=A7=84=E5=88=92?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Phase 2（深度功能 + 管理后台，~6 周）:
- T2.1 企业详情工作台（多 Tab + 图表 + AI 建议抽屉 + 时间线）
- T2.2 Admin 管理后台（租户/用户/审计日志）
- T2.3 月报文件上传 + PDF 导出
- T2.4 创始人端完善（大数字卡片 + AI 辅助填充）
- T2.5 审计日志 + Redis 缓存
- T2.6 驾驶舱增强（热力图 + 多企业趋势对比）

Phase 3（智能化 + 生态扩展，~10 周）:
- T3.1 RAG 知识库 + 语义搜索（PgVector）
- T3.2 智能预警 + 预测分析
- T3.3 多源数据接入（Crunchbase/工商/GitHub）
- T3.4 协作闭环 + 任务管理（Kanban + 评论 + 通知）
- T3.5 数据安全 + 合规加固（2FA/限流/脱敏/加密）
- T3.6 投后报告增强 + 定期推送（AI 季度报告 + 邮件推送）
---
 docs/2-task.md | 183 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 183 insertions(+)

diff --git a/docs/2-task.md b/docs/2-task.md
index 15c8ec9..65704c2 100644
--- a/docs/2-task.md
+++ b/docs/2-task.md
@@ -145,3 +145,186 @@ T1.8 依赖 T1.1-T1.7 全部完成
 | M2：月报 + 健康度 | T1.3-T1.4 | 2 周 |
 | M3：驾驶舱 + 风险 | T1.5-T1.6 | 1 周 |
 | M4：报告 + 移动端 | T1.7-T1.8 | 1 周 |
+
+---
+
+## Phase 2：深度功能 + 管理后台
+
+> 目标：从 MVP 走向可用产品 — 企业详情工作台、Admin 后台、文件上传、创始人端完善、审计日志、Redis 缓存
+
+### T2.1 企业详情工作台（投资人端核心页面）
+- [ ] `frontend/src/app/(investor)/companies/[id]/workbench/page.tsx`（工作台主页）
+- [ ] `frontend/src/components/workbench/TabNav.tsx`（左侧 Tab 导航：概览/财务/经营/组织/AI+专项/风险/月报）
+- [ ] `frontend/src/components/workbench/FinancialTab.tsx`（财务面板：营收/现金流/跑道 图表）
+- [ ] `frontend/src/components/workbench/OperationalTab.tsx`（经营面板：关键指标趋势）
+- [ ] `frontend/src/components/workbench/OrgTab.tsx`（组织面板：团队规模/流失率）
+- [ ] `frontend/src/components/workbench/AITab.tsx`（AI+专项面板：商业化/成本效率）
+- [ ] `frontend/src/components/workbench/AISuggestionDrawer.tsx`（右侧 AI 建议抽屉）
+- [ ] `frontend/src/components/workbench/PostInvestTimeline.tsx`（底部投后管理时间线）
+- [ ] `backend/app/routers/companies.py` 补充 `GET /companies/{id}/detail`（聚合月报+评分+风险）
+- [ ] `backend/tests/test_company_detail.py`（聚合接口测试）
+- 验证：进入企业详情 → 多 Tab 切换 → 图表展示 → AI 建议抽屉 → 时间线
+
+### T2.2 Admin 管理后台
+- [ ] `backend/app/routers/admin.py`（租户 CRUD + 用户管理 + 审计日志查询）
+- [ ] `backend/app/schemas/admin.py`（Admin 请求/响应 schema）
+- [ ] `backend/app/core/audit.py`（审计日志写入中间件 — 自动记录关键操作）
+- [ ] `backend/tests/test_admin.py`（Admin API 测试）
+- [ ] `frontend/src/app/admin/page.tsx`（重写：管理后台首页 — 系统概览卡片）
+- [ ] `frontend/src/app/admin/tenants/page.tsx`（租户管理列表）
+- [ ] `frontend/src/app/admin/users/page.tsx`（用户管理列表 + 角色分配）
+- [ ] `frontend/src/app/admin/audit-logs/page.tsx`（审计日志查看 + 筛选）
+- [ ] `frontend/src/lib/admin.ts`（Admin API 函数）
+- 验证：Admin 登录 → 查看租户列表 → 管理用户角色 → 查看审计日志
+
+### T2.3 月报文件上传 + PDF 导出
+- [ ] `backend/app/services/file_parser.py`（Excel/PDF 文件解析 → 文本提取）
+- [ ] `backend/app/routers/reports.py` 补充 `POST /reports/upload`（文件上传 → 解析 → AI 分析）
+- [ ] `backend/app/services/pdf_generator.py`（weasyprint 生成 PDF 报告）
+- [ ] `backend/app/routers/reports_export.py` 补充 `GET /reports-export/{id}/pdf`（真实 PDF 导出）
+- [ ] `backend/tests/test_file_upload.py`（上传解析测试）
+- [ ] `frontend/src/app/(founder)/reports/submit/page.tsx` 增强（支持文件上传 + 拖拽）
+- [ ] `frontend/src/components/shared/FileUploader.tsx`（文件上传组件）
+- [ ] `frontend/src/app/(investor)/reports/view/[id]/page.tsx` 增强（PDF 导出按钮 → 真实 PDF）
+- 验证：上传 Excel → AI 解析 → 投资人查看 → 导出 PDF
+
+### T2.4 创始人端完善
+- [ ] `backend/app/routers/founder.py`（创始人专属 API：经营概览数据 + 自身健康度）
+- [ ] `frontend/src/app/founder/page.tsx` 重写（经营概览：大数字卡片 + 指标趋势图）
+- [ ] `frontend/src/components/founder/MetricCard.tsx`（大数字指标卡片：Runway/MRR/客户数/健康度）
+- [ ] `frontend/src/components/founder/MetricTrendChart.tsx`（指标趋势折线图）
+- [ ] `frontend/src/app/founder/reports/submit/page.tsx` 增强（AI 辅助填充：上传文件 → 自动建议值）
+- [ ] `frontend/src/app/founder/copilot/page.tsx`（独立 AI 副驾驶页面 + 快捷问题按钮）
+- [ ] `frontend/src/components/founder/QuickQuestions.tsx`（快捷问题："投资人关心什么"/"融资建议"/"组织诊断"）
+- [ ] `backend/tests/test_founder.py`（创始人 API 测试）
+- 验证：创始人登录 → 概览大数字 → 提交月报（AI 辅助）→ AI 副驾驶问答
+
+### T2.5 审计日志 + Redis 缓存
+- [ ] `backend/app/core/audit.py`（审计日志装饰器/中间件 — 自动记录 CREATE/UPDATE/DELETE）
+- [ ] `backend/app/core/redis.py`（Redis 连接 + 缓存工具函数）
+- [ ] `backend/app/core/cache.py`（缓存装饰器 — 仪表盘/企业列表等热点接口）
+- [ ] `backend/app/routers/admin.py` 补充 `GET /admin/audit-logs`（审计日志查询 + 筛选）
+- [ ] `backend/tests/test_audit.py`（审计日志写入测试）
+- 验证：关键操作 → audit_logs 自动写入 → Admin 可查看 → Redis 缓存命中
+
+### T2.6 驾驶舱增强
+- [ ] `frontend/src/app/(investor)/dashboard/page.tsx` 增强（集成 HealthDistribution + RiskSummary + AIWeeklyBrief）
+- [ ] `frontend/src/components/dashboard/PortfolioHeatmap.tsx`（企业 × 维度健康度热力图）
+- [ ] `frontend/src/components/dashboard/MultiCompanyTrend.tsx`（多企业健康度趋势对比 sparkline）
+- [ ] `backend/app/routers/dashboard.py` 补充 `GET /dashboard/heatmap`（热力图数据）
+- [ ] `backend/app/routers/dashboard.py` 补充 `GET /dashboard/trends`（多企业趋势数据）
+- 验证：驾驶舱 → 热力图 → 趋势对比 → AI 周报 → 风险概览
+
+---
+
+## Phase 3：智能化 + 生态扩展
+
+> 目标：从规则驱动走向 AI 深度赋能 — RAG 知识库、智能预警、多源数据接入、协作闭环、数据安全加固
+
+### T3.1 RAG 知识库 + 语义搜索
+- [ ] `backend/app/services/embedding.py`（文本向量化 — 调用千问 embedding API）
+- [ ] `backend/app/models/knowledge.py`（KnowledgeChunk 模型 — 存储向量化的月报/报告片段）
+- [ ] `backend/alembic/versions/xxx_add_pgvector.py`（PgVector 扩展迁移）
+- [ ] `backend/app/services/rag.py`（RAG 检索服务 — 语义搜索 + 上下文注入）
+- [ ] `backend/app/routers/knowledge.py`（知识库 API：搜索/上传/管理）
+- [ ] `backend/tests/test_rag.py`（RAG 检索测试）
+- [ ] `frontend/src/components/shared/KnowledgeSearch.tsx`（语义搜索组件）
+- [ ] AI Copilot 增强：对话时自动 RAG 检索相关历史月报/报告，注入上下文
+- 验证：搜索"跑道不足" → 返回所有相关月报片段 → Copilot 对话引用历史数据
+
+### T3.2 智能预警 + 预测分析
+- [ ] `backend/app/services/predictor.py`（趋势预测 — 基于历史评分预测未来 3 月健康度）
+- [ ] `backend/app/services/anomaly_detector.py`（异常检测 — 统计方法识别指标突变）
+- [ ] `backend/app/services/risk_engine.py` 增强（弱信号关联 — 多指标交叉检测）
+- [ ] `backend/app/routers/dashboard.py` 补充 `GET /dashboard/forecasts`（预测数据）
+- [ ] `frontend/src/components/dashboard/ForecastChart.tsx`（预测趋势图 — 含置信区间）
+- [ ] `frontend/src/components/risk/WeakSignalPanel.tsx`（弱信号关联面板）
+- [ ] `backend/tests/test_predictor.py`（预测引擎测试）
+- 验证：健康度预测曲线 → 异常指标标红 → 弱信号关联风险自动生成
+
+### T3.3 多源数据接入
+- [ ] `backend/app/services/data_connectors/`（数据连接器框架）
+- [ ] `backend/app/services/data_connectors/crunchbase.py`（Crunchbase API — 融资信息同步）
+- [ ] `backend/app/services/data_connectors/alphaess.py`（企业工商数据 — 天眼查/企查查 API）
+- [ ] `backend/app/services/data_connectors/github.py`（GitHub 活跃度 — 开源项目监控）
+- [ ] `backend/app/models/data_source.py`（DataSource 模型 — 记录外部数据源配置和同步状态）
+- [ ] `backend/app/routers/data_sources.py`（数据源管理 API — 配置/同步/查看）
+- [ ] `frontend/src/app/(investor)/companies/[id]/data-sources/page.tsx`（数据源配置页）
+- [ ] `frontend/src/components/company/DataSourceCard.tsx`（数据源卡片 — 状态/最后同步时间）
+- [ ] `backend/tests/test_data_connectors.py`（连接器测试 — mock 外部 API）
+- 验证：配置 Crunchbase API → 同步融资数据 → 企业详情页展示外部数据
+
+### T3.4 协作闭环 + 任务管理
+- [ ] `backend/app/models/task.py`（Task 模型 — 投后任务/待办/跟进项）
+- [ ] `backend/app/models/comment.py`（Comment 模型 — 月报评论/风险评论）
+- [ ] `backend/app/routers/tasks.py`（任务 CRUD + 分配 + 状态流转）
+- [ ] `backend/app/routers/comments.py`（评论 CRUD — 月报/风险/企业维度）
+- [ ] `backend/app/services/notification.py`（通知服务 — 邮件/站内信/Webhook）
+- [ ] `backend/tests/test_tasks.py` + `backend/tests/test_comments.py`
+- [ ] `frontend/src/app/(investor)/tasks/page.tsx`（任务看板 — Kanban 视图）
+- [ ] `frontend/src/components/shared/CommentThread.tsx`（评论组件 — 月报/风险下方）
+- [ ] `frontend/src/components/shared/NotificationBell.tsx`（通知铃铛 — Header 右侧）
+- 验证：风险事件 → 创建跟进任务 → 分配给投资人 → 评论协作 → 完成闭环
+
+### T3.5 数据安全 + 合规加固
+- [ ] `backend/app/core/security.py` 增强（JWT refresh token 轮转 + 黑名单）
+- [ ] `backend/app/core/rate_limit.py`（限流中间件 — 登录 5 次/min + 写接口按用户限流）
+- [ ] `backend/app/core/data_masking.py`（PII 脱敏 — 手机/邮箱/身份证 日志脱敏）
+- [ ] `backend/app/core/encryption.py`（敏感字段加密存储 — API Key/外部凭证）
+- [ ] `backend/app/routers/auth.py` 增强（2FA 支持 — TOTP）
+- [ ] `backend/tests/test_security.py`（安全测试 — 限流/脱敏/加密/2FA）
+- [ ] `frontend/src/app/(investor)/settings/page.tsx`（设置页 — 修改密码/2FA 配置/API Key 管理）
+- [ ] `frontend/src/components/shared/TwoFactorSetup.tsx`（2FA 设置组件 — QR 码）
+- 验证：登录限流 → 2FA 验证 → PII 脱敏日志 → 加密存储 → refresh token 轮转
+
+### T3.6 投后报告增强 + 定期推送
+- [ ] `backend/app/services/report_generator.py`（AI 报告生成 — 季度/年度报告自动生成）
+- [ ] `backend/app/services/scheduler.py`（定时任务 — 月报提醒/报告生成/风险扫描）
+- [ ] `backend/app/services/email_sender.py`（邮件发送 — 报告推送/风险预警通知）
+- [ ] `backend/app/routers/reports_export.py` 增强（PDF 模板 — 封面/目录/图表/建议）
+- [ ] `backend/tests/test_report_generator.py`
+- [ ] `frontend/src/app/(investor)/reports/templates/page.tsx`（报告模板选择页）
+- [ ] `frontend/src/components/report/ReportPreview.tsx`（报告预览组件 — 浏览器打印优化）
+- 验证：选择企业 → 选择模板 → AI 生成报告 → 预览 → 导出 PDF → 邮件推送
+
+---
+
+## Phase 2 依赖关系
+
+```
+T2.1（企业详情工作台）→ T2.6（驾驶舱增强）
+T2.2（Admin 后台）→ T2.5（审计日志）
+T2.3（文件上传 + PDF）独立
+T2.4（创始人端完善）独立
+T2.5（审计 + Redis）→ T2.2
+```
+
+## Phase 3 依赖关系
+
+```
+T3.1（RAG）→ T3.2（智能预警 — RAG 提供上下文）
+T3.3（多源数据）独立
+T3.4（协作闭环）独立
+T3.5（安全加固）独立
+T3.6（报告增强）依赖 T3.1（RAG 引用历史数据）
+```
+
+## Phase 2 里程碑
+
+| 里程碑 | 任务 | 预期 |
+|---|---|---|
+| M5：企业工作台 | T2.1 + T2.6 | 2 周 |
+| M6：Admin + 审计 | T2.2 + T2.5 | 1.5 周 |
+| M7：文件上传 + PDF | T2.3 | 1 周 |
+| M8：创始人端 | T2.4 | 1 周 |
+
+## Phase 3 里程碑
+
+| 里程碑 | 任务 | 预期 |
+|---|---|---|
+| M9：RAG 知识库 | T3.1 | 2 周 |
+| M10：智能预警 | T3.2 | 2 周 |
+| M11：多源数据 | T3.3 | 1.5 周 |
+| M12：协作闭环 | T3.4 | 2 周 |
+| M13：安全加固 | T3.5 | 1 周 |
+| M14：报告增强 | T3.6 | 1.5 周 |