개발 환경 준비

로컬에서 LMGX 앱을 안정적으로 실행하기 위한 기본 도구와 프로젝트 설정을 정리합니다.

도구 체인

개발 환경은 JDK, Gradle, IDE, 브라우저를 같은 기준으로 맞추는 것에서 시작합니다. 특히 팀 문서에는 권장 버전뿐 아니라 실제 확인 명령과 실패했을 때 볼 로그 위치를 같이 적어야 새 구성원이 빠르게 합류할 수 있습니다.

- JDK 버전을 프로젝트 빌드 설정과 맞춥니다.

- Gradle wrapper를 우선 사용합니다.

- IDE 자동 import와 annotation processing 상태를 확인합니다.

로컬, 스테이징, 운영 설정은 값이 다른 것보다 책임이 섞이는 것이 더 위험합니다. 데이터베이스, 인증, 외부 API 주소처럼 환경마다 달라지는 값은 프로파일이나 환경 변수로 분리하고 문서에는 기본값과 필수값을 구분합니다.

- 로컬 기본값은 실행 가능한 수준으로 유지합니다.

- 비밀값은 저장소에 넣지 않습니다.

- 설정 누락 시 에러 메시지가 바로 보이게 합니다.

UI 작업은 수정, 실행, 브라우저 확인의 반복 속도가 중요합니다. 서버 로그와 브라우저 콘솔을 동시에 보고, CSS 변경은 실제 viewport에서 확인하며, 라우팅 문제는 직접 URL 접근으로 재현합니다.

- 서버 재시작이 필요한 변경과 아닌 변경을 구분합니다.

- 브라우저 캐시 때문에 생기는 오판을 줄입니다.

- 예외 stack trace의 첫 애플리케이션 파일을 기준으로 추적합니다.

환경 문서는 한 사람이 성공한 과정을 적는 문서가 아니라 여러 사람이 같은 결과를 얻는 계약입니다. 새 장비에서 실행했을 때 필요한 순서를 빠뜨리지 않고, 장애가 자주 나는 지점을 troubleshooting 항목으로 남깁니다.

- 설치 순서를 위에서 아래로 실행 가능하게 씁니다.

- OS별 차이는 별도 문단으로 분리합니다.

- 마지막에는 route 확인 목록을 둡니다.