---
name: backend-implementation-engineering
when: 'Controller, DTO, API实现, 事务, 幂等, 权限, 后端编码'
scope:
  - backend
products:
  - '*'
id: ka-pattern-backend-implementation-engineering
asset_kind: pattern
lifecycle_status: active
authority: supporting
owner_mechanism_id: mc-backend-implementation-contract
routes:
  - code_change
primary_triggers:
  - 后端实现
  - API实现
priority: P1
specificity: 5
version: 1.1.0
last_reviewed: '2026-06-01'
consumes:
  - mc-backend-implementation-contract
emits: []
secondary_triggers: []
negative_triggers: []
type: pattern
stages: ["编码与单元测试", "联调验证"]
---

## 工程规则

- Controller 入参与出参按接口语义使用 DTO/VO，不暴露数据库实体。
- 参数必须验证必填、长度、枚举、金额、日期区间和关联对象存在性。
- 列表接口限制 page size 并对白名单排序；响应使用统一分页对象。
- 写操作在 Service 定义清晰事务边界；外部调用不放在长事务内。
- 支付、回调、创建与状态流转具备幂等键、并发控制和重复提交测试。
- 敏感操作必须校验权限和租户，并产出可追踪审计记录。
- OpenAPI、字段表、错误码和 migration 必须与实现同步复验。
