fullstack-workflow

fullstack-workflow 技能為 Next.js 環境中的功能開發提供了一套嚴謹且模組化的模式。專為開發複雜 Web 應用程式的工程師所設計，它強化了資料提取、伺服器端變更操作與客戶端 UI 狀態管理之間的明確職責分離。透過使用可預測的架構，此流程能降低開發過程中的認知負荷，並確保大型代碼庫的一致性。此模式特別適合需要高可靠性的應用程式，例如管理電子郵件資料、身份驗證與背景處理的 SaaS 產品。

• 實作以 withAuth 或 withEmailAccount 等身份驗證中間件封裝的 GET API 路由，以確保資料暴露的安全性。

• 利用 Prisma 進行型別安全的資料庫存取，確保與 PostgreSQL 和 Redis 資料儲存的可靠互動。

• 使用 next-safe-action 定義基於 Zod 輸入驗證的伺服器操作，確保強大的伺服器端安全性和錯誤處理。

• 整合 SWR 以進行高效的客戶端資料獲取、自動重新驗證與快取策略優化。

• 結合 React Hook Form 與 zodResolver，精簡表單狀態管理、驗證與提交邏輯。

• 透過操作用戶端元數據將 Sentry 儀表板標準化，以改進可觀察性與錯誤追蹤。

• 在資料完整性與型別安全性至關重要的 CRUD 作業中使用此工作流程。

• 務必以適當的中間件封裝 API 路由，以強制執行身份與帳戶上下文。

• 將輸入驗證架構定義在特定的驗證檔案中，以保持伺服器操作的專注與易於維護。

• 根據特定的權限需求使用 actionClient、actionClientUser 或 adminActionClient 上下文。

• 預期的輸入包括經過驗證的 Zod 物件；預期的輸出為符合 TypeScript 介面要求的型別推論 JSON 回應。

• 限制條件包括嚴格遵守既定架構，以確保與現有中間件與記錄基礎設施的完全相容。