Files
Resume/dist/01-java-spring-backend.feat.google-version.html

207 lines
9.3 KiB
HTML

<!doctype html>
<html lang="ko">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>01-java-spring-backend.feat.google-version</title>
<style>:root {
color-scheme: light;
--ink: #1f2933;
--muted: #52616b;
--rule: #d8dee4;
--accent: #0f766e;
--soft: #eef7f5;
}
@page {
size: A4;
margin: 10mm 12mm 11mm;
}
* {
box-sizing: border-box;
}
body {
margin: 0;
background: #ffffff;
color: var(--ink);
font-family: "Noto Sans CJK KR", "Noto Sans KR", "Apple SD Gothic Neo", "Malgun Gothic", Arial, sans-serif;
font-size: 8.9pt;
line-height: 1.38;
word-break: keep-all;
overflow-wrap: break-word;
}
main {
max-width: 190mm;
margin: 0 auto;
}
h1,
h2,
h3 {
margin: 0;
line-height: 1.25;
letter-spacing: 0;
}
h1 {
padding-bottom: 2.8mm;
border-bottom: 2px solid var(--accent);
font-size: 18.5pt;
font-weight: 800;
}
h2 {
margin-top: 4.6mm;
padding-bottom: 1.1mm;
border-bottom: 1px solid var(--rule);
color: var(--accent);
font-size: 12.1pt;
font-weight: 800;
}
h3 {
margin-top: 3.6mm;
font-size: 10.4pt;
font-weight: 800;
}
.project {
display: block;
break-inside: avoid;
}
.project h3 {
margin-top: 3.8mm;
}
.project:first-of-type h3 {
margin-top: 3mm;
}
p {
margin: 1.7mm 0;
}
a {
color: #0b5cad;
text-decoration: none;
}
hr {
height: 1px;
margin: 3mm 0;
border: 0;
background: var(--rule);
}
table {
width: 100%;
margin: 2mm 0 3mm;
border-collapse: collapse;
font-size: 8.7pt;
}
td,
th {
padding: 1mm 1.6mm;
border-bottom: 1px solid var(--rule);
text-align: left;
vertical-align: top;
}
td:first-child,
th:first-child {
width: 23mm;
color: var(--muted);
font-weight: 700;
}
blockquote {
margin: 1.7mm 0;
padding: 1.5mm 2.2mm;
border-left: 3px solid var(--accent);
background: var(--soft);
color: #334e4a;
}
blockquote p {
margin: 0.8mm 0;
}
ul {
margin: 1.4mm 0 2.2mm;
padding-left: 4.4mm;
}
li {
margin: 0.75mm 0;
padding-left: 0.5mm;
}
strong {
font-weight: 800;
}
code {
padding: 0.1mm 0.7mm;
border-radius: 2px;
background: #f3f4f6;
color: #1f2937;
font-family: "JetBrains Mono", "D2Coding", Consolas, monospace;
font-size: 0.92em;
}
h3 + blockquote {
margin-top: 1.2mm;
}
blockquote + p,
blockquote + ul {
margin-top: 1.6mm;
}
h2,
h3,
blockquote,
table {
break-after: avoid;
}
li,
blockquote,
tr {
break-inside: avoid;
}
</style>
</head>
<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>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>현업 개발자의 멘토링 아래 약 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, Spring Data JPA, PostgreSQL</li></ul>
<p><strong>Architecture / Testing</strong></p>
<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>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>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>