요구사항을 API와 데이터 경계로 바꾸기

행위 추출

회원가입, 주문 생성, 문서 공유처럼 사용자 행동을 명령과 조회로 나눈다.

각 행동의 요청 DTO, 응답 DTO, 오류 코드를 먼저 정의한다.

엔티티 관계, 소유권, 상태 전이, 삭제 정책을 설계한다.

권한 누락, 중복 처리, 감사 로그, 성능 목표를 acceptance 기준에 포함한다.

Command

상태 변경 생성, 수정, 취소, 승인 같은 행위

idempotency와 권한 중요

Query

조회 목록, 상세, 통계, 검색 조건

pagination과 filter 설계

Entity

영속 데이터 관계, unique 제약, soft delete 여부

DB 제약으로 무결성 보강

Policy

접근 규칙 role, ownership, organization scope

API마다 명시

요구사항 계약 검수 기능 설명에 성공 조건과 실패 조건이 함께 있다.

오류 계약 validation, conflict, forbidden, not found가 구분돼 있다.

데이터 제약 중복과 상태 전이가 DB와 서비스 양쪽에서 보호된다.

관측 중요 명령은 로그와 감사 기록 기준이 있다.