경상북도 모바일 도민증 '모이소'
2024.04 ~ 2025.08 · 사용자 약 20만 명 · 발주 경상북도, 주관 파라메타, 개발 수행 에즈넷
Java 11 · Spring Boot 2.6 · JPA · MySQL · Thymeleaf · Bootstrap · Flutter · 공공 마이데이터 연계
도민이 모바일 신분 확인과 복지 서비스를 이용하는 플랫폼입니다.
기존 프로젝트를 인수받아 API 서버와 관리자 웹, Flutter 앱의 운영과 기능 고도화를 담당했고, 신규 서비스는 화면기획서 작성부터 개발과 배포까지 맡았습니다.
대표 경험 : 근무상황표 조회 성능 개선
- 문제
- 행복선생님 서비스의 근무상황표는 여러 교사의 한 달간 근무 기록을 날짜별로 조회하는 화면이었습니다.
- 기존에는 교사 목록을 조회한 뒤 각 교사의 날짜별 근무 로그를 반복 조회해, 교사 수와 조회 기간이 늘어날수록 DB 조회 횟수가 함께 증가했습니다.
- 한 달 범위 조회 시 응답 시간이 10초 이상 소요됐습니다.
- 개선
- 조회 기간에 해당하는 근무 로그를 한 번에 조회하고, 교사/날짜/근무 유형을 기준으로 중첩 Map을 구성해 반복문 내부의 추가 DB 조회를 제거했습니다.
- 한 번에 처리하는 데이터 범위를 제한하기 위해 날짜와 교사를 기준으로 페이징을 적용했습니다.
- 결과
- 10초 이상 소요되던 근무상황표 조회 시간을 0.5초 이내로 단축했습니다.
기타 개선 및 운영 경험
- JPA 더티체킹으로 인한 개인정보 재저장 문제
- 기존 레거시 구조에서 농어민수당 신청서 조회 응답에 엔티티를 직접 사용하고 있었고, 화면 표시를 위해 암호화된 개인정보를 복호화해 엔티티에 설정하고 있었습니다. 이 값이 영속성 컨텍스트의 변경사항으로 감지되면서 조회만으로도 평문 개인정보가 DB에 UPDATE되는 문제가 발생했습니다.
당시 조회 응답 전반이 엔티티에 의존하고 있어 DTO로 전환하려면 다수의 조회 로직과 화면 연동을 함께 수정해야 했기 때문에, 우선 저장과 flush, detach 이후 복호화하도록 처리 순서를 변경해 문제를 차단했습니다.
이후에는 조회 응답을 DTO로 분리하는 구조가 더 적절하다고 판단했습니다.
- Base64 저장 첨부파일의 AES 암호화 점진 전환
- Base64로 저장되어 있던 기존 파일을 AES 암호화 방식으로 전환하면서 전체 파일을 일괄 마이그레이션하지 않고, 파일 헤더의 4바이트 매직 넘버로 포맷을 구분하도록 구성했습니다.
기존 Base64 파일과 신규 AES 암호화 파일을 모두 읽을 수 있도록 하여 점진적으로 전환했습니다.
- 대용량 엑셀 생성 시 OOM과 요청 타임아웃 개선
- 수만 건 데이터를 처리하는 엑셀 다운로드에서 OOM과 요청 타임아웃이 발생해, 파일 생성 방식을 스트리밍으로 변경하고 비동기 생성 구조를 적용해 메모리 부족과 요청 타임아웃 문제를 해소했습니다.
- 공공기관 감리 및 보안 진단 대응
- 접근제어, 파일 업로드, 개인정보 처리 등 보안 진단 지적 사항을 조치하고 이행진단을 통과했습니다.
주민등록번호가 앱 메모리에 평문으로 잔존하는 문제는 가변 버퍼에서 사용 후 즉시 초기화하도록 수정했습니다.
감리 대응을 위해 ERD, 테이블 정의서, 인덱스 명세서, 성능시험 결과서 등의 산출물을 작성했습니다.
- 보안 장비(WAF) 차단으로 인한 이미지 업로드 실패 대응
- 특정 이미지 첨부가 앱에서는 성공으로 처리됐지만 실제로는 저장되지 않는 문제가 있었습니다. 응답은 200 OK였지만 본문은 WAF 차단 페이지였고, 요청이 업로드 API에 도달하지 못해 서버 로그도 남지 않았습니다.
먼저 앱에서 응답 본문의 차단 메시지를 감지해 업로드 실패를 토스트 메시지로 안내하는 패치를 배포했습니다.
보안 장비 담당 측은 앱 문제일 가능성을 제기했기 때문에, 로컬과 개발·운영 서버, 업로드 경로별로 파일 확장자와 실제 형식을 바꿔가며 재현했습니다. 확장자와 실제 형식이 다른 파일이 차단되고 요청이 서버에 도달하지 않는다는 결과를 운영 서버 일부 경로에서 차단되지 않는 예외까지 함께 보고서로 정리해 전달하고, 차단 조건 확인을 요청했습니다. 그 결과 해당 업로드 경로에 예외 정책이 적용됐고, 이후 같은 오류는 재발하지 않았습니다.