API 與後端 MOC

用途：串連 API 設計、後端與資料庫的相關筆記。 上層：Software Engineering MOC

API 設計

• API
• RESTful API

驗證

• Example For Zod And Yup

資料庫

• 資料庫 MOC — schema 設計、正規化、SQL 方言與查詢效能原理

大量資料與長時間工作

• 1M 列批次建立改用瀏覽器內 SQLite（souffle 1199 + cupcake 1777） — 來源筆記：完整的前後端拆解、風險清單與矛盾點
• 用二進位 artifact 當 API 的傳輸格式 — 讓後端直接產可查詢的檔案
• 長時間工作改成 202 加 workflowId 輪詢
• 前端的即時驗證是 UX，後端重驗才是 gate
• 失敗時只回錯誤集合，讓使用者就地修正

Review 時要抓的坑

• 在共用 endpoint 加無條件檢查會打爛其他呼叫者
• 契約 breaking 又沒有分流時，前後端不能分開部署

可觀測性 / Logging

• Logging 架構設計 — logging 作為橫切關注點：ambient singleton + AsyncLocalStorage 串 trace（NestJS + Winston + GCP）

---