feat(api): NestJS standalone 骨架 + Drizzle/postgres.js 接入

Co-Authored-By: Claude Code <noreply@anthropic.com>

apps/api/src/app.module.ts

@@ -0,0 +1,4 @@
+import { Module } from '@nestjs/common'
+
+@Module({ imports: [] })
+export class AppModule {}

apps/api/src/db/client.ts

@@ -0,0 +1,13 @@
+import './env.js'
+import { drizzle } from 'drizzle-orm/postgres-js'
+import postgres from 'postgres'
+import * as schema from './schema.js'
+
+// DATABASE_URL_TEST ?? DATABASE_URL 的回退链是 Task 13 集成测试的接线：
+// 测试临时库优先，开发库兜底。env 加载见 ./env.ts（向上查找仓库根 .env）。
+export function getDb(
+  connectionString = process.env.DATABASE_URL_TEST ?? process.env.DATABASE_URL!,
+) {
+  const sql = postgres(connectionString, { max: 5 })
+  return drizzle(sql, { schema })
+}

apps/api/src/db/env.ts

@@ -0,0 +1,18 @@
+import { existsSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { config } from 'dotenv'
+
+// dotenv 默认只读 cwd 下的 .env：从仓库根跑 `pnpm test` 时 cwd 是仓库根，能读到根 .env；
+// 但在 apps/api 内跑 drizzle-kit（db:generate / db:migrate）时 cwd 是包目录，默认读不到。
+// 因此这里从 cwd 逐级向上查找 .env（就近优先，找到即停），两种场景都能稳定读到仓库根 .env。
+let dir = process.cwd()
+for (;;) {
+  const candidate = join(dir, '.env')
+  if (existsSync(candidate)) {
+    config({ path: candidate })
+    break
+  }
+  const parent = dirname(dir)
+  if (parent === dir) break
+  dir = parent
+}

apps/api/src/db/schema.ts

@@ -0,0 +1,2 @@
+// 聚合导出：后续任务（6-12）按域追加 pgTable 定义
+export {}