# 강동현 · 백엔드 신입 (Java / Spring) | | | |---|---| | Email | donghyeonka68@gmail.com | | GitHub | [github.com/donghyeon-ka](https://github.com/donghyeon-ka) | | Velog | [velog.io/@donghyeon2](https://velog.io/@donghyeon2) | --- ## Summary Java / Spring Boot 기반 백엔드 개발을 중심으로 학습하며, 인증 서버의 레이어 구조, 예외 응답 표준, 인증 위임 구조를 직접 구현해 온 신입 백엔드 개발자입니다. Spring Security Resource Server 와 Keycloak JWT 검증 구조를 구성했고, Clean / Hexagonal Architecture 5 개 모듈과 ArchUnit 테스트로 계층 의존성을 검증했습니다. 프로젝트는 모두 개인 로컬 / dev 환경 기준이며, 구현 범위와 검증 범위를 구분해 문서화했습니다. --- ## Skills **Main** - Java 21, Spring Boot 4.0.3, Spring Security Resource Server, JPA, PostgreSQL 16 **Used in Projects** - Keycloak, OAuth2 / OIDC, Nimbus JWT (JWKS), Flyway, ArchUnit, JUnit 5, AssertJ, OpenAPI / Swagger UI, MDC `traceId` 기반 structured logging **Infrastructure (보조)** - Docker, K3s, Kustomize, Vault, VSO, Traefik --- ## Projects ### Project-Auth-Server — Spring Boot 인증 서버 (Clean / Hexagonal) > 개인 프로젝트 · 2025.11 ~ 현재 · 1 인 · 설계 / 구현 / 로컬 검증 > [github.com/donghyeon-ka/project-auth-server](https://github.com/donghyeon-ka/project-auth-server) Spring Boot 인증 서버를 Clean / Hexagonal Architecture 로 분리하고, Keycloak JWT 를 Resource Server 로 검증하는 구조를 구현한 프로젝트입니다. - **5 모듈 Clean / Hexagonal Architecture** — `domain` / `application` / `presentation` / `infrastructure` / `bootstrap` 로 Gradle multi-project 분리. `domain` 은 Spring / JPA / Servlet 의존 0 - **ArchUnit 으로 레이어 의존성 검증** — `LayerDependencyArchitectureTest` 가 빌드 단계에서 `presentation → infrastructure` 같은 위반을 검출. CI 연결 시 PR 게이트로 활용 가능한 구조 - **`ErrorCode` 와 HTTP status 분리** — `BusinessException` 의 `ErrorCode` 는 비즈니스 의미만 (code + message), HTTP status 매핑은 presentation 의 `ApiErrorHttpStatusMapper` 가 담당 - **Spring Security Resource Server + Keycloak** — `oauth2-client` 가 아니라 `oauth2-resource-server` 만 사용. Keycloak 발급 JWT 의 issuer / signature / expiration / role claim 을 백엔드에서 다시 검증 - **Exception Handler 4 계층 분리** — 필터 단 (`SecurityExceptionHandler`) / Spring MVC 입력단 / application / infrastructure 누수 감지. 모든 응답은 `ApiResult` (success · code · message · data · traceId · timestamp) 로 통일 - **MDC `traceId` 일관성 + Flyway 마이그레이션 관리** — `TraceIdFilter` 가 32 자리 hex traceId 를 응답 헤더 / 로그 / audit 에 동일하게 전파. `auth` schema 의 V1~V5 SQL migration 을 infrastructure 모듈에서 관리 `Java 21` `Spring Boot 4.0.3` `Spring Security` `JPA` `PostgreSQL` `Keycloak` `ArchUnit` `Flyway` ### feed-postgresql-query-tuning — PostgreSQL 쿼리 튜닝 프로젝트 > 개인 프로젝트 · 2025.03 ~ 2025.04 · 1 인 · 분석 / 최적화 / 검증 (수치는 모두 EXPLAIN ANALYZE 기준 쿼리 실행 시간) > [github.com/donghyeon-ka/feed-postgresql-query-tuning](https://github.com/donghyeon-ka/feed-postgresql-query-tuning) 피드 목록 조회 쿼리를 EXPLAIN ANALYZE 기준으로 분석하고, JOIN 구조 / 인덱스 설계 / 캐시 / 부하 검증 순으로 단계적으로 개선한 프로젝트입니다. - 피드 목록 조회 쿼리 응답 시간 **1.77 초 → 7.66 ms** (단계적 개선 결과, EXPLAIN ANALYZE 기준) - **원인 분석** — 4-table LEFT JOIN 데이터 폭증 + 인덱스 미사용 + 외부 정렬 발생 확인 - **1 차 개선** — 불필요한 JOIN 을 EXISTS 서브쿼리로 교체 + 쿼리 분리 → 1.77 초 → 0.216 초 - **2 차 개선** — 복합 인덱스 + 커버링 인덱스 → 0.216 초 → 7.66 ms - **JPA 측면** — N+1 회피, fetch 전략 명시 (LAZY + 필요 시 명시적 join fetch) - **부하 검증** — 단일 인스턴스 환경에서 Locust 동시 1,000 명 부하 → 900~1,100 RPS `PostgreSQL` `JPA` `EXPLAIN ANALYZE` `Index design` `Redis` `Locust` ### Project-Infra — Spring 앱 실행 환경 구성 > 개인 프로젝트 · 2025.11 ~ 현재 · 1 인 · 로컬 / dev 환경 구성 > [github.com/donghyeon-ka/project-infra](https://github.com/donghyeon-ka/project-infra) auth-server 가 동작하는 로컬 / dev K3s 환경을 Kustomize overlay 로 구성하고, Ingress 인증 게이트와 시크릿 주입 흐름을 함께 설계한 프로젝트입니다. - auth-server 가 동작하는 로컬 / dev K3s 실행 환경을 Kustomize overlay 로 구성 - Traefik ForwardAuth + oauth2-proxy + Keycloak 으로 로그인 / 세션 확인 경계를 분리하고, auth-server 는 JWT 검증에 집중하도록 구성 - Vault → VSO → Kubernetes Secret 흐름으로 secret 주입 구조 구성 `Kubernetes (K3s)` `Kustomize` `Vault` `VSO` `Traefik` --- ## Blog - [Velog @donghyeon2](https://velog.io/@donghyeon2) — 기술적 의사결정 과정과 트러블슈팅 경험 기록 --- ## Links - **GitHub**: [github.com/donghyeon-ka](https://github.com/donghyeon-ka) - **인증 서버 (메인)**: [project-auth-server](https://github.com/donghyeon-ka/project-auth-server) - **인프라**: [project-infra](https://github.com/donghyeon-ka/project-infra) - **쿼리 튜닝**: [feed-postgresql-query-tuning](https://github.com/donghyeon-ka/feed-postgresql-query-tuning)