43 KiB
PORTFOLIO REVIEW — "AI가 만든 티" 제거
대상 Backend 제품형 11p · Backend 성능형 11p · Infra/Platform 11p (dist/*.pdf)
방법 33페이지를 150dpi 이미지로 렌더해 리뷰어 3명이 한 장씩 육안 확인. 소스 수정 없음.
날짜 2026-09-23
이전 리뷰와의 차이 직전 라운드는 겹침·잘림·정보 위계를 다뤘고 그건 해결됐다. 이 문서는 "사람이 쓴 문서로 안 읽히는 이유" 하나만 다룬다.
0. 판정
내용은 정직하고 수치는 정확하다. 문제는 균질성이다.
측정해 보면 이렇다.
| 항목 | Backend | Infra |
|---|---|---|
| 산문 문장 수 | 41 | 38 |
~니다 종결 비율 |
95% | 87% |
| 15자 이하 문장 | 0개 | 1개 |
| 문장 길이 중앙값 / 최장 | 74 / 194자 | 89 / 250자 |
| meta 질문 줄 | 10개 | 10개 |
| 그 질문의 어미 | ~는가?/~인가? 10/10 |
10/10 |
| 본문 산문의 물음표 | 0개 | 0개 |
| 페이지 골격 | H1→H2→META→문단→그림→[불릿]→문단 10/10 동일 |
10/10 동일 |
두 문서 합쳐 meta 질문 20개가 전부 ~는가? 또는 ~인가?로 끝난다. 이 어미는 한국어 구어에서 거의 쓰지 않는 논설문투다. 한 번이면 문체고, 스무 번이면 슬롯이다.
그리고 질문은 본문에서 회수되지 않는다. 본문 산문의 물음표가 0개다. 질문을 던져 놓고 곧바로 서술로 들어간다. 질문-응답이 아니라 질문-장식이다.
핵심: 문장을 예쁘게 다시 쓰는 것보다 템플릿에 의도적인 불균형을 넣는 것이 효과가 크다. 사람이 쓴 문서는 어떤 페이지는 길고 어떤 페이지는 세 줄이고, 어떤 페이지엔 그림이 없고, 한 페이지쯤은 삽질 얘기로 절반을 쓴다. 지금은 그 편차가 0이다.
1. P0 — 먼저 고칠 사실 오류
AI 티 이전에 신뢰 문제다. 세 건 모두 직전 개편에서 생겼다. 직접 확인했다.
1-1. Backend p.06 — 본문은 축 4개, 표는 5행
- 본문:
네 가지 인증 구조를 같은 **네 가지 질문**으로 비교했습니다+ 나열 4개(브라우저 보관 / API 호출자 / 서버 상태 / 검증 대상) - 실제 표: 5행 — 위 4개 +
CSRF 경계
본문과 그림을 따로 만들고 맞춰보지 않은 흔적이다.
조치 — 본문을 표에 맞춘다.
인증 구조 4개에 같은 질문 5개를 던졌습니다. 브라우저가 무엇을 들고 있는지, API를 누가 호출하는지, 서버가 무엇을 저장하는지, CSRF 경계가 어디 생기는지, 그리고 무엇을 검증하는지.
1-2. Backend p.10 — 같은 페이지에 LATERAL 수치가 두 개
- 불릿:
LATERAL: 60 rows · 204 buffers · 0.323 ms - 그림 카드:
index on · Index Scan + Limit · 168 buffers · 0.336 ms
원본을 보면 전자는 Window/LATERAL/2-step 3자 비교, 후자는 index on/off 대조로 서로 다른 실험이다. 두 페이지를 한 장으로 합치면서 구분 없이 병치했다. 읽는 사람은 "숫자를 지어냈나"를 먼저 의심한다. 이 문서 전체에서 가장 위험한 지점이다.
조치 — 두 측정임을 명시하거나 페이지를 다시 나눈다.
LATERAL은 같은 질의를 두 실험에서 쟀습니다. 3자 비교(부모 20개)에서는 204 buffers · 0.323 ms, index on/off 대조에서는 168 buffers · 0.336 ms입니다.
※ 두 실험의 데이터셋·조건이 실제로 달랐는지 본인 확인 필요. 같은 조건인데 값이 다르면 한쪽이 틀린 것이다.
1-3. Backend p.11 — 차트 3계열, 불릿 2개
차트에 Keyset − index: 2,000 rows · 141 buffers · 0.373 ms가 있는데 불릿에서 빠졌다. 읽는 사람은 "왜 하나만 뺐지"를 먼저 생각한다.
더 나쁜 건 그 숨은 값이 주장을 흔든다는 점이다. Keyset − index의 0.373 ms는 OFFSET의 0.996 ms보다 여전히 2.6배 빠르다. 그런데 본문은 "정렬 index를 제거하면 다시 전체 scan으로 돌아갔습니다"로 닫아 "index 없으면 keyset은 무의미"라는 인상을 준다. 차트를 본 사람과 글을 읽은 사람의 결론이 갈린다.
조치 — 불릿에 세 번째 줄을 넣고 결론을 정직하게 고친다.
index를 뺀 채 같은 keyset query를 돌리니 읽은 row가 20에서 2,000으로, buffer가 1에서 141로 올라갔습니다. OFFSET과 정확히 같은 숫자입니다. 그래도 0.373 ms로 OFFSET의 0.996 ms보다는 빨랐는데, 읽는 양이 같은데 시간이 갈린 이유는 여기까지 확인하지 않았습니다.
1-4. Infra p.06 — 자기가 잰 숫자를 뭉갬
66 → 1,872 ms는 28배인데 본문은 "20배 이상으로 커진 점"이라고 쓴다. 자기 측정값을 본인이 정확히 안 쓰면 나머지 숫자도 의심받는다.
2. AI 티의 3대 원인
원인 1 — meta 질문 줄 20개가 전부 같은 어미 (최대 원인)
**목록 1페이지를 여는 데 실제로 몇 번 질의하는가?** · 별도 멘토링 과제 · Feed Query Performance Lab
**같은 public path를 몇 군데에서 만들고 있었는가?** · TechLog Backend · 개인 프로젝트
**replica를 늘리면 세션은 정말 유지되는가?** · VM 2대 · 2-node K3s · Keycloak 26
오른쪽 꼬리표도 반복된다. Backend에서 · TechLog Backend · 개인 프로젝트 4회, · 별도 멘토링 과제 · Feed Query Performance Lab 4회가 글자 그대로 반복된다.
처방 — 질문 줄을 문서당 3개 이하로 줄인다. 남길 후보는 본인이 실제로 던졌을 법한 것만. 나머지는 상황 한 줄로 바꾼다.
| 현재 | 대체 |
|---|---|
**목록 1페이지를 여는 데 실제로 몇 번 질의하는가?** |
Feed Query Lab · PostgreSQL 16 · [측정 시기] |
**Studio에서 고치는 중인 글이 그대로 공개되어도 되는가?** |
Studio 자동 저장 · 초기 구현 |
**module 18개에서 참조해도 되는 방향을 누가 기억하는가?** |
(남긴다면) module 18개의 의존 방향, 누가 기억하죠? |
남기는 질문도 어미를 흩뜨린다: ~할까?, ~하나?, ~죠?, 물음표 없는 자문.
날짜가 들어가면 그 자체로 사람 티가 난다.
원인 2 — 같은 문장을 2~3번 복창
가장 노골적인 사례. Backend p.05에서 그림 하단 배너와 본문이 한 글자도 안 틀리고 같다.
그림 배너: adapter는 서로를 모르고 application port만 구현합니다
본문: 이제 adapter는 서로를 모르고 application port만 구현합니다.
같은 페이지에 3중 중복이 하나 더 있다.
| 본문 | 그림 |
|---|---|
transport 하나를 바꾸면 관계없는 저장소 adapter까지 같이 열어야 했습니다 |
transport 하나를 바꾸면 저장소 adapter까지 같이 열어야 함 |
outer adapter끼리 직접 참조하는 project dependency가 생겼습니다 |
outer adapter끼리 직접 참조하는 project dependency |
수치 중복도 심하다.
| 값 | 등장 횟수 | 위치 |
|---|---|---|
2,022 (Backend p.08) |
5회 | H2 · 본문 · 차트 라벨 · 분해 카드 · 표 |
151 → 151 (Infra p.05) |
4회 | 표지 · H2 · 본문 · 그림 |
2,305 s (Infra p.09) |
5회 | 표지 · H2 · 그림 숫자 · 그림 캡션 · 불릿 |
처방
- 그림 하단 굵은 컬러 결론 배너를 문서당 2개 이하로. 지금은 있는 페이지와 없는 페이지가 뒤섞여 규칙도 없다. 본문 재진술인 것부터 삭제한다 — Backend p.02·p.05, Infra p.03·p.04·p.07·p.09·p.10.
- 같은 수치는 한 페이지에 2회까지. H2에 넣었으면 본문에서 빼고, 그림에 있으면 불릿에서 뺀다.
- Backend p.08의 차트와 표 중 하나를 버린다. 25/222/2,022를 똑같이 두 번 그린다.
원인 3 — "어떻게 알아챘는지"가 33페이지에 한 줄도 없다
명령어, 로그 한 줄, 대시보드 이름, 날짜, 틀린 가설이 0개다. 1인칭(저는/제가)도 0회. 실패·되돌린 선택·후회도 0건.
전체에서 사람 냄새가 나는 문장은 딱 셋이다.
- Backend p.08 —
7회 중 앞 2회를 warm-up으로 제외한 5회의 median / max입니다 - Backend p.03 —
Project Decision은 publish까지 끝났고 목록에도 보였지만, 링크를 누르면 404가 났습니다 - Infra p.08 —
key를 지운 시점만으로는 이 교차를 설명할 수 없었고
3번이 문서 전체에서 유일한 '헛다리' 흔적이다. 이 톤이 기준이 돼야 한다.
가장 아까운 건 **Infra p.09 (TLS Renewal)**다. 33페이지 중 유일하게 주입/재현이 아니라 실제로 잘못돼 있던 사고인데, 발견 경위 없이 원인부터 서술해서 나머지 실험 페이지와 구분이 안 된다.
처방 — 각 페이지에 다음 중 최소 하나를 넣는다.
- 증상을 처음 본 순간 (무엇을 보고 알았나)
- 처음 의심했다가 틀린 곳
- 실제로 친 명령어 / 열어 본 파일 / 본 화면
- "그래서 뭘 바꿨나" — 안 바꿨으면 "안 바꿨습니다"라고 쓰는 게 훨씬 사람 같다
3. 페이지별 — Backend 제품형
p.01 표지 — AI티 강함
- H2
게시 상태와 module 경계, 인증 경계를 코드로 고정해 왔습니다— 추상명사 3연발. 개인 프로젝트 하나를 3년 경력처럼 쓰는 어투. - 인용 블록이 문제 3개를 말하고, 바로 아래 카드 3장이 같은 3개를 다시 말한다. 카드 제목은
초안 공개 차단/404 재발 차단/의존 방향 위반 차단— 완전 대칭 3연 명사구. - 지원자가 누구인지가 없다. 연차, 왜 만들었는지, 왜 읽어야 하는지가 한 줄도 없다.
대체
H2:
혼자 만든 블로그 백엔드에서 초안이 공개되고, 게시한 글이 404가 났습니다인용:TechLog는 제가 쓴 글을 올리려고 만든 블로그 백엔드입니다. 위 두 문제와, module이 18개로 늘면서 의존 방향이 제 기억에만 남아 있던 문제를 다뤘습니다. 7~10페이지의 Feed Query 성능 비교는 TechLog가 아니라 별도 멘토링 과제입니다.카드 어미 비대칭으로:초안은 publish 앞에서 막힙니다/path는 route contract 한 곳에서만 나옵니다/선언 안 한 module edge는 Gradle check가 깹니다
p.02 Publication Workflow — AI티 강함
그림 배너가 H2를 복창하고, publication status와 publishedVersion만 봅니다가 그림·본문에 또 겹친다. 같은 사실 3회.
검증을 통과하지 못한 문서도 링크만 알면 보였습니다가 유일하게 살아 있는 문장인데 어떻게 알았는지가 없다.
대체
Studio는 타이핑 중에도 계속 저장합니다. 초기 구현에서는 그 저장본이 곧 공개 화면이었고, 검증을 통과하지 못한 문서도 로그인 없이 링크만 알면 열렸습니다.
그림 배너 삭제. 마지막 문단에서 use case 나열(그림에 이미 있음)을 뺀다.
p.03 Contract Drift — 애매 (11장 중 가장 사람 같음)
진짜 원인인 decisions#{slug} vs decisions/{slug}가 그림 안에만 있고 본문이 말하지 않는다. 본문은 "각각 같은 public path를 따로 만들고 있었고"라는 추상 요약으로 끝난다. 구체는 그림에 숨기고 본문은 매끄럽게 닫는 습관.
불릿 4개가 ~검사 / ~검사 / ~유도 / ~드러나게 함으로 전부 명사형 종결.
대체
목록에는 떠 있는데 누르면 404. Project Decision 글에서 처음 봤습니다. 따라가 보니 public path를 만드는 곳이 네 군데였습니다 — OpenAPI contract, publisher, projection DB, frontend route. 넷이 각자 문자열을 조립하고 있었으니 한 곳만 decisions#{slug}로 쓰고 다른 곳이 decisions/{slug}로 쓰면 그대로 깨집니다. 리뷰로 잡을 수 있는 종류의 버그가 아니었습니다.
불릿 어미 풀기: ~하면 검사에서 걸립니다 / ~실제로 해석해 봅니다 / ~같은 contract에서 뽑습니다 / ~하나 빠지면 컴파일이 안 됩니다
p.04 Dependency Direction — 애매
사람 기억이 아니라 build에서— "A가 아니라 B" 구문. 두 문서 합쳐 6회 나온다.- 불릿 3개가 전부 "실패"로 끝난다.
- 그림 배너
app-bootstrap은 구현체를 고르지만 application contract를 소유하지 않습니다가 p.05의 주제를 미리 말해버린다. p.05 불릿에 같은 내용이 또 나온다. - 규칙을 넣고 실제로 무슨 일이 일어났는지가 없다. 도입 비용, 불편, 깨진 사례 전부 없음.
대체
H2:
module이 18개가 되자 의존 방향을 제가 더 이상 못 외웠습니다본문:module이 18개가 되자 의존 방향 하나 확인하려고 build.gradle.kts를 18번 열어야 했습니다. 지금은 허용 edge를 modules.json 한 파일에 적어 두고 ./gradlew check가 실제 project dependency와 대조합니다. 선언에 없는 edge가 생기면 build가 깨지니까, 이제 아무도 기억할 필요가 없습니다.비용 한 줄 추가 [확인 필요]:대신 module을 새로 만들 때마다 modules.json을 먼저 고쳐야 합니다.
그림 배너는 p.05와 안 겹치게: 화살표는 항상 안쪽을 가리킵니다 — 이 그림과 다른 edge는 선언 자체가 안 됩니다
p.05 Contract Ownership — AI티 강함
본문과 그림 배너가 한 글자도 안 다른 문장을 두 번 쓴다(원인 2 참조). 둘 중 하나를 지운다.
BEFORE(빨강)/AFTER(초록) 2단 도식이 p.03에 이어 두 페이지 만에 재등장한다. 색·배치·굵기까지 같다.
대체
transport adapter를 손대는데 JPA adapter의 build 파일이 같이 열렸습니다. inbound adapter가 자기 interface를 정의하고 outbound adapter가 그 타입을 구현하면서, adapter끼리 직접 참조하는 project dependency가 생겨 있었습니다.
p.04 그림 배너와 겹치는 app-bootstrap 불릿은 여기서 삭제.
p.06 Authentication 패턴 비교 — AI티 강함 + 사실 오류
§1-1 참조. 그 외:
이 표는 네 구조를 모두 구현해 본 실험 결과이고— 이 문서에서 가장 무거운 주장인데 링크도 repo도 코드 조각도 없다. 면접에서 제일 먼저 찔린다. meta 줄에 repo 경로를 직접 넣어야 한다.브라우저에서 token을 치우면 서버 쪽에 세션 상태가 생기고, 세션 쿠키를 쓰면 CSRF 경계가 따라옵니다— 교과서 대구문. 누가 써도 같은 문장이 나온다.
대체
네 개를 다 짜 보고 나서 고른 기준은 "브라우저에 무엇이 남는가"였습니다. 브라우저에서 token을 치우면 그만큼 서버에 세션 상태가 생기고, 세션 쿠키를 쓰면 CSRF 경계가 따라옵니다. TechLog에는 이 중 두 가지를 넣었습니다.
p.07 Authentication Modes — AI티 강함 (최악의 문장 포함)
공개 배포가 어느 mode로 떠 있는지는 **이 작업공간에서** 확인되지 않아 단정하지 않습니다.
"이 작업공간"은 사람의 어휘가 아니다. 자기가 만든 서비스가 어느 모드로 떠 있는지 모르는 것도 이상하고, 그걸 "작업공간에서 확인되지 않아"라고 쓰는 건 더 이상하다. 읽는 사람은 여기서 AI 생성을 확신한다. 한 문장으로 저자가 누군지 자백한다.
(이 문장은 이번 개편 이전 원본부터 있던 것이다.)
마지막 문단에 면책이 연달아 3개다: 단정하지 않습니다 + 비교 실험 범위이고 + 넣지 않았습니다. 정직하려는 의도가 방어적 톤으로 굳었다.
대체
repository 기본값과 제 로컬 .env는 모두 jwt입니다.(뒤 절 통째로 삭제 — 공개 배포 모드는 확인해서 쓰거나 아예 언급하지 않는다) 유지 비용 한 줄 [확인 필요]:분기를 남겨둔 만큼 인증 관련 테스트는 두 mode로 각각 돌려야 합니다.
Forward-Auth는 비교 실험 범위이고…는 p.06과 중복이므로 여기서 삭제.
p.06과 표 레이아웃이 동일하다(회색 라벨 열 + 컬러 헤더 + 흰 셀). 연속 두 페이지가 같은 표라 템플릿 인상이 가장 강해지는 구간이다.
p.08 N+1 Baseline — 애매 (측정 조건은 사람 같음)
2,022가 한 페이지에 5번. 차트와 표가 완전히 같은 데이터를 두 번 그린다.
빠진 것: N=1,000이 어디서 왔는지. 실제 목록 화면이 한 번에 1,000건을 열 일이 없다면 면접에서 바로 찔린다.
대체
loadFeed(0, 1000)한 번에 PreparedStatement가 2,022개 나갔습니다. Hibernate Statistics로 뜯어보면 content 1, count 1, User ToOne 20, Page ToOne 1,000, Highlight collection 1,000. 앞의 22개는 고정이고 나머지 2,000개가 부모 행 수를 그대로 따라갑니다. 피드를 한 페이지 더 길게 뽑을 때마다 SQL이 그만큼 더 나간다는 뜻입니다.각주:측정 조건 — PostgreSQL 16(Testcontainers), 동일 JVM, warm cache, single thread. 7회 돌려 앞 2회는 JIT warm-up으로 버리고 남은 5회의 median / max만 적었습니다. 단일 스레드 값이라 동시 요청에서의 지연은 여기 없습니다.`
p.09 Batch / Projection — AI티 강함
숫자 4중 반복(H2 → 카드 4장 → 본문). 헤드라인·그림·본문을 차례로 읽으면 세 번 같은 말을 듣는다.
그림이 사실상 "숫자 4개를 박스에 넣은 것"인데 페이지의 40%를 차지한다. 내용이 없는데 자리가 큰 것 자체가 템플릿 티다.
목록처럼 읽기만 하는 화면에만 적용했습니다 — 어느 화면인지 없다. TechLog에 넣은 건지 Lab 안에서만 한 건지도 불분명하다.
대체 (숫자 복창을 빼고 판단만)
두 방법은 성격이 다릅니다. Batch Fetch는 기존 entity 코드를 한 줄도 안 건드립니다. 적용 비용이 거의 없는 대신 entity는 여전히 1,569개가 만들어집니다. Projection은 반대로 읽기 전용 DTO를 새로 짜야 하고, 그 대가로 entity load가 0이 됩니다. 수정 경로에서 쓰던 기능은 포기해야 하고요. 그래서 [어느] 화면에만 Projection을 넣었습니다.
그림을 버리고 p.08 표에 행 2개를 붙이면 p.08+p.09를 한 페이지로 합칠 수 있다.
p.10 Top-N & Index — AI티 강함 + 수치 불일치
§1-2 참조. 그 외:
- 왼쪽 1-2-3 스텝 박스는 SQL을 아는 독자에겐 자명한 설명이다. 지면 1/3을 교과서 설명에 쓴다.
EXPLAIN (ANALYZE, BUFFERS)실제 출력 한 줄(Index Scan ... rows=3 loops=20)로 바꾸면 손에 잡히는 디테일이 생긴다. - 그림에만 있는
168 buffers / 0.336 ms,4,446 buffers / 5.472 ms가 본문에 한 번도 안 나온다. 가장 극적인 증거를 본문이 "composite index가 있어서"라는 추상 명사구로 뭉갠다.
대체
여기서 이긴 건 LATERAL이 아니라 (feed_item_id, created_at DESC) index입니다. 같은 SQL에서 이 index만 떨어뜨리자 계획이 Index Scan + Limit에서 Seq Scan으로 바뀌었습니다. 168 buffers · 0.336 ms가 4,446 buffers · 5.472 ms로. buffer 26배, 시간 16배입니다. 그래서 이 실험의 결론을 "Top-N엔 LATERAL"이 아니라 "Top-N을 쓰려면 index부터 확인"으로 적어 뒀습니다.
p.11 Pagination — 애매 + 정보 은폐 인상
§1-3 참조. 그 외: 마지막 페이지인데 마무리가 없다. 11페이지짜리 문서가 keyset 주의사항으로 끝난다. 읽는 사람이 "그래서 이 사람은?"에서 멈춘다.
대체 (유보를 맨 뒤가 아니라 맨 앞으로 빼서 리듬을 바꾼다)
그렇다고 Keyset이 공짜는 아닙니다. index를 뺀 채 같은 keyset query를 돌리니 읽은 row가 20에서 2,000으로, buffer가 1에서 141로 올라갔습니다. OFFSET과 정확히 같은 숫자입니다. 정렬 key가 흔들리지 않을 것, cursor로 이어 갈 화면일 것, 그 key를 덮는 index가 있을 것. 셋이 다 맞을 때만 20행짜리 막대가 나옵니다.
마지막 ~것. 체언 종결 3연타가 문서 전체에서 유일한 리듬이 된다.
이 페이지 하단에 3~4줄짜리 닫는 말을 추가한다(새 페이지 만들지 말 것).
4. 페이지별 — Infra / Platform
p.01 표지 — AI티 강함
장애를 직접 재현하고, **무엇이 끊기고 무엇이 남는지** 숫자로 확인했습니다가 p.05 meta재시작하면 **무엇이 끊기고 무엇이 남는가?**와 같은 문형. 표지 카피와 내지 슬롯이 같은 틀에서 나왔다는 게 첫 장부터 드러난다.- hero 숫자 3개가 각각 p.05/p.06/p.09에 그대로 다시 나온다. 표지가 목차가 아니라 요약 중복이 됐다.
대체 — hero 캡션을 결과 라벨이 아니라 '의외였던 점'으로
K3s로 개인 서버에 home lab을 세워 두고, 인증·TLS·secret 경로에서 깨질 만한 곳을 하나씩 일부러 건드려 봤습니다. 아래 세 숫자는 그중 제가 예상과 제일 크게 어긋났던 것들입니다.66 → 1,872 ms— DB에 200 ms만 넣었는데 login이 28배가 됐습니다151 → 151— 재시작해도 DB row는 안 줄었습니다 (줄어들 거라 생각했습니다)2,305 s → 1–2 s— 갱신은 성공인데 옛 인증서가 38분 더 나가고 있었습니다
p.02 Request Path — 애매
결론에서 스스로 "단일 실패 지점"이라 말해 놓고 그에 대한 측정·대응이 문서 어디에도 없다. 실무자는 바로 "그래서 그게 죽으면?"이라고 묻는다. (p.09의 reload 무중단 8,856/8,856이 사실상 그 답인데 연결이 안 돼 있다.)
정리했습니다는 문서가 스스로를 서술하는 AI 습관.
대체
문이 하나라 인증서와 forwarded header를 한 곳에서만 맞추면 되는 대신, Host Nginx가 죽거나 config를 잘못 밀면 전부 같이 죽습니다. reload만큼은 무중단인지 따로 재 봤고 결과는 08에 있습니다. 프로세스 자체가 죽는 경우는 아직 대비가 없습니다.
p.03 Edge Trust — AI티 강함
불릿 5개가 전부 설정값 나열이다. Host Nginx upstream: 127.0.0.1:30080, K3s NodePort bind: 127.0.0.0/8… 이건 config를 붙여넣은 것이지 "제가 막았습니다"의 증거가 아니다. 설정은 문서 보고 누구나 쓴다.
Gitea / Grafana / metrics의 외부 우회 경로는 404 한 줄만 유일한 검증 결과인데, 뭘 어떻게 쳐서 404를 봤는지가 없어 나머지 설정 줄과 구분이 안 된다.
대체 — "설정"에서 "쳐 본 결과"로 전환 [모두 확인 필요]
LAN 안에서 192.168.0.x:30080으로 직접 붙어 봤더니 connection refused. NodePort를 127.0.0.0/8에만 bind해 둔 결과입니다.외부에서 X-Forwarded-For: 1.2.3.4를 붙여 보내도 Traefik access log에는 10.42.0.1이 찍힙니다. Host Nginx가 덮어쓰기 때문입니다.Gitea / Grafana / metrics 경로를 공인 도메인으로 쳤을 때 404.
확인한 적이 없다면 그 불릿은 "설정했다"로 정직하게 낮추거나 빼는 게 낫다.
p.04 Session State — 애매
**replica를 늘리면 세션은 정말 유지되는가?**— '정말'이 붙어 반문 톤까지 템플릿화됐다.- 그림 배너가 H2 + 본문의 세 번째 반복.
다음 페이지에서 실제로 replica를 재시작해 어느 쪽이 남는지 확인했습니다— 문서의 자기 서술이라 AI 목차 같다.- 근본 문제: Keycloak 문서를 읽으면 아는 내용이다. 본인 경험이 들어간 부분이 없다.
대체 [확인 필요 — 실제로 오해했던 게 맞는지]
처음엔 replica를 2개로 띄우면 JGroups가 세션을 복제해 주는 줄 알았습니다. 실제로는 persistent-user-sessions를 켠 쪽이 일을 하고 있었고, JGroups는 discovery와 transport만 맡습니다. durable state는 PostgreSQL에 있고, 각 replica가 따로 들고 있는 건 cache입니다.
p.05 Rolling Restart — AI티 강함
151 → 151이 4번. 숫자만 있고 방법이 없다. 151을 어떻게 셌는지, HTTP 200을 어떻게 확인했는지, 몇 번 반복했는지가 전부 빠졌다.
Scope는 붙어 있는데 같은 lab에서 한 p.06~p.08에는 없다 — 기준 불일치.
대체 [N 값은 확인 필요]
kubectl rollout restart를 걸어 두고, 옆 터미널에서 [N초] 간격으로 login endpoint를 치면서 PostgreSQL의 session 테이블 row를 같이 세었습니다. 응답은 계속 200이었고 row는 151에서 움직이지 않았습니다. 재시작한 쪽 replica의 local cache만 0으로 떨어졌다가 다시 찼고, 재시작 전에 받아 둔 refresh token도 그대로 먹혔습니다.H2에서 숫자 빼기:restart 중에 끊긴 건 replica cache뿐이었습니다
p.06 Latency Fault — 애매 (내용은 제일 좋은데 마감이 AI)
- §1-4의 28배/20배 문제.
이 실험의 결과입니다로 문단을 라벨링하는 건 전형적 모델 마감.- 원인 규명이 얕다.
여러 번 일어나는 DB round trip— 실무자는 즉시 "몇 번인데?"라고 묻는다. 1,872 / 200 ≈ 9회. 셀 수 있었던 숫자를 "여러 번"으로 남겼다. - 지연 주입 도구가 없다.
tc netem인지 toxiproxy인지에 따라 해석이 달라진다. 1,872 ms가 평균인지 p95인지 최대인지 없음.20 s가 설정값인지 관측값인지 구분 안 됨.- "그래서 뭘 바꿨나"가 없다.
대체 [N 값 전부 확인 필요]
200 ms가 28배가 된 건 login 한 번에 DB를 [N]번 왕복하기 때문이었습니다. 왕복 횟수만큼 지연이 곱해지고, 느려진 요청이 connection을 붙잡으면서 뒤 요청은 pool에서 대기했습니다. 마지막엔 readiness probe가 [N초] timeout에 걸려 Pod 하나가 endpoint에서 빠졌는데, 그 결과 남은 Pod로 부하가 몰려 더 느려졌습니다. "DB가 조금 느린 것"과 "Pod가 빠지는 것"이 이렇게 짧게 이어져 있을 줄은 몰랐습니다.
p.07 Refresh Rotation — 애매
그림 배너와 바로 아래 본문이 같은 말이다.
error handling에서 이 둘을 구분해 재로그인으로 넘길지 판단해야 합니다 — 일반론으로 닫는 전형적 AI 마감. 본인이 실제로 구분했는지는 안 적혀 있다.
숫자가 비었다. 5건 중 몇 건이 200이고 몇 건이 실패였는지가 그림에도 본문에도 없다.
대체 [분포·횟수·조치 전부 확인 필요]
같은 refresh token R0으로 5건을 동시에 보냈습니다. [N]건은 200을 받았고 나머지는 [에러코드]였는데, 재사용이 감지된 순간 client session 자체가 무효가 돼서 방금 200으로 받아 둔 새 token R1도 다음 요청에서 거절당했습니다. 같은 요청을 순차로 [N]번 보냈을 때는 매번 정상이었습니다.결론:클라이언트가 병렬로 API를 때릴 때 401을 보고 동시에 refresh를 던지면 이 상황이 그대로 만들어집니다. "refresh 한 번 실패"라면 재시도하면 되지만 여기선 세션이 날아가 재로그인 말고는 답이 없습니다. [실제 조치 — 또는 "아직 안 고쳤습니다"]
p.08 JWKS Cache — 애매 (발견은 최고, 마무리가 없음)
401 → 200 → 401 → 200 → 401 → 200 → 401 → 2008개를 다 나열하는 건 과시적이다. 정말 보여줄 거면 그림이 시간축으로 보여줘야 하는데, 지금 그림은 A=200 / B=401 정적 박스라 교차의 재미가 죽어 있다.- "그래서 뭘 바꿨나"가 통째로 없다. 문서에서 가장 흥미로운 발견인데 결론이 "봐야 설명됐습니다"로 끝난다.
- Nimbus JWKS cache TTL 값이 없다. 이게 없으면 "언제 수렴했는가"에 답할 수 없다.
대체 [TTL·수렴 시간·조치 확인 필요]
realm에서 old signing key를 지운 직후, 같은 old access token으로 계속 요청했더니 401과 200이 [N]번 연속으로 번갈아 나왔습니다. 처음엔 Keycloak 쪽이 아직 키를 정리 중인 줄 알고 시간을 두고 다시 쳐 봤는데, 패턴이 랜덤이 아니라 정확히 한 번씩 번갈아 나오는 걸 보고 load balancer가 두 replica로 번갈아 보내고 있다는 걸 깨달았습니다. 검증은 Keycloak이 매번 해 주는 게 아니라 각 Resource Server replica가 자기 JWKS cache로 합니다. [N분] 뒤에는 양쪽 다 401로 수렴했습니다.
그림을 요청 순번 × 응답코드 시간축으로 바꾸면 이 페이지만 다른 리듬이 생긴다.
p.09 TLS Renewal — 애매 (유일한 실제 사고인데 그게 안 드러남)
§2 원인 3 참조. 그 외:
2,305 s/38분 25초가 5번. 같은 값을 초와 분으로 번갈아 쓰며 반복한다.- 불릿
p95 205.7 ms → 204.3 ms— 0.7% 차이다. 1회 측정이면 노이즈다. 이걸 개선처럼 굵게 쓰면 실무자는 "측정을 모르는구나"로 읽는다. 핵심은 8,856/8,856 무실패지 p95 소수점이 아니다.
대체 — 발견 경위부터 [경위·기간·도구 확인 필요]
[언제/어떤 계기로] 인증서 만료일이 이상한 걸 보고 openssl s_client로 실제 serving되는 인증서를 확인했더니, 파일 시스템의 certificate는 이미 갱신돼 있는데 Nginx가 내보내는 건 옛날 것이었습니다. certbot timer는 매번 성공하고 있었고, 빠진 건 renew 후에 reload를 걸어 주는 deploy hook이었습니다.
p95 소수점 비교는 삭제하거나 "차이 없음"으로 쓴다.
이 페이지는 형식을 통째로 바꿀 것. 제목 → 굵은 문장 → 그림 틀을 버리고 시간순 타임라인으로: 언제 이상함을 느꼈고 → 뭘 쳐 봤고 → 뭘 의심했다가 아니었고 → 원인이 뭐였고 → 뭘 붙였고 → 그 뒤로 어떤지.
p.10 Vault Secret Delivery — AI티 강함
측정이 하나도 없다. 전부 구성 설명이고, VSO README를 읽으면 쓸 수 있는 문장들이다.
여기서는 전달 경로까지만 이야기합니다 — 문서가 스스로 범위를 선언하는 모델 특유의 어법. 이 문장 때문에 "측정 안 했다"가 겸손이 아니라 방어로 읽힌다.
그림 배너 = H2 + 본문 마지막 문장의 세 번째 반복. 한 페이지에서 같은 명제를 세 번 말한다.
대체 [VSO로 옮긴 경위가 맞는지 확인 필요]
처음엔 각 workload가 Vault에 직접 붙게 했는데, 앱마다 Vault 주소와 token 수명을 신경 써야 해서 금방 관리가 안 됐습니다. 지금은 Vault와 직접 말하는 주체를 Vault Secrets Operator 하나로 줄였습니다. VSO가 자기 ServiceAccount token으로 Kubernetes Auth를 통과하고, policy와 role이 읽을 수 있는 path를 정하고, 그 결과만 Kubernetes Secret으로 내려옵니다. 앱 입장에서는 그냥 env와 volume입니다.마지막:manual unseal이라 서버를 재부팅하면 제가 직접 열어 줘야 하고, secret을 바꿨을 때 Pod가 언제 새 값을 보는지는 아직 안 재 봤습니다.
p.11 Observability — AI티 강함
- 숫자가 하나도 없는 유일한 페이지이고 문서가 여기서 끝난다. 측정 없는 구성도 두 장(p.10, p.11)이 연속으로 마지막을 차지해 마무리 인상이 제일 약하다.
네 신호를 한 덩어리로 다루면 "어디를 봐야 하는가"에 답할 수 없습니다— 가상의 반대 입장을 세우고 논박하는 전형적 AI 도입부. 아무도 그러자고 하지 않았다.request id 같은 공통 key를 각 신호에 같이 실어야 합니다— 교과서 결론. 본인이 실제로 했는지가 없다.- 결정적으로: 앞의 p.05~p.09 실험들이 이 스택으로 관측됐는지가 안 적혀 있다. 연결되면 이 페이지가 살고, 안 되면 장식이다.
대체 [실제 관측 여부 확인 필요]
앞의 실험들에서 login이 느려진 걸 알아챈 건 Grafana 대시보드였고, 어느 Pod가 endpoint에서 빠졌는지는 Loki에서 봤습니다. 네 신호는 수집 방식부터 다릅니다. Prometheus는 target을 직접 긁어 가고(pull), log와 trace는 소스가 Alloy로 밀어 넣습니다(push).마지막:다만 지금 구성으로는 같은 요청을 metric에서 log로, log에서 trace로 따라가는 게 안 됩니다. request id 같은 공통 key를 세 신호에 같이 실어야 하는데 아직 안 했습니다.
5. 변형본 2종 — 지금은 의미가 없다
기계적으로 확인했다.
product.json과performance.json의sections배열은 원소가 완전히 동일한 10개이고 순서만 회전시킨 것이다.- 두 산출물의 본문 10개 섹션을 섹션 번호만 떼고 비교하면 사실상 완전 일치한다.
- 두 커버의 구조도 동일:
H1 → H2 → 인용 → 3칸 지표 → 스택 → 연락처. H1 문자열("강동현 · Backend Engineer")까지 같다.
두 PDF를 나란히 본 사람은 "두 벌을 준비했구나"가 아니라 **"같은 파일을 자동 생성기로 두 번 뽑았구나"**를 본다.
성능형으로서의 추가 결함:
- 본문 톤이 제품형과 100% 같다. EXPLAIN 계획 페이지와 Gradle module 그래프 페이지가 같은 골격, 같은 문장 길이, 같은 종결어미, 같은 "단서로 닫기"를 쓴다. 사람이라면 쿼리 계획 얘기를 할 때 훨씬 조밀해지고 출력을 그대로 붙여 넣는다. 그 차이가 0이다.
- 성능형인데 성능 지면이 40%다. 11쪽 중 4쪽만 성능이다.
- 그 4쪽의 출처가 전부 **"별도 멘토링 과제"**로 네 번 명시돼 있다. 성능 리뷰어가 첫 4쪽에서 읽는 메시지는 "이 사람의 대표 성능 증거는 과제물"이다.
- 실무 성능 지표가 하나도 없다. 동시성, p95/p99, throughput, connection pool, GC/JVM, 캐시 적중률, 실트래픽 — 전부 없다. 모두 single thread · warm cache · Testcontainers 마이크로 측정이다. 수치는 정확하지만 성능 엔지니어가 찾는 축이 아니다.
선택지 (우선순위 순)
- 본문도 가른다. 같은 섹션이라도 성능형에서는 계획/버퍼/측정 조건을 한 단계 더 파고, 제품형에서는 "사용자에게 뭐가 달라졌나"로 줄인다. 지금처럼 배열만 회전시키는 빌드로는 불가능하고,
perf-*.md에 variant를 두거나 섹션 안에 variant 블록이 필요하다. - 섹션 수를 다르게. 성능형은 성능 6~7쪽 + 아키텍처 3쪽, 제품형은 반대. 지금은 10/10으로 같다.
- 성능형에 "실제 서비스에 적용한 것" 한 쪽을 반드시 넣는다. TechLog에서 Projection이나 Keyset을 실제로 쓰고 있다면 그 쪽이 성능형의 1번 섹션이 되어야 한다. [적용 여부 확인 필요]
- 커버 틀을 다르게. 성능형은 3칸 지표 대신 before/after 표 + 측정 조건 한 줄로.
- 위가 전부 어렵다면 2종을 없애고 1종으로 간다. 커버만 바꾼 두 벌은 한 벌보다 나쁘다.
6. 구조 처방
덜어낼 것
| # | 대상 | 효과 |
|---|---|---|
| 1 | Backend p.08 + p.09 병합 (숫자 박스 그림 삭제, 표에 2행 추가) | 11 → 10p |
| 2 | Infra p.04 + p.05 병합 (결론이 같은 명제 하나) | 11 → 10p, 151 → 151 4중 반복도 해소 |
| 3 | 그림 하단 굵은 컬러 배너 — Backend 2개, Infra 5개 삭제 | 본문 재진술 제거 |
| 4 | meta 질문 줄 20개 → 문서당 3개 이하 | 최대 원인 제거 |
| 5 | Backend p.08 차트 또는 표 중 하나 | 같은 데이터 2회 그리기 해소 |
| 6 | · 구분자 사용을 절반으로 |
제목·meta·스택·불릿·각주가 전부 같은 리듬 |
변주를 줄 곳
- Backend p.03을 "사건 기록" 형식으로 단독 변형. 시간순 3단(증상 → 오진 → 원인) +
decisions#{slug}대decisions/{slug}대조만 크게. 한 장이라도 골격이 다르면 나머지가 "템플릿"으로 안 읽힌다. - Backend p.07을 코드 페이지로. 표 대신
SecurityConfig분기 실제 코드 10~15줄. 지금 이 문서에는 코드 블록이 한 개도 없다. 백엔드 포트폴리오에 코드가 0줄인 것 자체가 부자연스럽다. p.06과 표 레이아웃이 겹치는 문제도 자동 해결된다. - **Infra p.09(TLS)**를 타임라인 형식으로 (§4 참조).
- Infra p.08(JWKS) 그림을 시간축으로.
- 그림 없는 페이지를 2~3장 만든다. 22/22가 도식이라 균일함의 가장 큰 원인이다. 실무자는 예쁜 SVG보다 진짜 터미널 출력 한 조각을 믿는다.
- TechLog와 Performance Lab의 시각 언어를 나눈다. 지금은 같은 팔레트·같은 카드라 "별도 멘토링 과제"라는 사실이 글로만 있고 눈에 안 보인다.
Scope규칙을 하나로. 지금 Infra 3페이지에만 있다. 표지에 한 번만 쓰고 내지에서 전부 빼거나, 측정 결과가 있는 모든 페이지에 붙이거나 — 둘 중 하나. 지금처럼 들쭉날쭉하면 "면피 문구를 슬롯에 끼웠다"로 보인다.- "안 한 것 / 되돌린 것" 블록을 최소 2페이지에 추가. 새 페이지를 만들지 말고 기존 페이지 하단에 2~3줄로.
- 표지에 본인 한 줄 추가. 지금 표지에는 문제만 있고 사람이 없다.
7. 문체 규칙 (검사 가능한 형태)
앞으로 이 문서를 고칠 때 지킨다. 전부 grep이나 스크립트로 셀 수 있다.
| # | 규칙 | 현재 |
|---|---|---|
| 1 | 한 페이지 안에서 ~습니다 종결 3개 연속 금지 |
Backend 95%, Infra 87% |
| 2 | 한 페이지에 15자 이하 문장 최소 1개 | Backend 0개, Infra 1개 |
| 3 | h2 11개 중 과거형 ~았/었/했습니다 종결 최대 6개. 같은 동사가 h2에 두 번 나오면 하나 교체 |
10/11이 ~습니다, "비교했습니다" 2회 |
| 4 | meta 질문의 ~는가?/~인가? 어미 문서당 최대 2개 |
10/10 |
| 5 | A는 X이고, B는 Y입니다 정통 대구 문서당 3회 이하 |
5회 |
| 6 | A가 아니라 B / ~하지 않고 ~만 뒤집기 문서당 3회 이하 |
두 문서 합 6회 |
| 7 | "단, 이 조건에서만" 유보로 문단을 닫는 섹션 10개 중 4개 이하. 필요하면 문단 맨 앞이나 각주로 위치를 옮김 | 6개 |
| 8 | 그림 안의 수치는 본문 문장에도 최소 1회 등장 | Backend p.10의 4,446 buffers, p.11의 Keyset − index가 본문 0회 |
| 9 | 섹션마다 도구/명령어/파일명이 그대로 박힌 문장 최소 1개 (EXPLAIN (ANALYZE, BUFFERS), ./gradlew check, modules.json, kubectl rollout restart, openssl s_client) |
추상명사가 대신 자리를 차지 |
| 10 | 섹션 골격 최소 3종, 같은 골격이 문서당 5개를 넘지 않게 | 10/10 동일 |
| 11 | 같은 X 표현 문서당 8회 이하 |
Backend 12회 |
| 12 | 이 작업공간, ~까지만 이야기합니다, 정리했습니다 같은 문서가 자기를 서술하는 표현 금지 |
각 1회 이상 |
규칙 1·2·6·7·10만 적용해도 체감이 크게 달라진다.
8. 본인에게 물어봐야 할 것
이 답들이 없으면 위 대체 문장의 [확인 필요]를 채울 수 없다. 8번 하나가 지금의 22페이지보다 사람 냄새를 더 낼 가능성이 높다.
- Backend p.10의
204 buffers · 0.323 ms와168 buffers · 0.336 ms는 같은 측정인가, 다른 측정인가? (다르면 조건을 명시, 같으면 하나가 틀린 수치다) - Infra p.09 인증서 건, 처음에 어떻게 알아챘나? 브라우저 경고인지, 만료 알림 메일인지, 우연히
openssl s_client를 쳐 본 건지. 그 상태로 며칠/몇 주가 지나 있었나? - 각 실험에서 실제로 친 명령어는? session row를 센 SQL, 응답 확인용 curl 루프, 지연 주입 도구(
tc netem/toxiproxy), 부하 도구(hey/k6/ab)와 RPS·지속 시간. - 각 실험은 몇 번 반복했고, 제시한 숫자는 평균인가 p95인가 단일 측정인가? 특히
1,872 ms,22.2 s,p95 205.7 ms. - 초안이 공개되던 문제는 언제, 어떻게 알았나? 404 사건에서 처음 의심한 곳은 어디였고 그게 틀렸나? 몇 개 글이 영향받았고 원인 찾는 데 얼마나 걸렸나?
- 인증 4패턴 구현 repo는 어디인가? BFF와 Forward-Auth를 TechLog에 안 넣은 이유는? 넣었다 뺀 건가, 처음부터 안 넣었나?
jwt와redis-session을 지금도 둘 다 유지하는 이유는? 공개 배포는 어느 쪽인가? - Feed Query Lab의 N=1,000은 어디서 나온 숫자인가? 실제 TechLog 목록은 한 번에 몇 건을 여나? Batch와 Projection 중 실제 제품에 들어간 건 어느 쪽이고 어느 화면인가?
- 시도했다가 실패했거나 되돌린 작업이 있나? 멘토링 과제에서 멘토에게 들은 지적 중 뼈아팠던 것은?
- Infra p.11: 앞의 실험들(p.05~p.09)을 실제로 이 Grafana/Loki/Tempo로 관측했나? 실제로 울린 alert가 한 번이라도 있나?
- Infra p.03: LAN 우회 경로 차단과 404를 실제로 쳐서 확인했나?
9. 작업 순서
1차 — 신뢰 (질문 없이 지금 가능) §1의 네 건. Backend p.06 축 개수, p.10 두 측정 구분, p.11 세 번째 불릿, Infra p.06 28배. 사실 오류가 남아 있으면 나머지 작업이 무의미하다.
2차 — 중복 제거 (질문 없이 지금 가능) 그림 하단 배너 7개 삭제, meta 질문 20 → 6, 수치 3중·4중·5중 반복 정리, Backend p.08+p.09 병합, Infra p.04+p.05 병합. 여기까지만 해도 AI 티의 절반이 빠진다.
3차 — 골격 변주 (질문 없이 지금 가능) Backend p.03 사건 기록형, Backend p.07 코드 페이지, Infra p.09 타임라인, Infra p.08 시간축 그림, 그림 없는 페이지 2~3장.
4차 — 사람 넣기 (§8 답변 필요) 발견 경위, 틀린 가설, 실제 명령어, "그래서 뭘 바꿨나", 실패·되돌린 것. 이게 본체다. 1~3차는 AI 티를 빼는 작업이고, 4차만이 사람을 넣는 작업이다.
5차 — 문체 (§7 규칙 적용) 마지막에 일괄. 규칙 1·2·6·7·10 우선.
10. 한 줄 총평
수치 정확도와 검증 태도, 용어 일관성은 상위권이다. AI 티의 원인은 내용이 아니라 균질성이다. 종결어미 95%가 한 형태, 섹션 골격 10/10 동일, meta 질문 어미 20/20 동일, 커버 두 장 골격 동일, 본문 두 변형본 간 완전 동일.
정직함(Scope 명시, "측정하지 않았다"는 고백)은 이 문서의 진짜 강점이다. 문제는 그 정직함조차 매 페이지 같은 자리에 같은 모양으로 박혀 있어서 규칙처럼 보인다는 점이다.
문장을 다시 쓰는 것보다 템플릿을 깨는 것이 먼저다.