From 393ff406a370473e139700075068dd23f8de6de9 Mon Sep 17 00:00:00 2001
From: imbytecat <imbytecat@gmail.com>
Date: Sat, 25 Apr 2026 17:34:43 +0800
Subject: [PATCH] =?UTF-8?q?docs(readme):=20=E5=BC=BA=E8=B0=83=20PostgreSQL?=
 =?UTF-8?q?=2018+=20=E8=A6=81=E6=B1=82=E5=B9=B6=E6=8F=90=E4=BE=9B=20escape?=
 =?UTF-8?q?=20hatch?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

代码 schema 用了 PG 原生 uuidv7() 函数，PG <18 会炸。在技术栈行里把
PostgreSQL 改成 PostgreSQL 18+，快速开始顶部加 callout 说明改回
Bun.randomUUIDv7() 的方式以兼容老版本。
---
 README.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index d3cd0ea..0eef03c 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,7 @@
 
 一个**单二进制**的全栈应用 starter——`bun run compile` 出来的 `./server` 文件就是你要部署的全部产物，自带 HTTP 服务、SSR、API、嵌入式 SQL 迁移，运行时不依赖 Node、不依赖源码、不依赖外部 migration 目录。
 
-技术栈：Bun · TanStack Start (React 19 SSR) · ORPC（契约优先 API）· Drizzle ORM · PostgreSQL · Tailwind v4 · Biome。
+技术栈：Bun · TanStack Start (React 19 SSR) · ORPC（契约优先 API）· Drizzle ORM · PostgreSQL 18+ · Tailwind v4 · Biome。
 
 ## 为什么用这个
 
@@ -13,6 +13,8 @@
 
 ## 快速开始
 
+> **需要 PostgreSQL 18+**——schema 用 PG 原生的 `uuidv7()` 生成主键（`compose.yaml` 已锁 `postgres:18-alpine`）。要兼容更老的 PG，把 `src/server/db/fields.ts` 里的 `default(sql\`uuidv7()\`)` 换成 `$defaultFn(() => Bun.randomUUIDv7())`，再跑 `bun run db:generate`。
+
 ```bash
 cp .env.example .env        # 把里面的 DATABASE_URL 改成你的 Postgres
 bun install