Skip to content

v0.2.0 - Production Readiness

Latest

Choose a tag to compare

@Jake627520 Jake627520 released this 21 Aug 03:50
· 91 commits to main since this release

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_value 100% 向後相容。
  • 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 部署模板。