通用设计模式

概述

与编程语言无关的通用设计模式规则，涵盖骨架项目（Skeleton Projects）的使用方法、仓库模式（Repository Pattern）和统一的 API 响应格式。这些模式适用于所有技术栈，帮助团队建立一致的架构基础。

骨架项目（Skeleton Projects）

实现新功能时：

1. 搜索经过实战检验的骨架项目
2. 使用并行代理（Parallel Agents）评估选项：
   • 安全性评估
   • 可扩展性分析
   • 相关性评分
   • 实现规划
3. 克隆最佳匹配作为基础
4. 在经过验证的结构中迭代

设计模式

仓库模式（Repository Pattern）

将数据访问封装在一致的接口背后：

• 定义标准操作：findAll、findById、create、update、delete
• 具体实现处理存储细节（数据库、API、文件等）
• 业务逻辑依赖抽象接口，而非存储机制
• 便于切换数据源，使用模拟对象（Mock）简化测试

API 响应格式

为所有 API 响应使用一致的信封格式：

• 包含成功/状态指示器
• 包含数据负载（出错时为 null）
• 包含错误消息字段（成功时为 null）
• 对分页响应包含元数据（total、page、limit）