Skip to content

Releases

v0.2.0 - Production Readiness

Choose a tag to compare

@Jake627520 Jake627520 released this 21 Aug 03:50

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 部署模板。

v0.1.0: Survey System MVP

Choose a tag to compare

@Jake627520 Jake627520 released this 21 Aug 02:54

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog,
and this project adheres to Semantic Versioning.


[0.1.0] - 2026-08-21

Milestone 1 (M1)

  • 核心問卷流程與資料庫架構(PostgreSQL + Prisma)。
  • 純函數核心計分引擎:支援 0 分與 NULL 嚴格區分、特殊非線性分數、負向題目反向計分。
  • Excel 雙 Sheet(questions、choices)匯入與報表匯出。
  • 「其他」必填文字與「以上皆非」互斥防呆。
  • 線上填答頁面、統計分析頁面。

Milestone 2 (M2)

  • 條件式顯示 / 跳題(Skip Logic)基礎引擎。
  • 複選題 min_selections / max_selections 數量限制。
  • 數值題 min_value / max_value 範圍檢核。
  • 輕量問卷版本控制(version 欄位與 parent_survey_id 關聯)。
  • 條件隱藏題目自動豁免必填與排除計分。

Milestone 3 (M3)

  • 條件跳題直覺簡寫語法解析(SHOW IF Q1 in [...]、SHOW IF Q5 contains slack、HIDE IF ...)。
  • 拓撲循環相依(Circular Dependency)檢測防護。
  • 草稿暫存與進度恢復(ResponseStatus.IN_PROGRESS,透過 ?responseId 恢復)。
  • 統計分母校正(被隱藏題目與草稿不計入分母)。
  • 問卷版本一鍵複製 API。

Milestone 4 (M4)

  • 簡寫語法支援選項中文標籤(label)智慧比對。
  • 條件題目顯現時的提示文字支援(visibility_hint)。
  • 回覆名單與草稿管理頁面(支援草稿刪除、已完成回覆保護)。
  • Excel 匯入多錯誤定位強化(附帶 Excel 列號與題目代碼)。
  • 累計 56 項自動化測試全數通過。