常見開發情境
透過四項具體工作,串接頁面、業務資料、付費權益與多語言發布。
完成基本設定後,串接自己的業務功能時,通常會遇到四件事:建立登入後才能使用的頁面、儲存使用者資料、控制付費存取,以及支援新語言。本章以這四項工作為主,每篇都說明需要修改哪些檔案、如何串接既有模組,以及如何驗證結果。
從哪裡開始
| 教學 | 完成後的結果 | 開始前需要準備 |
|---|---|---|
| 新增登入後才能使用的業務頁面 | 具備多語言文案與登入檢查的工作區頁面 | 本機專案可以執行,且能登入 |
| 從業務資料表到使用者資料 API | 可建立與分頁讀取的個人收藏連結 API | 本機 D1 已初始化 |
| 為業務功能串接付費權益 | 方案、付款與業務權限串成完整流程 | 已串接 Stripe 測試環境 |
| 為網站新增語言 | 頁面、文案與內容支援日文 | 熟悉現有頁面與內容目錄 |
前兩篇可以依序操作。第三篇會在收藏連結功能上加入付費存取,第四篇則可以獨立閱讀。程式碼中新增的 workspace、saved-links 與 saved_links_access,都是教學範例,不是範本預先提供的功能。
本文的檔案路徑,皆以透過 Saavo 建立的應用程式根目錄為基準。程式碼區塊標示「新增檔案」時,可以作為該檔案的起點。標示「合併至」時,只新增對應欄位,不要覆寫既有設定。
與前面章節的關係
實作教學示範從產品構想到上線的完整過程,本章則補充日常開發中可以個別完成的工作。常用功能介紹各模組的職責、設定與運作方式,需要了解背景時,再回到對應章節。
下列主題已有專門說明,這裡不再重複維護簡略版教學:
- 第三方登入:Google OAuth。
- 次數、額度與點數:權限與使用權益與設計方案與串接使用權益。
- 檔案、郵件與排程工作:檔案儲存、電子郵件、排程工作。
教學會沿用範本既有的分層方式。資料庫結構、SQL、資料轉換、業務規則與 HTTP API,各有明確的位置,後續新增功能時,可以沿著相同流程擴充。