NestJS 프로젝트 통합

요구사항에서 API 설계까지 연결하기

요구사항 분석은 기능 목록을 모으는 일이 아니라 구현 판단의 기준을 만드는 단계입니다. 사용자 행위, 데이터 경계, 품질 조건을 함께 고정합니다.

01

협업 에디터 요구사항을 나누는 기준

user story, non-functional requirement, API contract, data boundary를 기능 범위, 품질 조건, 데이터 경계로 나누어 검증합니다.

user story
02

API, WebSocket, 저장소 책임 위치

요구사항 문서, ERD, endpoint 초안, 예외와 권한 흐름을 구현 책임과 연결합니다.

API 계약
03

프로젝트 요구사항 분석과 설계의 실패 조건

화면 요구만 보고 API와 데이터 소유권을 정하지 않으면 구현 뒤 계약이 계속 흔들립니다. 변경 요청, 거부 응답, 예외 로그를 같은 기준으로 남깁니다.

conflict case
04

Acceptance criteria와 위험 목록으로 보는 준비도

마지막에는 acceptance criteria, API 초안, 위험 목록, 일정 영향도 같은 증거를 남겨 요구사항 ID, API contract, acceptance test가 같은 판단 기준을 가리키는지 다시 확인합니다.

acceptance
책임
온라인 코드 에디터의 핵심 사용 흐름과 협업 세션 범위를 먼저 확정 파일 편집, 실행, 초대, 동시 편집, 채팅 같은 기능이 어떤 사용자 행위와 데이터 소유권을 갖는지 요구사항에 명시합니다.
session
경계
요구사항이 API 계약, WebSocket 이벤트, DB 모델로 이어지는지 확인 사용자 스토리마다 REST endpoint, 실시간 이벤트, 권한 정책, 저장 데이터, 실패 응답을 함께 적어 구현 누락을 줄입니다.
API event
인수 조건
협업 충돌, 실행 실패, 권한 거부 조건을 요구사항 단계에서 분리 동시 편집 충돌, 코드 실행 timeout, 프로젝트 접근 권한 실패를 acceptance criteria와 에러 응답에 반영합니다.
criteria

프로젝트 요구사항 분석과 설계 검증 지점

핵심 사용자 흐름 사용자가 프로젝트를 만들고 파일을 편집한 뒤 협업자에게 변경 사항이 실시간 반영되는 흐름을 기준 시나리오로 둡니다.
요구사항 누락 위험 동시 편집 충돌, 코드 실행 제한, 인증 만료, 프로젝트 초대 권한을 요구사항에서 빼면 구현 후 API 계약이 흔들립니다.
설계 준비도 지표 Acceptance criteria, API 초안, 이벤트 목록, 데이터 모델, 위험 목록이 서로 같은 사용자 흐름을 가리키는지 확인합니다.

프로젝트 통합 점검

질문: 동시 편집, 코드 실행, 초대 권한 요구가 acceptance criteria까지 내려갔는가
순서: 온라인 코드 에디터와 협업 세션 범위 정의 -> 기능 요구, API 계약, 품질 조건 연결 -> 협업 충돌과 권한 거부 조건 검증
위험: 협업 충돌과 실행 timeout을 요구사항에서 빼면 구현 후 API 계약과 화면 상태가 계속 흔들립니다.