공통코드 초기화 스크립트 추가로 신규 환경 세팅 자동화

공통코드 그룹 및 상세 항목 초기화 스크립트 추가

2026-04-01에 공통코드 관련 기능을 추가했음.

공통코드는 상태값, 타입, 카테고리 같은 값들을 DB에서 관리하는 구조임. 하드코딩을 줄이고, 관리자가 화면에서 코드 목록을 수정할 수 있게 하는 게 목적임.

구조

공통코드 그룹 (GROUP_CODE)
  ├── 코드 항목 1 (CODE_VALUE, CODE_NAME)
  ├── 코드 항목 2
  └── ...

초기화 스크립트를 추가해서 신규 환경 구성 시 기본 공통코드를 한 번에 넣을 수 있게 했음. 로컬 개발 환경이나 새 서버에 세팅할 때 유용함.

화면에서 공통코드를 드롭다운으로 표시할 때, 매번 DB 조회하는 대신 앱 시작 시 캐시해두고 쓰는 방식을 주로 씀.

다음

작업 규모는 크지 않았지만 운영 안정성을 위한 필요한 변경이었음. 이런 작은 수정들이 쌓여서 전체 시스템의 신뢰도를 높임.

개발 중 챙긴 것들

• 트랜잭션 범위: DB를 건드리는 로직은 @<어노테이션> 범위를 명확히 해야 함
• 예외 처리: RuntimeException 전파 vs 잡아서 응답 변환 중 선택
• 로그: 운영에서 디버깅 가능하도록 중요 입출력값 INFO로 남겨둠
• 코드 리뷰: 수정한 로직이 기존 흐름에 영향 없는지 추적

작업 맥락

이 커밋은 플랫폼의 특정 기능 영역을 개선한 작업임. 기능 추가뿐 아니라 기존 코드의 안정성과 유지보수성을 높이는 방향으로 진행했음.

Spring MVC + MyBatis 구조에서 내부 클래스는 요청 처리와 화면 제어를 담당하고, SQL XML에서 쿼리를 관리함. JSP가 뷰 레이어로 HTML을 렌더링함.

작업 후 로컬에서 기동 확인 → 개발 DB 반영 → 배포 순서로 처리했음.

다음