TECH NOTES
기술노트
현장에서 검증된 개발 지식을 기록합니다.
151815171516151515141513151215111510150915081507
AI
GraphRAG — 지식 그래프로 다중 홉 질문 푸는 RAG
문서에서 엔티티와 관계를 뽑아 지식 그래프로 만드는 GraphRAG. 일반 RAG가 막히는 다중 홉·전역 질문을 로컬/글로벌 검색으로 푸는 원리와 비용 트레이드오프.
Infra
쿠버네티스 프로브 튜닝 — liveness·readiness·startup 제대로 나누기
liveness에 DB를 물렸다가 무한 재시작 사고를 냈다. 세 프로브의 역할 차이부터 타이밍 파라미터, graceful shutdown 연동까지 실전 튜닝을 정리했다.
Backend
패스키 로그인 — WebAuthn으로 비밀번호 없이 인증하기
패스키가 왜 피싱에 강한지, WebAuthn 등록·인증 흐름을 코드로 짚고 계정 복구·userVerification 등 실전에서 데인 지점까지 정리했습니다.
AI
LLM 샘플링 파라미터 — top-k, min-p, 반복 페널티까지
temperature와 top-p 너머의 샘플링 손잡이. top-k와 min-p로 꼬리를 자르고 frequency·presence 페널티로 반복을 다스리는, 작업별 실전 레시피를 정리했다.
Frontend
CloseWatcher API — Esc·뒤로 가기로 커스텀 UI 닫기
안드로이드 뒤로 가기로 메뉴가 아니라 페이지가 통째로 닫히던 문제를 CloseWatcher API가 해결합니다. Esc와 뒤로 가기를 하나의 close 이벤트로 다루고 중첩 UI와 취소·폴백까지 처리하는 법을 살펴봅니다.
AI
스페큘러티브 디코딩 — 드래프트 모델과 수용률의 경제학
작은 드래프트 모델이 미리 짓고 큰 모델이 검증하는 스페큘러티브 디코딩. 품질은 왜 안 깎이는지, 이득을 좌우하는 수용률과 제안 길이 k의 저울질을 설명한다.
Frontend
useActionState — React 19 폼 상태와 서버 액션을 한 훅으로
React 19의 useActionState 훅으로 폼 액션 실행·결과 상태·pending을 한 번에 관리하는 법. useFormState와의 차이, 서버 액션 연동, 흔한 함정까지 실전 정리.
Etc
epoch 시계 vs 단조 시계(monotonic) — 시간 측정엔 뭘 써야 하나
epoch 시계는 몇 시냐를, 단조 시계는 얼마나 흘렀냐를 잽니다. 벽시계가 거꾸로 가 타임아웃이 음수가 되는 버그, 두 시계의 용도 구분과 실전 함정을 정리했습니다.
Infra
DNS TTL과 캐싱 — 'DNS 전파'의 진짜 정체
DNS 전파가 느리다는 통념의 실체는 TTL 캐시 만료입니다. 계층별 캐시 구조, 마이그레이션 전 TTL 조정, 네거티브 캐싱까지 실무 관점으로 풀었습니다.
Backend
Graceful Shutdown — 배포할 때마다 뜨는 502를 없애는 법
배포 때마다 502가 튀는 진짜 이유는 프로세스를 그냥 죽여서입니다. readiness 전환부터 드레이닝 대기까지 올바른 종료 순서를 코드와 쿠버네티스 설정으로 정리했습니다.
AI
컨텍스트 엔지니어링 — 프롬프트가 아니라 컨텍스트를 설계하는 법
프롬프트 문장이 아니라 컨텍스트 윈도우에 무엇을·얼마나·어떤 순서로 넣을지 설계하는 컨텍스트 엔지니어링. 토큰 예산 함수, 롤링 요약, 캐시 정렬까지 실전 정리.
Frontend
ResizeObserver — 요소 크기 변화를 감지하는 실전 패턴
window.resize로는 못 잡는 개별 요소의 크기 변화를 ResizeObserver로 감지합니다. borderBoxSize 사용법, 악명 높은 loop 에러 회피, 컨테이너 기준 반응형 실전 패턴까지 정리했습니다.