---
name: backend-api-implementation
type: procedure
when: '后端接口, Controller, DTO, API实现, 数据写入'
scope:
  - backend
products:
  - '*'
id: ka-procedure-后端接口实现工作流
asset_kind: procedure
lifecycle_status: active
authority: supporting
owner_mechanism_id: mc-backend-implementation-contract
routes:
  - code_change
  - artifact_generation
primary_triggers:
  - 后端接口实现工作流
secondary_triggers:
  - REST API
negative_triggers: []
priority: P1
specificity: 5
consumes:
  - mc-backend-implementation-contract
emits:
  - backend_work_package
  - verification_result
required_evidence:
  - execution_evidence
version: 1.1.0
last_reviewed: '2026-06-01'
stages: ["编码与单元测试"]
---

## 步骤

1. 确认 OpenAPI、数据库 migration、权限与状态流转基线。
2. 定义请求 DTO、响应 DTO、字段校验、错误码和分页排序边界。
3. 定义应用服务事务边界、幂等策略、并发控制和审计事件。
4. 编码并执行单元、集成、权限、重复提交与契约一致性验证。
5. 审查 finding 清零并提供验收证据后交付。

## 工作包

| 类别 | 需明确内容 | 证据 |
|---|---|---|
| 接口边界 | DTO、统一响应、错误码、分页 | OpenAPI/测试 |
| 一致性 | 事务、幂等、并发、状态流转 | migration/集成测试 |
| 安全 | 权限、租户、审计、隐私 | 越权测试/审计日志 |
