Files

T

selfrelease fad458b2a7 docs(uiux): UIUX 设计方案大改 + 5 份作业指导书对齐 + 开发任务文档

- UIUX 文档：填充 19 个缺口（多主体画像/健康度/AI+看板/增长域/洞察域/创始人端/OODA/助推/商密）
- UIUX 文档：插入 6 个新章节（十四~十九），旧章节重编号为二十~三十一，更新目录和交叉引用
- 作业指导书 x5：导航改为 6 域分组，新增 Context Bar/工作模式/Insight Rail/决策线程/多工作区等 UI 概念
- 新建 docs/2-task-uiux.md：50 个代码落地开发任务，按 P0-P6 分优先级 + 8 Sprint 规划
- 后端/前端：大量新增模型、路由、组件（来自之前 Phase 开发）

2026-07-19 11:53:38 +08:00

41 KiB

Raw Blame History

任务清单 (2-task)

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

Phase 0：项目骨架

T0.1 项目目录结构

创建 frontend/ backend/ docs/daily/ docs/decisions/ 目录
创建 .gitignore（Python + Node + IDE + .env）
创建 .env.example
验证：目录结构正确

T0.2 后端项目初始化

backend/pyproject.toml（FastAPI + SQLAlchemy + Alembic + Pydantic + pytest）
backend/app/__init__.py
backend/app/main.py（FastAPI app 实例 + 健康检查 /health）
backend/app/core/config.py（环境变量配置）
backend/app/core/database.py（SQLAlchemy engine + session）
backend/tests/__init__.py
backend/tests/test_health.py（4 个测试全部 GREEN）
验证：pytest tests/test_health.py -v → 4 passed

T0.3 前端项目初始化

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

T0.4 Docker Compose 开发环境

docker-compose.yml（PostgreSQL 16 + Redis 7 + Ollama）
backend/Dockerfile
frontend/Dockerfile
docker-compose.dev.yml（开发覆盖：挂载源码 + hot reload）
验证：docker compose up -d 全部 healthy

T0.5 数据库迁移基座

backend/alembic.ini
backend/alembic/ 初始化
首个 migration：创建 7 张核心表（tenants/users/companies/monthly_reports/health_scores/risk_events/audit_logs）
验证：alembic upgrade head 成功，\dt 显示 8 张表

Phase 1：MVP 核心功能

T1.1 认证与权限

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

T1.2 企业档案管理

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

T1.3 月报管理 + AI 解析

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

T1.4 健康度评分

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

T1.5 投资机构驾驶舱

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

T1.6 风险预警

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

T1.7 投后报告

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

T1.8 移动端适配

投资人端响应式：< md Sidebar 折叠为顶部 Header（已有）
创始人端移动布局：卡片流 + 底部导航
AI Copilot 浮动对话窗口（底部抽屉式）
风险预警 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 企业详情工作台（投资人端核心页面）

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 组件，依赖各模块 API 就绪后集成 ✅

T2.2 财务数据接入与自动校验

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

T2.3 投资协议解析与条款监控

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

T2.4 董事会管理

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

T2.5 弱信号采集（增强版）+ 关联引擎

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

T2.6 决策前哨（基础版）

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

T2.7 重大事项自动识别 + 追问清单

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

T2.8 多主体画像（基础版）

backend/app/models/firm_profile.py（投资机构画像）
backend/app/models/fund_profile.py（基金画像）
backend/app/models/manager_profile.py（投资经理画像）
backend/app/routers/profiles.py（画像 CRUD + 关联查询）
backend/tests/test_profiles.py
验证：后端 API ✅；前端页面 + 测试（待补充）

T2.9 健康度维度扩展

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

T2.10 Admin 管理后台 + 审计日志 + Redis 缓存

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

T2.11 月报文件上传 + 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/founder.py（创始人专属 API：经营概览数据 + 自身健康度）
backend/tests/test_file_upload.py（5 tests GREEN）
frontend/src/app/(founder)/reports/submit/page.tsx 增强（支持文件上传 + 拖拽 + AI 辅助填充）
frontend/src/components/shared/FileUploader.tsx（文件上传组件）
frontend/src/app/founder/page.tsx 重写（经营概览 — 企业信息 + 健康度 + 最新月报）
frontend/src/app/founder/copilot/page.tsx（独立 AI 副驾驶页面）
验证：创始人端 API + 概览页 + Copilot + 文件上传 + PDF 导出 ✅

T2.12 驾驶舱增强

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 + GET /dashboard/trends
验证：驾驶舱 → 热力图 → 趋势对比 → AI 周报 → 风险概览 ✅

Phase 3：Portfolio 协同与增长引擎

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

T3.1 协同机会中心

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

T3.2 组合创新实验室

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

T3.3 人才引力场

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

T3.4 客户增长引擎

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

T3.5 创始人 AI 副驾驶（完整版）

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

T3.6 OKR 对齐引擎

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

T3.7 行为助推引擎

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

T3.8 Peer Learning Circles

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

T3.9 AI 产品竞争力诊断

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

T3.10 里程碑动态管理

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

T3.11 协同与赋能健康度 + AI+ 专项健康度扩展

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

T3.12 约束点识别 + 认知追踪 + 鸿沟诊断

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

T3.13 协作闭环 + 任务管理

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 + test_comments.py
frontend/src/app/(investor)/tasks/page.tsx（任务看板 — 按状态分类 + 状态更新）
验证：后端 API + 前端页面 ✅；通知服务 + 测试（待补充）

T3.14 客户成功运营模型（完整版）

backend/app/services/qbr_generator.py（QBR 季度业务回顾 — 自动汇总季度进展/指标变化/干预效果/下季度建议）
backend/app/services/expansion_play.py（扩展机会识别 — 新市场/新产品/新客户群推荐）
backend/app/services/churn_risk_detector.py（流失风险预警 — 识别企业活跃度下降/数据共享减少/互动减少的早期信号）
backend/app/routers/customer_success.py（QBR + Expansion + Churn Risk API）
backend/tests/test_customer_success.py（4 tests GREEN）
frontend/src/app/(investor)/customer-success/page.tsx（客户成功运营页）
frontend/src/components/success/QBRReport.tsx（QBR 季度回顾报告组件）
frontend/src/components/success/ExpansionCard.tsx（扩展机会卡片）
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 归因

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

T4.2 退出时机预测引擎

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

T4.3 组合层面资源再分配 + Monte Carlo 模拟

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

T4.4 数字孪生（基础版）

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

T4.5 投后管理知识图谱（基础版）

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

T4.6 AAR 系统化复盘

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

T4.7 Pre-mortem 失败推演 + Red Team 对抗分析

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

T4.8 多 Agent 协同与自治执行

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

T4.9 RAG 知识库 + 语义搜索

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

T4.10 智能预警 + 预测分析

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

T4.11 多源数据接入

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

T4.12 行业研究自动化

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

T4.13 基金级策略分析 + 跨基金资源调度

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

T4.14 数据安全 + 合规加固

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

T4.15 投后报告增强 + 定期推送

backend/app/services/report_generator.py（AI 报告生成 — 季度/年度报告自动生成）
backend/app/services/pdf_generator.py（PDF 报告生成 — weasyprint）
backend/tests/test_security_reports.py（报告生成测试 GREEN）
frontend/src/app/(investor)/reports/templates/page.tsx（报告模板选择页）
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 修复）

41 KiB Raw Blame History Unescape Escape

任务清单 (2-task)

Phase 0：项目骨架

T0.1 项目目录结构

T0.2 后端项目初始化

T0.3 前端项目初始化

T0.4 Docker Compose 开发环境

T0.5 数据库迁移基座

Phase 1：MVP 核心功能

T1.1 认证与权限

T1.2 企业档案管理

T1.3 月报管理 + AI 解析

T1.4 健康度评分

T1.5 投资机构驾驶舱

T1.6 风险预警

T1.7 投后报告

T1.8 移动端适配

依赖关系

里程碑

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

T2.1 企业详情工作台（投资人端核心页面）

T2.2 财务数据接入与自动校验

T2.3 投资协议解析与条款监控

T2.4 董事会管理

T2.5 弱信号采集（增强版）+ 关联引擎

T2.6 决策前哨（基础版）

T2.7 重大事项自动识别 + 追问清单

T2.8 多主体画像（基础版）

T2.9 健康度维度扩展

T2.10 Admin 管理后台 + 审计日志 + Redis 缓存

T2.11 月报文件上传 + PDF 导出 + 创始人端完善

T2.12 驾驶舱增强

Phase 3：Portfolio 协同与增长引擎

T3.1 协同机会中心

T3.2 组合创新实验室

T3.3 人才引力场

T3.4 客户增长引擎

T3.5 创始人 AI 副驾驶（完整版）

T3.6 OKR 对齐引擎

T3.7 行为助推引擎

T3.8 Peer Learning Circles

T3.9 AI 产品竞争力诊断

T3.10 里程碑动态管理

T3.11 协同与赋能健康度 + AI+ 专项健康度扩展

T3.12 约束点识别 + 认知追踪 + 鸿沟诊断

T3.13 协作闭环 + 任务管理

T3.14 客户成功运营模型（完整版）

Phase 4：智能投后操作系统

T4.1 投后管理 Alpha 归因

T4.2 退出时机预测引擎

T4.3 组合层面资源再分配 + Monte Carlo 模拟

T4.4 数字孪生（基础版）

T4.5 投后管理知识图谱（基础版）

T4.6 AAR 系统化复盘

T4.7 Pre-mortem 失败推演 + Red Team 对抗分析

T4.8 多 Agent 协同与自治执行

T4.9 RAG 知识库 + 语义搜索

T4.10 智能预警 + 预测分析

T4.11 多源数据接入

T4.12 行业研究自动化

T4.13 基金级策略分析 + 跨基金资源调度

T4.14 数据安全 + 合规加固

T4.15 投后报告增强 + 定期推送

Phase 2 依赖关系

Phase 3 依赖关系

Phase 4 依赖关系

Phase 2 里程碑

Phase 3 里程碑

Phase 4 里程碑

18 个月产品验证计划

产品里程碑

客户与覆盖目标

收入目标（基准情景）

产品效果验证指标

当前进度总结

已完成概览

测试状态

前端构建状态

已完成

41 KiB

Raw Blame History