API 实现（API Implementation）

适用场景

• 按 OpenAPI 契约实现端点
• 多语言 / 多框架的统一分层
• 接口参数校验 / DTO / 响应序列化
• HTTP 中间件 / 拦截器 / 过滤器
• 跨语言通用模式（路由 / 控制器 / 服务）

核心原则

1. 分层清晰
   Controller / Handler   → 接收请求、调用服务、返回响应
   Service / UseCase      → 业务逻辑、事务编排
   Repository / DAO       → 数据访问
   Domain Model           → 业务实体