4.2 设计交互式数据仪表盘布局
一个优秀的数据分析平台,其 UI/UX 设计直接决定了用户能否高效地获取数据洞察。对于 AI Data Agent 项目而言,我们的界面不仅要展示传统的数据图表,还需要优雅地容纳自然语言输入、异步任务状态跟踪以及大模型的流式或结构化输出。
本节我们将基于 Tailwind CSS,在我们的 Next.js 前端项目中设计一个现代化、支持暗黑模式的仪表盘 (Dashboard) 布局,并将上一节中编写的 AnalysisForm、UploadForm 和 TaskStatusViewer 等组件完美融合进去。
1. 仪表盘的架构设计思想
大多数 B端/数据类产品的经典布局包含以下三个部分:
- Sidebar (侧边栏):系统级导航,用于切换不同的分析项目、数据源或历史报告。
- Header (顶部导航):包含全局状态提示(如系统连接状态、环境提示)和用户身份信息。
- Main Content (主内容区):核心工作区。对于我们的 AI Analyzer 项目,主内容区需要被划分为“核心指标区”、“数据操作区”和“AI 交互区”。
在 Next.js 的 App Router 架构中,我们可以完美利用嵌套路由布局 (Nested Layouts):将侧边栏和 Header 放在 layout.tsx 中,让它们在页面切换时保持状态且不重新渲染;将核心内容放在 page.tsx 中。
2. 构建 Dashboard 全局布局骨架
我们在 frontend/src/app/dashboard/ 目录下创建一个 layout.tsx 文件。这个布局组件将包裹我们所有的 Dashboard 页面,并提供支持 Tailwind 暗黑模式 (dark:) 的 UI 骨架。
// frontend/src/app/dashboard/layout.tsx
import React from 'react';
export default function DashboardLayout({
children,
}: {
children: React.ReactNode;
}) {
return (
<div className="flex h-screen bg-gray-50 dark:bg-zinc-950 text-black dark:text-zinc-100">
{/* 左侧边栏 (Sidebar) */}
<aside className="w-64 bg-white dark:bg-zinc-900 border-r border-gray-200 dark:border-zinc-800 p-4 flex flex-col hidden md:flex">
<div className="mb-8 px-2">
<h2 className="text-2xl font-bold bg-gradient-to-r from-blue-600 to-indigo-600 bg-clip-text text-transparent">
AI Analyzer
</h2>
<p className="text-xs text-gray-500 dark:text-zinc-500 mt-1">智能数据洞察引擎</p>
</div>
<nav className="flex-1">
<ul className="space-y-2">
<li>
<a href="/dashboard" className="block p-3 bg-blue-50 dark:bg-blue-900/20 text-blue-700 dark:text-blue-400 rounded-lg font-medium transition-colors">
总览面板
</a>
</li>
<li>
<a href="#" className="block p-3 text-gray-600 dark:text-zinc-400 hover:bg-gray-100 dark:hover:bg-zinc-800/50 rounded-lg font-medium transition-colors">
数据源管理
</a>
</li>
{/* 更多菜单项... */}
</ul>
</nav>
{/* 底部用户信息 */}
<div className="border-t border-gray-200 dark:border-zinc-800 pt-4 mt-auto">
<div className="flex items-center gap-3 px-2">
<div className="w-8 h-8 rounded-full bg-gradient-to-tr from-indigo-500 to-purple-500 flex items-center justify-center text-white font-bold text-sm">A</div>
<div>
<p className="text-sm font-medium">Admin User</p>
</div>
</div>
</div>
</aside>
{/* 右侧主体区 */}
<div className="flex-1 flex flex-col overflow-hidden relative">
{/* 顶部 Header */}
<header className="h-16 bg-white/80 dark:bg-zinc-900/80 backdrop-blur-md border-b border-gray-200 dark:border-zinc-800 flex items-center px-6 justify-between sticky top-0 z-10">
<div className="flex items-center gap-4">
<h1 className="text-xl font-semibold text-gray-800 dark:text-zinc-100">控制台</h1>
<span className="px-2 py-1 bg-green-100 dark:bg-green-900/30 text-green-700 dark:text-green-400 text-xs rounded-full border border-green-200 dark:border-green-800">
系统运行正常
</span>
</div>
</header>
{/* 核心内容滚动区 */}
<main className="flex-1 overflow-y-auto p-6 md:p-8">
<div className="max-w-7xl mx-auto">
{children}
</div>
</main>
</div>
</div>
);
}
技术点解析:
- 我们使用了
flex h-screen来固定满屏高度,配合flex-1 overflow-y-auto让主内容区可独立滚动,这是 Web 应用最经典的布局方式。backdrop-blur-md为顶部 Header 提供了毛玻璃质感,这在现代设计中非常流行。
3. 设计可复用的指标卡片 (Metric Cards)
在主内容区最显眼的位置,我们通常需要展示系统的核心状态和关键业务指标。我们先来封装一个 MetricCard 组件。
// frontend/src/components/MetricCard.tsx
import React from 'react';
interface MetricCardProps {
title: string;
value: string | number;
trend?: string;
isPositive?: boolean;
icon?: React.ReactNode;
}
export default function MetricCard({ title, value, trend, isPositive, icon }: MetricCardProps) {
return (
<div className="bg-white dark:bg-zinc-900 p-6 rounded-2xl shadow-sm border border-gray-100 dark:border-zinc-800 transition-all hover:shadow-md">
<div className="flex justify-between items-start mb-4">
<h3 className="text-sm font-medium text-gray-500 dark:text-zinc-400">{title}</h3>
{icon && <div className="text-gray-400 dark:text-zinc-500">{icon}</div>}
</div>
<div className="flex items-baseline gap-3">
<span className="text-3xl font-bold text-gray-900 dark:text-zinc-100">{value}</span>
{trend && (
<span className={`text-sm font-medium px-2 py-0.5 rounded-full flex items-center gap-1 ${
isPositive
? 'bg-green-50 text-green-600 dark:bg-green-900/20 dark:text-green-400'
: 'bg-red-50 text-red-600 dark:bg-red-900/20 dark:text-red-400'
}`}>
{/* 上下箭头图标略 */}
{trend}
</span>
)}
</div>
</div>
);
}
4. 整合 AI 模块:重构 Dashboard 页面
现在,我们要把前面章节写的 Server Actions 文件上传、SWR 任务轮询、以及自然语言 AI 表单全部整合到刚才搭建好的布局中。
利用 CSS Grid 布局,我们可以将页面划分得井井有条:
- 顶部放置欢迎语和后端 NestJS 的连接状态。
- 中间使用
grid-cols-4放置 4 张MetricCard。 - 底部使用
grid-cols-2左右分栏:左侧负责批量数据操作(上传与进度监听),右侧负责 AI 对话交互。
// frontend/src/app/dashboard/page.tsx
import AnalysisForm from '@/components/AnalysisForm';
import UploadForm from '@/components/UploadForm';
import TaskStatusViewer from '@/components/TaskStatusViewer';
import MetricCard from '@/components/MetricCard';
export default async function DashboardPage() {
// 服务端获取 NestJS 后端连接状态
let statusText = '未知';
let isConnected = false;
try {
const res = await fetch('http://localhost:3001/analysis/status', { cache: 'no-store' });
if (res.ok) {
statusText = await res.text();
isConnected = true;
}
} catch (error) {
statusText = '后端未连接 (请确保 nestjs 在 3001 端口运行)';
}
return (
<div className="space-y-8">
{/* 欢迎模块 & 状态展示 */}
<div className="flex flex-col md:flex-row justify-between items-start md:items-center gap-4 bg-white dark:bg-zinc-900 p-6 rounded-2xl shadow-sm border border-gray-100 dark:border-zinc-800">
<div>
<h2 className="text-2xl font-bold text-gray-900 dark:text-zinc-100">欢迎回来,数据分析师 👋</h2>
<p className="text-gray-500 dark:text-zinc-400 mt-1">今天的数据准备好进行 AI 深度分析了吗?</p>
</div>
<div className="flex items-center gap-3 bg-gray-50 dark:bg-zinc-950 px-4 py-2 rounded-lg border border-gray-100 dark:border-zinc-800">
<div className="flex flex-col">
<span className="text-xs text-gray-500 dark:text-zinc-500">NestJS 引擎状态</span>
<span className="text-sm font-medium text-gray-900 dark:text-zinc-200">{statusText}</span>
</div>
<div className={`w-3 h-3 rounded-full ${isConnected ? 'bg-green-500 animate-pulse' : 'bg-red-500'}`}></div>
</div>
</div>
{/* 核心指标卡片区域 (Grid 布局) */}
<div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-4 gap-4">
<MetricCard title="今日分析任务" value="24" trend="12%" isPositive={true} />
<MetricCard title="已处理数据量" value="1.2 GB" trend="8.5%" isPositive={true} />
<MetricCard title="AI 洞察生成数" value="156" trend="2.4%" isPositive={false} />
<MetricCard title="队列排队中" value="0" />
</div>
{/* 业务功能操作区 */}
<div className="grid grid-cols-1 lg:grid-cols-2 gap-8">
{/* 左侧:数据上传与轮询状态 */}
<div className="space-y-8">
<section className="bg-white dark:bg-zinc-900 p-6 rounded-2xl shadow-sm border border-gray-100 dark:border-zinc-800">
<h2 className="text-lg font-semibold mb-2 text-gray-900 dark:text-zinc-100">批量数据上传</h2>
<p className="text-sm text-gray-500 dark:text-zinc-400 mb-6">上传您的 CSV/JSON 业务数据文件,引擎将自动排队解析并生成初步画像。</p>
<UploadForm />
</section>
<section className="bg-white dark:bg-zinc-900 p-6 rounded-2xl shadow-sm border border-gray-100 dark:border-zinc-800">
<h2 className="text-lg font-semibold mb-2 text-gray-900 dark:text-zinc-100">后台任务状态监听</h2>
<p className="text-sm text-gray-500 dark:text-zinc-400 mb-6">通过 SWR 轮询,实时追踪您的数据分析进度。</p>
<TaskStatusViewer jobId="demo-job-123" />
</section>
</div>
{/* 右侧:自然语言交互分析 */}
<section className="bg-white dark:bg-zinc-900 p-6 rounded-2xl shadow-sm border border-gray-100 dark:border-zinc-800 flex flex-col h-full">
<h2 className="text-lg font-semibold mb-2 text-gray-900 dark:text-zinc-100">AI 数据洞察对话</h2>
<p className="text-sm text-gray-500 dark:text-zinc-400 mb-6">直接输入您想了解的数据趋势或具体指标问题,让大模型为您解答。</p>
<div className="flex-1">
<AnalysisForm />
</div>
</section>
</div>
</div>
);
}
通过这套精心设计的布局,我们的页面瞬间从简单的 Demo 升级成了具备生产力工具质感的现代 Web 应用。
有了漂亮的骨架和各种表单/任务监听模块,下一节我们将把真实的数据通过图表库展示出来!
