요구사항은 구현 산출물과 검증 신호까지 이어져야 한다
기능 요구사항을 API, 이벤트, 데이터, 운영 기준으로 연결해야 빠진 책임을 찾을 수 있다.
| 요구사항 | 구현 산출물 | 검증 기준 | 누락 징후 |
|---|---|---|---|
| 사용자 관리 회원가입, 로그인, 내 프로필 | AuthModule, JWT, POST /auth/login | 비밀번호 해시, 토큰 만료, 401 응답 | profile까지 같은 토큰으로 이어지는가 |
| 파일 관리 프로젝트와 파일 트리 | Project, File, Folder schema와 REST API | ownerId 필터, 삭제 트랜잭션 | 다른 사용자 접근이 차단되는가 |
| 협업 세션 join_file, code_change | Gateway room, Socket.IO event | 100ms 동기화, reconnect 처리 | room 별 사용자가만 전파되는가 |
| 운영 기준 PostgreSQL, Redis, Docker | DB migration, Redis adapter, health check | 500ms API, 로그, 배포 재현성 | 장애 신호가 로그까지 이어지는가 |
추적 기준 요구사항 항목이 어디에 구현됐고, 어떤 실패를 막으며, 어떤 테스트로 확인되는지가 보여야 한다.