bunjs-architecture

bunjs-architecture 技能为使用 Bun.js 和 TypeScript 构建可维护、可扩展且类型安全的后端应用程序提供了全面的框架。它专为优先考虑整洁架构模式和严格职责分离，以避免复杂系统中技术债的资深开发人员与团队所设计。通过强制执行严格的分层方法，该技能确保业务逻辑与 HTTP 处理和数据库持久性解耦，从而促进代码库的测试、重构和长期维护。

• 实施严格的四层架构：路由 (API/中间件) → 控制器 (请求/响应) → 服务 (业务逻辑) → 存储库 (Prisma 数据库访问)。

• 在所有层级强制执行不可妥协的 camelCase 命名惯例，包括 JSON REST API 字段、Zod 架构、TypeScript 接口以及数据库标识符 (数据表、列、外键)。

• 提供有关依赖流的架构指导，防止向上依赖 (例如服务访问控制器)，并推动单向向下的数据流。

• 包含 Prisma 架构建模的最佳实践，例如单数模型命名与 @@map 数据表映射、一致的时间戳后缀，以及布尔字段前缀 (is/has/can)。

• 优化全栈开发体验，确保数据库架构与前端数据结构之间的 1:1 映射，无需繁琐的转换层或映射工具函数。

• 提供定义 API 端点规范并将其映射到内部逻辑层的结构化实施工作流程。

• 在启动新的 Bun.js 项目或重构旧模块以采用整洁代码原则时使用此技能。

• 始终保持层级隔离：控制器绝不应包含业务逻辑，服务绝不应直接访问 HTTP 上下文，例如请求或响应对象。

• 利用此技能标准化命名，确保端到端的类型安全，并为您的 API 合约提供完美的 IDE 自动完成支持。

• 严格遵循已定义的依赖流；仅在不违反职责分离的情况下才跨层级，但编排时始终建议通过服务层进行。

• 参考相关技能，例如 dev:bunjs 用于基本服务器设置、dev:bunjs-production 用于部署策略，以及 dev:bunjs-apidog 用于 OpenAPI/Swagger 整合。