사용자 행동
회원가입, 프로젝트 생성, 실시간 편집처럼 사용자가 원하는 일을 문장으로 적는다.
사용자 행동을 그대로 구현하지 말고 API 계약, 저장 규칙, 완료 기준으로 쪼개야 누락이 줄어든다.
회원가입, 프로젝트 생성, 실시간 편집처럼 사용자가 원하는 일을 문장으로 적는다.
method, path, DTO, status, error code, 권한 조건으로 고정한다.
소유권, 관계, unique 제약, transaction, 삭제 정책을 명시한다.
성공, 실패, 권한, 성능, 검사 로그를 테스트 가능한 기준으로 둔다.
| 기능 | API 계약 | 데이터 규칙 | 완료 기준 |
|---|---|---|---|
| 회원가입 이메일 계정 생성 | POST /auth/signup, 201, conflict | email unique, password hash | validation, rate limit, audit |
| 프로젝트 소유자가 생성 | POST /projects, owner guard | ownerId, member relation | 권한 테스트, 삭제 정책 |
| 협업 편집 동시 수정 | WebSocket event, ack, error | document version, transaction | latency, conflict handling |
산출물은 네 가지 OpenAPI, DTO/Guard, Entity/Migration, E2E 테스트가 같은 계약 이름을 공유해야 프론트와 백엔드가 같은 그림을 보고 구현할 수 있다.