Petrichor 的应用架构总览

┌─────────────────────────────────────────────────────────┐
│  浏览器 (SPA + SSR Public Pages)                        │
└────────────┬────────────────────────────────────────────┘
             │ HTTPS
             ▼
┌─────────────────────────────────────────────────────────┐
│  Vercel Edge / Serverless Functions                      │
│  ├─ app/[...path]/page.tsx     ← 客户端 SPA 壳          │
│  ├─ app/api/**/route.ts        ← API 薄路由层           │
│  ├─ app/rss.xml/atom.xml/...   ← 公开 RSS / SEO         │
│  └─ src/server/**              ← handler + 业务逻辑     │
└──────┬────────────────────┬─────────────────────┬───────┘
       │ Postgres            │ S3 兼容              │ 用户自带 AI Key
       │ (Transaction        │ (上传 / 头像 /        │ (OpenAI/Gemini/
       │  Pooler 6543)        │  附件 / 封面)         │  DeepSeek/...)
       ▼                     ▼                     ▼
┌──────────────┐    ┌──────────────────┐   ┌─────────────────┐
│ Supabase     │    │ Bitiful / R2 /   │   │ AI 厂商 OpenAI  │
│ PostgreSQL   │    │ AWS S3 / MinIO   │   │ 兼容 HTTP API   │
└──────────────┘    └──────────────────┘   └─────────────────┘

.
├── apps/
│   └── web/                # Next.js 全栈应用
├── docs/                   # SQL 迁移 + 文档
├── package.json            # 根 package（workspace 声明）
├── pnpm-workspace.yaml
└── pnpm-lock.yaml

{
  "scripts": {
    "dev": "pnpm --filter @petrichor/web dev",
    "build": "pnpm --filter @petrichor/web build",
    "test": "pnpm --filter @petrichor/web test"
  }
}
JSON

// app/api/kb/list/route.ts
export { listKnowledgeBases as POST } from '@/server/kb/handlers'

export async function listKnowledgeBases(request: NextRequest) {
  try {
    const user = await requireCurrentUser(request)
    const input = listKnowledgeBasesSchema.parse(await readJson(request))
    const result = await listKnowledgeBasesByUser({
      userId: user.id,
      ...input
    })
    return ok(tableData(result.items, result.total))
  } catch (error) {
    return toErrorResponse(error, request.nextUrl.pathname)
  }
}

src/server/
├── kb/                   # 知识库模块
│   ├── handlers.ts       # HTTP handler（薄）
│   ├── logic.ts          # 业务逻辑（厚，可测试）
│   ├── logic.test.ts
│   └── mappers.ts        # 数据库 → API 响应的映射
├── auth/                 # 认证：邮箱密码、Better Auth 桥接、LinuxDo OAuth
├── ai/                   # AI 模型配置 / 写作 / LLM Wiki Agent
├── upload/               # S3 预签名上传
├── notification/
├── db/
│   ├── schema.ts         # Drizzle 表结构（单一信源）
│   ├── client.ts         # 连接池
│   └── full-migration.ts # 生成完整初始化 SQL
└── http/
    ├── response.ts       # ok / tableData / toErrorResponse
    └── pagination.ts     # 通用分页参数解析

// apps/web/src/server/db/client.ts
import { drizzle } from 'drizzle-orm/postgres-js'
import postgres from 'postgres'


let client: postgres.Sql | null = null
let db: ReturnType<typeof drizzle<typeof schema>> | null = null


export function getSqlClient() {
  client ??= postgres(getServerConfig().databaseUrl, {
    max: 5,
    prepare: false
  })
  return client
}

PostgresError: prepared statement "s1" already exists

export const users = pgTable(
  'petrichor_user',
  {
    id: bigint('id', { mode: 'bigint' }).primaryKey().generatedAlwaysAsIdentity(),
    authUserId: text('auth_user_id'),
    email: text('email').notNull(),
    passwordHash: text('password_hash').notNull(),
    systemRole: text('system_role').notNull().default('USER')
    // ...
  },
  table => [uniqueIndex('ux_petrichor_user_email').on(table.email)]
)

pnpm --silent --filter @petrichor/web db:sql > petrichor-init.sql
Bash