코드를 쓰면서 얻은 것들
클라우드 엔지니어에서 풀스택을 거쳐 프론트엔드로 옮겨온 개발자입니다.
케이스 스터디
케이스 스터디 →- 2026.08단독 개발 (0 → 1 재구축)
아코디언에 접힌 본문은 AI 크롤러에게 존재하지 않는다
사이트 텍스트의 절반이 아코디언·캐러셀 안에 있어 JS를 실행하지 않는 크롤러가 본문을 못 읽던 문제를, CSS로만 숨기는 규약과 초기 HTML 검사 게이트로 해결한 과정.
Next.js 16React 19TypeScriptnext-intlPlaywrightaxe-core
- 2026.01 – 2026.08페이지·기능·API 연동 레이어 주 담당
새 요금제를 추가하면 유료 기능이 전부 열리는 구조였다
이름 블랙리스트로 만들어진 유료 기능 게이팅을 등급 체계로 교체해, 플랜이 추가될 때 자동으로 페이월이 뚫리던 구조와 UI·API 이중 표기 문제를 함께 제거했다.
Next.js 16React 19TypeScriptTanStack Query v5ZodTossPayments SDK v2
- 2026.07단독 개발 · 개인 프로젝트
유닛 테스트 1,090개가 전부 통과하는데 컴포넌트의 4분의 1은 렌더되지 않았다
React 프로젝트를 읽기 전용으로 스캔해 컴포넌트를 분류·렌더·추출하는 도구를 만들면서, 유닛 테스트가 볼 수 없는 결함을 잡기 위해 렌더 센서스라는 자체 품질 게이트를 만든 과정.
TypeScriptts-morphesbuildpnpm workspaceTurborepopostcss
- 2025.11 – 2026.07프론트엔드 단독 구축 후 리드
이상 데이터 한 건이 회원 목록 전체를 빈 화면으로 만들었다
엄격한 enum 매퍼가 배열 변환 안에서 throw 하는 바람에 한 행의 문제가 페이지 전체를 죽이던 문제를, 매퍼를 느슨하게 만들지 않고 경계에서 격리하는 방식으로 해결한 과정.
React 19TypeScriptVite 7TanStack Router/Query/TableZodTailwind CSS v4
글
글 →2026
- 트러블슈팅
PostgreSQL에서 OFFSET이 음수면 'must not be negative'로 쿼리가 실패한다
페이지 번호를 0이나 음수로 받으면 (page-1)*size 계산이 음수 OFFSET을 만들어 PostgreSQL이 쿼리를 거부하고 목록 API가 500을 반환한다. 원인과, 페이지 번호를 서버에서 유효 범위로 보정하는 해결을 정리한다.
- 인사이트
노출 기간이 있는 데이터는 클라이언트에서 다시 판정하지 마라
서버가 '지금 노출할' 항목만 내려줬는데 클라이언트가 start/end 시각으로 다시 필터링하면, 시계가 틀어진 브라우저에서만 항목이 사라지는 재현 불가 버그가 생긴다. 시간 기반 노출 판정을 서버 단일 시계로 통일하는 이유와 경계 조건을 정리한다.
- 트러블슈팅
Next.js 16에서 hydration mismatch가 나는 진짜 이유
서버와 클라이언트의 렌더 결과가 갈리는 대표 원인 4가지와, 각각을 어떻게 특정하고 고치는지 실제 스택트레이스로 정리한다.
- 인사이트
pnpm에서 ERR_MODULE_NOT_FOUND가 뜰 때: strict 격리와 peer dependency
npm에서는 되던 코드가 pnpm에서만 모듈을 못 찾는 이유를 node_modules 구조 차이로 설명하고, 올바른 해결책과 피해야 할 우회책을 구분한다.