imprun engineering

작성일: 2025-11-05카테고리: NestJS, React, TypeScript, JWT, Axios, Zustand, API, 에러처리난이도: 중급TL;DR문제: NestJS + React 프로젝트를 시작할 때마다 표준 응답, HTTP 클라이언트, 인증 스토어를 처음부터 구현해결: 재활용 가능한 3가지 핵심 코드 패턴 정립 (ResponseUtil, httpClient, authStore)핵심: "일관된 에러 처리와 타입 안정성이 개발 속도를 3배 높인다"결과: 약 2시간 소요되던 초기 설정이 10분으로 단축 (실제 경험)들어가며imprun.dev는 "API 개발부터 AI 통합까지, 모든 것을 하나로 제공"하는 Kubernetes 기반 API 플랫폼입니다.imprun.dev 플랫폼을 개발하면서 매번..

작성일: 2025-11-03카테고리: Implementation, Troubleshooting, Architecture난이도: 중급TL;DR문제: "Environment-Agnostic = MongoDB에 baseName만 저장"이라는 착각으로 404 에러 폭탄해결: 환경별 독립 CloudFunction 존재 (dev/hello, staging/hello, prod/hello), extractBaseName() 패턴 전면 적용핵심: "Frontend는 환경 몰라도 됨" ≠ "MongoDB도 환경 몰라도 됨"결과: Function 생성 실패, History 404, Promote 실패 → 모두 해결 (4시간 디버깅)들어가며imprun.dev는 "API 개발부터 AI 통합까지, 모든 것을 하나로 제공"하는 ..

작성일: 2025-11-03카테고리: Architecture, API Design, Frontend난이도: 중급TL;DR문제: dev/staging/prod 환경 prefix가 Frontend에 노출되어 코드 복잡도 증가 및 네트워크 낭비 (3배)해결: Environment-Agnostic Pattern - Frontend는 환경을 몰라야 한다핵심: 환경 정보는 인프라 레이어(Domain/Subdomain)에서 처리, API 응답은 baseName만 반환결과: 네트워크 비용 66% 감소, Frontend 코드 간결화, 배포 유연성 향상들어가며imprun.dev는 "API 개발부터 AI 통합까지, 모든 것을 하나로 제공"하는 Kubernetes 기반 API Gateway 플랫폼입니다. CloudFuncti..

작성일: 2025-11-03카테고리: Claude AI, 개발 가이드, 최적화, Anthropic Best Practices난이도: 중급TL;DR문제: 997줄 CLAUDE.md를 작성했는데도 AI가 패턴을 60%만 준수해결: 파일 참조 전략 + MCP 강제 활성화 + 우선순위 재구조화핵심: "AI에게 코드를 주지 말고, 파일 경로를 알려주라"결과: 997줄 → 593줄 (43% 감축), 패턴 준수율 95%들어가며imprun.dev는 "API 개발부터 AI 통합까지, 모든 것을 하나로 제공"하는 Kubernetes 기반 API 플랫폼입니다. 이전 글에서 997줄짜리 CLAUDE.md를 공개했습니다. Container/Presentational 패턴과 Layered Architecture로 일관성 있는 코..

작성일: 2025-11-02카테고리: MongoDB, Database, Performance, Aggregation난이도: 중급TL;DR문제: 기존 코드가 3번 쿼리 + 메모리 조인으로 페이지네이션마다 반복 조회해결: Aggregation Pipeline의 $facet + $lookup으로 1번 쿼리에 모든 것 처리핵심: $facet + $lookup의 주요 장점은 네트워크 왕복 횟수 감소 (count + data + join을 1번에)결과: 약 58% 성능 개선 예상 (이론적 계산), 쿼리 횟수 66% 감소 (3번 → 1번)주의: $lookup은 서버 측 조인, $in + Map은 애플리케이션 조인 - 환경에 따라 선택들어가며imprun.dev는 "API 개발부터 AI 통합까지, 모든 것을 하나로 제공..

작성일: 2025-11-02카테고리: MongoDB, Database, Performance, Backend, NestJS난이도: 중급TL;DR문제: MongoDB 인덱스를 애플리케이션 시작 시 자동 생성? 수동 생성? 어느 것이 맞을까?해결: 환경에 따라 다른 전략 사용 - Development는 자동, Production은 수동 + 환경 변수 제어핵심: 대규모 컬렉션에서 인덱스 빌드는 시간과 리소스 소요가 크므로 Production에서는 신중하게 계획결과: 개발 속도 ↑, Production 안정성 ↑, 유연한 인덱스 관리구현: NestJS onModuleInit + AUTO_CREATE_INDEXES 환경 변수로 Hybrid 접근들어가며imprun.dev는 "API 개발부터 AI 통합까지, 모든 것..

작성일: 2025-11-02카테고리: MongoDB, NestJS, Connection Pool, Debugging난이도: 중급TL;DR문제: 로컬 개발 환경에서 MongoDB 연결 시 50% 확률로 30초 타임아웃 발생원인: 로컬 개발을 위한 Connection Pool 분리 설계가 Hot-Reload 환경에서 673,098개의 연결 생성 초래핵심: minPoolSize=1이어도 여러 MongoClient 인스턴스가 동시에 초기화되면 연결 경합(Connection Race) 발생해결: Module-level Singleton 패턴 + Connection Pool 통합으로 타임아웃 0%로 감소들어가며imprun.dev는 "API 개발부터 AI 통합까지, 모든 것을 하나로 제공"하는 Kubernetes 기..

작성일: 2025-11-02카테고리: Design Pattern, Microservices, Distributed Systems난이도: 중급TL;DRSaga Pattern: 분산 시스템에서 여러 독립 서비스 간 트랜잭션을 보상 트랜잭션으로 관리두 가지 방식: Choreography (이벤트 기반) vs Orchestration (중앙 조정)imprun의 선택: State Machine + Timeout으로 충분 (단일 서비스 내 작업)교훈: 패턴보다 문제 이해가 먼저, 복잡한 게 항상 좋은 건 아님들어가며imprun.dev는 "API 개발부터 AI 통합까지, 모든 것을 하나로 제공"하는 Kubernetes 기반 API 플랫폼입니다.API Gateway를 생성할 때 여러 단계의 리소스 생성이 필요합니다:g..