# Playbook: Add API

Use when: “新增xxx接口”

## Steps

1. **OpenAPI** — add path to `proto/openapi.yaml`
2. **Migration** — if new/changed table (`apps/api/migrations/`)
3. **Model** — `internal/model`
4. **Repository** — SQL only
5. **Service** — business + authz
6. **Handler** — bind + envelope; interface at handler
7. **Wire** — register route in `cmd/server` or router file
8. **Test** — at least service/engine unit test if logic-heavy
9. **SDK/types** — update `packages/sdk` + `packages/types` if clients need it
10. **Commands** — `go test ./...`, hit with curl
11. **Review + DoD + checklist/feature.md**

Follow patterns: `handler.md` `service.md` `repository.md` `pagination.md`.