快速開始 (Getting Started)

clone → 設定 → 跑起來，約 5 分鐘。

前置需求

工具	版本	安裝
Node.js	22+	nvm install 22
pnpm	9+	npm i -g pnpm
Docker	24+	docs.docker.com
PostgreSQL	15+	透過 Docker（建議）
Claude Code	latest	npm i -g @anthropic-ai/claude-code（選用，給 AI agent 開發）

1. 取得專案

git clone <你的 repo url> ai-rc-engineer-pm
cd ai-rc-engineer-pm

2. 一鍵本地啟動（建議）

專案根目錄的 Makefile 已封裝所有步驟：

make local-setup   # 首次：起 Docker Postgres + Mailpit、寫 .env.local（含新的 AUTH_SECRET）、跑 migration、seed demo 資料
make local         # 每次：起 Docker infra + Next.js dev server → http://localhost:3000

make local-setup 內部會呼叫 make local-db（套用 migration + seed demo 資料，idempotent）。

開啟 http://localhost:3000。

3. 手動步驟（如不使用 Makefile）

# 設定環境變數
cp next-app/.env.example next-app/.env.local

必要環境變數：

# 資料庫
DATABASE_URL=postgresql://saas_user:saas_pass@localhost:5432/saas_dev

# Auth.js v5（JWT session — 工牌編號登入需要 JWT，不能用 DB session）
AUTH_SECRET=your-random-secret-here   # openssl rand -base64 32
AUTH_URL=http://localhost:3000
AUTH_TRUST_HOST=true

# 起資料庫（infra only）
docker compose up -d postgres mailpit

# 安裝、migrate、seed
cd next-app
pnpm install
pnpm db:generate    # 從 lib/schema/* 產生 Drizzle migration
pnpm db:migrate     # 套用 migration
pnpm db:seed        # seed demo 帳號 + 瑞成 personas（dev only）

# 起 dev server
pnpm dev

4. 登入（工牌編號 + 密碼）

瑞成 PMS 以工牌編號（格式 R00001）+ 密碼登入，不需要公司 Email。

seed 後的測試帳號（三層權限各一）：

角色	工牌編號	密碼
管理員 Admin	R90001	Admin123!
行政 Operator	R90002	Editor123!
一般 Staff	R90003	Viewer123!

另有六位瑞成 personas（R00001 張庭瑜、R00012 林靜怡、R00007 陳柏宇 等）供展示真實案件資料，密碼皆為 Rc123456!。

下一步

• 架構與 API Guide — 了解 Route Handlers、Server Actions 與 RBAC 守衛
• 部署 Deployment — 部署到 Zeabur
• 終端使用者操作手冊與領域知識（六大分類、三層權限、燈號預警）請見另一個獨立發佈的 user-docs 使用手冊站