다국어(i18n) 서비스 전환

기준정보 다국어·운영 반영

백엔드 기준정보와 서버 메시지를 다국어로 제공하고, 운영 DB에 안전하게 반영했습니다.

  • Java
  • Spring Boot
  • SQL

핵심 기여

  • 메뉴·코드·쿠폰·행정구역 응답에 다국어 이름 추가
  • 다국어 DB 이관 스크립트와 검증 기준을 갖춘 운영 반영 SQL 작성
  • 개발 DB와 운영 SQL 번역값 차이를 맞추는 보정 SQL 작성

문제: 화면만 번역해서는 끝나지 않는다

메뉴, 업무 분류, 쿠폰, 지역 같은 이름은 화면이 아니라 DB 기준정보에서 옵니다. 프론트 번역 파일만 고치면 이 이름들은 계속 한국어로 남았고, 서버가 내려주는 오류 메시지도 마찬가지였습니다.

접근: API가 요청 언어에 맞는 이름을 내려준다

Spring Boot 백엔드의 코드·메뉴·쿠폰·행정구역 응답에 다국어 이름을 더하고, 값이 비어 있으면 기본값으로 돌아가게 했습니다. 서버 오류 메시지도 영어·일본어 번역을 채웠습니다.

다이어그램을 불러오는 중...

운영 반영: 되돌릴 수 있게, 검증할 수 있게

  • 다국어 컬럼 이관 스크립트와 운영 DB 반영 SQL을 따로 만들었습니다.
  • 반영 SQL에는 검증 쿼리를 함께 두어, 넣은 값이 기준과 맞는지 바로 확인할 수 있게 했습니다.
  • 개발 DB와 운영 SQL의 번역값 차이를 표로 뽑고, 개발 DB를 운영 값에 맞추는 보정 SQL을 만들었습니다.
  • 나중에 추가된 업무 역량 같은 신규 기준정보도 같은 방식으로 번역값을 반영했습니다.