AIPortPilot/docs/2-task-uiux.md

# 开发任务 — UIUX 设计方案代码落地

> 关联文档：`docs/UIUX-多层级投后工作台设计方案.md`
> 创建时间：2025-07-19
> 状态：待开发

---

## 当前代码现状

| 维度 | 现状 | 目标（UIUX 方案） |
|---|---|---|
| 投资人导航 | 5 个扁平分组（核心功能/投后管理/增值服务/高级分析/系统），19 个入口 | 6 业务域分组（今日/组合/工作/增长/洞察/报告）+ 底部固定设置 |
| 角色化导航 | 无（所有投资人角色看到相同顺序） | 按角色调整默认顺序和首页（GP→指挥塔、投后负责人→今日、投资经理→今日） |
| Context Bar | 无 | Scope/Lens/Time 三维上下文栏，全局同步 |
| 工作模式 | 无 | Overview/Compare/Focus/Queue 四种自适应模式 |
| Insight Rail | 无 | 右侧 AI 洞察面板，12 个 Agent 差异化展示 |
| 决策线程 | 无 | `/threads` 路由，线程详情页，状态机驱动 |
| 多工作区 | 无 | 多 Tab 工作区，独立上下文，最多 8 个 |
| 今日行动中心 | 无 | `/today` 路由，统一待办/风险/月报/任务入口 |
| 多企业对比 | 无 | `/compare` 路由，2-5 家企业并排对比 |
| OODA 可视化 | 无 | OODA 决策循环图 + 决策延迟追踪 |
| 行为助推引擎 | `/nudges` 页面存在但功能简单 | Nudge 策略库 + 效果追踪页 + 助推疲劳检测 |
| 商业秘密保护 | 无 | 信息分级标识 + 查看留痕 + 导出管控 + 水印 |
| 创始人端 | 3 个底部导航（概览/月报/AI副驾驶） | 6 域导航 + 经营驾驶舱 + 投资人沟通准备中心 + 里程碑自填 |
| Admin 端 | 单页标签页 | 6 管理域 Sidebar + 商业秘密保护配置 |

---

## 任务清单

### P0 — 导航架构重构（阻塞性）

| # | 任务 | 涉及文件 | 状态 |
|---|---|---|---|
| 1 | 投资人 Sidebar 改为 6 业务域分组 | `frontend/src/app/(investor)/layout.tsx` | ⏳ |
| 2 | 角色化导航顺序（GP/投后负责人/投资经理 各自不同默认顺序和首页） | `layout.tsx` + 新增 `navConfig.ts` | ⏳ |
| 3 | 新增 `/today` 路由 — 今日行动中心 | `app/(investor)/today/page.tsx` | ⏳ |
| 4 | 新增 `/compare` 路由 — 多企业对比工作区 | `app/(investor)/compare/page.tsx` | ⏳ |
| 5 | 新增 `/threads` 和 `/threads/[id]` 路由 — 决策线程 | `app/(investor)/threads/` | ⏳ |
| 6 | 新增 `/workspace` 路由 — 通用工作区（URL 参数驱动） | `app/(investor)/workspace/page.tsx` | ⏳ |
| 7 | Admin 端改为 6 管理域 Sidebar 布局 | `app/admin/layout.tsx` + `app/admin/page.tsx` 拆分 | ⏳ |
| 8 | 创始人端导航改为 6 域（今日/经营/月报/Copilot/通知/我的） | `app/founder/layout.tsx` | ⏳ |

### P1 — 核心 UI 组件新建

| # | 任务 | 涉及文件 | 状态 |
|---|---|---|---|
| 9 | Context Bar 组件（Scope/Lens/Time 三维切换器） | `components/shared/ContextBar.tsx` | ⏳ |
| 10 | Context Bar 状态管理（全局 Context + URL 参数同步） | `lib/context-bar-context.tsx` | ⏳ |
| 11 | Work Mode 切换器组件（Overview/Compare/Focus/Queue） | `components/shared/WorkModeSwitcher.tsx` | ⏳ |
| 12 | Focus 模式布局（隐藏导航 + 全屏 + TOC 可视化 + BML 仪表盘） | `components/workbench/FocusMode.tsx` | ⏳ |
| 13 | Queue 模式布局（Split View 左右分栏） | `components/workbench/QueueMode.tsx` | ⏳ |
| 14 | Compare 模式布局（2-5 家企业并排对比） | `components/workbench/CompareMode.tsx` | ⏳ |
| 15 | Insight Rail 组件（右侧 AI 洞察面板 + 展开/折叠） | `components/shared/InsightRail.tsx` | ⏳ |
| 16 | Insight Rail — 12 个 Agent 差异化卡片 | `components/insight-rail/` 目录下 12 个组件 | ⏳ |
| 17 | Decision Thread 组件（线程列表 + 详情 + 状态机时间线） | `components/threads/ThreadList.tsx` + `ThreadDetail.tsx` | ⏳ |
| 18 | Multi-Workspace Tab 管理器（多 Tab + 独立上下文 + 淘汰策略） | `components/shared/WorkspaceTabs.tsx` | ⏳ |
| 19 | Highlights Panel 组件（企业战情室顶部摘要） | `components/workbench/HighlightsPanel.tsx` | ⏳ |

### P2 — 新增页面开发

| # | 任务 | 涉及文件 | 状态 |
|---|---|---|---|
| 20 | 今日行动中心页面（待办聚合 + 风险队列 + 月报状态 + 任务概览） | `app/(investor)/today/page.tsx` | ⏳ |
| 21 | 多企业对比页面（指标选择 + 并排卡片 + 差异高亮） | `app/(investor)/compare/page.tsx` | ⏳ |
| 22 | 决策线程列表页（按状态/企业筛选 + 线程卡片） | `app/(investor)/threads/page.tsx` | ⏳ |
| 23 | 决策线程详情页（状态机时间线 + 关联事件 + AAR 链接） | `app/(investor)/threads/[id]/page.tsx` | ⏳ |
| 24 | OODA 决策循环可视化页面 | `app/(investor)/ooda/page.tsx` 或集成到企业详情 | ⏳ |
| 25 | 行为助推效果追踪页（接受率 + 后续效果 + 疲劳检测） | 扩展 `app/(investor)/nudges/page.tsx` | ⏳ |
| 26 | 商业秘密保护 — 信息分级标识组件（4 级密级标签） | `components/shared/ClassificationBadge.tsx` | ⏳ |
| 27 | 商业秘密保护 — 查看留痕 + 导出管控 + 水印 | 后端 API + 前端拦截 | ⏳ |
| 28 | Admin — 商业秘密保护配置页面 | `app/admin/security/page.tsx` | ⏳ |

### P3 — 创始人端增强

| # | 任务 | 涉及文件 | 状态 |
|---|---|---|---|
| 29 | 经营驾驶舱页面（KPI 卡片 + 健康度雷达图 + 投资人关注面板 + 待办） | 扩展 `app/founder/page.tsx` | ⏳ |
| 30 | 投资人沟通准备中心（董事会/季度汇报/紧急沟通/Q&A 生成） | 扩展 `app/founder/copilot/page.tsx` | ⏳ |
| 31 | 里程碑自填页面（创始人自主添加/编辑里程碑 + 偏差双向通知） | `app/founder/milestones/page.tsx` | ⏳ |
| 32 | 创始人端 OKR 对齐视图 | `app/founder/okrs/page.tsx` | ⏳ |
| 33 | 创始人端认知追踪（BML）页面 | `app/founder/bml/page.tsx` | ⏳ |

### P4 — 企业详情工作台增强

| # | 任务 | 涉及文件 | 状态 |
|---|---|---|---|
| 34 | 企业战情室集成 4 种工作模式切换 | `app/(investor)/companies/[id]/workbench/page.tsx` | ⏳ |
| 35 | 企业战情室集成 Context Bar | 同上 | ⏳ |
| 36 | 企业战情室集成 Insight Rail | 同上 | ⏳ |
| 37 | 企业战情室集成 Highlights Panel | 同上 | ⏳ |
| 38 | Focus 模式 — TOC 约束点识别可视化 | `components/workbench/TOCVisualization.tsx` | ⏳ |
| 39 | Focus 模式 — BML 认知追踪仪表盘 | `components/workbench/BMLDashboard.tsx` | ⏳ |
| 40 | 健康度体系 — 9 维度雷达图增强（AI 商业化 + AI 成本效率） | 扩展 `components/health/HealthRadar.tsx` | ⏳ |
| 41 | AI+ 专项看板（AI 商业化看板 + AI 成本效率看板） | `components/dashboard/AIScoreboard.tsx` | ⏳ |

### P5 — 多主体画像体系

| # | 任务 | 涉及文件 | 状态 |
|---|---|---|---|
| 42 | 多主体画像 — GP 视角（组合指挥塔视角的企业画像） | `components/portrait/GPView.tsx` | ⏳ |
| 43 | 多主体画像 — 投后负责人视角（行动中心视角） | `components/portrait/PostInvestManagerView.tsx` | ⏳ |
| 44 | 多主体画像 — 投资经理视角（执行视角） | `components/portrait/InvestmentManagerView.tsx` | ⏳ |
| 45 | 多主体画像 — 创始人视角（经营视角） | `components/portrait/FounderView.tsx` | ⏳ |
| 46 | 多主体画像 — 管理员视角（系统视角） | `components/portrait/AdminView.tsx` | ⏳ |

### P6 — 移动端适配

| # | 任务 | 涉及文件 | 状态 |
|---|---|---|---|
| 47 | 移动端 Sidebar 折叠为抽屉/下拉 | `layout.tsx` 响应式改造 | ⏳ |
| 48 | 移动端 Insight Rail 变为 Bottom Sheet | `components/shared/InsightRail.tsx` | ⏳ |
| 49 | 移动端 Context Bar 简化为单行选择器 | `components/shared/ContextBar.tsx` | ⏳ |
| 50 | 移动端 Focus 模式全屏优化 | `components/workbench/FocusMode.tsx` | ⏳ |

---

## 依赖关系

```
P0（导航重构）→ 阻塞所有后续任务
  ├── P1 #9-10（Context Bar）→ 阻塞 P4 #35
  ├── P1 #11-14（工作模式）→ 阻塞 P4 #34
  ├── P1 #15-16（Insight Rail）→ 阻塞 P4 #36
  ├── P1 #17（决策线程组件）→ 阻塞 P2 #22-23
  └── P1 #18（多工作区）→ 独立可并行

P2（新增页面）→ 依赖 P0 + P1
P3（创始人端）→ 依赖 P0 #8
P4（企业工作台）→ 依赖 P0 + P1 #9-16
P5（多主体画像）→ 依赖 P1 组件
P6（移动端）→ 依赖 P1 组件完成后适配
```

---

## 建议实施顺序

1. **Sprint 1**：P0 全部（#1-8）— 导航架构重构
2. **Sprint 2**：P1 #9-11, #15, #18-19 — Context Bar + 工作模式切换 + Insight Rail + 工作区 + Highlights
3. **Sprint 3**：P1 #12-14, #16-17 — Focus/Queue/Compare 模式 + Agent 卡片 + 决策线程
4. **Sprint 4**：P2 #20-25 — 新增页面
5. **Sprint 5**：P3 #29-33 — 创始人端增强
6. **Sprint 6**：P4 #34-41 — 企业工作台集成
7. **Sprint 7**：P5 #42-46 — 多主体画像
8. **Sprint 8**：P2 #26-28 + P6 #47-50 — 商业秘密保护 + 移动端适配