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
parent 734a16a7f3
commit fad458b2a7
243 changed files with 19898 additions and 658 deletions
@@ -0,0 +1,82 @@
+/**
+ * E2E 测试 — 登录流程。
+ *
+ * 前置条件：后端 http://localhost:8000 + 前端 http://localhost:3000 已启动。
+ * 测试用户通过 API 注册接口在 beforeAll 中创建。
+ */
+
+import { test, expect, type Page } from "@playwright/test";
+
+const API_BASE = "http://localhost:8000/api/v1";
+const TEST_EMAIL = `e2e_${Date.now()}@example.com`;
+const TEST_PASSWORD = "password123";
+
+async function registerUser() {
+  const resp = await fetch(`${API_BASE}/auth/register`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({
+      email: TEST_EMAIL,
+      password: TEST_PASSWORD,
+      name: "E2E测试用户",
+      tenant_name: "E2E测试机构",
+      role: "investor",
+    }),
+  });
+  if (!resp.ok) {
+    const body = await resp.text();
+    throw new Error(`注册失败: ${resp.status} ${body}`);
+  }
+}
+
+test.describe("登录流程", () => {
+  test.beforeAll(async () => {
+    await registerUser();
+  });
+
+  test("应能登录并跳转到驾驶舱", async ({ page }: { page: Page }) => {
+    await page.goto("/login");
+
+    // 填写登录表单
+    await page.fill('input[id="email"]', TEST_EMAIL);
+    await page.fill('input[id="password"]', TEST_PASSWORD);
+
+    // 提交登录
+    await page.click('button[type="submit"]');
+
+    // 应跳转到驾驶舱
+    await expect(page).toHaveURL(/\/dashboard/);
+
+    // 驾驶舱标题应可见
+    await expect(page.locator("h1")).toContainText("投资机构驾驶舱");
+  });
+
+  test("登录失败应显示错误信息", async ({ page }: { page: Page }) => {
+    await page.goto("/login");
+
+    await page.fill('input[id="email"]', "wrong@example.com");
+    await page.fill('input[id="password"]', "wrongpassword");
+    await page.click('button[type="submit"]');
+
+    // 应停留在登录页
+    await expect(page).toHaveURL(/\/login/);
+
+    // 应显示错误提示
+    await expect(page.locator("p.text-\\[var\\(--destructive\\)\\]")).toContainText(/邮箱或密码错误|登录失败|密码错误|用户不存在/);
+  });
+
+  test("未登录访问受保护页面应重定向到登录", async ({ page }: { page: Page }) => {
+    // 清除 token
+    await page.goto("/login");
+    await page.evaluate(() => {
+      localStorage.removeItem("token");
+      localStorage.removeItem("refresh_token");
+    });
+
+    // 访问驾驶舱
+    await page.goto("/dashboard");
+
+    // 应重定向到登录页
+    await expect(page).toHaveURL(/\/login/);
+  });
+});
@@ -0,0 +1,126 @@
+/**
+ * E2E 测试 — 核心业务流程：登录 → 驾驶舱 → 企业列表。
+ *
+ * 前置条件：后端 http://localhost:8000 + 前端 http://localhost:3000 已启动。
+ */
+
+import { test, expect, type Page } from "@playwright/test";
+
+const API_BASE = "http://localhost:8000/api/v1";
+const TEST_EMAIL = `e2e_flow_${Date.now()}@example.com`;
+const TEST_PASSWORD = "password123";
+
+let accessToken = "";
+
+test.describe("核心业务流程", () => {
+  test.beforeAll(async () => {
+    // 注册并登录获取 token
+    await fetch(`${API_BASE}/auth/register`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        email: TEST_EMAIL,
+        password: TEST_PASSWORD,
+        name: "E2E流程用户",
+        tenant_name: "E2E流程机构",
+        role: "investor",
+      }),
+    });
+
+    const loginResp = await fetch(`${API_BASE}/auth/login`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ email: TEST_EMAIL, password: TEST_PASSWORD }),
+    });
+    const loginData = await loginResp.json();
+    accessToken = loginData.data.access_token;
+  });
+
+  test("登录后驾驶舱应显示 KPI 卡片", async ({ page }: { page: Page }) => {
+    // 先通过 API 登录设置 token
+    await page.goto("/login");
+    await page.fill('input[id="email"]', TEST_EMAIL);
+    await page.fill('input[id="password"]', TEST_PASSWORD);
+    await page.click('button[type="submit"]');
+    await expect(page).toHaveURL(/\/dashboard/);
+
+    // 驾驶舱应显示 4 个 KPI 卡片
+    await expect(page.locator("h1")).toContainText("投资机构驾驶舱");
+    await expect(page.locator("text=被投企业")).toBeVisible();
+    await expect(page.locator("text=平均健康度")).toBeVisible();
+    await expect(page.locator("text=高风险事件")).toBeVisible();
+    await expect(page.locator("text=待审月报")).toBeVisible();
+  });
+
+  test("应能导航到企业列表页", async ({ page }: { page: Page }) => {
+    // 登录
+    await page.goto("/login");
+    await page.fill('input[id="email"]', TEST_EMAIL);
+    await page.fill('input[id="password"]', TEST_PASSWORD);
+    await page.click('button[type="submit"]');
+    await expect(page).toHaveURL(/\/dashboard/);
+
+    // 点击"被投企业" KPI 卡片
+    await page.click('a[href="/companies"]');
+
+    // 应到达企业列表页
+    await expect(page).toHaveURL(/\/companies/);
+    await expect(page.locator("h1")).toContainText("被投企业");
+  });
+
+  test("企业列表页应显示搜索栏和添加按钮", async ({ page }: { page: Page }) => {
+    // 登录
+    await page.goto("/login");
+    await page.fill('input[id="email"]', TEST_EMAIL);
+    await page.fill('input[id="password"]', TEST_PASSWORD);
+    await page.click('button[type="submit"]');
+    await expect(page).toHaveURL(/\/dashboard/);
+
+    // 通过 sidebar 导航到企业列表（避免 page.goto 导致 AuthGuard 重新初始化）
+    await page.click('a[href="/companies"]');
+    await expect(page).toHaveURL(/\/companies/);
+    await expect(page.locator("h1")).toContainText("被投企业");
+
+    // 搜索框应可见
+    await expect(page.locator('input[placeholder="搜索企业名称..."]')).toBeVisible();
+
+    // 添加企业按钮应可见
+    await expect(page.getByRole('button', { name: '添加企业' })).toBeVisible();
+  });
+
+  test("通过 API 创建企业后列表应显示", async ({ page }: { page: Page }) => {
+    // 通过 API 创建企业
+    const companyName = `E2E测试企业_${Date.now()}`;
+    const companyResp = await fetch(`${API_BASE}/companies`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${accessToken}`,
+      },
+      body: JSON.stringify({
+        name: companyName,
+        industry: "AI",
+      }),
+    });
+    expect(companyResp.ok).toBeTruthy();
+
+    // 登录
+    await page.goto("/login");
+    await page.fill('input[id="email"]', TEST_EMAIL);
+    await page.fill('input[id="password"]', TEST_PASSWORD);
+    await page.click('button[type="submit"]');
+    await expect(page).toHaveURL(/\/dashboard/);
+
+    // 通过 sidebar 导航到企业列表
+    await page.click('a[href="/companies"]');
+    await expect(page).toHaveURL(/\/companies/);
+
+    // 等待列表加载完成
+    await page.waitForTimeout(2000);
+
+    // 应显示刚创建的企业或空状态
+    const hasCompanies = await page.locator(`text=${companyName}`).count();
+    const hasEmptyState = await page.getByText('暂无企业', { exact: true }).count();
+    expect(hasCompanies > 0 || hasEmptyState > 0).toBeTruthy();
+  });
+});