Task 03 변경 영향 공유 실습 가이드
📥 실습 입력 (Input)
- •
schema-change-request.md(변경 요청서)
💾 실습 출력 (Output)
- •
change-impact-report.md(변경 영향도 분석서)
1. 스토리 및 실습 배경
데이터베이스 설계가 끝난 후 급격한 비즈니스 스펙 변경이 생겼습니다. 기존에는 '예약 후 즉시 결제'였는데, '예약 후 전문가가 승인하면 결제창이 열리는 단계형 예약'으로 변경된 것입니다.
개발팀은 DB의 Reservations 테이블에 is_approved 컬럼을 급히 추가하고 승인 대기 상태를 넣었으나, 이 중요한 구조 변경이 API 명세서나 기획서에는 공유되지 않고 방치되었습니다. 이로 인해 QA 단계에서 API 파라미터 누락으로 인한 장애가 대량 발생했습니다.
이번 실습에서는 스키마의 수정이 발생했을 때, 이에 연쇄적으로 영향을 받는 API 엔드포인트와 화면 설계 수정 범위를 Codex를 활용해 전수 자동 분석하고 팀원들에게 공유할 리포트를 작성하는 워크플로우를 학습합니다.
2. 학습 목표
- 데이터 구조의 변경(Schema Change) 사항이 시스템에 미치는 연쇄 여파를 추적할 수 있다.
- 변경에 의해 즉각 개정이 필요한 API 명세서 및 화면 목록을 식별 매핑할 수 있다.
- 변경 사항 및 영향 범위를 요약하여 팀원들에게 공지할 공유 리포트를 자율 도출할 수 있다.
🛠️ 실제 따라 하기 실습 가이드
- 실습용 파일 생성: 아래 다운로드 버튼을 눌러
schema-change-request.md파일을automation/폴더 내에 저장합니다. - Codex 분석 위임: Codex Client 프롬프트 입력창에 아래 **Codex 요청 프롬프트**를 전송하여 빌드합니다.
- 영향 보고서 점검: 생성된 보고서에서 DB 상태 세분화(Wait Approve), API Response 필드 조정, 화면 UI 버튼 및 상태창 조치 요구사항이 제대로 정리되었는지 확인합니다.
실습 자료 다운로드
Codex 요청 프롬프트
Task 03 Prompt
예약 확정 프로세스가 '승인 대기' 상태 추가 및 '전문가 승인 후 결제'로 변경됨에 따라 영향을 받는 API 스펙, DB 스키마, 화면 및 변경 공유 리포트를 작성해 주세요.
4. 결과물 예시
Codex는 스키마 변경 사항을 바탕으로 하위 모듈 전반의 개정 요건을 정확히 추적해 줍니다.
| 영향 영역 | 상세 변경 내용 | 리스크 수준 | 조치 대상 문서 및 명세 |
|---|---|---|---|
| DB 스키마 | Reservations 테이블 status 공통 코드 세분화 (WAIT_APPROVE 상태 추가) | 보통 | DB 스키마 정의서 및 DDL 쿼리문 수정 |
| API 명세 | 예약 상세 조회 API Response에 approved_at 필드 추가, 결제 요청 API 호출 시점 조정 | 높음 | api-specification.md 내 관련 API 수정 |
| 화면 UI | 예약 상세 화면 내 '결제하기' 버튼 비활성화 상태 추가 및 '전문가 승인 대기' 정보창 추가 | 높음 | 회원 예약 화면 기획안 & UI 컴포넌트 수정 |