From 99d4a85ece848e3aad469caf880a0cb9074b0612 Mon Sep 17 00:00:00 2001
From: SerinaNya <34389622+SerinaNya@users.noreply.github.com>
Date: Mon, 28 Sep 2026 14:25:47 +0800
Subject: [PATCH] chore(db): add local PostgreSQL Compose setup

---
 .env.example |  1 +
 .gitignore   |  1 +
 README.md    | 32 ++++++++++++++++++++------------
 compose.yaml | 25 +++++++++++++++++++++++++
 package.json |  3 +++
 5 files changed, 50 insertions(+), 12 deletions(-)
 create mode 100644 .env.example
 create mode 100644 compose.yaml

diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..6611eb0
--- /dev/null
+++ b/.env.example
@@ -0,0 +1 @@
+DATABASE_URL=postgresql://postgres:Aa110011@localhost:5432/fluxent
diff --git a/.gitignore b/.gitignore
index c59e98a..4a7b1d0 100644
--- a/.gitignore
+++ b/.gitignore
@@ -30,6 +30,7 @@ pnpm-debug.log*
 
 # env files (can opt-in for committing if needed)
 .env*
+!.env.example
 
 # typescript
 *.tsbuildinfo
diff --git a/README.md b/README.md
index 1e66186..7f9512a 100644
--- a/README.md
+++ b/README.md
@@ -1,21 +1,29 @@
-# Next.js template
+# Fluxent Web
 
-This is a Next.js template with shadcn/ui.
+## 本地开发
 
-## Adding components
-
-To add components to your app, run the following command:
+需要已安装 Docker 和 pnpm。在项目目录执行：
 
 ```bash
-npx shadcn@latest add button
+pnpm install
+test -f .env.local || cp .env.example .env.local
+docker compose up -d
+docker compose ps
+pnpm db:logs
+pnpm drizzle-kit push --force
 ```
 
-This will place the ui components in the `components` directory.
+数据库镜像通过 `registry1.fw.ac.cn/docker.io/` 代理拉取最新的
+PostgreSQL Alpine 版本。
 
-## Using components
+`pnpm db:logs` 会持续显示数据库日志，可按 `Ctrl-C` 返回终端。数据库停止后仍会保留命名卷中的数据：
 
-To use the components in your app, import them as follows:
-
-```tsx
-import { Button } from "@/components/ui/button";
+```bash
+pnpm db:down
+```
+
+如需有意删除数据库及全部数据，执行以下命令。此操作不可恢复：
+
+```bash
+docker compose down -v
 ```
diff --git a/compose.yaml b/compose.yaml
new file mode 100644
index 0000000..54beb9b
--- /dev/null
+++ b/compose.yaml
@@ -0,0 +1,25 @@
+services:
+  db:
+    image: registry1.fw.ac.cn/docker.io/postgres:alpine
+    restart: unless-stopped
+    environment:
+      POSTGRES_USER: postgres
+      POSTGRES_PASSWORD: Aa110011
+      POSTGRES_DB: fluxent
+    ports:
+      - "127.0.0.1:5432:5432"
+    volumes:
+      - fluxent-postgres-data:/var/lib/postgresql
+    healthcheck:
+      test:
+        [
+          "CMD-SHELL",
+          'pg_isready -U "$${POSTGRES_USER}" -d "$${POSTGRES_DB}" -h 127.0.0.1 -p 5432',
+        ]
+      interval: 5s
+      timeout: 5s
+      retries: 10
+      start_period: 10s
+
+volumes:
+  fluxent-postgres-data:
diff --git a/package.json b/package.json
index c9cf450..659665d 100644
--- a/package.json
+++ b/package.json
@@ -7,6 +7,9 @@
     "dev": "next dev",
     "build": "next build",
     "start": "next start",
+    "db:up": "docker compose up -d --wait",
+    "db:down": "docker compose down",
+    "db:logs": "docker compose logs -f db",
     "lint": "eslint",
     "format": "prettier --write \"**/*.{ts,tsx}\"",
     "typecheck": "tsc --noEmit"