imprun engineering

작성일: 2025년 12월 6일카테고리: Authentication, Authorization, Architecture, Backend키워드: Ory Kratos, Ory Hydra, Ory Keto, Ory Oathkeeper, Zero Trust, OAuth2, ReBAC요약ImpRun v3 플랫폼은 Ory 스택 전체(Kratos, Hydra, Keto, Oathkeeper)를 통합하여 엔터프라이즈급 인증/인가 시스템을 구축했다. 각 컴포넌트가 명확한 역할을 담당하며, Zero Trust 아키텍처를 기반으로 웹 애플리케이션과 외부 API 클라이언트를 모두 지원한다. 이 글에서는 4개 Ory 컴포넌트의 조합 방식과 실제 구현 사례를 다룬다.Ory 스택 구성컴포넌트별 역할컴포넌트역할포트Ory Kratos..

Ory Oathkeeper를 활용한 Zero Trust IAP 구현 가이드작성일: 2025년 12월 6일카테고리: Authentication, Authorization, API Gateway, Security키워드: Ory Oathkeeper, Zero Trust, IAP, Identity Aware Proxy, Envoy, ext_authz요약Ory Oathkeeper는 Zero Trust Identity & Access Proxy로, 모든 요청에 대해 인증/인가를 수행하는 게이트키퍼 역할을 한다. Envoy Gateway와 연동하여 ext_authz 패턴으로 동작하며, Kratos 세션과 Hydra OAuth2 토큰을 모두 검증할 수 있다. 이 글에서는 ImpRun 프로젝트에서 Oathkeeper를 ..

작성일: 2025년 12월 6일카테고리: Authorization, Identity, Backend키워드: Ory Keto, ReBAC, Google Zanzibar, Authorization, Permission, OPL요약Ory Keto는 Google Zanzibar 논문을 기반으로 구현된 오픈소스 권한 관리 시스템이다. 전통적인 RBAC(Role-Based Access Control)의 한계를 넘어, Relationship-Based Access Control(ReBAC)을 통해 복잡한 권한 모델을 효율적으로 처리한다. 이 글에서는 Keto의 핵심 개념과 실제 프로젝트에서의 적용 방법을 다룬다.Google Zanzibar와 ReBACZanzibar의 배경Google Zanzibar는 Google 내..

Ory Kratos를 활용한 사용자 인증 시스템 구축: ImpRun 프로젝트 적용 사례작성일: 2025년 12월 6일카테고리: Authentication, Identity, Backend, Frontend키워드: Ory Kratos, Authentication, Identity Management, OAuth, OIDC, Session요약Ory Kratos는 클라우드 네이티브 환경을 위한 오픈소스 ID 관리 시스템이다. 자체적인 로그인/회원가입 UI를 제공하지 않고, API 기반으로 동작하여 프론트엔드에서 완전한 UI 커스터마이징이 가능하다. 이 글에서는 ImpRun 프로젝트에서 Kratos를 Next.js 프론트엔드와 Go 백엔드에 통합한 실제 구현 사례를 다룬다.Ory Kratos 개요Kratos란K..

작성일: 2025년 12월 6일카테고리: Authentication, OAuth2, Ory Stack키워드: Ory Hydra, OAuth2, OIDC, Kratos, Keto, Oathkeeper, API Gateway요약API Gateway 플랫폼에서 Ory Hydra를 OAuth2/OIDC 서버로 활용한 실제 구현 사례를 공유합니다. Hydra는 Ory 스택(Kratos, Keto, Oathkeeper)과 함께 사용되어, 사용자 인증은 Kratos가, 권한 관리는 Keto가, API 보호는 Oathkeeper가 담당하는 구조입니다. 이 글에서는 Docker 기반 배포, OAuth2 플로우 구현, 다른 Ory 서비스와의 통합 방법을 다룹니다.배경Ory 스택 소개Ory는 클라우드 네이티브 인증/인가 오..

작성일: 2025년 12월 6일카테고리: AI, Development Tools, Review키워드: Gemini 3.0 Pro, Antigravity, Claude Code, AI Coding Assistant, 비교요약Claude Code로 백엔드 개발을 해오던 개발자가 Google의 Antigravity IDE와 Gemini 3.0 Pro 조합을 실사용한 경험을 공유합니다. "Antigravity가 좋다"는 평가가 많아 기대했으나, 실제 사용에서는 무지성 반복 실행, 문제 회피성 해결, 컨텍스트 파악 실패 등 답답한 경험이 반복되었습니다. Gemini가 실수할 때마다 반성문을 작성하게 했는데, 그 기록을 바탕으로 이 글을 정리했습니다.Antigravity + Gemini 3.0 Pro를 사용하면서 ..

작성일: 2025년 12월 6일카테고리: Go, Development Tools, Productivity키워드: Go, Golang, Air, Live Reload, Hot Reload, 개발 환경요약Go 언어는 컴파일 언어 특성상 코드 변경 시 수동으로 빌드하고 재시작해야 하는 불편함이 있습니다. Next.js의 next dev, Vite의 HMR, NestJS의 --watch, FastAPI의 --reload 옵션처럼 프레임워크에서 자동 리로드 기능을 기본 제공하지 않아 개발 속도가 저하됩니다. Air는 이 문제를 해결하는 Go용 Live Reload 도구로, 파일 변경을 감지하여 자동으로 빌드하고 애플리케이션을 재시작합니다.문제 상황증상Go로 웹 서버나 API를 개발할 때, 코드를 수정할 때마다 다..

작성일: 2025년 11월 27일카테고리: AI, Backend, Architecture키워드: Claude Opus 4.5, Gemini 3.0, GPT-5.1, Go, Gin, gRPC, Clean Architecture요약프론트엔드 설계문서 비교에 이어, 동일한 프롬프트로 백엔드 설계문서 작성 능력을 비교했습니다. Go/Gin/GORM 기반의 Control Plane과 gRPC Agent 통신을 포함하는 복잡한 백엔드 아키텍처 설계를 테스트한 결과, Claude Opus 4.5가 프론트엔드와 마찬가지로 문서 구조, 코드 예시, 실무 적용 가능성에서 압도적 우위를 보였습니다.테스트 환경입력 자료architecture.md: Imp-Gateway v2 아키텍처 설계서 (논리/배포/물리 계층 분리, 엔티..

작성일: 2025년 11월 26일카테고리: AI, Frontend, Architecture키워드: Claude Opus 4.5, Gemini 3.0, GPT-5.1, Feature-Sliced Design, Next.js, AI 코딩요약Gemini 3.0, GPT-5.1 Codex Max, Claude Opus 4.5가 연이어 출시된 직후, 동일한 프롬프트로 프론트엔드 설계문서 작성 능력을 비교했습니다. 동료가 공유한 LinkedIn 글에서 "디자인 영역에서 Gemini 3.0이 압승"이라는 평가를 보고 Gemini Ultra를 결제하여 직접 테스트해봤습니다. 실무 개발자 관점에서 복잡한 B2B SaaS 프론트엔드 설계문서 작성 테스트를 진행한 결과, Claude Opus 4.5가 문서 구조, 기술적 깊..

작성일: 2025년 11월 25일카테고리: Developer Tools, AI, Productivity키워드: Claude Code, AI Coding, Workflow, Context Management, EPIC, Story, Daily Workflow요약imprun 팀에서 프로젝트 전체 기간 동안 매일 사용하는 Claude Code 실무 개발 워크플로우를 공유합니다. 새 기능 설계부터 구현, 일일 진행상황 추적, 주간보고까지 모든 과정을 자동화합니다. AI 질문으로 EPIC 문서 생성(/create-epic), EPIC을 Story로 분해(/start-epic), 매일 출근 시 Serena MCP로 코드 분석(/daily-start), 작업 중 /clear + /catchup으로 컨텍스트 복구, 퇴..

작성일: 2025년 11월 24일카테고리: Frontend Architecture키워드: Feature-Sliced Design, FSD, React, 프론트엔드 아키텍처, 모듈화, 레이어드 아키텍처요약Feature-Sliced Design(FSD)은 프론트엔드 프로젝트의 구조를 표준화하는 아키텍처 방법론입니다. 기술 중심이 아닌 비즈니스 기능 중심으로 코드를 조직하며, 7개의 레이어와 엄격한 의존성 규칙을 통해 확장 가능하고 유지보수하기 쉬운 코드베이스를 구축합니다. 현재 20,000개 이상의 오픈소스 프로젝트에서 채택되고 있습니다.FSD가 해결하는 문제전통적인 프론트엔드 구조의 한계대부분의 React 프로젝트는 다음과 같은 기술 중심 구조로 시작합니다:src/├── components/│ ├── ..

작성일: 2025년 11월 24일카테고리: AI, DevTools, Configuration키워드: Claude Code, Gemini CLI, OpenAI Codex, AGENTS.md, CLAUDE.md, AI Agent요약Claude Code, Gemini CLI, OpenAI Codex CLI 세 가지 AI 에이전트에서 AGENTS.md를 인식하도록 설정하는 방법을 정리합니다. 각 에이전트의 기본 파일명과 설정 방법이 다르지만, 적절한 설정을 통해 단일 AGENTS.md 파일로 모든 에이전트를 통합 관리할 수 있습니다.문제 상황배경모노레포 환경에서 여러 AI 코딩 어시스턴트를 사용할 때 다음 문제가 발생합니다:각 에이전트가 인식하는 기본 파일명이 다름 (CLAUDE.md, GEMINI.md, AG..

AI Agent를 위한 Frontend 개발 가이드: AGENTS.md로 Next.js + shadcn/ui 프로젝트 구조 설계작성일: 2025년 11월 24일카테고리: Frontend, AI, Architecture키워드: Next.js, React, AI Agent, AGENTS.md, CLAUDE.md, shadcn/ui, TanStack Query, Zustand요약AI 코딩 어시스턴트(Claude, Copilot 등)와 협업할 때 프로젝트 구조를 명확히 문서화하면 AI가 일관된 코드를 생성합니다. 이 글에서는 Next.js 16 + shadcn/ui 기반 프로젝트에서 AI Agent가 따라야 할 아키텍처 패턴, 네이밍 컨벤션, 데이터 흐름을 정의하는 방법을 공유합니다. 실제 B2B API Gat..

작성일: 2025년 11월 24일카테고리: AI, UX Design, API Gateway키워드: Claude, GPT Codex, Gemini, AI Review, UX, Menu Structure, API Gateway요약B2B API Gateway 플랫폼의 콘솔 메뉴 구조를 세 가지 AI 모델(Claude Sonnet 4.5, GPT 5.1 Codex Max, Gemini Pro 2.5)에게 리뷰 요청했습니다. 동일한 아키텍처 문서와 메뉴 스크린샷을 제공하고, 각 모델이 어떤 관점에서 피드백을 제시하는지 비교 분석했습니다. 세 모델 모두 긍정적인 평가를 내렸으나, 리뷰 스타일과 강조점에서 흥미로운 차이를 보였습니다.문제 상황배경imprun API Gateway Control Plane은 Provid..

작성일: 2025년 11월 23일카테고리: Kubernetes, Authentication키워드: Keycloak, Theme, ConfigMap, FreeMarker, Kubernetes요약Kubernetes 환경에서 Keycloak 커스텀 로그인 테마를 ConfigMap으로 배포하는 과정에서 여러 문제에 직면했습니다. ConfigMap이 중첩 디렉토리 구조를 보존하지 않는 특성과 네임스페이스 불일치 문제가 주요 원인이었습니다. 이 글에서는 Keycloak 테마의 구조, Kubernetes에서의 배포 방법, 그리고 배포 과정에서 겪은 시행착오와 해결 방법을 공유합니다.문제 상황증상프로덕션 환경에서 Keycloak의 기본 로그인 UI 대신 자체 브랜딩에 맞는 커스텀 테마가 필요했습니다. Kubernete..

Kubernetes Ephemeral Storage 문제 해결 가이드카테고리: Kubernetes, Troubleshooting, Storage, Technical Guide난이도: ⭐⭐⭐⭐⭐대상: Kubernetes 운영자, DevOps 엔지니어💡 이 문서는?기술 참조 문서: 단계별 해결 방법과 명령어실제 경험담: MongoDB가 죽었다: 150GB 디스크가 있는데 왜?예방 가이드: Oracle Cloud 준비 및 설정문제 상황증상MongoDB Pod가 Evicted 상태로 종료됨에러 메시지:The node was low on resource: ephemeral-storage.Threshold quantity: 4741241430, available: 4344280Ki.원인Oracle Cloud 무료..

작성일: 2025년 11월 18일카테고리: Kubernetes, Storage, Troubleshooting키워드: Kubernetes, Ephemeral Storage, Pod Eviction, Oracle Cloud, Block Volume요약Oracle Cloud 환경에서 Kubernetes를 운영하던 중 MongoDB Pod가 Evicted 상태로 종료되는 장애가 발생했습니다. 근본 원인은 150GB 블록 볼륨을 연결했으나 실제로 마운트하지 않아 Kubernetes가 root 파티션만을 ephemeral-storage로 인식한 것이었습니다. 이 글에서는 문제의 원인과 해결 과정, 그리고 재발 방지를 위한 방안을 공유합니다.문제 상황증상운영 중인 Kubernetes 클러스터에서 MongoDB Sta..

작성일: 2025-11-11카테고리: Kubernetes, kubectl, DevOps, 운영 자동화, 생산성난이도: 초급~중급TL;DR문제: kubectl 명령어가 길고 반복적이며, Runtime Pod 관리가 복잡함해결: 기본 별칭 + imprun 특화 함수 + 유용한 스크립트 세트 구성핵심: "타이핑 10초 → 1초로 단축, gatewayId만으로 Runtime Pod 즉시 조회"결과: 일일 kubectl 명령 약 200회 → 30초 절약/회 = 100분(1.7시간) 생산성 향상 (추정)들어가며imprun.dev는 "API 개발부터 AI 통합까지, 모든 것을 하나로 제공"하는 Kubernetes 기반 API 플랫폼입니다.Kubernetes 클러스터를 운영하다 보면 매일 수십 번 kubectl 명령어..

작성일: 2025-11-08카테고리: Frontend, React, Tailwind CSS, Layout, UI/UX난이도: 초급/중급TL;DR문제: 컴포넌트 배치에서 margin 남용, 불필요한 중첩, 반응형 미흡으로 유지보수 어려움해결: Flexbox flex + gap 패턴과 Grid를 활용한 체계적 레이아웃 시스템핵심: "margin을 버리고 gap을 택하라" - 간격은 부모가 관리결과: 코드 약 40% 감소, 다크모드 자동 지원, 반응형 대응 용이들어가며imprun.dev는 "API 개발부터 AI 통합까지, 모든 것을 하나로 제공"하는 Kubernetes 기반 API 플랫폼입니다.프론트엔드 개발에서 컴포넌트 배치는 단순해 보이지만 가장 어려운 과제 중 하나입니다. 초보 개발자는 물론 경험 많은 ..

작성일: 2025-11-08카테고리: CSS, UX, Cross-browser, Web Performance난이도: 초급~중급TL;DR문제: 스크롤바가 나타날 때 콘텐츠가 약 15-17px 밀리며 사용자 경험 저하해결: scrollbar-gutter: stable + Firefox fallback으로 크로스 브라우저 대응핵심: "스크롤바를 항상 표시하지 않고도 공간을 예약할 수 있다"결과: Chrome/Edge/Safari에서 레이아웃 shift 없이 깔끔한 UX 달성들어가며imprun.dev는 "API 개발부터 AI 통합까지, 모든 것을 하나로 제공"하는 Kubernetes 기반 API 플랫폼입니다.Frontend를 개발하면서 스크롤바가 나타날 때마다 페이지가 밀리는 불편한 UX 문제를 발견했습니다. ..

작성일: 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..

작성일: 2025-11-02카테고리: Design Pattern, Kubernetes, Reliability난이도: 중급TL;DR문제: API Gateway 생성 중 Kubernetes 리소스 생성 실패 시 무한 대기 또는 좀비 리소스 발생해결: 5분 타임아웃 + Graceful Degradation 패턴으로 자동 정리핵심: State Machine 패턴과 결합하여 실패 시 안전하게 Stopped 상태로 전환결과: 좀비 리소스 0건, 사용자 수동 개입 불필요, 시스템 안정성 향상들어가며imprun.dev는 "API 개발부터 AI 통합까지, 모든 것을 하나로 제공"하는 Kubernetes 기반 API 플랫폼입니다.사용자가 API Gateway를 생성하면, 백엔드는 Kubernetes에 Deployment,..

작성일: 2025-11-02카테고리: Platform Architecture, API Gateway, Kubernetes난이도: 고급TL;DR문제: REST API 개발과 배포가 복잡하고, AI 에이전트와의 통합이 어려웠습니다.해결: CloudFunction 기반 API 개발 + Kubernetes 자동 배포 + MCP Tool 통합을 하나의 플랫폼으로 제공했습니다.핵심:Hot Reload: MongoDB Change Stream으로 1초 이내 배포State Machine: Phase 기반 리소스 생명주기 관리Multi-tenant DB: Gateway별 독립 MongoDB 데이터베이스Environment 분리: dev/staging/prod 환경 자동 생성AI 통합: CloudFunction을 MCP ..