백엔드
질문에 대처하는 어느 플랫폼 개발자의 이야기
두줄요약
MessagingHub 확장으로 늘어난 질문과 커뮤니케이션 비용을 줄이기 위해 서버 SDK와 문서를 정비했습니다.\n연동 허들을 낮추고 질문을 코드와 가이드 중심으로 바꿔 실무 몰입도를 높였습니다.
문제 상황
- MessagingHub 확장으로 연동 지점과 이해관계자가 늘어나며 질문과 커뮤니케이션 비용이 급증
- 반복 질의응답이 누적돼 실무 몰입을 방해하는 커뮤니케이션 부채 형성
원인 분석
- 기존 external-lib는 최소 인터페이스만 제공해 연동 허들을 개발자가 직접 부담
- 개발자별 숙련도와 구현 방식 차이로 연동이 제각각이 되고, 에러 추적도 어려움
- 내부 맥락이 없는 외부 사용자에게 필요한 설명과 가이드가 부족
해결 방법
- 통합 가이드, 흐름 차트, README, 블로그·발표 자료로 질문 유형을 체계화
- 서버 SDK를 만들어 gRPC/REST 연동 절차를 추상화하고, 빌더·재시도·keepalive·주석을 제공
- Spring 의존성 제거와 JDK 1.8 기준 정리로 더 넓은 환경에서 쓰기 쉬운 라이브러리로 개선
적용해볼 점
- 반복 질문을 문서와 SDK로 전환해 연동 허들을 낮추는 접근
- 외부 사용자를 기준으로 주석·예제·가이드를 설계하는 방식