[배운점 & 회고] 5월 07일 실무를 마치고 느낀 점

고민한 것

• 오늘은 인터페이스 정의서에 명시된 기능들을 실제로 Spring Boot 기반의 백엔드 코드로 구현하는 작업을 진행했습니다. 특히 클라이언트에게 어떤 형식의 데이터를 반환할지, 응답 객체를 어떻게 구성해야 할지에 대해 많은 고민이 있었습니다. 단순한 필드가 아닌 리스트 형식의 데이터를 응답해야 할 경우, JSON 구조를 어떻게 잡아야 할지가 가장 큰 고민거리였습니다.

---

어려웠던 점

• 인터페이스 정의서를 수정하면서 응답 구조를 정의해야 했는데, 리스트 형태의 데이터를 직렬화하여 JSON 응답으로 구성하는 것이 생각보다 쉽지 않았습니다. 어떤 키를 사용할지, 리스트 내부의 객체 구조는 어떻게 구성할지 등 사소해 보이지만 중요한 세부사항에서 막히는 부분이 많았습니다.

---

해결 방법

• 혼자서 해결하려고 고민하기보다, ChatGPT와 같은 도구를 활용해 작성한 JSON이 올바른 구조인지 반복적으로 검토받으며 수정했습니다. 이렇게 작성한 예제를 기준 삼아 점차 다양한 형태의 응답 구조를 익혀가며 인터페이스 정의서와 일치하도록 구현할 수 있었습니다.

---

느낀점

• 작은 API 하나를 구현하더라도, 그 응답 구조를 명확하게 정의하고 클라이언트가 쉽게 이해할 수 있도록 표현하는 것이 중요하다는 것을 다시금 느꼈습니다. 단순히 동작하는 코드를 넘어서, 문서와 데이터가 일관성을 가지려면 사전에 설계 단계에서 충분히 고민해야 한다는 교훈을 얻었습니다. 아직도 부족한 부분이 많지만, 이런 시행착오를 통해 한 단계씩 성장하고 있다는 것을 실감하는 하루였습니다.