imprun engineering

작성일: 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 통합까지, 모든 것을 하나로 제공..