后端架构最佳实践指南，涵盖API设计、数据库优化、缓存策略与认证授权模式，S级安全认证的教育性文档。
说明：
## 核心用法
本 Skill 提供完整的后端开发模式参考，主要包括：
**API 设计模式**：RESTful 资源路由结构、查询参数过滤与分页、Repository 模式抽象数据访问、Service 层分离业务逻辑、中间件模式处理认证与请求管道。
**数据库优化**：精确列选择避免 `SELECT *`、批量查询解决 N+1 问题、Supabase RPC 事务保证数据一致性。
**缓存策略**：Redis 装饰器模式实现透明缓存层、Cache-Aside 模式管理缓存失效。
**错误处理**：集中式 ApiError 类与 errorHandler、Zod 验证错误处理、带指数退避的重试机制（1s/2s/4s）。
**认证授权**：JWT Token 验证与刷新、基于角色的权限控制（RBAC）、中间件高阶函数封装权限检查。
**系统治理**：内存限流器（100 req/min）、简单任务队列异步处理、结构化 JSON 日志与请求追踪。
## 显著优点
– **实战导向**：所有代码均为可直接运行的 TypeScript 示例，涵盖 Next.js API Routes、Express、Supabase 等主流技术栈
– **安全示范**：JWT 验证示例正确展示环境变量使用方式，而非硬编码密钥
– **性能优化**：N+1 查询解决方案、Redis 缓存装饰器、数据库事务模式均为生产级最佳实践
– **架构清晰**：Repository-Service 分层、中间件管道模式支持复杂业务扩展
## 潜在局限
– **示例完整性**：部分代码片段为简化演示（如 `vectorSearch` 未实现细节），需结合具体业务补全
– **无框架集成**：未提供 NestJS、Fastify 等框架的专用适配，需手动迁移
– **队列简单**：内置 `JobQueue` 为内存实现，无持久化能力，生产环境建议替换为 Bull/BullMQ
– **限流局限**：内存限流器不支持分布式部署，多实例场景需改用 Redis-based 方案
## 适合人群
– 正在使用 Node.js/Next.js 构建 API 服务的全栈开发者
– 从单体应用向分层架构转型的团队技术负责人
– 需要快速查阅后端设计模式参考的高级开发者
– 学习后端架构最佳实践的初中级工程师
## 常规风险
该 Skill 为纯 Markdown 文档型 Skill，无可执行代码，扫描确认无网络请求、无文件系统操作、无敏感信息硬编码。唯一需注意的风险点（RISK-001）为教学性质的环境变量引用示例，属安全编码示范而非漏洞。用户在实际项目中需确保 `JWT_SECRET` 等配置通过真实环境变量注入，避免复制示例中的占位符。
会员专属
