AIPortPilot/docs/2-task.md

# 任务清单 (2-task)

> 粒度：每个任务 2-5 分钟
> 状态标记：[ ] 待办 / [~] 进行中 / [x] 完成 / [!] 阻塞

---

## Phase 0：项目骨架

### T0.1 项目目录结构
- [x] 创建 `frontend/` `backend/` `docs/daily/` `docs/decisions/` 目录
- [x] 创建 `.gitignore`（Python + Node + IDE + .env）
- [x] 创建 `.env.example`
- 验证：目录结构正确

### T0.2 后端项目初始化
- [x] `backend/pyproject.toml`（FastAPI + SQLAlchemy + Alembic + Pydantic + pytest）
- [x] `backend/app/__init__.py`
- [x] `backend/app/main.py`（FastAPI app 实例 + 健康检查 `/health`）
- [x] `backend/app/core/config.py`（环境变量配置）
- [x] `backend/app/core/database.py`（SQLAlchemy engine + session）
- [x] `backend/tests/__init__.py`
- [x] `backend/tests/test_health.py`（4 个测试全部 GREEN）
- 验证：`pytest tests/test_health.py -v` → 4 passed

### T0.3 前端项目初始化
- [x] `npx create-next-app@latest frontend`（TypeScript + TailwindCSS 4 + App Router）
- [x] 安装 lucide-react + recharts + sonner + radix-ui + cva + clsx + tailwind-merge
- [x] 配置 `globals.css`（oklch 色彩、系统字体、`--radius: 0.625rem`、打印样式）
- [x] 创建三端布局：`(investor)` 路由组 + `founder/` + `admin/` 目录
- [x] 创建共享组件：`LoadingSpinner` / `EmptyState` / `HealthScoreBadge`
- [x] 创建 `lib/utils.ts`（cn 函数）+ `lib/api.ts`（API 客户端）
- 验证：`pnpm build` → 8 路由全部构建成功

### T0.4 Docker Compose 开发环境
- [x] `docker-compose.yml`（PostgreSQL 16 + Redis 7 + Ollama）
- [x] `backend/Dockerfile`
- [x] `frontend/Dockerfile`
- [x] `docker-compose.dev.yml`（开发覆盖：挂载源码 + hot reload）
- 验证：`docker compose up -d` 全部 healthy

### T0.5 数据库迁移基座
- [x] `backend/alembic.ini`
- [x] `backend/alembic/` 初始化
- [x] 首个 migration：创建 7 张核心表（tenants/users/companies/monthly_reports/health_scores/risk_events/audit_logs）
- 验证：`alembic upgrade head` 成功，`\dt` 显示 8 张表

---

## Phase 1：MVP 核心功能

### T1.1 认证与权限
- [x] `backend/app/models/user.py`（User + Role + Tenant）
- [x] `backend/app/routers/auth.py`（登录 / 注册 / refresh token）
- [x] `backend/app/core/security.py`（JWT + 密码哈希）
- [x] `backend/app/core/permissions.py`（角色级 + 字段级权限中间件）
- [x] `backend/tests/test_auth.py`（11 tests GREEN）
- [x] `frontend/src/app/login/page.tsx`（登录表单 + AuthProvider）
- [x] `frontend/src/lib/auth-context.tsx`（token 管理 + 自动恢复）
- 验证：登录 → 获取 token → 访问受保护 API ✅

### T1.2 企业档案管理
- [x] `backend/app/models/company.py`（CompanyProfile）
- [x] `backend/app/routers/companies.py`（CRUD + 筛选 + 分页）
- [x] `backend/app/schemas/company.py`（Pydantic schema）
- [x] `backend/tests/test_companies.py`（11 tests GREEN）
- [x] `frontend/src/app/(investor)/companies/page.tsx`（列表 + 搜索 + 分页）
- [x] `frontend/src/app/(investor)/companies/[id]/page.tsx`（详情页）
- [x] `frontend/src/components/company/CompanyCard.tsx`（独立组件抽取）
- 验证：创建企业 → 列表显示 → 详情页可访问 ✅

### T1.3 月报管理 + AI 解析
- [x] `backend/app/models/report.py`（MonthlyReport）
- [x] `backend/app/routers/reports.py`（CRUD + 提交）
- [x] `backend/app/services/ai_parser.py`（千问 LLM 流式解析）
- [x] `backend/app/schemas/report.py`
- [x] `backend/tests/test_reports.py`（7 tests GREEN）
- [x] `frontend/src/app/(founder)/reports/submit/page.tsx`（创始人提交月报）
- [x] `frontend/src/app/(investor)/reports/page.tsx`（投资人查看月报）
- [x] `frontend/src/app/(investor)/reports/[id]/page.tsx`（AI 解析页 SSE 流式）
- [x] `backend/app/services/report_tracker.py`（月报提交及时性追踪 — 统计提交延迟天数 + 数据质量评分）
- [x] `backend/app/routers/reports.py` 增强（新增 `/reports/timeliness` 端点 — 按企业/月份统计提交及时性和数据完整度）
- [x] `frontend/src/components/report/TimelinessPanel.tsx`（提交及时性面板 — 延迟热力图 + 数据质量评分卡）
- 验证：CRUD + 提交 + AI 解析 + 及时性追踪 ✅

### T1.4 健康度评分
- [x] `backend/app/models/health_score.py`（HealthScore）
- [x] `backend/app/services/health_calculator.py`（四维评分：财务/经营/AI商业化/AI成本）
- [x] `backend/app/routers/dashboard.py`（聚合查询 + 评分列表）
- [x] `backend/tests/test_dashboard.py`（4 tests GREEN）+ `test_health_calculator.py`（8 tests GREEN）
- [x] `frontend/src/components/health/HealthGauge.tsx`（仪表盘组件）
- [x] `frontend/src/components/health/HealthRadar.tsx`（雷达图组件）
- [x] `frontend/src/components/health/HealthTrend.tsx`（趋势 sparkline）
- 验证：自动算分 + 图表 ✅

### T1.5 投资机构驾驶舱
- [x] `backend/app/routers/dashboard.py`（聚合数据接口）
- [x] `backend/tests/test_dashboard.py`（4 tests GREEN）
- [x] `frontend/src/app/(investor)/dashboard/page.tsx`（驾驶舱首页 KPI + 概览）
- [x] `frontend/src/components/dashboard/HealthDistribution.tsx`
- [x] `frontend/src/components/dashboard/RiskSummary.tsx`
- [x] `frontend/src/components/dashboard/AIWeeklyBrief.tsx`
- 验证：驾驶舱 + 高级组件 + AI 周报 ✅

### T1.6 风险预警
- [x] `backend/app/models/risk.py`（RiskEvent）
- [x] `backend/app/services/risk_engine.py`（指标越界检测引擎，6 条规则）
- [x] `backend/app/routers/risks.py`（列表 / 更新 / 删除）
- [x] `backend/tests/test_risks.py`（6 tests GREEN）+ `test_risk_engine.py`（8 tests GREEN）
- [x] `frontend/src/app/(investor)/risks/page.tsx`（风险工作台）
- [x] `frontend/src/components/risk/RiskCard.tsx` + `RiskTimeline.tsx`
- 验证：CRUD + 状态流转 + 自动检测 ✅

### T1.7 投后报告
- [x] `backend/app/routers/reports_export.py`（报告汇总 + JSON 导出）
- [x] `backend/tests/test_report_export.py`（3 tests GREEN）
- [x] `frontend/src/app/(investor)/reports/view/[id]/page.tsx`（前端报告查看页）
- 验证：API 导出 + 前端报告页 ✅

### T1.8 移动端适配
- [x] 投资人端响应式：< md Sidebar 折叠为顶部 Header（已有）
- [x] 创始人端移动布局：卡片流 + 底部导航
- [x] AI Copilot 浮动对话窗口（底部抽屉式）
- [x] 风险预警 toast 推送
- 验证：三端布局 + Copilot + toast ✅

---

## 依赖关系

```
T0.1 → T0.2 → T0.5 → T1.1 → T1.2 → T1.3 → T1.4 → T1.5
                                    ↓
                                   T1.6 → T1.7
                                   
T0.3 → T1.2（前端依赖）
T0.4 → T0.5（DB 依赖 Docker）

T1.8 依赖 T1.1-T1.7 全部完成
```

## 里程碑

| 里程碑 | 任务 | 预期 |
|---|---|---|
| M0：骨架可运行 | T0.1-T0.5 | 1 周 |
| M1：认证 + 企业档案 | T1.1-T1.2 | 1 周 |
| M2：月报 + 健康度 | T1.3-T1.4 | 2 周 |
| M3：驾驶舱 + 风险 | T1.5-T1.6 | 1 周 |
| M4：报告 + 移动端 | T1.7-T1.8 | 1 周 |

---

## Phase 2：数据接入与智能校验

> 对应 v2.0 §17.2 第二期
> 目标：从 MVP 走向可用产品 — 财务数据校验、投资协议解析、董事会管理、弱信号增强、决策前哨、多主体画像、健康度维度扩展、Admin 后台、企业详情工作台

### T2.1 企业详情工作台（投资人端核心页面）
- [x] `frontend/src/app/(investor)/companies/[id]/workbench/page.tsx`（工作台主页）
- [x] `frontend/src/components/workbench/TabNav.tsx`（左侧 Tab 导航：概览/财务/经营/组织/AI+专项/风险/月报/董事会/协议/协同）
- [x] `frontend/src/components/workbench/FinancialTab.tsx`（财务面板：营收/现金流/跑道 图表）
- [x] `frontend/src/components/workbench/OperationalTab.tsx`（经营面板：关键指标趋势）
- [x] `frontend/src/components/workbench/OrgTab.tsx`（组织面板：团队规模/流失率）
- [x] `frontend/src/components/workbench/AITab.tsx`（AI+专项面板：商业化/成本效率）
- [x] `frontend/src/components/workbench/AISuggestionDrawer.tsx`（右侧 AI 建议抽屉 + 待办 + 弱信号预警）
- [x] `frontend/src/components/workbench/PostInvestTimeline.tsx`（底部投后管理时间线）
- [x] `backend/app/routers/companies.py` 补充 `GET /companies/{id}/detail`（聚合月报+评分+风险+弱信号）
- [x] `backend/tests/test_company_detail.py`（聚合接口测试）
- 验证：工作台为独立 Tab 组件，依赖各模块 API 就绪后集成 ✅

### T2.2 财务数据接入与自动校验
- [x] `backend/app/models/financial_data.py`（FinancialData 模型 — 资产负债表/利润表/现金流量表/科目余额）
- [x] `backend/app/services/financial_validator.py`（AI 数据校验 Agent — 交叉验证/逻辑矛盾检测/历史修订追踪）
- [x] `backend/app/routers/financial.py`（财务数据 CRUD + 校验结果查询）
- [x] `backend/app/services/ai_parser.py` 增强（支持财务报表 Excel/PDF 解析）
- [x] `backend/tests/test_financial_validator.py`（校验逻辑测试）
- [x] `frontend/src/app/(investor)/financial/page.tsx`（财务数据校验页 — 列表 + 可信度评分）
- 验证：后端 API + 前端页面 ✅；Excel 解析 + 测试（待补充）

### T2.3 投资协议解析与条款监控
- [x] `backend/app/models/agreement.py`（InvestmentAgreement 模型 — 协议条款/监控规则）
- [x] `backend/app/services/agreement_parser.py`（AI 投资协议 Agent — 解析 PDF → 提取关键条款）
- [x] `backend/app/services/agreement_monitor.py`（条款监控引擎 — 持续监控触发条件）
- [x] `backend/app/routers/agreements.py`（协议 CRUD + 条款预警列表）
- [x] `backend/tests/test_agreement_parser.py` + `test_agreement_monitor.py`
- [x] `frontend/src/app/(investor)/agreements/page.tsx`（投资协议管理页 — 列表 + 状态）
- 验证：后端 API + 前端页面 ✅；测试（待补充）

### T2.4 董事会管理
- [x] `backend/app/models/board.py`（BoardMeeting 模型 — 议程/纪要/决议/待办）
- [x] `backend/app/services/board_agent.py`（AI 董事会 Agent — 会前材料摘要/决议追踪/提问清单）
- [x] `backend/app/routers/board.py`（董事会 CRUD + 决议追踪）
- [x] `backend/tests/test_board.py`
- [x] `frontend/src/app/(investor)/board/page.tsx`（董事会管理页 — 会议列表 + 状态）
- 验证：后端 API + 前端页面 ✅；测试（待补充）

### T2.5 弱信号采集（增强版）+ 关联引擎
- [x] `backend/app/models/weak_signal.py`（WeakSignal 模型 — 信号类型/来源/置信度）
- [x] `backend/app/services/weak_signal_collector.py`（增强版采集器 — 技术/情绪/组织/市场 四类信号）
- [x] `backend/app/services/signal_correlator.py`（弱信号关联引擎 — 多源信号 → 跨维度/跨主体/跨时间关联 → 风险概率评估）
- [x] `backend/app/routers/weak_signals.py`（弱信号列表 + 关联结果查询）
- [x] `backend/tests/test_weak_signal.py` + `test_signal_correlator.py`
- [x] `frontend/src/app/(investor)/weak-signals/page.tsx`（弱信号监控页 — 四类信号 + 置信度 + 风险概率）
- 验证：后端 API + 前端页面 ✅；测试（待补充）

### T2.6 决策前哨（基础版）
- [x] `backend/app/models/decision_sentinel.py`（DecisionSentinel 模型 — 决策类型/信号/场景分析）
- [x] `backend/app/services/decision_sentinel_agent.py`（AI 决策前哨 Agent — 识别关键决策点 → 场景分析）
- [x] `backend/app/routers/decision_sentinels.py`（决策前哨 CRUD + 场景分析查询）
- [x] `backend/tests/test_decision_sentinel.py`
- [x] `frontend/src/app/(investor)/sentinels/page.tsx`（决策前哨页 — 岔路口 + 状态）
- 验证：后端 API + 前端页面 ✅；测试（待补充）

### T2.7 重大事项自动识别 + 追问清单
- [x] `backend/app/models/major_event.py`（MajorEvent 模型）
- [x] `backend/app/models/inquiry.py`（InquiryList 模型 — 追问清单）
- [x] `backend/app/services/event_detector.py`（AI 重大事项识别 — 从月报/弱信号中提取）
- [x] `backend/app/services/inquiry_generator.py`（AI 追问清单生成 — 根据月报数据生成补充问题）
- [x] `backend/app/routers/events.py` + `backend/app/routers/inquiries.py`
- [x] `backend/tests/test_event_detector.py` + `test_inquiry_generator.py`
- [x] `frontend/src/app/(investor)/events/page.tsx`（重大事项 & 追问清单页 — 标签切换）
- 验证：后端 API + 前端页面 ✅；测试（待补充）

### T2.8 多主体画像（基础版）
- [x] `backend/app/models/firm_profile.py`（投资机构画像）
- [x] `backend/app/models/fund_profile.py`（基金画像）
- [x] `backend/app/models/manager_profile.py`（投资经理画像）
- [x] `backend/app/routers/profiles.py`（画像 CRUD + 关联查询）
- [x] `backend/tests/test_profiles.py`
- 验证：后端 API ✅；前端页面 + 测试（待补充）

### T2.9 健康度维度扩展
- [x] `backend/app/services/health_calculator.py` 增强（新增 5 维度：组织人才/产品技术/市场竞争/治理合规/融资资本）
- [x] `backend/app/models/health_score.py` 增强（扩展字段）
- [x] `backend/tests/test_health_calculator.py` 增强（新增维度测试）
- [x] `frontend/src/components/health/HealthRadar.tsx` 增强（支持 9 维度雷达图）
- [x] `frontend/src/components/health/HealthDimensionDetail.tsx`（维度详情面板 — 评分依据/扣分项/建议）
- 验证：月报提交 → 9 维度评分 → 雷达图展示 → 维度详情可查看 ✅

### T2.10 Admin 管理后台 + 审计日志 + Redis 缓存
- [x] `backend/app/routers/admin.py`（租户 CRUD + 用户管理 + 审计日志查询）
- [x] `backend/app/core/audit.py`（审计日志装饰器/中间件 — 自动记录 CREATE/UPDATE/DELETE）
- [x] `backend/app/core/redis.py`（Redis 连接 + 缓存工具函数）
- [x] `backend/app/core/cache.py`（缓存装饰器 — 仪表盘/企业列表等热点接口）
- [x] `backend/tests/test_admin.py` + `test_audit.py`
- [x] `frontend/src/app/admin/page.tsx`（管理后台首页 — 概览/租户/用户/审计标签页）
- 验证：后端 API + 前端页面 ✅；测试（待补充）

### T2.11 月报文件上传 + PDF 导出 + 创始人端完善
- [x] `backend/app/services/file_parser.py`（Excel/PDF 文件解析 → 文本提取）
- [x] `backend/app/routers/reports.py` 补充 `POST /reports/upload`（文件上传 → 解析 → AI 分析）
- [x] `backend/app/services/pdf_generator.py`（weasyprint 生成 PDF 报告）
- [x] `backend/app/routers/founder.py`（创始人专属 API：经营概览数据 + 自身健康度）
- [x] `backend/tests/test_file_upload.py`（5 tests GREEN）
- [x] `frontend/src/app/(founder)/reports/submit/page.tsx` 增强（支持文件上传 + 拖拽 + AI 辅助填充）
- [x] `frontend/src/components/shared/FileUploader.tsx`（文件上传组件）
- [x] `frontend/src/app/founder/page.tsx` 重写（经营概览 — 企业信息 + 健康度 + 最新月报）
- [x] `frontend/src/app/founder/copilot/page.tsx`（独立 AI 副驾驶页面）
- 验证：创始人端 API + 概览页 + Copilot + 文件上传 + PDF 导出 ✅

### T2.12 驾驶舱增强
- [x] `frontend/src/app/(investor)/dashboard/page.tsx` 增强（集成 HealthDistribution + RiskSummary + AIWeeklyBrief）
- [x] `frontend/src/components/dashboard/PortfolioHeatmap.tsx`（企业 × 维度健康度热力图）
- [x] `frontend/src/components/dashboard/MultiCompanyTrend.tsx`（多企业健康度趋势对比 sparkline）
- [x] `backend/app/routers/dashboard.py` 补充 `GET /dashboard/heatmap` + `GET /dashboard/trends`
- 验证：驾驶舱 → 热力图 → 趋势对比 → AI 周报 → 风险概览 ✅

---

## Phase 3：Portfolio 协同与增长引擎

> 对应 v2.0 §17.3 第三期
> 目标：从单企业管理走向组合协同 — 协同机会中心、组合创新实验室、人才引力场、客户增长引擎、创始人 AI 副驾驶完整版、OKR 对齐、行为助推、Peer Learning、产品诊断、里程碑动态管理

### T3.1 协同机会中心
- [x] `backend/app/models/synergy.py`（SynergyOpportunity 模型 — 类型/双方/状态/授权/效果评估）
- [x] `backend/app/services/synergy_matcher.py`（AI 协同匹配 Agent — 需求分析 → Portfolio 内匹配 → 外部资源匹配）
- [x] `backend/app/routers/synergies.py`（协同 CRUD + 授权管理 + 效果评估）
- [x] `backend/tests/test_synergy.py`
- [x] `frontend/src/app/(investor)/synergies/page.tsx`（协同机会中心页 — 列表 + 授权操作）
- 验证：后端 API + 前端页面 ✅；测试（待补充）

### T3.2 组合创新实验室
- [x] `backend/app/services/innovation_lab.py`（AI 组合创新 Agent — 能力分析 → 组合发现 → 联合产品方案）
- [x] `backend/app/routers/innovation.py`（创新机会 CRUD + 方案生成）
- [x] `backend/tests/test_innovation_lab.py`
- [x] `frontend/src/app/(investor)/innovation/page.tsx`（组合创新实验室页 — 输入能力 → AI 发现机会）
- 验证：后端 API + 前端页面 ✅；测试（待补充）

### T3.3 人才引力场
- [x] `backend/app/models/talent.py`（TalentProfile + TeamMemberProfile 模型）
- [x] `backend/app/services/talent_agent.py`（AI 人才引力场 Agent — 人才流动预测 + 主动推荐 + 9-Box 矩阵）
- [x] `backend/app/routers/talents.py`（人才池 CRUD + 流动预测 + 推荐列表）
- [x] `backend/tests/test_talent_agent.py`
- [x] `frontend/src/app/(investor)/talents/page.tsx`（人才池页 — 列表 + 绩效/潜力/9-Box/状态）
- 验证：后端 API + 前端页面 ✅；测试（待补充）

### T3.4 客户增长引擎
- [x] `backend/app/models/customer_plan.py`（CustomerAcquisitionPlan 模型）
- [x] `backend/app/services/customer_growth_agent.py`（AI 客户增长 Agent — LP 资源匹配 + 客户获取方案生成）
- [x] `backend/app/routers/customer_plans.py`（客户获取方案 CRUD + 执行追踪）
- [x] `backend/tests/test_customer_growth.py`（4 tests GREEN）
- [x] `frontend/src/app/(investor)/customer-growth/page.tsx`（客户增长引擎页）
- [x] `frontend/src/components/customer/PlanCard.tsx`（客户获取方案卡片 — 切入角度/决策链/定价/竞争分析）
- 验证：AI 分析 LP 资源 + Portfolio 客户网络 → 生成客户获取方案 → 追踪执行结果 ✅

### T3.5 创始人 AI 副驾驶（完整版）
- [x] `backend/app/services/founder_copilot.py`（AI 副驾驶完整版 — 融资规划/组织诊断/投资人沟通/战略规划/月报自动生成）
- [x] `backend/app/routers/founder.py` 增强（融资建议 API + 组织诊断 API + 投资人沟通准备 API）
- [x] `backend/tests/test_founder_copilot.py`（6 tests GREEN）
- [x] `frontend/src/app/founder/copilot/page.tsx` 增强（融资规划工具 + 组织诊断工具 + 投资人沟通准备）
- [x] `frontend/src/components/founder/CopilotTools.tsx`（融资规划/组织诊断/投资人沟通准备组件）
- 验证：创始人使用 AI 副驾驶 → 融资规划 → 组织诊断 → 投资人沟通准备 ✅

### T3.6 OKR 对齐引擎
- [x] `backend/app/models/okr.py`（OKR 模型 — 季度/目标/关键结果/对齐度评分）
- [x] `backend/app/services/okr_agent.py`（AI OKR Agent — 共同制定 + KR 追踪 + 偏差预警 + 对齐度评分）
- [x] `backend/app/routers/okrs.py`（OKR CRUD + 进展追踪 + 复盘报告）
- [x] `backend/tests/test_okr.py`
- [x] `frontend/src/app/(investor)/okrs/page.tsx`（OKR 管理页 — 列表 + 对齐度 + KR 进展）
- 验证：后端 API + 前端页面 ✅；测试（待补充）

### T3.7 行为助推引擎
- [x] `backend/app/models/nudge.py`（NudgeRecord 模型 — 类型/上下文/接受/效果）
- [x] `backend/app/services/nudge_agent.py`（AI 行为助推 Agent — 时机判断 + 策略选择 + 效果追踪）
- [x] `backend/app/routers/nudges.py`（助推记录 CRUD + 效果分析）
- [x] `backend/tests/test_nudges.py`（4 tests GREEN）
- [x] `frontend/src/app/(investor)/nudges/page.tsx`（行为助推引擎页）
- [x] `frontend/src/components/shared/NudgeBanner.tsx`（助推横幅 — 锚定/损失厌恶/社会证明/默认/时机）
- 验证：AI 判断时机 → 选择助推策略 → 推送 → 追踪接受率和效果 ✅

### T3.8 Peer Learning Circles
- [x] `backend/app/models/peer_circle.py`（PeerLearningCircle 模型）
- [x] `backend/app/services/peer_matching.py`（AI 匹配 3-5 位面临类似挑战的创始人）
- [x] `backend/app/routers/peer_circles.py`（Circle CRUD + 讨论记录）
- [x] `backend/tests/test_peer_circles.py`（3 tests GREEN）
- [x] `frontend/src/app/(investor)/peer-circles/page.tsx`（Peer Learning Circle 页）
- [x] `frontend/src/components/peer/CircleCard.tsx`（Circle 卡片 — 话题/成员/讨论框架/行动承诺）
- 验证：AI 匹配创始人 → 结构化讨论 → 记录结论 → 3 月后 AAR 联动 ✅

### T3.9 AI 产品竞争力诊断
- [x] `backend/app/models/product_diagnostic.py`（ProductDiagnostic 模型）
- [x] `backend/app/services/product_diagnostic_agent.py`（AI 产品诊断 Agent — 体验产品 + 竞品对比 + 热力图）
- [x] `backend/app/routers/product_diagnostics.py`
- [x] `backend/tests/test_product_diagnostics.py`（4 tests GREEN）
- [x] `frontend/src/app/(investor)/product-diagnostics/page.tsx`（产品竞争力诊断页）
- [x] `frontend/src/components/diagnostic/Heatmap.tsx`（产品竞争力热力图）
- 验证：AI 体验产品 → 对比竞品 → 生成热力图 → 建议路线图调整 ✅

### T3.10 里程碑动态管理
- [x] `backend/app/models/milestone.py`（MilestoneTree 模型 — 分支路径/当前路径）
- [x] `backend/app/services/milestone_agent.py`（AI 里程碑 Agent — 环境变化 → 路径切换建议 → 未完成分析）
- [x] `backend/app/routers/milestones.py`
- [x] `backend/tests/test_milestone.py`
- [x] `frontend/src/app/(investor)/milestones/page.tsx`（里程碑树页 — 按企业查询 + 路径/状态）
- 验证：后端 API + 前端页面 ✅；测试（待补充）

### T3.11 协同与赋能健康度 + AI+ 专项健康度扩展
- [x] `backend/app/services/health_calculator.py` 增强（协同赋能维度 + AI+ 模型产品/数据合规/团队技术 3 维度）
- [x] `backend/tests/test_health_calculator.py` 增强
- [x] `frontend/src/components/health/HealthRadar.tsx` 增强（支持 14 维度雷达图）
- [x] `frontend/src/app/(investor)/companies/[id]/ai-metrics/page.tsx`（AI+ 专项指标看板页）
- [x] `frontend/src/components/ai-metrics/CommercialDashboard.tsx`（商业化看板）
- [x] `frontend/src/components/ai-metrics/ModelDashboard.tsx`（模型与产品看板）
- [x] `frontend/src/components/ai-metrics/ComplianceDashboard.tsx`（数据与合规看板）
- 验证：14 维度健康度评分 → AI+ 专项看板展示 → 雷达图完整呈现 ✅

### T3.12 约束点识别 + 认知追踪 + 鸿沟诊断
- [x] `backend/app/services/constraint_analyzer.py`（TOC 约束点识别 — 敏感度分析 → 约束点 = 敏感度 × 改善空间）
- [x] `backend/app/models/hypothesis.py`（BML 认知追踪模型 — 假设/实验/数据/结论）
- [x] `backend/app/services/chasm_diagnostic.py`（采用生命周期鸿沟诊断 — 早期采用者→早期大众）
- [x] `backend/app/routers/advanced_analysis.py`
- [x] `backend/tests/test_constraint_chasm.py`（6 tests GREEN）
- [x] `frontend/src/components/workbench/AdvancedAnalysis.tsx`（约束点/BML/鸿沟诊断组件）
- 验证：AI 识别约束点 → BML 认知追踪 → 鸿沟诊断预警 → 跨越策略建议 ✅

### T3.13 协作闭环 + 任务管理
- [x] `backend/app/models/task.py`（Task 模型 — 投后任务/待办/跟进项）
- [x] `backend/app/models/comment.py`（Comment 模型 — 月报评论/风险评论）
- [x] `backend/app/routers/tasks.py`（任务 CRUD + 分配 + 状态流转）
- [x] `backend/app/routers/comments.py`（评论 CRUD — 月报/风险/企业维度）
- [x] `backend/app/services/notification.py`（通知服务 — 邮件/站内信/Webhook）
- [x] `backend/tests/test_tasks.py` + `test_comments.py`
- [x] `frontend/src/app/(investor)/tasks/page.tsx`（任务看板 — 按状态分类 + 状态更新）
- 验证：后端 API + 前端页面 ✅；通知服务 + 测试（待补充）

### T3.14 客户成功运营模型（完整版）
- [x] `backend/app/services/qbr_generator.py`（QBR 季度业务回顾 — 自动汇总季度进展/指标变化/干预效果/下季度建议）
- [x] `backend/app/services/expansion_play.py`（扩展机会识别 — 新市场/新产品/新客户群推荐）
- [x] `backend/app/services/churn_risk_detector.py`（流失风险预警 — 识别企业活跃度下降/数据共享减少/互动减少的早期信号）
- [x] `backend/app/routers/customer_success.py`（QBR + Expansion + Churn Risk API）
- [x] `backend/tests/test_customer_success.py`（4 tests GREEN）
- [x] `frontend/src/app/(investor)/customer-success/page.tsx`（客户成功运营页）
- [x] `frontend/src/components/success/QBRReport.tsx`（QBR 季度回顾报告组件）
- [x] `frontend/src/components/success/ExpansionCard.tsx`（扩展机会卡片）
- [x] `frontend/src/components/success/ChurnRiskAlert.tsx`（流失风险预警组件）
- 验证：自动生成 QBR → 识别扩展机会 → 流失风险预警 → 触发挽留流程 ✅

---

## Phase 4：智能投后操作系统

> 对应 v2.0 §17.4 第四期
> 目标：从辅助管理走向对收益负责 — Alpha 归因、退出预测、组合再平衡、Monte Carlo、数字孪生、知识图谱、AAR 复盘、Pre-mortem、Red Team、多 Agent 自治、RAG 知识库、安全加固

### T4.1 投后管理 Alpha 归因
- [x] `backend/app/models/intervention.py`（InterventionEvent + InterventionResult 模型）
- [x] `backend/app/services/alpha_attribution.py`（AI Alpha 归因 Agent — 干预事件 → 指标变化 → 估值影响 → 回报贡献）
- [x] `backend/app/routers/alpha.py`（归因分析 API — 按企业/按干预类型/按时间）
- [x] `backend/tests/test_alpha_attribution.py`
- [x] `frontend/src/app/(investor)/alpha/page.tsx`（Alpha 归因概览页 — 干预事件列表）
- 验证：后端 API + 前端页面 ✅；测试（待补充）

### T4.2 退出时机预测引擎
- [x] `backend/app/models/exit_prediction.py`（ExitPrediction 模型）
- [x] `backend/app/services/exit_predictor.py`（AI 退出预测 Agent — 路径计算 + 时机窗口 + 期望收益对比）
- [x] `backend/app/routers/exit_predictions.py`
- [x] `backend/tests/test_exit_predictor.py`
- [x] `frontend/src/app/(investor)/exit-signals/page.tsx`（退出信号页 — AI 预测 + 结果列表）
- 验证：后端 API + 前端页面 ✅；测试（待补充）

### T4.3 组合层面资源再分配 + Monte Carlo 模拟
- [x] `backend/app/services/marginal_return.py`（边际回报率计算 — 每多投入一份资源带来的边际增长）
- [x] `backend/app/services/portfolio_rebalancer.py`（AI 组合再平衡 — 资源从低回报转向高回报 + IRR/DPI 影响模拟）
- [x] `backend/app/services/monte_carlo.py`（Monte Carlo 模拟 — 10000 次随机抽样 → 组合 IRR/DPI 概率分布）
- [x] `backend/app/models/portfolio_simulation.py`（PortfolioRebalancing + MonteCarloSimulation 模型）
- [x] `backend/app/routers/portfolio.py`
- [x] `backend/tests/test_monte_carlo.py` + `test_portfolio_rebalancer.py`
- [x] `frontend/src/app/(investor)/portfolio/page.tsx`（组合管理页 — 再平衡 + Monte Carlo 模拟）
- 验证：后端 API + 前端页面 ✅；测试（待补充）

### T4.4 数字孪生（基础版）
- [x] `backend/app/models/digital_twin.py`（DigitalTwinModel 模型）
- [x] `backend/app/services/digital_twin_engine.py`（数字孪生引擎 — 企业模型 + 场景模拟 + 精度追踪）
- [x] `backend/app/routers/digital_twins.py`
- [x] `backend/tests/test_digital_twin.py`
- [x] `frontend/src/app/(investor)/digital-twins/page.tsx`（数字孪生页 — 构建模型 + 场景模拟）
- 验证：后端 API + 前端页面 ✅；测试（待补充）

### T4.5 投后管理知识图谱（基础版）
- [x] `backend/app/models/knowledge_graph.py`（KnowledgeNode 模型 — 实体/属性/关系）
- [x] `backend/app/services/knowledge_graph_builder.py`（知识图谱构建 — 企业特征 + 管理动作 + 环境上下文 → 结果 → 回报影响）
- [x] `backend/app/services/knowledge_matcher.py`（新企业匹配最佳管理策略）
- [x] `backend/app/routers/knowledge_graph.py`
- [x] `backend/tests/test_knowledge_graph.py`
- [x] `frontend/src/app/(investor)/knowledge-graph/page.tsx`（知识图谱页 — 构建 + 策略匹配）
- 验证：后端 API + 前端页面 ✅；测试（待补充）

### T4.6 AAR 系统化复盘
- [x] `backend/app/models/aar.py`（AARRecord 模型 — 触发事件/原计划/实际结果/差异/教训/改进）
- [x] `backend/app/services/aar_agent.py`（AI AAR Agent — 五问复盘 + 知识图谱写入 + 改进追踪）
- [x] `backend/app/services/aar_trigger.py`（AAR 触发条件检测 — 风险处理完成/融资完成失败/人才入职离职等）
- [x] `backend/app/routers/aars.py`
- [x] `backend/tests/test_aar.py`
- [x] `frontend/src/app/(investor)/aars/page.tsx`（AAR 复盘页 — 五问生成 + 列表）
- 验证：后端 API + 前端页面 ✅；测试（待补充）

### T4.7 Pre-mortem 失败推演 + Red Team 对抗分析
- [x] `backend/app/models/pre_mortem.py`（PreMortemRecord 模型）
- [x] `backend/app/models/red_team.py`（RedTeamRecord 模型）
- [x] `backend/app/services/pre_mortem_agent.py`（AI Pre-mortem Agent — 失败路径推演 + 风险清单 + 缓解措施）
- [x] `backend/app/services/red_team_agent.py`（AI Red Team Agent — 魔鬼代言人 + 竞争对手视角 + 悲观投资人视角）
- [x] `backend/app/routers/pre_mortems.py` + `backend/app/routers/red_teams.py`
- [x] `backend/tests/test_pre_mortem.py` + `test_red_team.py`
- [x] `frontend/src/app/(investor)/pre-mortems/page.tsx`（Pre-mortem & Red Team 页 — 标签切换 + AI 分析）
- 验证：后端 API + 前端页面 ✅；测试（待补充）

### T4.8 多 Agent 协同与自治执行
- [x] `backend/app/services/agent_orchestrator.py`（Agent 编排引擎 — L1-L4 分级自治）
- [x] `backend/app/services/agent_executor.py`（Agent 执行引擎 — L1 人工审核/L2 人工确认/L3 事后审核/L4 人工决策）
- [x] `backend/app/models/agent_execution.py`（AgentExecution 模型 — Agent/级别/输入/输出/审核状态）
- [x] `backend/app/routers/agent_executions.py`（执行记录查询 + 审核 API）
- [x] `backend/tests/test_agent_orchestrator.py`
- [x] `frontend/src/app/(investor)/agents/page.tsx`（Agent 执行监控页 — 列表 + 审核）
- 验证：后端 API + 前端页面 ✅；测试（待补充）

### T4.9 RAG 知识库 + 语义搜索
- [x] `backend/app/services/embedding.py`（文本向量化 — 调用千问 embedding API）
- [x] `backend/app/models/knowledge.py`（KnowledgeChunk 模型 — 存储向量化的月报/报告片段）
- [x] `backend/app/services/rag.py`（RAG 检索服务 — 语义搜索 + 上下文注入）
- [x] `backend/app/routers/knowledge.py`（知识库 API：搜索/上下文构建）
- [x] `backend/tests/test_rag.py`（7 tests GREEN）
- [x] `frontend/src/components/shared/KnowledgeSearch.tsx`（语义搜索组件）
- [x] AI Copilot 增强：对话时自动 RAG 检索相关历史月报/报告，注入上下文
- 验证：搜索"跑道不足" → 返回相关月报片段 → Copilot 对话引用历史数据 ✅

### T4.10 智能预警 + 预测分析
- [x] `backend/app/services/predictor.py`（趋势预测 — 基于历史评分预测未来 3 月健康度）
- [x] `backend/app/services/anomaly_detector.py`（异常检测 — 统计方法识别指标突变）
- [x] `backend/app/routers/dashboard.py` 补充 `GET /dashboard/forecasts`
- [x] `frontend/src/components/dashboard/ForecastChart.tsx`（预测趋势图 — 含置信区间）
- [x] `backend/tests/test_predictor.py`（13 tests GREEN）
- 验证：健康度预测曲线 → 异常指标标红 → 弱信号关联风险自动生成 ✅

### T4.11 多源数据接入
- [x] `backend/app/services/data_connectors/`（数据连接器框架）
- [x] `backend/app/services/data_connectors/crunchbase.py`（Crunchbase API — 融资信息同步）
- [x] `backend/app/services/data_connectors/business_registry.py`（企业工商数据 — 天眼查/企查查 API）
- [x] `backend/app/services/data_connectors/github.py`（GitHub 活跃度 — 开源项目监控）
- [x] `backend/app/models/data_source.py`（DataSource 模型）
- [x] `backend/app/routers/data_sources.py`（数据源管理 API）
- [x] `backend/tests/test_data_sources.py`（3 tests GREEN）
- 验证：后端 API + 测试 ✅；前端页面（待补充）

### T4.12 行业研究自动化
- [x] `backend/app/services/industry_research_agent.py`（AI 行业研究 Agent — 行业动态/政策变化/竞品融资/上市公司动态）
- [x] `backend/app/routers/industry_research.py`
- [x] `backend/tests/test_industry_research.py`（3 tests GREEN）
- 验证：后端 API + 测试 ✅；前端页面（待补充）

### T4.13 基金级策略分析 + 跨基金资源调度
- [x] `backend/app/services/fund_strategy_analyzer.py`（基金策略分析 — 不同基金策略/期限/退出要求对比）
- [x] `backend/app/services/cross_fund_scheduler.py`（跨基金资源调度优化）
- [x] `backend/app/services/lp_report_generator.py`（LP 报告自动生成）
- [x] `backend/app/routers/funds.py`
- [x] `backend/tests/test_fund_strategy.py`（4 tests GREEN）
- 验证：后端 API + 测试 ✅；前端页面（待补充）

### T4.14 数据安全 + 合规加固
- [x] `backend/app/core/rate_limit.py`（限流中间件 — 登录 5 次/min + 写接口按用户限流）
- [x] `backend/app/core/data_masking.py`（PII 脱敏 — 手机/邮箱/身份证 日志脱敏）
- [x] `backend/app/core/encryption.py`（敏感字段加密存储 — API Key/外部凭证）
- [x] `backend/tests/test_security.py`（10 tests GREEN）+ `test_security_reports.py`（11 tests GREEN）
- [x] `frontend/src/app/(investor)/settings/page.tsx`（设置页 — 修改密码/2FA/API Key 管理/通知设置）
- 验证：登录限流 → PII 脱敏 → 加密存储 → 设置页 ✅；2FA + refresh token 轮转（待补充）

### T4.15 投后报告增强 + 定期推送
- [x] `backend/app/services/report_generator.py`（AI 报告生成 — 季度/年度报告自动生成）
- [x] `backend/app/services/pdf_generator.py`（PDF 报告生成 — weasyprint）
- [x] `backend/tests/test_security_reports.py`（报告生成测试 GREEN）
- [x] `frontend/src/app/(investor)/reports/templates/page.tsx`（报告模板选择页）
- [x] `frontend/src/components/report/ReportPreview.tsx`（报告预览组件 — 浏览器打印优化 + 模板选择）
- 验证：选择企业 → 选择模板 → AI 生成报告 → 预览 → 导出 PDF ✅；定时任务 + 邮件推送（待补充）

---

## Phase 2 依赖关系

```
T2.1（企业详情工作台）→ T2.5（弱信号面板嵌入工作台）
T2.2（财务校验）→ T2.1（财务 Tab 展示校验结果）
T2.3（协议解析）→ T2.1（协议 Tab）
T2.4（董事会）→ T2.1（董事会 Tab）
T2.5（弱信号增强）→ T2.6（决策前哨依赖弱信号）
T2.7（重大事项 + 追问）→ T2.1（工作台展示）
T2.8（多主体画像）→ T2.1（企业关联投资经理）
T2.9（健康度扩展）→ T2.1（雷达图 9 维度）
T2.10（Admin + 审计 + Redis）独立
T2.11（文件上传 + 创始人端）独立
T2.12（驾驶舱增强）→ T2.9（热力图依赖多维度）
```

## Phase 3 依赖关系

```
T3.1（协同中心）→ T3.2（组合创新依赖协同框架）
T3.3（人才引力场）独立
T3.4（客户增长）独立
T3.5（创始人 AI 副驾驶）独立
T3.6（OKR 对齐）独立
T3.7（行为助推）→ T3.6（助推 OKR 执行）
T3.8（Peer Learning）独立
T3.9（产品诊断）独立
T3.10（里程碑）独立
T3.11（健康度扩展）→ T3.12（约束点依赖完整维度）
T3.13（协作闭环）独立
T3.14（客户成功完整版）→ T3.11（健康度扩展依赖客户成功数据）
```

## Phase 4 依赖关系

```
T4.1（Alpha 归因）→ T4.2（退出预测依赖归因数据）
T4.2（退出预测）→ T4.3（组合再平衡依赖退出预测）
T4.3（Monte Carlo）→ T4.8（Agent 自治执行组合再平衡）
T4.4（数字孪生）独立
T4.5（知识图谱）→ T4.6（AAR 写入知识图谱）
T4.6（AAR）→ T4.5（AAR 结论写入知识图谱）
T4.7（Pre-mortem + Red Team）→ T2.6（决策前哨触发）
T4.8（Agent 自治）依赖 T4.1-T4.7
T4.9（RAG）→ T4.10（智能预警引用 RAG 上下文）
T4.10（智能预警）独立
T4.11（多源数据）独立
T4.12（行业研究）独立
T4.13（基金策略）独立
T4.14（安全加固）独立
T4.15（报告增强）→ T4.9（RAG 引用历史数据）
```

## Phase 2 里程碑

| 里程碑 | 任务 | 预期 |
|---|---|---|
| M5：企业工作台 + 健康度扩展 | T2.1 + T2.9 + T2.12 | 2 周 |
| M6：财务校验 + 协议 + 董事会 | T2.2 + T2.3 + T2.4 | 3 周 |
| M7：弱信号 + 决策前哨 + 重大事项 | T2.5 + T2.6 + T2.7 | 2 周 |
| M8：多主体画像 + Admin + 审计 | T2.8 + T2.10 | 1.5 周 |
| M9：文件上传 + 创始人端 | T2.11 | 1.5 周 |

## Phase 3 里程碑

| 里程碑 | 任务 | 预期 |
|---|---|---|
| M10：协同中心 + 组合创新 | T3.1 + T3.2 | 3 周 |
| M11：人才 + 客户增长 | T3.3 + T3.4 | 2 周 |
| M12：创始人 AI 副驾驶 + OKR | T3.5 + T3.6 | 2 周 |
| M13：助推 + Peer Learning + 产品诊断 | T3.7 + T3.8 + T3.9 | 2 周 |
| M14：里程碑 + 健康度扩展 + 高级分析 | T3.10 + T3.11 + T3.12 | 2 周 |
| M15：协作闭环 + 客户成功 | T3.13 + T3.14 | 2 周 |

## Phase 4 里程碑

| 里程碑 | 任务 | 预期 |
|---|---|---|
| M16：Alpha 归因 + 退出预测 | T4.1 + T4.2 | 3 周 |
| M17：组合再平衡 + Monte Carlo | T4.3 | 2 周 |
| M18：数字孪生 + 知识图谱 + AAR | T4.4 + T4.5 + T4.6 | 3 周 |
| M19：Pre-mortem + Red Team + Agent 自治 | T4.7 + T4.8 | 2 周 |
| M20：RAG + 智能预警 + 多源数据 | T4.9 + T4.10 + T4.11 | 3 周 |
| M21：行业研究 + 基金策略 + 安全 + 报告增强 | T4.12 + T4.13 + T4.14 + T4.15 | 3 周 |

---

## 18 个月产品验证计划

> 对应 v2.0 §17.5 — 天使轮重点验证付费、续费、覆盖率和实际管理结果

### 产品里程碑

| 时间段 | 里程碑 | 对应 Phase |
|---|---|---|
| 0–5 月 | 完成企业档案、月报解析、健康度和风险驾驶舱 MVP，上线弱信号采集基础版 | Phase 1 |
| 6–8 月 | 完成首批设计伙伴验证，形成私有化交付模板 | Phase 1 验收 |
| 9–12 月 | 上线协议、董事会、数据校验和 AI+ 专项管理 Agent，上线决策前哨基础版 | Phase 2 |
| 12–18 月 | 形成 Portfolio 协同、增长引擎、创始人 AI 副驾驶和投后管理 Alpha 归因 | Phase 3-4 |

### 客户与覆盖目标

- 签约 8–12 家投资机构或产业资本客户
- 12 个月覆盖 100–150 家目标企业
- 18 个月覆盖 250–400 家目标企业
- 建立 2–3 家标杆客户和可公开或脱敏展示的案例
- 单机构符合条件被投企业覆盖率达到 60% 以上

### 收入目标（基准情景）

| 指标 | 目标 |
|---|---|
| 12 个月累计确认收入 | 80–120 万元 |
| 18 个月累计确认收入 | 220–320 万元 |
| 18 个月期末 ARR | 300–450 万元 |
| 订阅费收入占比 | ≥ 65% |
| 机构客户续费率 | ≥ 80% |

**收入测算**：`订阅收入 = 机构数量 × 机构基础订阅费 + 覆盖企业数量 × 企业账户费`
- 8–12 家机构 × 8–12 万元/年 + 250–400 家企业 × 0.4–0.8 万元/年 + 增值服务费

### 产品效果验证指标

- 风险发现时间相较人工方式明显提前
- 弱信号预警提前 30–90 天命中重大事件的比例
- 投后人员人均可管理企业数量显著提升
- 至少沉淀 5 万个有效经营指标或风险事件记录
- 形成至少 3 个风险处理或资源协同的量化案例
- 证明风险识别、董事会任务和管理结果能够形成反馈闭环
- 至少形成 1 个投后管理 Alpha 归因案例（管理动作→企业指标变化→投资回报影响）

---

## 当前进度总结

> 更新时间：2025-07-19

### 已完成概览

| 阶段 | 后端 API | 前端页面 | 测试 | 总体 |
|---|---|---|---|---|
| Phase 0 | ✅ 全部完成 | ✅ 全部完成 | ✅ 全部完成 | **100%** |
| Phase 1 | ✅ 全部完成 | ✅ 全部完成 | ✅ 全部完成 | **100%** |
| Phase 2 | ✅ 全部完成 | ✅ 全部完成 | ✅ 全部完成 | **100%** |
| Phase 3 | ✅ 全部完成 | ✅ 全部完成 | ✅ 全部完成 | **100%** |
| Phase 4 | ✅ 全部完成 | ✅ 全部完成 | ✅ 全部完成 | **100%** |

### 测试状态
- 后端全量测试：**405 passed, 0 failed, 0 errors** ✅
- 前端 E2E 测试：7 passed（Playwright）
- 测试数据库修复：conftest.py 统一使用文件级 SQLite + StaticPool，消除 83 个表缺失错误
- 新增 20+ 测试文件覆盖全部 service 层和 API 层

### 前端构建状态
- `next build` ✅ 34 个路由全部编译成功
- TypeScript 类型检查全部通过
- 静态页面生成 34/34 完成

### 已完成
- ✅ 后端测试：405 passed（全量通过，0 errors）
- ✅ 前端 E2E 测试：7 passed（Playwright）
- ✅ 前端路由守卫（AuthGuard）
- ✅ Bug 修复：MappedAnnotationError / require_role / monte_carlo 类型错误 / AuditLog 字段名不匹配
- ✅ 测试数据库修复：conftest.py 统一文件级 SQLite + StaticPool
- ✅ 全部 25 项待完成任务已完成（20+ 测试文件 + notification.py + audit.py 修复）