Repository navigation
Overview
本版本為 Survey System MVP v0.2.0 (Production Readiness Preview),標誌著問卷系統從功能原型走向具備完整 Production Readiness 與 Open-Source Hardening 規格的現代化問卷平台。
Note
本版本目前定位為 Self-Hosted Ready / Preview,適合個人、研究團隊或組織在本地及私有伺服器環境中部署使用。
Highlights (M1 ~ M5 核心功能)
- Survey Engine:以原始答案為唯一正式資料來源之高彈性問卷引擎。
- Multiple Question Types:支援單選、複選、單行文字、多行文字、數值、是非(Yes/No)與提示型純文字等多種題型。
- Scoring Engine:支援正向/反向計分、0分與NULL(不計分)嚴格區隔、自訂分值與最高分計算。
- Skip Logic & Visibility Rules:強大條件跳題引擎,支援多條件 AND/OR 組合、Shorthand 語法、中文選項標籤(Label)比對及防呆循環相依檢測(DAG)。
- Draft Responses:支援作答進度隨時暫存與續填,具備草稿獨立管理與刪除機制。
- Survey Versioning:問卷具備版本機制,支援一鍵版本複製(Clone Version)。
- Published Survey Lock:問卷一旦發布即鎖定題目、選項與規則,防範歷史結果被破壞。
-
Normalized AnswerChoice Model:複選題建立正規化
AnswerChoice(answer_choices) 關聯,同時維持raw_value100% 向後相容。 -
Excel Import/Export Round-Trip:Excel
$\rightarrow$ Import$\rightarrow$ DB$\rightarrow$ Export$\rightarrow$ Re-import 達成 100% 屬性零遺失無損保真。 - Deterministic Statistics:經基準資料集嚴格驗證之統計報表引擎(排除隱藏題分母、排除草稿、精準平均與比例)。
-
Anonymous Survey Support:明確的問卷層級匿名設定(
is_anonymous=true),API 嚴格禁止蒐集未授權個資。 - GitHub Actions CI:完整自動化 CI 工作流(Node 20 + PostgreSQL + lint + typecheck + vitest + next build)。
-
Docker / PostgreSQL Support:提供 Multi-stage Dockerfile 與具備 PostgreSQL healthcheck 依賴的一鍵啟動
docker compose up -d。
Quality Assurance
- 66 Automated Tests Passed:19 個測試套件共 66 項自動化單元/整合測試 100% PASS。
- TypeScript Typecheck:0 errors (
tsc --noEmit)。 - ESLint:0 warnings / 0 errors。
- Production Build:Next.js Standalone 生產打包成功編譯。
- GitHub Actions CI:遠端 CI 流程綠燈通過。
Known Limitations
- Authentication & Authorization:尚未整合使用者登入與權限管理。
- Multi-user / Multi-tenant:目前為單租戶架構,尚未支援多租戶隔離。
- Public Sharing / QR Code:尚未內建公開短網址與 QR Code 分享生成器。
- Prisma Migration:目前使用
prisma db push進行同步,正式生產部署建議建立基準遷移檔。 - Production Deployment Strategy:目前提供 Docker Compose 方案,尚未提供 Kubernetes Helm Chart 或雲端 Serverless 部署模板。