🚀 快速開始
| 想做什麼 | 看哪份文件 |
|---|---|
| 安裝 + 啟動本機伺服器 | QUICK_START.md |
| 把專案推到自己的 GitHub | PUSH_TO_GITHUB.md |
| 設定 Git SSH / HTTPS 認證 | GIT_AUTH_SETUP.md |
| 多 GitHub 帳號異地備份 | MULTI_GITHUB_BACKUP.md |
| 公開部署到網路上 | PUBLIC_DEPLOYMENT.md |
| 立即部署：GitHub Pages + Render | DEPLOY_NOW.md |
| 公眾分享庫部署細節 | GALLERY_DEPLOYMENT.md |
📚 設計脈絡 / 開發歷程
📊 工作紀錄
WORK_LOG_2026-04-26.md — 2026-04-26 工作紀錄（5d 筆順練習 + 5g 公眾分享庫完成總結）
🎯 決策日誌
docs/decisions/ — 完整決策日誌：每個模組的設計取捨、遭遇困難、解法
各模組決策日誌索引
| 模組 | 狀態 |
|---|---|
| mode_01: 單字模式 + 核心 IR 設計 | ✅ 完成 |
| mode_02: 字帖模式 | 追溯中 |
| mode_03: 筆記模式 | 追溯中 |
| mode_04: 信紙模式 | 追溯中 |
| mode_05: 稿紙模式 | 追溯中 |
| mode_06: 塗鴉模式 | 追溯中 |
| mode_07: 文字雲家族 | 追溯中 |
| mode_08: 抄經模式 | 追溯中 |
| mode_09: 筆順練習頁 PSD | 追溯中 |
| mode_10: 公眾分享庫 | 追溯中 |
| infra_01: 資料源 chain（多源 fallback） | ✅ 完成 |
| 2026-04-26: 5d + 5g 階段決策 | ✅ 完成 |
🛠 技術概覽
- 後端：Python 3.10+ FastAPI、stdlib SQLite + smtplib（無 ORM、無 PyJWT、零 auth 依賴）
- 前端：原生 ES modules（無 React/Vue/build step）
- 資料源：g0v / Make Me a Hanzi / KanjiVG / CNS 全字庫 / 教育部 楷·隸·宋 / 崇羲篆體 / 使用者字典
- 核心 IR：EM 2048 Y-down 座標系、Character / Stroke / Point 三層 dataclass
- 測試：1057 條 pytest（涵蓋 Phase 1 → 5g 全模組）
🌐 線上資源
- 📦 GitHub repo：github.com/seyen37/stroke-order
- 🚀 線上 demo：stroke-order.onrender.com（首次喚醒 ~30 秒，免費 tier 限制）
- ✍️ 筆順練習頁：/handwriting
- 🌐 公眾分享庫：/gallery
📜 授權
- 程式碼：MIT License（LICENSE）
- 第三方資料源：各保留原始授權，整理見 LICENSE 末段