소프트웨어 개발 · SW-15
이름만 바꾼 응답 필드
가상 이야기 · 핵심노트 기반
핵심노트 개념: 인터페이스 계약 — 프로그램 사이의 입력·출력 규칙을 관리한다
이 글에서 배우는 교훈
다른 프로그램이 사용하는 데이터 규격을 바꾸면 기존 사용자도 계속 동작할지 확인해야 합니다.
핵심노트를 바탕으로 만든 가상 이야기입니다. 실제 사건이나 검증된 성과가 아닙니다.
근거: 인터페이스 계약 — 프로그램 사이의 입력·출력 규칙을 관리한다 · 핵심노트 15
구체적으로는 고객 이름 항목을 바꾸면서 이전 앱이 멈췄습니다. 팀은 옛 항목을 일정 기간 유지하고 앱팀과 전환 시점을 합의했습니다.
관련 교재 내용
소프트웨어 개발 · II. 소프트웨어 재사용 · 인터페이스와 변경 영향
재사용 모듈은 기능·용법·인터페이스가 명확해야 하며 변경의 부차적 영향을 이해해야 합니다.
이 사례에 적용한 내용: 응답 필드 이름을 바꾸어 기존 앱이 깨진 뒤 호환 기간과 소비자 전환을 합의합니다. API 버전 전환 방식은 사례의 실무 확장입니다.
교재 원리의 실무 적용 · 교재 원문 인용이 아닌 자체 설명입니다.
본문
서버팀이 응답의 customerName을 name으로 정리했습니다. 같은 날 업데이트하지 못한 모바일 앱은 고객 이름을 표시하지 못했습니다.
서버팀은 이전 필드를 일정 기간 유지하고 새 규격의 적용 시점을 앱팀과 합의했습니다. 이전 앱이 계속 동작하는지 자동 검증에 포함했습니다.
결론
내부적으로 더 좋은 이름이어도 외부 사용자는 기존 약속에 의존합니다. 인터페이스 변경에는 사용자와 전환 기간을 고려해야 합니다.