📚 전체 글

BigInt PK에서 Int PK로 — 첫 번째 스키마 리팩토링

전체 테이블 CUID String PK에서 Mixed ID Strategy(User=CUID, Master=Int, Transaction=BigInt)로 전환한 과정. BigInt JSON 직렬화 버그를 만나고, Junction Table을 다시 Int로 다운그레이드한 첫 번째 스키마 리팩토링 기록.

2026년 4월 15일

PrismaPostgreSQL스키마설계

📚 Claude Code 팀 에이전트 실전기

Claude 팀 에이전트 완전 가이드 — 개념부터 실전 셋업까지

Claude Code Agent Teams의 아키텍처를 이해하고, team-setup 스킬로 tmux 멀티 에이전트 환경을 자동 구성하는 방법. 실제 캡처와 함께 단계별로 안내합니다.

2026년 4월 14일

Claude CodeAI개발일지

27개 테이블의 탄생 — Prisma 스키마 설계기

B2B SaaS 백엔드의 Prisma 스키마를 설계한 과정. 인증 → 조직 → 러닝 코어 → 트래킹 순서로 27개 테이블과 15개 enum을 만들면서 겪은 설계 결정과 실수들을 기록합니다.

2026년 4월 13일

PrismaPostgreSQL스키마설계

📚 Claude Code 팀 에이전트 실전기

Claude 팀 에이전트 첫 실전 — ERP 권한 체계를 하루 만에 뜯어고치다

수동 오케스트레이션에서 Claude Agent Teams로 전환한 첫 실전. 듀얼 레포 ERP 시스템의 권한 체계를 프론트/백엔드 팀메이트와 병렬로 리팩토링한 8시간의 기록.

2026년 4월 12일

Claude CodeAI개발일지

도메인 모델링 첫날 — B2B SaaS의 핵심 엔티티 정의하기

B2B SaaS 백엔드를 만들면서 도메인 모델링을 시작한 이야기. 마스터 문서 2,486줄을 쓰고, 유즈케이스를 정의하고, 핵심 엔티티 관계를 잡아가는 과정을 기록합니다.

2026년 4월 11일

도메인모델링DDDNestJS

📚 Claude Code 팀 에이전트 실전기

AI 4명을 부렸는데 결국 나만 바빴다 — 수동 오케스트레이션의 한계

Claude Code 세션 4개를 PM/BE/FE/QA로 나눠 3개월간 운영한 경험. session-sync.md로 에이전트 간 통신을 구현했지만, 사람이 중계하는 구조의 한계를 깨달은 이야기.

2026년 4월 10일

Claude CodeAI개발일지

📚 블로그 SEO 실험실

Google E-E-A-T를 개인 블로그에 실제로 적용하는 방법 — 공식 문서 기반 실전 가이드

Google E-E-A-T(경험, 전문성, 권위, 신뢰)를 개인 기술 블로그에 실제로 적용한 과정을 정리합니다. 품질 평가 가이드라인을 읽고, 환경 명시 박스·레퍼런스 박스·구조화 데이터·시리즈 구조를 도입하기까지 — 공식 문서에서 근거를 찾고 하나씩 적용한 기록입니다.

2026년 4월 7일

SEOE-E-A-TGoogle

📚 AI 파이프라인 일지

Anthropic이 서드파티 하네스를 구독에서 잘랐다 — 자동화 파이프라인 운영자의 대응기

Anthropic이 서드파티 하네스를 구독에서 분리했다. 에러 원인, $200 크레딧 수령, CLI 브릿지 대응까지 정리.

2026년 4월 5일

AnthropicClaude서드파티 하네스

ClaudeClaude CodeAnthropic API

Claude Max 플랜으로 API 호출하면 429가 뜨는 이유 — 인증 체계 5단계 완전 정리

Claude Max 플랜의 OAuth 토큰(sk-ant-oat)으로 Messages API를 직접 호출하면 429 Rate Limit이 뜹니다. Claude Code의 인증 우선순위 5단계, sk-ant-oat vs sk-ant-api 차이, 그리고 스크립트에서 Max 플랜을 활용하는 우회법을 실제 트러블슈팅 사례와 함께 정리합니다.

2026년 4월 5일

패키지 설치 후 Invalid hook call? Vite 캐시 무효화가 답이다

Vite 프로젝트에서 새 패키지를 설치한 뒤 Invalid hook call 에러가 발생하는 원인은 의존성 사전 번들링 캐시(.vite/deps)다. React 중복 인스턴스 문제의 근본 원인부터 node_modules/.vite 삭제, vite --force, optimizeDeps 설정까지 실전 해결법과 예방 전략을 정리한다.

2026년 4월 4일

ViteReact캐시

NestJSPrismaprisma generate

prisma generate 누락 — 빌드는 되는데 런타임 에러가 나는 이유

NestJS + Prisma 프로젝트에서 schema.prisma에 새 필드를 추가한 뒤 prisma generate를 빠뜨리면, TypeScript 빌드는 as any 캐스팅 덕에 통과하지만 런타임에서 Prisma Client가 새 필드를 모른다. pnpm build와 prisma generate가 별개 명령인 구조적 함정, prebuild 훅으로 자동화하는 해결법, Docker와 CI에서 놓치지 않는 예방 전략을 실전 코드와 함께 정리한다.

2026년 4월 3일

Refine useCustom config.query가 정수를 보장하지 않는 함정 — 타입은 number인데 왜 400이야?

Refine의 useCustom hook에서 config.query 객체에 number 타입 값을 전달해도, URL 쿼리 파라미터로 직렬화되면서 문자열이 된다. NestJS @Type(() => Number) 검증과 조합하면 targetClassId must be an integer number 400 에러가 터진다. URL 직접 삽입 패턴으로 해결한 실전 사례를 정리한다.

2026년 4월 2일

ReactRefineuseCustom

Soft Delete 필터가 빠진 곳 찾기 — 삭제한 데이터가 되살아나는 미스터리

NestJS + Prisma 프로젝트에서 Soft Delete 필터를 Application Service에만 적용하고 Domain Repository를 누락하면, 삭제된 데이터가 배치 프로세스와 조회 API에서 좀비처럼 되살아난다. PM 코드 리뷰에서 11곳 추가 발견된 실전 사례를 통해, 레이어별 필터 점검 체크리스트와 grep 기반 검증법을 정리한다.

2026년 4월 1일

NestJSPrismaSoft Delete

react-hook-form + Zod 연동에서 겪는 실전 함정 6가지 — 에러가 안 뜨는 이유부터 타입 불일치까지

react-hook-form과 Zod를 연동할 때 자주 발생하는 6가지 트러블슈팅 사례를 정리합니다. zodResolver 미연결, defaultValues 타입 불일치, mode 설정 누락 등 실전에서 놓치기 쉬운 함정과 해결법을 코드와 함께 설명합니다.

2026년 3월 31일

Reactreact-hook-formZod

NestJS 재귀 호출 무한루프 — API 504 타임아웃의 숨겨진 원인 찾기

NestJS 서비스에서 메서드 간 재귀 호출이 발생하면 스택 오버플로우와 504 Gateway Timeout이 터진다. 통계 API에서 추세 계산이 무한루프에 빠진 실전 사례를 통해, 재귀 호출 탐지법과 skipFlag 패턴으로 방어하는 방법을 정리한다.

2026년 3월 30일

NestJS재귀 호출스택 오버플로우

Framer MotionReactwhileInView

Framer Motion whileInView 애니메이션이 스크린샷에서 사라지는 이유와 해결법

Framer Motion whileInView로 만든 스크롤 애니메이션이 Chrome DevTools MCP 스크린샷이나 OG 이미지 생성에서 보이지 않는 원인은 IntersectionObserver의 뷰포트 의존성이다. initial hidden 상태가 캡처되는 근본 원인과 3가지 해결 전략을 실전 코드로 정리한다.

2026년 3월 29일

Docker 빌드에서 pnpm 모노레포 삽질 — 데코레이터 에러 3132개의 정체

Docker에서 pnpm 모노레포 NestJS 프로젝트를 빌드하면 TypeScript 데코레이터 에러가 3132개 터진다. TypeScript 버전 충돌부터 tsconfig 누락, pnpm deploy --legacy, Prisma Client 수동 복사까지 — 4가지 함정과 해결법을 실전 코드로 정리한다.

2026년 3월 28일

Dockerpnpm모노레포

1인 개발 CI/CD 파이프라인 삽질기 — 수동 배포에서 완전 자동화까지

1인 개발 모노레포에서 CI/CD 파이프라인을 구축하며 겪은 실전 트러블슈팅. Docker 빌드 경로 오류, 배포 자동화 실패, Cloud Scheduler 설정 함정까지 — 수동 배포의 고통에서 벗어나는 과정을 정리했다.

2026년 3월 27일

CICDDockerCloud Run

NestJSDependency InjectionDI

NestJS DI 에러 디버깅 — Nest can't resolve dependencies 3가지 원인과 서버 기동 테스트

NestJS에서 Nest can't resolve dependencies 에러를 만나면 당황스럽습니다. 모듈 imports 누락, @Injectable() 빠짐, 순환 참조까지 — DI 에러의 3대 원인을 실전 코드로 분석하고, 서버 기동 테스트로 사전에 잡는 방법을 정리합니다.

2026년 3월 26일

shadcn init 실행했더니 프라이머리 컬러가 검정으로 — CSS 변수 덮어쓰기 트러블슈팅

shadcn init 실행 후 커스텀 CSS 변수가 기본값으로 덮어씌워지는 문제의 원인과 해결법을 정리합니다. 디자인 토큰이 초기화되는 근본 원인을 분석하고, git diff 기반 복구 및 예방 패턴을 코드와 함께 설명합니다.

2026년 3월 25일

shadcnCSS 변수Tailwind CSS

Seed 데이터 FK 삭제 순서 삽질 — Prisma deleteMany가 터지는 이유

Prisma seed 스크립트에서 deleteMany 순서를 잘못 잡으면 FK 제약 조건 위반 에러가 발생합니다. 테이블 의존 관계를 분석하고 자식→부모 순으로 삭제하는 실전 패턴을 정리합니다. 바로 적용할 수 있는 방법을 알려드릴게요.

2026년 3월 24일

PrismaSeedFK

스펙 변경에 강한 API 설계 — 1인 개발 실전 패턴 5가지

스펙이 바뀔 때마다 API를 뒤엎지 않으려면? NestJS + Prisma 모노레포에서 겪은 5가지 스펙 변경 사고와 그로부터 얻은 API 설계 원칙을 정리했다.

2026년 3월 23일

API설계NestJS스펙변경

Prisma enum vs 도메인 타입 캐스팅 함정 — TypeScript 타입 불일치 해결기

Prisma가 생성한 enum과 도메인 타입이 TypeScript에서 호환되지 않아 빌드 에러가 발생합니다. 명시적 캐스팅 패턴과 아키텍처별 예방 전략을 정리합니다.

2026년 3월 22일

PrismaTypeScriptenum

WordPress → Astro 마이그레이션 — 블로그 전환 실전 삽질기

WordPress에서 Astro 5로 블로그를 마이그레이션하면서 겪은 콘텐츠 변환, SEO 보존, 빌드 에러, 댓글 시스템 전환까지. Cloudflare Pages 배포와 MDX 컴포넌트 설계 과정을 기록한다.

2026년 3월 21일

AstroWordPress마이그레이션

BE 응답 래퍼 언래핑 패턴 — API 200인데 왜 에러?

API가 200 OK를 반환하는데 프론트엔드에서 에러 페이지가 뜬다면, BE 응답 래퍼 구조를 의심하세요. useCustom + ApiWrapper 패턴으로 2중 언래핑하는 실전 해결법을 정리합니다.

2026년 3월 20일

ReactNestJSAPI

GitHub ActionsCloudflare PagesCICD

GitHub Actions + Cloudflare Pages 자동 배포 — Astro 블로그 CI/CD

Astro 블로그를 GitHub Actions와 Cloudflare Pages로 자동 배포하면서 만난 삽질들. Wrangler v3 설정부터 pnpm 캐시, Secrets 관리, 배포 실패 디버깅까지 실전 트러블슈팅.

2026년 3월 19일

React useEffect 비동기 cleanup이 GPU를 죽이는 과정 — Pixi.js RenderTexture 실종 사건

React useEffect의 비동기 cleanup이 Pixi.js RenderTexture를 파괴하는 레이스 컨디션 버그를 추적합니다. 웹 브라우저에서는 정상인데 Vuplex WebView + 고사양 GPU에서만 재현되는 3중 함정의 원인과 해결법을 정리합니다.

2026년 3월 19일

ReactPixi.jsWebGL

NestJS FK 제약 위반 디버깅 — Level ID 검증으로 500 에러 잡기

NestJS + Prisma에서 콘텐츠 등록 시 Foreign key constraint violated 500 에러가 터졌습니다. 존재하지 않는 Level ID가 원인이었고, 저장 전 검증 패턴으로 해결한 과정을 정리합니다.

2026년 3월 18일

NestJSPrismaFK

pnpm workspace 의존성 삽질기 — 모노레포 5가지 함정

pnpm workspace + Turborepo 모노레포에서 의존성 관리 중 겪은 실전 트러블슈팅. TypeScript 버전 충돌, Docker 빌드 실패, Prisma Client 미생성, DI 에러까지 — 증상별 원인과 해결법을 정리했다.

2026년 3월 17일

pnpm모노레포의존성관리

NestJS DTO 클래스 필수인 이유 — interface로 만들면 터지는 두 가지

NestJS에서 DTO를 interface로 만들면 400 에러와 Swagger 스키마 누락이 동시에 발생합니다. class-validator와 @ApiProperty가 작동하는 원리부터 해결까지 정리했습니다.

2026년 3월 16일

NestJSDTOSwagger

Umami 셀프호스팅 — Docker 설치부터 AdBlock 우회까지

Oracle ARM 서버에 Umami를 Docker로 올리고, 4개 블로그에 트래커를 심으면서 만난 삽질들. TRACKER_SCRIPT_NAME이 안 먹는 문제부터 AdBlock 우회, WP mu-plugin 자동 매핑까지 실전 트러블슈팅.

2026년 3월 15일

Umami웹 애널리틱스Docker

React Admin DataProvider 커스터마이징 삽질기

Refine 기반 React 어드민에서 DataProvider 커스터마이징 시 흔히 겪는 두 가지 함정을 정리합니다. BE가 객체를 반환하는데 useList를 쓴 경우, 그리고 total 파싱 경로가 어긋난 경우의 증상·원인·해결법입니다.

2026년 3월 14일

ReactRefineDataProvider

CouchDB + Obsidian LiveSync로 메모 동기화 구축하기

Oracle ARM 서버에 CouchDB를 Docker로 올리고, Obsidian Self-hosted LiveSync 플러그인으로 실시간 메모 동기화를 구축하면서 만난 삽질들. CORS, max_document_size, 시스템 DB 누락까지 실전 트러블슈팅.

2026년 3월 13일

CouchDBObsidianLiveSync

왜 NestJS + Prisma를 선택했나 — B2B SaaS 백엔드 기술 선택기

Express vs NestJS, TypeORM vs Prisma. B2B SaaS 백엔드를 만들면서 기술 스택을 고르기까지의 과정과 첫 커밋 이야기.

2026년 3월 12일

NestJSPrisma기술선택

Prisma 마이그레이션 실수 방지 — 컬럼 누락 해결기

NestJS + Prisma 마이그레이션에서 테이블 하나를 빠뜨려 운영 DB에 컬럼 없음 에러가 터졌습니다. schema.prisma 변경 시 모든 모델을 확인하는 체크리스트와 migrate diff 예방법을 정리했어요.

2026년 3월 12일

NestJSPrisma마이그레이션

NestJS + React 모노레포 구성법 — pnpm workspace 실전기

1인 개발로 NestJS 백엔드 + React 프론트엔드를 모노레포로 구성한 이유와 pnpm workspace + Turborepo 세팅 과정을 정리했다. 삽질 포인트와 구조 결정 기록. 초보자도 따라할 수 있게 정리했어요.

2026년 3월 11일

모노레포NestJSReact

Cloudflare Full Strict SSL + Nginx 리버스 프록시 삽질 총정리

Cloudflare Origin Certificate 발급부터 Nginx SSL 종단, PHP-FPM HTTPS 인식 문제까지. 멀티사이트 SSL 구성에서 만난 실전 트러블슈팅 기록. 실전 경험을 바탕으로 정리했어요.

2026년 3월 10일

CloudflareSSLNginx

Vite 6.x 프록시에서 PATCH만 CORS 에러? 소문자 메서드 함정과 해결법

Vite 6.x 개발 서버 프록시 환경에서 PATCH 요청만 CORS 에러가 발생하는 원인은 HTTP 메서드 대소문자입니다. toUpperCase() 한 줄로 해결하는 방법과 프록시 디버깅 체크리스트를 정리합니다.

2026년 3월 9일

ViteCORSReact

NestJS CORS 삽질 총정리 — PATCH만 안 되는 이유

PATCH 요청만 CORS에 막힌다면 allowedHeaders와 Vite 프록시를 의심하세요. 프리플라이트부터 해결까지 실전 트러블슈팅 기록. 지금 바로 확인해 보세요.

2026년 3월 8일

NestJSCORSVite

NestJS + Prisma에서 N+1 쿼리 문제 해결하기

NestJS + Prisma에서 API가 갑자기 느려졌다면 N+1 쿼리를 의심하세요. 650개 쿼리를 2개로 줄인 실전 해결기와 예방법을 정리했어요.

2026년 3월 8일

NestJSPrisma성능최적화