How leniolabs/ai-data-dashboard works
Project type and purpose
• This is a full-stack Next.js application (React + TypeScript) that lets end users upload CSV datasets and uses OpenAI’s GPT-3 to generate JSON-driven visualizations (bar, line, pie, treemap, etc.).
• The README confirms it’s a dashboard generator that accepts CSVs, sends them to OpenAI via a prompt template, and then renders charts automatically.
File structure
• Top-level “pages” folder: contains Next.js entrypoints (_app.tsx, index.tsx).
• “components/” subdivided into “layout” (UI widgets, buttons, inputs, panels) and “viz” (chart components).
• “openai/” folder: encapsulates all GPT-3 integration—API wrappers (completions.ts, analyze.ts), prompt templates, model configs.
• “utils/” holds CSV parsing, formatting, styling helpers.
• “lib/gtag.ts”: Google Analytics.
• Configuration: next.config.js, tsconfig.json, ESLint and style files under “styles/” and .vscode.
README for insights
• Architecture isn’t explicitly diagrammed there, but it specifies a client-server flow: user uploads CSV → AI analysis → JSON → charts.
• Dependencies: Next.js, OpenAI API, React, CSS modules.
Main components & interactions
a. Frontend / Presentation Layer
• Browser / User
• Next.js React UI: pages/index.tsx, components/layout, components/viz
• CSV Uploader (UploadDatasetButton + utils/parseData)
• User controls (filters, settings modal)
b. Backend / Business Logic Layer
• Next.js Serverless API (implied or built into pages—could be an API Route or server‐side function called from getServerSideProps or client fetch)
• openai/index.ts → analyze.ts / completions.ts → uses prompt templates in openai/template.ts
• Model configs: openai/models/*.ts
• Data transformation (utils/models.ts, utils/parseFunc.ts)
c. External Services
• OpenAI GPT-3 API (completions endpoint)
• Google Analytics (lib/gtag.ts)
d. Styling / Static Assets
• CSS Modules (styles/Components.module.scss) and public/
Architectural patterns & design principles
• Layered pattern: Presentation (components) ←→ Business Logic (API wrappers + utils) ←→ External (OpenAI).
• Component-based UI (atomic layout + viz components).
• Single-page interactions powered by serverless functions (no persistent database).
• JSON-first protocol: AI returns chart specifications that drive React viz components.
Essential elements
• Clear, consistent labels: “UploadDatasetButton”, “analyze.ts prompt service”, “PieChart”, etc.
• A title at the top: “AI Dashboard Generator – System Architecture”.
• A note or footnote explaining that components under openai/models select the GPT-3 variant.