chore: prepare portable postgres development environment

README.md

@@ -28,3 +28,41 @@ corepack enable
 pnpm install
 pnpm check
 ```
+
+## 本地数据库
+
+在有 Docker 的机器上执行：
+
+```bash
+cp .env.example .env
+docker compose up -d postgres
+docker compose ps
+pnpm db:migrate
+pnpm db:seed
+```
+
+确认数据库健康后，再启动 API：
+
+```bash
+pnpm --filter @personal-brand/api dev
+```
+
+停止数据库但保留数据：
+
+```bash
+docker compose stop postgres
+```
+
+停止并删除容器但保留数据卷：
+
+```bash
+docker compose down
+```
+
+删除容器和本地数据库数据（不可恢复）：
+
+```bash
+docker compose down -v
+```
+
+`DATABASE_URL` 用于宿主机运行 API 时连接 `localhost`。如果以后把 API 也放进 Compose，连接地址应改为服务名 `postgres`，不能继续使用 `localhost`。