标准AI SaaS项目目录结构

my-nextjs-app/
├── app/                    # App Router 路由目录
│   ├── layout.tsx          # 根布局（所有页面共享）
│   ├── page.tsx            # 首页（/）
│   ├── loading.tsx         # 全局加载态
│   ├── error.tsx           # 全局错误边界
│   ├── not-found.tsx       # 404 页面
│   ├── globals.css         # 全局样式
│   └── (routes)/           # 路由分组（不影响 URL）
│       ├── dashboard/
│       │   ├── layout.tsx  # 仪表盘布局
│       │   └── page.tsx    # 仪表盘页面
│       └── settings/
│           └── page.tsx    # 设置页面
├── public/                 # 静态资源（直接通过 URL 访问）
│   ├── favicon.ico
│   └── images/
├── src/                    # （可选）应用源码根目录
├── next.config.ts          # Next.js 配置
├── tsconfig.json           # TypeScript 配置
├── package.json            # 依赖与脚本
├── .env.local              # 本地环境变量
└── .env.production         # 生产环境变量

my-ai-saas/
├── app/                    # 路由层：页面定义和数据获取
├── components/             # 组件层：可复用的 UI 组件
│   ├── ui/                 # 基础 UI 组件（Button、Input、Modal）
│   └── shared/             # 业务共享组件（Header、Sidebar、DataTable）
├── lib/                    # 工具层：通用工具函数和客户端
│   ├── utils.ts            # 纯函数工具
│   ├── db.ts               # 数据库连接
│   └── auth.ts             # 认证工具
├── services/               # 服务层：业务逻辑封装
│   ├── ai/                 # AI 相关服务
│   ├── billing/            # 计费服务
│   └── user/               # 用户服务
├── types/                  # 类型层：全局 TypeScript 类型
├── config/                 # 配置层：环境变量和应用配置
├── hooks/                  # Hooks 层：自定义 React Hooks
├── constants/              # 常量层：枚举值、固定配置
├── styles/                 # 样式层：全局样式和主题
└── public/                 # 静态资源

// ❌ 在路由中直接写业务逻辑
app/api/users/route.ts:
  const user = await db.user.create({ ... })
  await stripe.customers.create({ ... })
  await sendWelcomeEmail(user.email)
 
// ✅ 服务层封装
services/user/create-user.ts:
  export async function createUser(input: CreateUserInput) { ... }
 
app/api/users/route.ts:
  const user = await createUser(requestBody)

my-ai-saas/
├── ai/                          # AI 模块根目录
│   ├── providers/               # 模型提供商适配层
│   │   ├── openai.ts            # OpenAI 客户端封装
│   │   ├── anthropic.ts         # Anthropic 客户端封装
│   │   └── types.ts             # 提供商统一接口
│   ├── prompts/                 # Prompt 模板管理
│   │   ├── _registry.ts         # Prompt 注册表
│   │   ├── chat/                # 按功能分组
│   │   │   ├── system.ts        # 系统 Prompt
│   │   │   └── user-context.ts  # 用户上下文 Prompt
│   │   └── generation/
│   │       ├── outline.ts       # 大纲生成 Prompt
│   │       └── draft.ts         # 草稿生成 Prompt
│   ├── agents/                  # Agent 定义
│   │   ├── types.ts             # Agent 接口定义
│   │   ├── writer-agent.ts      # 写作 Agent
│   │   ├── editor-agent.ts      # 编辑 Agent
│   │   └── supervisor-agent.ts  # 监督 Agent
│   ├── vectors/                 # 向量存储相关
│   │   ├── embeddings.ts        # 文本向量化
│   │   ├── store.ts             # 向量数据库客户端
│   │   └── retrieval.ts         # 检索逻辑
│   ├── tools/                   # Agent 可调用的工具
│   │   ├── web-search.ts        # 网络搜索工具
│   │   ├── code-executor.ts     # 代码执行工具
│   │   └── types.ts             # 工具接口定义
│   ├── workflows/               # 多步骤工作流编排
│   │   ├── content-pipeline.ts  # 内容生产流水线
│   │   └── research-flow.ts     # 研究分析流程
│   └── middleware/              # AI 调用中间件
│       ├── rate-limit.ts        # 速率限制
│       ├── token-counter.ts     # Token 计数
│       └── retry.ts             # 重试策略
├── services/                    # 业务服务层
│   └── ai/                      # AI 业务逻辑（调用 ai/ 模块）
│       ├── chat.ts              # 对话业务
│       └── generation.ts        # 生成业务

// ❌ Prompt 散落在业务代码中
export async function generateOutline(topic: string) {
  const response = await openai.chat.completions.create({
    messages: [
      { role: "system", content: "你是一个专业的内容策划..." },
      { role: "user", content: `请为「${topic}」生成大纲...` }
    ]
  })
  // ...
}

// ✅ Prompt 独立文件
// ai/prompts/generation/outline.ts
export const OUTLINE_SYSTEM_PROMPT = `你是一个专业的内容策划...`
export const OUTLINE_USER_TEMPLATE = (topic: string) =>
  `请为「${topic}」生成大纲...`
 
// services/ai/generation.ts
import { OUTLINE_SYSTEM_PROMPT, OUTLINE_USER_TEMPLATE } from '@/ai/prompts/generation/outline'
 
export async function generateOutline(topic: string) {
  const response = await ai.chat({
    system: OUTLINE_SYSTEM_PROMPT,
    user: OUTLINE_USER_TEMPLATE(topic)
  })
}

// ❌ 按技术类型划分（容易失控）
components/  →  所有组件混在一起
hooks/       →  所有 hooks 混在一起
utils/       →  所有工具函数混在一起
 
// ✅ 按功能域划分（高内聚低耦合）
features/
├── auth/        →  认证相关组件、hooks、逻辑
├── billing/     →  计费相关组件、hooks、逻辑
└── ai-chat/     →  AI 对话相关组件、hooks、逻辑

// app/(dashboard)/chat/page.tsx
import { ChatView } from './_components/chat-view'
import { getUser } from '@/lib/auth'
import { redirect } from 'next/navigation'
 
export default async function ChatPage() {
  const user = await getUser()
  if (!user) redirect('/login')
 
  return <ChatView userId={user.id} />
}

// ai/providers/openai.ts
// 只知道如何调用 OpenAI API，不知道业务逻辑
export async function chatCompletion(params: ChatParams) { ... }
 
// services/ai/generation.ts
// 结合业务逻辑调用 AI 能力
export async function generateContent(userId: string, input: ContentInput) {
  const user = await getUser(userId)
  const plan = await getUserPlan(userId)
  const prompt = buildPrompt(input, user.tone)
  const result = await chatCompletion({ model: plan.model, prompt })
  await saveGeneration(userId, result)
  return result
}

// ai/agents/types.ts  → AI Agent 相关的类型
// services/billing/types.ts  → 计费相关的类型
// types/  → 跨多个功能域共享的全局类型

my-ai-mvp/
├── app/                         # 路由 + 页面组件
│   ├── (marketing)/             # 营销页面
│   │   ├── page.tsx             # 首页
│   │   └── pricing/page.tsx     # 定价页
│   ├── (app)/                   # 应用页面
│   │   ├── dashboard/page.tsx
│   │   └── chat/page.tsx
│   ├── api/                     # API 路由
│   │   └── chat/route.ts
│   └── layout.tsx
├── components/                  # 所有组件（暂不分类）
│   ├── ui/                      # 基础 UI
│   └── chat/                    # 对话相关组件
├── lib/                         # 工具函数 + 数据库 + AI 调用
│   ├── db.ts
│   ├── ai.ts                    # AI 调用（直接封装，不分目录）
│   └── auth.ts
├── types/                       # 全局类型
├── config/                      # 配置
└── public/                      # 静态资源

my-ai-saas/
├── app/                         # 路由层（保持简洁）
├── components/                  # 组件层
│   ├── ui/
│   ├── shared/
│   └── features/                # 按功能域组织的组件
│       ├── chat/
│       ├── generation/
│       └── billing/
├── services/                    # 服务层（从 lib/ 中抽离）
│   ├── ai/
│   ├── billing/
│   └── user/
├── ai/                          # AI 能力层（从 lib/ai.ts 拆出）
│   ├── providers/
│   ├── prompts/
│   ├── agents/
│   └── vectors/
├── lib/                         # 通用工具
├── types/
├── config/
└── public/

my-ai-platform/                   # Monorepo 根目录
├── apps/
│   ├── web/                      # 前端 Web 应用
│   ├── api/                      # 独立 API 服务
│   └── admin/                    # 管理后台
├── packages/
│   ├── ui/                       # 共享 UI 组件库
│   ├── ai-core/                  # AI 核心能力（providers、prompts、agents）
│   ├── db/                       # 数据库 schema 和迁移
│   ├── prompts/                  # Prompt 模板包（独立版本管理）
│   ├── vectors/                  # 向量存储包
│   ├── config/                   # 共享配置
│   └── types/                    # 共享类型
├── tools/                        # 开发工具
│   ├── prompt-editor/            # Prompt 编辑工具
│   └── eval-runner/              # AI 评测运行器
├── turbo.json
└── pnpm-workspace.yaml

ai-writer/
├── app/
│   ├── (marketing)/                  # 营销站
│   │   ├── layout.tsx                # 营销站布局（导航栏 + 页脚）
│   │   ├── page.tsx                  # 首页
│   │   ├── pricing/page.tsx          # 定价页
│   │   └── blog/
│   │       ├── page.tsx              # 博客列表
│   │       └── [slug]/page.tsx       # 博客详情
│   ├── (app)/                        # 应用主体
│   │   ├── layout.tsx                # 应用布局（侧边栏 + 顶栏）
│   │   ├── dashboard/
│   │   │   └── page.tsx              # 仪表盘
│   │   ├── documents/
│   │   │   ├── page.tsx              # 文档列表
│   │   │   ├── [id]/
│   │   │   │   ├── page.tsx          # 文档编辑器
│   │   │   │   └── _components/      # 编辑器内部组件
│   │   │   │       ├── editor.tsx
│   │   │   │       ├── toolbar.tsx
│   │   │   │       └── ai-suggestions.tsx
│   │   │   └── new/page.tsx          # 新建文档
│   │   ├── templates/
│   │   │   ├── page.tsx              # 模板库
│   │   │   └── [id]/page.tsx         # 模板详情
│   │   └── settings/
│   │       ├── page.tsx              # 设置首页
│   │       ├── billing/page.tsx      # 账单管理
│   │       └── api-keys/page.tsx     # API Key 管理
│   ├── api/
│   │   ├── webhooks/stripe/route.ts  # Stripe Webhook
│   │   ├── chat/route.ts             # AI 对话 API
│   │   └── documents/route.ts        # 文档 CRUD API
│   ├── layout.tsx                    # 根布局
│   ├── globals.css
│   └── not-found.tsx
├── components/
│   ├── ui/                           # 基础 UI（shadcn/ui 生成）
│   │   ├── button.tsx
│   │   ├── dialog.tsx
│   │   ├── input.tsx
│   │   └── ...
│   └── shared/                       # 共享业务组件
│       ├── header.tsx
│       ├── sidebar.tsx
│       ├── pricing-table.tsx
│       └── ai-streaming-text.tsx
├── services/
│   ├── document/
│   │   ├── create.ts                 # 创建文档
│   │   ├── update.ts                 # 更新文档
│   │   ├── list.ts                   # 文档列表
│   │   └── types.ts
│   ├── billing/
│   │   ├── stripe.ts                 # Stripe 集成
│   │   ├── plans.ts                  # 套餐逻辑
│   │   └── usage.ts                  # 用量统计
│   └── user/
│       ├── profile.ts
│       └── preferences.ts
├── ai/
│   ├── providers/
│   │   ├── openai.ts                 # OpenAI 封装
│   │   └── types.ts                  # 统一接口
│   ├── prompts/
│   │   ├── _registry.ts              # Prompt 版本注册表
│   │   ├── generate/
│   │   │   ├── article.ts            # 文章生成 Prompt
│   │   │   ├── outline.ts            # 大纲生成 Prompt
│   │   │   └── title.ts              # 标题生成 Prompt
│   │   ├── rewrite/
│   │   │   ├── simplify.ts           # 简化改写
│   │   │   ├── expand.ts             # 扩写
│   │   │   └── tone.ts               # 语气调整
│   │   └── translate/
│   │       └── translate.ts          # 翻译 Prompt
│   ├── agents/
│   │   ├── writer.ts                 # 写作 Agent（生成 + 改写）
│   │   └── editor.ts                 # 编辑 Agent（校对 + 润色）
│   ├── vectors/
│   │   ├── embeddings.ts             # 文档向量化
│   │   ├── store.ts                  # Pinecone 客户端
│   │   └── search.ts                 # 语义搜索
│   └── middleware/
│       ├── token-counter.ts          # Token 用量统计
│       └── rate-limit.ts             # 调用频率限制
├── lib/
│   ├── db.ts                         # Prisma 客户端
│   ├── auth.ts                       # NextAuth 配置
│   ├── utils.ts                      # 通用工具函数
│   └── validators.ts                 # Zod 校验 schema
├── hooks/
│   ├── use-ai-stream.ts              # AI 流式响应 Hook
│   ├── use-document.ts               # 文档状态 Hook
│   └── use-billing.ts                # 计费状态 Hook
├── types/
│   ├── document.ts
│   ├── user.ts
│   └── api.ts
├── config/
│   ├── env.ts                        # 环境变量校验（使用 @t3-oss/env-nextjs）
│   ├── site.ts                       # 站点元数据
│   └── ai-models.ts                  # 模型配置（名称、价格、上下文长度）
├── constants/
│   ├── plans.ts                      # 套餐定义
│   └── limits.ts                     # 各套餐用量限制
├── styles/
│   └── themes/
├── public/
│   ├── favicon.ico
│   └── og/                           # Open Graph 图片
├── prisma/
│   └── schema.prisma                 # 数据库 Schema
├── next.config.ts
├── tsconfig.json
├── tailwind.config.ts
└── package.json

ai-analytics/
├── app/
│   ├── (marketing)/                  # 营销站
│   │   ├── page.tsx
│   │   ├── pricing/page.tsx
│   │   └── docs/                     # 文档站
│   │       └── [[...slug]]/page.tsx
│   ├── (app)/                        # 应用主体
│   │   ├── layout.tsx                # 应用布局
│   │   ├── workspaces/
│   │   │   ├── page.tsx              # 工作空间列表
│   │   │   └── [id]/
│   │   │       ├── page.tsx          # 工作空间概览
│   │   │       ├── queries/
│   │   │       │   ├── page.tsx      # 查询列表
│   │   │       │   ├── [queryId]/
│   │   │       │   │   ├── page.tsx  # 查询详情 + 结果
│   │   │       │   │   └── _components/
│   │   │       │   │       ├── query-editor.tsx
│   │   │       │   │       ├── chart-view.tsx
│   │   │       │   │       └── ai-suggestions.tsx
│   │   │       │   └── new/page.tsx  # 新建查询
│   │   │       ├── datasources/
│   │   │       │   └── page.tsx      # 数据源管理
│   │   │       └── agents/
│   │   │           └── page.tsx      # Agent 配置
│   │   └── admin/
│   │       ├── page.tsx              # 管理后台
│   │       └── users/page.tsx        # 用户管理
│   ├── api/
│   │   ├── query/route.ts            # 查询执行 API
│   │   ├── query/stream/route.ts     # 流式查询 API
│   │   ├── datasources/route.ts      # 数据源 CRUD
│   │   └── webhooks/
│   │       └── stripe/route.ts
│   └── layout.tsx
├── ai/
│   ├── providers/
│   │   ├── openai.ts
│   │   ├── anthropic.ts
│   │   └── types.ts                  # Provider 统一接口
│   ├── prompts/
│   │   ├── nl2sql/
│   │   │   ├── system.ts             # 自然语言转 SQL 系统 Prompt
│   │   │   ├── schema-context.ts     # 数据库 Schema 上下文注入
│   │   │   └── few-shot.ts           # 示例 Prompt
│   │   ├── chart/
│   │   │   └── suggest.ts            # 图表类型推荐 Prompt
│   │   └── insight/
│   │       └── summarize.ts          # 数据洞察摘要 Prompt
│   ├── agents/
│   │   ├── types.ts
│   │   ├── query-agent.ts            # 查询 Agent（NL → SQL）
│   │   ├── chart-agent.ts            # 图表 Agent（数据 → 可视化）
│   │   ├── insight-agent.ts          # 洞察 Agent（结果 → 摘要）
│   │   └── supervisor.ts             # 监督 Agent（多 Agent 协调）
│   ├── tools/
│   │   ├── sql-executor.ts           # SQL 执行工具（带安全检查）
│   │   ├── chart-renderer.ts         # 图表渲染工具
│   │   ├── schema-reader.ts          # 数据库 Schema 读取工具
│   │   └── types.ts
│   ├── vectors/
│   │   ├── embeddings.ts             # 查询历史向量化
│   │   ├── store.ts                  # 向量存储（pgvector）
│   │   └── retrieval.ts              # 相似查询检索
│   ├── workflows/
│   │   ├── query-pipeline.ts         # NL → SQL → 执行 → 可视化
│   │   └── insight-pipeline.ts       # 数据 → 分析 → 洞察 → 报告
│   └── middleware/
│       ├── sql-safety.ts             # SQL 安全检查（防注入、限制操作）
│       ├── token-counter.ts
│       └── retry.ts
├── services/
│   ├── query/
│   │   ├── execute.ts
│   │   ├── history.ts
│   │   └── types.ts
│   ├── datasource/
│   │   ├── connection.ts             # 数据源连接管理
│   │   ├── schema.ts                 # Schema 获取与缓存
│   │   └── types.ts
│   ├── workspace/
│   │   ├── members.ts
│   │   └── settings.ts
│   └── billing/
│       ├── stripe.ts
│       └── usage.ts
├── components/
│   ├── ui/                           # 基础 UI
│   ├── shared/                       # 共享组件
│   └── features/
│       ├── query-editor/             # 查询编辑器组件
│       ├── chart-builder/            # 图表构建器
│       ├── datasource-wizard/        # 数据源配置向导
│       └── agent-config/             # Agent 配置界面
├── lib/
│   ├── db.ts
│   ├── auth.ts
│   ├── redis.ts                      # Redis 客户端（缓存、限流）
│   └── utils.ts
├── hooks/
│   ├── use-query-stream.ts
│   ├── use-workspace.ts
│   └── use-agent.ts
├── types/
│   ├── query.ts
│   ├── datasource.ts
│   ├── workspace.ts
│   └── agent.ts
├── config/
│   ├── env.ts
│   ├── ai-models.ts
│   └── supported-databases.ts        # 支持的数据库类型
├── constants/
│   ├── sql-limits.ts                 # SQL 执行限制（超时、行数）
│   └── plans.ts
├── prisma/
│   └── schema.prisma
└── package.json