nestjs-best-practices

此技能作為 NestJS 11+ 開發者的全面知識庫，專為使用 TypeScript 建構穩健、可擴展的企業級應用程式而設計。它彌補了官方文檔與實際生產實作之間的差距，提供從模組架構到微服務協調的完整應用生命週期指導。該技能專為需要確保大規模 Node.js 專案的一致性、型別安全和簡潔程式碼原則的高級開發人員和架構師而設計。

• 進階依賴注入模式，包含 forwardRef、自定義提供者與動態模組配置。

• 透過中介軟體、守衛、攔截器、管道與全域例外過濾器進行請求生命週期管理。

• 使用 class-validator、class-transformer 與自定義 ValidationPipes 進行輸入驗證與資料轉換。

• 利用 JWT、Passport 與基於角色的存取控制 (RBAC) 實作強大的身份驗證與授權機制。

• 支援 TypeORM、Prisma 與 Drizzle ORM 的資料庫整合，包含儲存庫模式與遷移安全性。

• 涵蓋單元測試、端對端 (E2E) 測試與整合測試，並提供提供者模擬技巧。

• 支援跨 TCP、Redis、NATS 與 Kafka 傳輸層的企業級微服務架構。

• 具備 OpenAPI 與 GraphQL 文件生成模式，並遵循裝飾器與解析器最佳實踐。

• 適用於重構舊版 NestJS 程式碼或架構新功能模組時使用。

• 提供常見錯誤檢查，例如循環依賴、不當的單例作用域與缺少白名單驗證。

• 協助導航 NestJS 11 的重大變更，包含 Express v5 與 Fastify v5 的遷移路徑。

• 透過落實健康檢查、ConfigService 實作與正確的環境設定，確保應用程式的生產環境就緒。

• 協助除錯依賴解析錯誤以及效能關鍵的微服務通訊設定。