update resume & portfolio

This commit is contained in:
donghyeon-ka
2026-09-22 15:11:53 +09:00
parent a80bccd99d
commit de82d99aaa
21 changed files with 1340 additions and 939 deletions
+12 -12
View File
@@ -180,27 +180,27 @@ tr {
<body>
<main>
<h1>강동현 · 백엔드 신입 (Java / Spring)</h1>
<table><tbody><tr><td></td><td></td></tr><tr><td>Email</td><td>donghyeonka68@gmail.com</td></tr><tr><td>GitHub</td><td><a href="https://github.com/donghyeon-ka">github.com/donghyeon-ka</a></td></tr><tr><td>Blog</td><td><a href="https://velog.io/@donghyeon2">velog.io/@donghyeon2</a></td></tr></tbody></table>
<table><tbody><tr><td></td><td></td></tr><tr><td>Email</td><td>donghyeonka68@gmail.com</td></tr><tr><td>GitHub</td><td><a href="https://github.com/donghyeon-ka">github.com/donghyeon-ka</a></td></tr><tr><td>TechLog</td><td><a href="https://hyeonworks.com">hyeonworks.com</a></td></tr><tr><td>Blog</td><td><a href="https://velog.io/@donghyeon2">velog.io/@donghyeon2</a></td></tr></tbody></table>
<hr>
<h2>Summary</h2>
<p>Java / Spring Boot 기반 백엔드에서 인증, 계층 분리, 예외 응답 표준화, 데이터 영속성 경계에 집중해 학습해 온 신입 백엔드 개발자입니다.</p>
<p>Spring Boot 인증 서버를 5 개 모듈 Clean / Hexagonal 구조로 나누고, <code>domain</code> 모듈이 Spring / JPA / Servlet에 의존하지 않도록 분리했습니다. 또한 ArchUnit 테스트로 계층 의존성을 검증하고, Keycloak JWT를 Resource Server로 다시 검증하는 구조를 구현했습니다.</p>
<p>프로젝트는 개인 로컬 / dev 환경 기준입니다. 대신 구현 범위, 검증 범위, 아직 운영 경험으로 볼 수 없는 부분을 문서 안에서 구분했습니다.</p>
<p>Java / Spring Boot 기반 백엔드에서 인증 경계, 데이터 조회 성능, 계층 분리에 집중해 학습해 온 신입 백엔드 개발자입니다.</p>
<p>현업 개발자의 멘토링 아래 약 6개월 동안 과제를 수행하며, 단순히 기술을 적용하는 데서 끝내지 않고 <strong>왜 이 구조를 선택했는지, 어떤 조건에서 문제가 생기는지</strong>를 직접 구현하고 검증했습니다. Keycloak 인증 구조에서는 token / session의 소유 경계를 비교했고, 피드 조회에서는 N+1부터 Top-N 조회와 pagination까지 실제 SQL과 실행계획으로 확인했습니다.</p>
<p>이 과정에서 쌓인 기록을 다시 찾고 맥락대로 연결하기 위해 <strong>TechLog</strong>를 만들고 있습니다. 현재 frontend는 <a href="https://hyeonworks.com">hyeonworks.com</a>에서 확인할 수 있으며, backend와 인프라의 최종 통합은 진행 중입니다.</p>
<hr>
<h2>Skills</h2>
<p><strong>Core</strong></p>
<ul><li>Java 21, Spring Boot 4, Spring Security Resource Server, Spring Data JPA, PostgreSQL 16</li></ul>
<ul><li>Java 21, Spring Boot 4, Spring Security, Spring Data JPA, PostgreSQL</li></ul>
<p><strong>Architecture / Testing</strong></p>
<ul><li>Clean Architecture, Hexagonal Architecture, Gradle multi-project, ArchUnit, JUnit 5, AssertJ</li></ul>
<p><strong>Auth / Observability</strong></p>
<ul><li>Keycloak, OAuth2 / OIDC, JWKS 기반 JWT 검증, Flyway, OpenAPI / Swagger UI, MDC <code>traceId</code> 기반 structured logging</li></ul>
<ul><li>Clean Architecture, Gradle multi-module, ArchUnit, JUnit, Testcontainers, Flyway</li></ul>
<p><strong>Auth / Performance</strong></p>
<ul><li>Keycloak, OAuth2 / OIDC, PKCE, JWT / JWKS, Redis, Hibernate Statistics, <code>EXPLAIN (ANALYZE, BUFFERS)</code></li></ul>
<hr>
<h2>Projects</h2>
<section class="project"><h3>Project-Auth-Server — Spring Boot 인증 서버</h3><blockquote><p>개인 프로젝트 · 2025.11 ~ 현재 · 1 인 · 설계 / 구현 / 로컬 검증 <a href="https://github.com/donghyeon-ka/project-auth-server">github.com/donghyeon-ka/project-auth-server</a></p></blockquote><p>Spring Boot 인증 서버를 계층별 책임이 드러나도록 분리하고, 인증 위임 / JWT 검증 / 예외 응답 / DB 마이그레이션 경계를 정리한 프로젝트입니다.</p><ul><li>Gradle multi-project로 <code>domain</code> / <code>application</code> / <code>presentation</code> / <code>infrastructure</code> / <code>bootstrap</code> 5 개 모듈을 분리했습니다.</li><li><code>domain</code> 모듈은 Spring, JPA, Servlet 의존성을 두지 않고 값 객체와 도메인 규칙만 포함하도록 구성했습니다.</li><li>ArchUnit의 <code>LayerDependencyArchitectureTest</code>로 <code>presentation → infrastructure</code> 같은 계층 위반을 빌드 단계에서 탐지하도록 했습니다.</li><li>로그인 플로우는 Keycloak / Ingress 계층에 위임하고, 백엔드는 <code>oauth2-resource-server</code>로 JWT issuer / signature / expiration / role claim을 다시 검증하도록 구성했습니다.</li><li><code>ErrorCode</code>는 비즈니스 의미만 담고, HTTP status 매핑은 presentation의 mapper가 담당하도록 분리했습니다.</li><li>예외 처리는 Security filter, Spring MVC 입력 검증, application, infrastructure 누수 감지로 나눴고, 응답은 <code>ApiResult&lt;T&gt;</code> 형태로 통일했습니다.</li><li><code>TraceIdFilter</code>로 32 자리 hex <code>traceId</code>를 응답 헤더, 로그, audit 흐름에 동일하게 전파했습니다.</li><li>Flyway V1~V5로 <code>auth</code> 스키마와 사용자 / provider 관련 변경을 단계별 마이그레이션으로 관리했습니다.</li></ul><p><code>Java 21</code> <code>Spring Boot</code> <code>Spring Security</code> <code>Keycloak</code> <code>JPA</code> <code>PostgreSQL</code> <code>ArchUnit</code> <code>Flyway</code></p></section>
<section class="project"><h3>feed-postgresql-query-tuning — PostgreSQL 쿼리 최적화</h3><blockquote><p>개인 프로젝트 · 2025.03 ~ 2025.04 · 1 인 · 분석 / 최적화 / 검증 <a href="https://github.com/donghyeon-ka/feed-postgresql-query-tuning">github.com/donghyeon-ka/feed-postgresql-query-tuning</a></p></blockquote><p>피드 목록 조회 쿼리를 실행 계획 기준으로 분석하고, JOIN 구조와 인덱스 설계를 바꿔 성능을 개선한 프로젝트입니다.</p><ul><li><code>EXPLAIN ANALYZE</code> 기준 피드 목록 조회 쿼리 실행 시간을 <strong>1.77 s → 7.66 ms</strong>로 개선했습니다.</li><li>4-table <code>LEFT JOIN</code>에 따른 row 폭증, 인덱스 미사용, 디스크 기반 외부 정렬을 병목으로 확인했습니다.</li><li><code>EXISTS</code> 서브쿼리, 페이지네이션 쿼리 분리, 복합 / 커버링 인덱스를 단계적으로 적용했습니다.</li><li>단일 인스턴스 환경에서 Locust 1,000 동시 사용자 시나리오를 실행해 약 <strong>900~1,100 RPS</strong> 구간을 확인했습니다.</li></ul><p><code>PostgreSQL</code> <code>EXPLAIN ANALYZE</code> <code>Index design</code> <code>JPA</code> <code>Redis</code> <code>Locust</code></p></section>
<section class="project"><h3>Project-Infra — Spring 앱 실행 환경</h3><blockquote><p>개인 프로젝트 · 2025.11 ~ 현재 · 1 인 · 로컬 / dev 환경 구성 <a href="https://github.com/donghyeon-ka/project-infra">github.com/donghyeon-ka/project-infra</a></p></blockquote><p>auth-server가 동작하는 로컬 / dev K3s 환경을 구성하면서 백엔드와 인프라의 인증 책임을 분리한 프로젝트입니다.</p><ul><li>Traefik ForwardAuth + oauth2-proxy + Keycloak으로 로그인 / 세션 확인을 Ingress 계층에 두고, auth-server는 JWT 검증에 집중하도록 구성했습니다.</li><li>Vault → VSO → Kubernetes Secret 흐름으로 secret 주입 책임을 애플리케이션 코드 밖으로 분리했습니다.</li><li>Kustomize base / overlay 구조로 로컬과 dev 환경 차이를 manifest 단에서 관리했습니다.</li></ul><p><code>Kubernetes</code> <code>K3s</code> <code>Kustomize</code> <code>Vault</code> <code>VSO</code> <code>Traefik</code></p><hr></section>
<section class="project"><h3>TechLog — 기술 학습 기록을 서비스로 연결한 프로젝트</h3><blockquote><p>멘토링 기반 개인 프로젝트 · 약 6개월 · 1 인 · 설계 / 구현 / 검증 <a href="https://hyeonworks.com">hyeonworks.com</a></p></blockquote><p>인증, 성능, 아키텍처 과제를 진행하며 문서가 늘어났지만, 기록이 흩어져 <strong>“왜 이런 결정을 했는지”를 다시 따라가기 어려운 문제</strong>가 생겼습니다. 이를 해결하기 위해 Public / Studio 구조의 기술 기록 서비스를 만들었습니다.</p><ul><li>작성 흐름을 Create / Save / Validate / Preview / Publish 유스케이스로 분리하고 persistence / rendering 구현을 port 뒤로 분리했습니다.</li><li>backend를 18개 Gradle module로 나누고, <code>modules.json</code>을 기준으로 허용 dependency와 runtime membership을 검증하도록 구성했습니다.</li><li>Project / Topic / Release 관리 유스케이스를 application layer에 두어 JPA entity와 화면 DTO가 application 정책으로 직접 유출되지 않도록 분리했습니다.</li><li>backend contract에는 값이 있지만 HTTP mapping 또는 frontend adapter에서 누락되어 화면이 비는 문제를 추적하고 contract / route / test gate를 보강했습니다.</li><li>frontend도 <code>domain → application → adapter → presentation</code> 경계를 두고 HTTP / mock adapter를 교체할 수 있도록 구성했습니다.</li></ul><p><code>Java 21</code> <code>Spring Boot</code> <code>JPA</code> <code>PostgreSQL</code> <code>Gradle</code> <code>ArchUnit</code> <code>React</code> <code>TypeScript</code></p></section>
<section class="project"><h3>Keycloak 인증 구조 — 브라우저와 서버의 credential 경계 비교</h3><blockquote><p>멘토링 과제 · 개인 lab · 설계 / 구현 / 검증</p></blockquote><p>같은 로그인 기능이라도 SPA, BFF, Forward-Auth에 따라 token과 session의 위치, API 호출 주체가 달라집니다. 구조 이름만 비교하지 않고 <strong>credential이 실제로 어디에 머무는지</strong>를 기준으로 네 가지 패턴을 구현했습니다.</p><ul><li>SPA / Token Mediator / BFF / Forward-Auth를 구현해 authorization code 교환 주체, refresh token 보관 위치, API caller를 비교했습니다.</li><li>BFF에서는 브라우저 JavaScript에서 OAuth token을 제거하는 대신 server-side session, CSRF, session scale-out 문제가 새로 생기는 것을 확인했습니다.</li><li>Forward-Auth에서는 edge가 만든 identity header를 신뢰하려면 header overwrite와 network isolation이 함께 필요하다는 점을 검증했습니다.</li><li>이후 2-node K3s 환경으로 확장해 Keycloak session의 실제 저장 위치를 확인했습니다.</li><li>Keycloak 26 기본 <code>persistent-user-sessions</code> 조건에서 교차 노드 session 처리가 Infinispan 복제보다 <strong>공유 PostgreSQL session 조회에 의존하는 경로</strong>임을 SQL로 확인했습니다.</li></ul><p><code>Keycloak</code> <code>OAuth2 / OIDC</code> <code>Spring Security</code> <code>PostgreSQL</code> <code>K3s</code> <code>Nginx</code></p></section>
<section class="project"><h3>피드 조회 성능 — N+1 이후의 조회 전략 비교</h3><blockquote><p>멘토링 과제 · PostgreSQL 16 Testcontainers 기반 측정 아래 수치는 local / warm-cache 기준이며 운영 성능 수치가 아닙니다.</p></blockquote><p>피드마다 최신 하이라이트와 공개 범위, pagination을 함께 처리하면서 N+1만 제거하면 끝나지 않는 문제를 확인했습니다. 쿼리 수, 반환 행, 인덱스, paging 비용을 분리해 비교했습니다.</p><ul><li>FeedItem 1,000개 조회에서 Hibernate Statistics 기준 PreparedStatement <strong>2,022개</strong>를 기준선으로 확인했습니다.</li><li>fetch join에서 <code>MultipleBagFetchException</code>, row 증가, collection fetch + paging의 in-memory paging 문제를 재현했습니다.</li><li>Batch Fetch 적용 후 같은 조건에서 PreparedStatement를 <strong>2,022 → 23</strong>으로 줄였습니다.</li><li>부모별 최신 3개 조회에서 Window Function / LATERAL / 2-step을 비교하고, 작은 K와 복합 인덱스 조건에서 LATERAL이 유리한 이유를 실행계획으로 확인했습니다.</li><li>2,000행의 깊은 페이지에서 OFFSET은 2,000행을 읽고 Keyset + 정렬키 index는 <strong>20행</strong>만 읽는 실행계획을 확인했습니다.</li></ul><p><code>Spring Data JPA</code> <code>Hibernate</code> <code>PostgreSQL 16</code> <code>Testcontainers</code> <code>EXPLAIN ANALYZE</code></p><hr></section>
<h2>Links</h2>
<ul><li><strong>GitHub</strong>: <a href="https://github.com/donghyeon-ka">github.com/donghyeon-ka</a></li><li><strong>메인 프로젝트</strong>: <a href="https://github.com/donghyeon-ka/project-auth-server">project-auth-server</a></li><li><strong>인프라</strong>: <a href="https://github.com/donghyeon-ka/project-infra">project-infra</a></li><li><strong>쿼리 튜닝</strong>: <a href="https://github.com/donghyeon-ka/feed-postgresql-query-tuning">feed-postgresql-query-tuning</a></li><li><strong>Blog</strong>: <a href="https://velog.io/@donghyeon2">velog.io/@donghyeon2</a></li></ul>
<ul><li><strong>TechLog</strong>: <a href="https://hyeonworks.com">hyeonworks.com</a></li><li><strong>GitHub</strong>: <a href="https://github.com/donghyeon-ka">github.com/donghyeon-ka</a></li><li><strong>Blog</strong>: <a href="https://velog.io/@donghyeon2">velog.io/@donghyeon2</a></li></ul>
</main>
</body>
</html>