開始使用

快速開始

在本機用 docker compose 起完整套服務，貼上第一份條文，看它變成可以驗證的 CQL。

事前準備：Docker（含 Compose），以及執行前端開發伺服器用的 Node.js 與 npm。

安裝步驟

1
設定環境變數
複製 .env.example，並產生一組 JWT_SECRET。在 NODE_ENV=production 下，留空或仍是預設值，backend 會拒絕啟動。
Terminal
```
cp .env.example .env
openssl rand -hex 32  # 填入 JWT_SECRET
```
2
啟動服務
一次起 nginx、backend、postgres、cql-engine 與 RustFS。新的資料庫 volume 第一次啟動時，會自動套用全部 migration。
```
docker compose up -d
```
3
啟動前端
Vite 開發伺服器會把 /api 代理到 nginx 的 :8081。
```
cd frontend && npm ci && npm run dev
# http://localhost:5173
```
4
設定 LLM
以管理員登入，到「管理 → LLM 設定」新增模型 profile。多個 profile 可以依 priority 備援（fallback），或依 weight 分流（load_balance）。
5
分析第一份條文
貼上文字，或上傳 PDF、docx。系統先拆成任務，再逐段分析成 IR；完成後到審核頁逐條件接受、退回或標為不適用。

上線前必須更換：預設管理員由 ensureSeedAdmin 建立；.env.example 裡的所有密碼都是開發用預設值。

服務	位址
工作台（開發）	http://localhost:5173
整套服務（nginx）	http://localhost:8081
RustFS console	http://localhost:8081/rustfs/console/

backend 沒有 volume mount，改了程式碼要重新 build：

docker compose build backend && docker compose up -d backend