Repository navigation
Releases
Releases · Jake627520/questions
v0.2.0 - Production Readiness
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 部署模板。
v0.1.0: Survey System MVP
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 項自動化測試全數通過。