Quick Start Guide

Full path from clone to first epic. Takes ~5 minutes. 本指南面向維護瑞成 PMS 這個 repo 的工程師（用 Claude Code 開發）。終端使用者操作請見另一個獨立發佈的 user-docs 使用手冊站。

Step 1: Clone and install

git clone <你的 repo url> ai-rc-engineer-pm
cd ai-rc-engineer-pm/next-app
pnpm install

Step 2: Configure database

# Start Postgres via Docker
docker compose up -d db

# Copy env template
cp .env.example .env.local
# Edit .env.local: set DATABASE_URL, AUTH_SECRET, NEXTAUTH_URL

Step 3: Run migrations and seed

pnpm db:generate
pnpm db:migrate
pnpm db:seed        # seed 三層 demo 帳號（工牌登入）+ 瑞成 personas

Step 4: Start dev server

pnpm dev
# → http://localhost:3000

登入（工牌編號 + 密碼）：管理員 R90001 / Admin123!、行政 R90002 / Editor123!、一般 R90003 / Viewer123!。

Step 5: Run quality checks

pnpm typecheck
pnpm lint
pnpm test
pnpm test:e2e

What's next?

• 領域知識（六大分類、三層權限、燈號預警）請見另一個獨立發佈的 user-docs 使用手冊站
• Set up the AI Agent Team for automated development
• Follow the First Epic Walkthrough to build a new feature