도구/연봉 실수령액/기술 소개
ENGINEERING · 연봉 실수령액 기술 소개

연봉 실수령액, 이렇게 만들었습니다.

예쁜 화면이 아니라 실제로 돌아가는 구조로 신뢰를 만듭니다. 데이터가 어떻게 흐르고, 무엇을 어디에 두었는지 정리했습니다.

기술 스택

STACK
프론트엔드
Thymeleaf SSRSSE(실시간 댓글)Vanilla JS
백엔드
Java 21Spring Boot스케줄러(통계 수집)
데이터
MySQL + FlywayRedis (Pub/Sub)통계청 KOSIS Open API
인프라
Kubernetes무중단 블루-그린 배포

데이터 흐름

ARCHITECTURE

요청이 들어와 화면에 반영되기까지의 경로입니다. 내부 호스트명·인증정보는 제외한 추상 구조입니다.

SSE 실시간로그인·회원브라우저연봉 서비스 (SSR · 계산 · 인사이트)MySQL · 요율/통계/댓글Redis Pub/Sub통계청 KOSIS Open API통계 수집 스케줄러API Gatewaymember 공통 서비스
클라이언트서비스데이터스토어외부 API게이트웨이 별도 계층 호출(점선)
  • 브라우저연봉 서비스 (SSR · 계산 · 인사이트) (SSR · 계산 요청)
  • 연봉 서비스 (SSR · 계산 · 인사이트)MySQL · 요율/통계/댓글 (요율·통계 조회)
  • 통계 수집 스케줄러통계청 KOSIS Open API (통계 수집)
  • 통계 수집 스케줄러MySQL · 요율/통계/댓글 (적재(Upsert))
  • 연봉 서비스 (SSR · 계산 · 인사이트)Redis Pub/Sub (댓글 이벤트)
  • Redis Pub/Sub브라우저 (SSE 실시간)
  • 브라우저API Gateway (로그인·회원)
  • API Gatewaymember 공통 서비스 (JWT 검증)

설계 포인트

01
계산은 DB 기준

요율과 간이세액표를 코드가 아니라 DB(Flyway 버전 관리)에 두어, 제도가 바뀌어도 데이터만 갱신하면 됩니다.

02
통계로 맥락 제공

통계청 공개 데이터를 주기적으로 수집·적재해 "내 소득이 어느 위치인지"를 함께 보여줍니다.

03
실시간 반응

댓글 같은 상호작용은 Redis Pub/Sub → SSE로 다른 사용자 화면에 즉시 반영됩니다.

구조는 그만, 직접 돌려보는 게 빠릅니다.
연봉 실수령액을(를) 열어 직접 확인해 보세요.