지식 지도 — Knowledge Index

단일 모델이 복잡해질수록 읽기와 쓰기가 서로 발목을 잡는다. CQRS가 그 문제를 어떻게 해결하는지, 단순한 분리부터 이벤트 소싱까지 TypeScript 예제로 완벽 정리.

서비스를 운영하면서 유저가 어디서 이탈하는지, 어떤 기능을 쓰는지 전혀 몰랐다. PostHog를 붙이고 데이터 기반으로 결정하기 시작한 경험.

"기술 부채"라는 말을 들은 비개발자 관리자는 왜 항상 고개를 갸우뚱할까? 기술 부채를 비즈니스 언어로 번역하고, 리팩토링을 투자로 포지셔닝하고, 이해관계자를 설득하는 실전 프레임워크를 정리했어.

결제 플로우의 상태를 if문과 boolean 플래그로 관리하다 버그 지옥에 빠졌다. XState의 상태 머신으로 불가능한 상태를 원천 차단한 경험.

REST API와 수동 타입 관리의 한계를 Zod 스키마 검증과 tRPC로 해결하는 방법을 정리했어. 라우터 설정부터 클라이언트 타입 추론, Zod 에러 처리, REST 마이그레이션까지 실전 예제로 커버해.

회원가입 확인 이메일을 보내야 하는데 HTML 이메일이 지옥이었다. React Email로 컴포넌트처럼 이메일을 만들고 Resend로 보내는 방법을 정리했다.

3개월 전에 만든 내 API를 보고 이게 뭔지 몰랐다. 일관된 REST API를 설계하기 위한 네이밍, 버전 관리, 페이지네이션 패턴을 정리했다.

요청-응답 방식의 동기 통신이 마이크로서비스에서 어떤 문제를 일으키는지, 그리고 이벤트 기반 아키텍처가 그걸 어떻게 해결하는지 파헤쳐봐. Kafka, RabbitMQ, SQS 비교부터 이벤트 소싱, 최종 일관성 개념까지 Node.js 예제와 함께 정리했어.

헥사고날 아키텍처는 비즈니스 로직을 외부 세계로부터 철저히 격리시키는 설계 패턴이야. 포트(Port)와 어댑터(Adapter) 개념을 통해 의존성 방향을 뒤집고, 어떤 DB나 프레임워크가 들어와도 흔들리지 않는 코어를 만드는 방법을 TypeScript 예제로 풀어봤어.

REST API를 만들 때마다 프론트엔드와 백엔드의 타입이 어긋났다. tRPC를 도입하고 API 명세서 없이 타입이 자동으로 맞춰지는 경험을 했다.

Uncle Bob의 Clean Architecture를 프론트엔드에 그대로 적용하면 과도한 복잡도가 생긴다. 실전에서 통하는 수준으로 다듬은 프론트엔드 레이어 분리 전략을 정리했다.

내 서비스를 키보드만으로 써보려다 탭이 엉뚱한 곳으로 날아갔다. 웹 접근성을 실제로 개선하면서 배운 것들을 정리했다.

코드 커버리지 100%인데 버그가 새나간다면? 테스트가 있다고 다 좋은 테스트가 아니다. 뮤테이션 테스트가 테스트 스위트의 진짜 품질을 드러내는 방법을 알아봤다.

한국어로만 서비스하던 블로그에 영어를 추가하면서 next-intl을 도입했다. App Router 환경에서 다국어를 구현하며 겪은 시행착오와 패턴.

TDD와 BDD는 둘 다 '테스트 먼저'라는 철학을 공유하지만, 초점과 사용 방식이 다르다. Red-Green-Refactor 사이클부터 Gherkin 문법까지, 실전 TypeScript 예제로 비교해봤다.

서비스를 만들었는데 아무도 오지 않았다. 마케팅 예산 없이 검색 유입을 만드는 기술적 SEO를 Next.js에서 직접 구현한 경험.

처음 코드 리뷰를 받았을 때 느끼는 그 두려움, 누구나 겪는 거다. PR 올리는 법부터 건설적인 피드백 주는 법까지, 리뷰 문화를 제대로 만들어가는 실전 가이드.

서비스가 죽었는데 12시간 동안 몰랐다. 1인 개발자가 최소한의 비용으로 서비스 상태를 감시하는 모니터링 스택을 구성한 경험.

유저가 카카오톡으로 '안 돼요'라고 보내기 전에 에러를 먼저 감지하고 싶었다. Next.js 프로젝트에 Sentry를 연동하면서 배운 실전 설정과 알림 구성.

테스트에서 fetch를 직접 모킹하거나, axios를 vi.mock()으로 교체하다가 실제 API와 차이가 생겨 고생한 적 있다. MSW는 네트워크 레벨에서 요청을 인터셉트해서 그런 문제를 근본적으로 해결한다. 설정부터 Vitest, Storybook 통합까지 정리했다.