Rain9Rain9
首页
AI 岗位
AI 目录
前端
后端
桌面端
WebGL
Web3
  • 算法与面试
  • 面试八股
  • Vim 练级
  • Github
  • 掘金
  • 公众号《与 IT 有约》
首页
AI 岗位
AI 目录
前端
后端
桌面端
WebGL
Web3
  • 算法与面试
  • 面试八股
  • Vim 练级
  • Github
  • 掘金
  • 公众号《与 IT 有约》
  • 2026 · AI 时代

    • 程序员的出路:AI 时代的价值思考
    • 从零开始构建智能体(Hello-Agents 课程通俗笔记)

4.2 设计交互式数据仪表盘布局

一个优秀的数据分析平台,其 UI/UX 设计直接决定了用户能否高效地获取数据洞察。对于 AI Data Agent 项目而言,我们的界面不仅要展示传统的数据图表,还需要优雅地容纳自然语言输入、异步任务状态跟踪以及大模型的流式或结构化输出。

本节我们将基于 Tailwind CSS,在我们的 Next.js 前端项目中设计一个现代化、支持暗黑模式的仪表盘 (Dashboard) 布局,并将上一节中编写的 AnalysisForm、UploadForm 和 TaskStatusViewer 等组件完美融合进去。


1. 仪表盘的架构设计思想

大多数 B端/数据类产品的经典布局包含以下三个部分:

  1. Sidebar (侧边栏):系统级导航,用于切换不同的分析项目、数据源或历史报告。
  2. Header (顶部导航):包含全局状态提示(如系统连接状态、环境提示)和用户身份信息。
  3. 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>
  );
}

技术点解析:

  1. 我们使用了 flex h-screen 来固定满屏高度,配合 flex-1 overflow-y-auto 让主内容区可独立滚动,这是 Web 应用最经典的布局方式。
  2. 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 应用。

有了漂亮的骨架和各种表单/任务监听模块,下一节我们将把真实的数据通过图表库展示出来!

最近更新: 2026/10/31 10:01