feat: 累积功能变更 — 聊天集成、租户管理、小程序更新、ETL 增强、迁移脚本

包含多个会话的累积代码变更:
- backend: AI 聊天服务、触发器调度、认证增强、WebSocket、调度器最小间隔
- admin-web: ETL 状态页、任务管理、调度配置、登录优化
- miniprogram: 看板页面、聊天集成、UI 组件、导航更新
- etl: DWS 新任务(finance_area_daily/board_cache)、连接器增强
- tenant-admin: 项目初始化
- db: 19 个迁移脚本(etl_feiqiu 11 + zqyy_app 8)
- packages/shared: 枚举和工具函数更新
- tools: 数据库工具、报表生成、健康检查
- docs: PRD/架构/部署/合约文档更新

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Neo
2026-04-06 00:03:48 +08:00
parent 70324d8542
commit 6f8f12314f
515 changed files with 76604 additions and 7456 deletions

View File

@@ -0,0 +1,68 @@
/**
* Dashboard 页面 E2E 测试。
*
* 验证点:
* - 4 个区块渲染OpsPanel、DbHealthCard、AI 运行总览、AI 调度摘要)
* - 跳转链接正确ETL 状态详情、触发器详情、AI 调度详情)
*/
import { test, expect } from '@playwright/test';
import { injectAuth, mockAllApis } from './helpers';
test.describe('Dashboard 页面', () => {
test.beforeEach(async ({ page }) => {
await injectAuth(page);
await mockAllApis(page);
await page.goto('/dashboard');
// 等待页面标题渲染,确认 Dashboard 已加载
await expect(page.locator('text=运行状态').first()).toBeVisible();
});
test('4 个区块均渲染', async ({ page }) => {
// 区块 1OpsPanel 子组件(系统资源信息)
// SystemResourceSection 会展示 CPU / 内存 / 磁盘等信息
await expect(page.locator('text=CPU').first()).toBeVisible();
// 区块 2数据库健康监控DbHealthCard
await expect(page.locator('text=数据库').first()).toBeVisible();
// 区块 3AI 运行总览
await expect(page.locator('text=AI 运行总览').first()).toBeVisible();
// 区块 4AI 调度摘要
await expect(page.locator('text=AI 调度摘要').first()).toBeVisible();
// 验证统计卡片存在
await expect(page.locator('text=今日触发数')).toBeVisible();
await expect(page.locator('text=今日成功率')).toBeVisible();
await expect(page.locator('text=总记录数')).toBeVisible();
});
test('ETL 状态详情跳转到 /etl-tasks?tab=status', async ({ page }) => {
const btn = page.locator('button', { hasText: 'ETL 状态详情' });
await expect(btn).toBeVisible();
await btn.click();
await expect(page).toHaveURL(/\/etl-tasks\?tab=status/);
});
test('触发器详情跳转到 /triggers?tab=all', async ({ page }) => {
const btn = page.locator('button', { hasText: '触发器详情' });
await expect(btn).toBeVisible();
await btn.click();
await expect(page).toHaveURL(/\/triggers\?tab=all/);
});
test('AI 调度详情跳转到 /triggers?tab=ai', async ({ page }) => {
const btn = page.locator('button', { hasText: 'AI 调度详情' });
await expect(btn).toBeVisible();
await btn.click();
await expect(page).toHaveURL(/\/triggers\?tab=ai/);
});
test('AI 调度摘要底部链接跳转到 /triggers?tab=ai', async ({ page }) => {
// 卡片底部的 "查看 AI 调度详情" 链接
const link = page.locator('text=查看 AI 调度详情');
await expect(link).toBeVisible();
await link.click();
await expect(page).toHaveURL(/\/triggers\?tab=ai/);
});
});

View File

@@ -0,0 +1,97 @@
/**
* ETL 任务管理页面 E2E 测试。
*
* 验证点:
* - 5 个 Tab 切换config、queue、schedule、history、status
* - 各 Tab 内容渲染
* - Tab 与 URL 查询参数同步
*/
import { test, expect } from '@playwright/test';
import { injectAuth, mockAllApis } from './helpers';
test.describe('ETL 任务管理页面', () => {
test.beforeEach(async ({ page }) => {
await injectAuth(page);
await mockAllApis(page);
await page.goto('/etl-tasks');
// 等待页面标题渲染
await expect(page.locator('text=ETL 任务管理').first()).toBeVisible();
});
test('默认显示 config Tab', async ({ page }) => {
// 默认 Tab 为"发起"
const configTab = page.locator('[role="tab"]', { hasText: '发起' });
await expect(configTab).toHaveAttribute('aria-selected', 'true');
});
test('5 个 Tab 均可见', async ({ page }) => {
await expect(page.locator('[role="tab"]', { hasText: '发起' })).toBeVisible();
await expect(page.locator('[role="tab"]', { hasText: '队列' })).toBeVisible();
await expect(page.locator('[role="tab"]', { hasText: '调度' })).toBeVisible();
await expect(page.locator('[role="tab"]', { hasText: '历史' })).toBeVisible();
await expect(page.locator('[role="tab"]', { hasText: '状态' })).toBeVisible();
});
test('切换到 queue Tab', async ({ page }) => {
const queueTab = page.locator('[role="tab"]', { hasText: '队列' });
await queueTab.click();
await expect(queueTab).toHaveAttribute('aria-selected', 'true');
// URL 同步
await expect(page).toHaveURL(/\?tab=queue/);
});
test('切换到 schedule Tab', async ({ page }) => {
const scheduleTab = page.locator('[role="tab"]', { hasText: '调度' });
await scheduleTab.click();
await expect(scheduleTab).toHaveAttribute('aria-selected', 'true');
// URL 同步
await expect(page).toHaveURL(/\?tab=schedule/);
});
test('切换到 history Tab', async ({ page }) => {
const historyTab = page.locator('[role="tab"]', { hasText: '历史' });
await historyTab.click();
await expect(historyTab).toHaveAttribute('aria-selected', 'true');
// URL 同步
await expect(page).toHaveURL(/\?tab=history/);
});
test('切换到 status Tab', async ({ page }) => {
const statusTab = page.locator('[role="tab"]', { hasText: '状态' });
await statusTab.click();
await expect(statusTab).toHaveAttribute('aria-selected', 'true');
// URL 同步
await expect(page).toHaveURL(/\?tab=status/);
});
test('通过 URL 直接访问 queue Tab', async ({ page }) => {
await page.goto('/etl-tasks?tab=queue');
const queueTab = page.locator('[role="tab"]', { hasText: '队列' });
await expect(queueTab).toHaveAttribute('aria-selected', 'true');
});
test('通过 URL 直接访问 schedule Tab', async ({ page }) => {
await page.goto('/etl-tasks?tab=schedule');
const scheduleTab = page.locator('[role="tab"]', { hasText: '调度' });
await expect(scheduleTab).toHaveAttribute('aria-selected', 'true');
});
test('通过 URL 直接访问 history Tab', async ({ page }) => {
await page.goto('/etl-tasks?tab=history');
const historyTab = page.locator('[role="tab"]', { hasText: '历史' });
await expect(historyTab).toHaveAttribute('aria-selected', 'true');
});
test('通过 URL 直接访问 status Tab', async ({ page }) => {
await page.goto('/etl-tasks?tab=status');
const statusTab = page.locator('[role="tab"]', { hasText: '状态' });
await expect(statusTab).toHaveAttribute('aria-selected', 'true');
});
test('无效 tab 参数回退到默认 config', async ({ page }) => {
await page.goto('/etl-tasks?tab=invalid');
const configTab = page.locator('[role="tab"]', { hasText: '发起' });
await expect(configTab).toHaveAttribute('aria-selected', 'true');
});
});

View File

@@ -0,0 +1,230 @@
/**
* E2E 测试公共辅助:注入 JWT 令牌 + 通用 API mock。
*
* 认证方式:向 localStorage 写入伪造的 access_token / refresh_token
* 与 authStore.hydrate() 逻辑一致,页面加载后自动识别为已登录状态。
*/
import { type Page } from '@playwright/test';
/* ------------------------------------------------------------------ */
/* 伪造 JWTpayload 可被 authStore.parseJwtPayload 正确解析) */
/* ------------------------------------------------------------------ */
function makeFakeJwt(payload: Record<string, unknown>): string {
const header = btoa(JSON.stringify({ alg: 'HS256', typ: 'JWT' }));
const body = btoa(JSON.stringify(payload));
const sig = 'fake_signature';
return `${header}.${body}.${sig}`;
}
const FAKE_ACCESS_TOKEN = makeFakeJwt({
user_id: 1,
username: 'admin',
display_name: '测试管理员',
site_id: 1,
roles: ['admin'],
exp: Math.floor(Date.now() / 1000) + 3600,
});
const FAKE_REFRESH_TOKEN = 'fake_refresh_token';
/* ------------------------------------------------------------------ */
/* 注入登录状态 */
/* ------------------------------------------------------------------ */
/**
* 在页面导航前注入 localStorage 令牌,模拟已登录状态。
* 必须在 page.goto() 之前调用。
*/
export async function injectAuth(page: Page): Promise<void> {
// 先访问 baseURL 以获得同源 localStorage 访问权限
await page.goto('/login', { waitUntil: 'commit' });
await page.evaluate(
([accessToken, refreshToken]) => {
localStorage.setItem('access_token', accessToken);
localStorage.setItem('refresh_token', refreshToken);
},
[FAKE_ACCESS_TOKEN, FAKE_REFRESH_TOKEN] as const,
);
}
/* ------------------------------------------------------------------ */
/* 通用 API mock — 拦截所有 /api/** 请求返回空数据 */
/* ------------------------------------------------------------------ */
/** 为所有 /api/ 请求注册兜底 mock避免真实网络调用 */
export async function mockAllApis(page: Page): Promise<void> {
// 运维面板
await page.route('**/api/ops/system-info', (route) =>
route.fulfill({
status: 200,
contentType: 'application/json',
body: JSON.stringify({
code: 0,
data: {
cpu_percent: 25.0,
memory_percent: 60.0,
disk_percent: 45.0,
uptime_seconds: 86400,
platform: 'Windows',
python_version: '3.10.0',
},
}),
}),
);
await page.route('**/api/ops/services', (route) =>
route.fulfill({
status: 200,
contentType: 'application/json',
body: JSON.stringify({
code: 0,
data: [
{ name: 'backend', env: 'prod', status: 'running', pid: 1234, port: 8000 },
],
}),
}),
);
await page.route('**/api/ops/git-info', (route) =>
route.fulfill({
status: 200,
contentType: 'application/json',
body: JSON.stringify({
code: 0,
data: [
{ env: 'prod', branch: 'main', commit: 'abc1234', dirty: false },
],
}),
}),
);
// 数据库健康
await page.route('**/api/db-health**', (route) =>
route.fulfill({
status: 200,
contentType: 'application/json',
body: JSON.stringify({
code: 0,
data: [
{ db_name: 'etl_feiqiu', status: 'healthy', latency_ms: 5, details: null },
{ db_name: 'zqyy_app', status: 'healthy', latency_ms: 3, details: null },
],
}),
}),
);
// AI 调度摘要trigger jobs
await page.route('**/api/admin/ai/trigger-jobs**', (route) =>
route.fulfill({
status: 200,
contentType: 'application/json',
body: JSON.stringify({
code: 0,
data: { items: [], total: 0 },
}),
}),
);
// AI Dashboard 相关
await page.route('**/api/admin/ai/**', (route) =>
route.fulfill({
status: 200,
contentType: 'application/json',
body: JSON.stringify({ code: 0, data: [] }),
}),
);
// 统一触发器
await page.route('**/api/triggers/unified**', (route) =>
route.fulfill({
status: 200,
contentType: 'application/json',
body: JSON.stringify({
code: 0,
data: [
{
id: 1, name: '测试触发器', source: 'biz',
trigger_condition: 'cron', status: 'running',
last_run_at: '2026-01-01T00:00:00', next_run_at: '2026-01-02T00:00:00',
last_error: null,
},
],
}),
}),
);
// 业务触发器
await page.route('**/api/trigger-jobs**', (route) =>
route.fulfill({
status: 200,
contentType: 'application/json',
body: JSON.stringify({
code: 0,
data: [
{
id: 1, job_name: 'test_job', description: '测试任务',
trigger_condition: 'cron', trigger_config: { cron_expression: '0 */2 * * *' },
status: 'enabled', last_run_at: null, next_run_at: null, last_error: null,
},
],
}),
}),
);
// ETL 调度任务
await page.route('**/api/schedules**', (route) =>
route.fulfill({
status: 200,
contentType: 'application/json',
body: JSON.stringify({
code: 0,
data: [
{
id: 1, name: 'ETL 日常同步', task_codes: ['ODS_LOAD'],
enabled: true, last_status: 'success',
last_run_at: '2026-01-01T00:00:00', next_run_at: '2026-01-02T00:00:00',
run_count: 100, created_at: '2025-01-01T00:00:00',
},
],
}),
}),
);
// 执行队列Footer 状态栏)
await page.route('**/api/execution/queue**', (route) =>
route.fulfill({
status: 200,
contentType: 'application/json',
body: JSON.stringify({ code: 0, data: [] }),
}),
);
// ETL 任务配置
await page.route('**/api/task-config**', (route) =>
route.fulfill({
status: 200,
contentType: 'application/json',
body: JSON.stringify({ code: 0, data: [] }),
}),
);
// ETL 状态
await page.route('**/api/etl-status**', (route) =>
route.fulfill({
status: 200,
contentType: 'application/json',
body: JSON.stringify({ code: 0, data: [] }),
}),
);
// 兜底:其他未匹配的 /api/ 请求返回空成功
await page.route('**/api/**', (route) =>
route.fulfill({
status: 200,
contentType: 'application/json',
body: JSON.stringify({ code: 0, data: [] }),
}),
);
}

View File

@@ -0,0 +1,122 @@
/**
* 导航与路由 E2E 测试。
*
* 验证点:
* - 默认路由 / → /dashboard 重定向
* - /log-viewer → /etl-tasks?tab=manager 重定向
* - 菜单高亮
* - Tab-URL 同步
*/
import { test, expect } from '@playwright/test';
import { injectAuth, mockAllApis } from './helpers';
test.describe('路由重定向', () => {
test.beforeEach(async ({ page }) => {
await injectAuth(page);
await mockAllApis(page);
});
test('/ 重定向到 /dashboard', async ({ page }) => {
await page.goto('/');
await expect(page).toHaveURL(/\/dashboard/);
// 确认 Dashboard 页面已渲染
await expect(page.locator('text=运行状态').first()).toBeVisible();
});
test('/log-viewer 重定向到 /etl-tasks?tab=queue', async ({ page }) => {
await page.goto('/log-viewer');
await expect(page).toHaveURL(/\/etl-tasks\?tab=queue/);
});
test('未登录时重定向到 /login', async ({ page }) => {
// 清除 localStorage 中的令牌
await page.goto('/login', { waitUntil: 'commit' });
await page.evaluate(() => {
localStorage.removeItem('access_token');
localStorage.removeItem('refresh_token');
});
await page.goto('/dashboard');
await expect(page).toHaveURL(/\/login/);
});
});
test.describe('菜单高亮', () => {
test.beforeEach(async ({ page }) => {
await injectAuth(page);
await mockAllApis(page);
});
test('Dashboard 页面菜单高亮"运行状态"', async ({ page }) => {
await page.goto('/dashboard');
await expect(page.locator('text=运行状态').first()).toBeVisible();
// Ant Design Menu 选中项会有 ant-menu-item-selected 类
const menuItem = page.locator('.ant-menu-item-selected', { hasText: '运行状态' });
await expect(menuItem).toBeVisible();
});
test('ETL 任务页面菜单高亮"ETL 任务管理"', async ({ page }) => {
await page.goto('/etl-tasks');
const menuItem = page.locator('.ant-menu-item-selected', { hasText: 'ETL 任务管理' });
await expect(menuItem).toBeVisible();
});
test('触发器管理页面菜单高亮"触发器管理"', async ({ page }) => {
await page.goto('/triggers');
const menuItem = page.locator('.ant-menu-item-selected', { hasText: '触发器管理' });
await expect(menuItem).toBeVisible();
});
});
test.describe('Tab-URL 同步', () => {
test.beforeEach(async ({ page }) => {
await injectAuth(page);
await mockAllApis(page);
});
test('ETL 任务页 Tab 切换同步 URL', async ({ page }) => {
await page.goto('/etl-tasks');
await expect(page.locator('text=ETL 任务管理').first()).toBeVisible();
// 点击"队列"Tab
await page.locator('[role="tab"]', { hasText: '队列' }).click();
await expect(page).toHaveURL(/\?tab=queue/);
// 点击"调度"Tab
await page.locator('[role="tab"]', { hasText: '调度' }).click();
await expect(page).toHaveURL(/\?tab=schedule/);
// 点击"历史"Tab
await page.locator('[role="tab"]', { hasText: '历史' }).click();
await expect(page).toHaveURL(/\?tab=history/);
// 点击"状态"Tab
await page.locator('[role="tab"]', { hasText: '状态' }).click();
await expect(page).toHaveURL(/\?tab=status/);
// 点击"发起"Tab 回到默认
await page.locator('[role="tab"]', { hasText: '发起' }).click();
await expect(page).toHaveURL(/\?tab=config/);
});
test('触发器管理页 Tab 切换同步 URL', async ({ page }) => {
await page.goto('/triggers');
await expect(page.locator('text=触发器管理').first()).toBeVisible();
// 点击"业务"Tab
await page.locator('[role="tab"]', { hasText: '业务' }).click();
await expect(page).toHaveURL(/\?tab=biz/);
// 点击"AI"Tab
await page.locator('[role="tab"]', { hasText: 'AI' }).click();
await expect(page).toHaveURL(/\?tab=ai/);
// 点击"ETL"Tab
await page.locator('[role="tab"]', { hasText: 'ETL' }).click();
await expect(page).toHaveURL(/\?tab=etl/);
// 回到"全部"Tab
await page.locator('[role="tab"]', { hasText: '全部' }).click();
await expect(page).toHaveURL(/\?tab=all/);
});
});

View File

@@ -0,0 +1,85 @@
/**
* 触发器管理页面 E2E 测试。
*
* 验证点:
* - 4 个 Tab全部、业务、AI、ETL
* - 统一视图数据展示
* - 业务 Tab 编辑功能存在
*/
import { test, expect } from '@playwright/test';
import { injectAuth, mockAllApis } from './helpers';
test.describe('触发器管理页面', () => {
test.beforeEach(async ({ page }) => {
await injectAuth(page);
await mockAllApis(page);
await page.goto('/triggers');
// 等待页面标题渲染
await expect(page.locator('text=触发器管理').first()).toBeVisible();
});
test('4 个 Tab 均可见', async ({ page }) => {
await expect(page.locator('[role="tab"]', { hasText: '全部' })).toBeVisible();
await expect(page.locator('[role="tab"]', { hasText: '业务' })).toBeVisible();
await expect(page.locator('[role="tab"]', { hasText: 'AI' })).toBeVisible();
await expect(page.locator('[role="tab"]', { hasText: 'ETL' })).toBeVisible();
});
test('默认显示"全部"Tab', async ({ page }) => {
const allTab = page.locator('[role="tab"]', { hasText: '全部' });
await expect(allTab).toHaveAttribute('aria-selected', 'true');
});
test('统一视图表格展示数据', async ({ page }) => {
// "全部"Tab 的统一视图表格应展示 mock 数据
// 等待表格渲染
await expect(page.locator('table').first()).toBeVisible();
// 验证 mock 数据中的触发器名称
await expect(page.locator('text=测试触发器')).toBeVisible();
// 验证类型标签
await expect(page.locator('text=业务')).toBeVisible();
});
test('切换到业务 Tab 并验证编辑按钮', async ({ page }) => {
const bizTab = page.locator('[role="tab"]', { hasText: '业务' });
await bizTab.click();
await expect(bizTab).toHaveAttribute('aria-selected', 'true');
await expect(page).toHaveURL(/\?tab=biz/);
// 等待业务触发器表格加载
await expect(page.locator('table').first()).toBeVisible();
// 验证编辑按钮存在mock 数据中 status=enabled编辑按钮应可用
const editBtn = page.locator('button', { hasText: '编辑' }).first();
await expect(editBtn).toBeVisible();
});
test('切换到 AI Tab', async ({ page }) => {
const aiTab = page.locator('[role="tab"]', { hasText: 'AI' });
await aiTab.click();
await expect(aiTab).toHaveAttribute('aria-selected', 'true');
await expect(page).toHaveURL(/\?tab=ai/);
});
test('切换到 ETL Tab', async ({ page }) => {
const etlTab = page.locator('[role="tab"]', { hasText: 'ETL' });
await etlTab.click();
await expect(etlTab).toHaveAttribute('aria-selected', 'true');
await expect(page).toHaveURL(/\?tab=etl/);
// 等待 ETL 调度表格加载
await expect(page.locator('table').first()).toBeVisible();
});
test('通过 URL 直接访问 biz Tab', async ({ page }) => {
await page.goto('/triggers?tab=biz');
const bizTab = page.locator('[role="tab"]', { hasText: '业务' });
await expect(bizTab).toHaveAttribute('aria-selected', 'true');
});
test('通过 URL 直接访问 ai Tab', async ({ page }) => {
await page.goto('/triggers?tab=ai');
const aiTab = page.locator('[role="tab"]', { hasText: 'AI' });
await expect(aiTab).toHaveAttribute('aria-selected', 'true');
});
});