인사이트

‘어떻게’보다 ‘왜’에 집중하며, 아키텍처 설계 과정의 트레이드오프를 조율한 기술 회고입니다.

2026.09.096 min

프로젝트 사례형

Config 이후의 경계: 멀티플랫폼 React를 core·rsConfig·platform으로 나눈 이유

설정으로 값의 차이를 흡수한 뒤에도 남는 공통 동작과 화면·로직 차이를 core·rsConfig·platform 중 어디에 둘지 정한 기준을 설명합니다.

FrontendArchitectureReactConfig-driven

2026.09.095 min

프로젝트 사례형

Props Drilling을 줄이기 위해 예약 Context의 생명주기를 라우터에 둔 이유

예약 단계 사이에서 쓰는 상태를 중간 컴포넌트가 계속 전달하던 문제를, 예약 라우터 범위의 ReservationProvider와 useReservation으로 줄인 판단을 설명합니다.

FrontendReactContext APIState Management

2026.09.046 min

프로젝트 사례형

정산 상태는 DB에, 재처리 입력은 JSON에 둔 이유

하이패스 정산에서 지급 여부는 DB 상태로 판단하고, 복잡한 쿼리로 계산한 지급 입력과 실패 항목만 JSON에 남겼습니다. 단일 서버·단일 스케줄러 범위에서 성공 제거와 실패 보존, 재시도를 어떻게 운영했는지 설명합니다.

BackendArchitectureSettlementNode.jsOperations

2026.09.047 min

프로젝트 사례형

공용 Room에서 화원별 User Room으로: 전달 범위와 전달 보장은 다르다

하이패스 신규 구축에서 Socket.io의 공용 Room이 관계없는 사용자에게도 주문 이벤트를 보낼 수 있음을 발견해 화원별 User Room으로 바꿨습니다. 수신 대상을 제한한 결과와 메시지 도달을 보장하지 못한 범위를 분리해 설명합니다.

BackendArchitectureSocket.ioReal-timeOperations

2026.07.077 min

프로젝트 사례형

GitHub Actions 전환보다 중요했던 배포 단위 재설계

Jenkins에서 GitHub Actions로 도구를 옮기는 데서 멈추지 않고, 공통 코드와 호텔별 변경 범위를 계산해 다섯 배포 대상을 matrix job으로 분리했습니다. 단일 slave의 순차 대기열을 대상별 병렬 실행으로 바꾸며 배포 화면 기준 약 15분에서 약 3분으로 줄인 과정입니다.

DevOpsCI/CDGitHub ActionsJenkinsCost OptimizationRefactoring

2026.06.089 min

프로젝트 사례형

DX 하네스 v2: 복사형 도구에서 사내 개발 운영 플랫폼까지

Jenkins 제거에서 시작한 하네스가 파일 복사의 한계를 넘어 소유권 경계, CLI 진단, AI 정책 집행과 멀티 세션 실험을 갖춘 사내 개발 운영 플랫폼으로 발전한 과정입니다.

DevOpsDXGitHub ActionsInfisicalAI AgentCI/CD

2026.04.238 min

기술 탐구형

Vercel Developer Seat 비용 조건과 Custom CI 배포 검증

2026-08 Vercel Pro의 Developer Seat·Viewer·usage credit 공개 조건과 GitHub Actions + Vercel CLI 직접 실험을 분리해, Custom CI가 맞는 범위와 사용량 비용을 더 검증해야 하는 조건을 정리했습니다.

DevOpsVercelGitHub ActionsCost OptimizationServerless

2026.04.237 min

프로젝트 사례형

환경변수 중앙화는 저장보다 경계 설계다: Infisical Self-Hosted 도입기

여러 호텔 프로젝트의 환경변수가 Jenkins UI·로컬 .env·Slack에 흩어져 있던 구조에서 다른 호텔의 값이 운영 배포에 섞이는 장애가 발생했습니다. Infisical을 프로젝트·환경·실행 목적별 단일 원천으로 구성하고, 배포와 복구의 장애 경계를 나눈 경험입니다.

DevOpsInfisicalSecuritySSOTHigh-Availability

2026.04.2310 min

프로젝트 사례형

Cloudflare Tunnel만으로는 배포 경계가 완성되지 않는다

GitHub Actions에서 사내 서버로 배포하기 위해 Cloudflare Tunnel을 도입했지만, WAF 차단과 같은 hostname의 connector 혼선을 겪었습니다. 실패 단계를 직접 분리해 확인한 뒤, 공용 진입점과 서버별 권한을 나눈 Bastion 구조로 발전시킨 기록입니다.

DevOpsSecurityCloudflare TunnelZero TrustGitHub ActionsTroubleshooting

2026.03.0310 min

AI 에이전트로 포트폴리오 구축하기: 아키텍트의 역할과 검증 기준

최근 개발 생태계의 뜨거운 감자인 AI 에이전트 기반 개발. 실무에서 복잡한 트랜잭션을 다루던 백엔드 개발자인 저는, 상대적으로 도메인 로직이 가벼운 개인 포트폴리오 웹사이트 구축을 기회 삼아 AI 에이전트 중심의 개발 워크플로우 를 실험해 보았습니다. 이 실험을 통해 깨달은 AI 시대 개발자의 역할과, 아키텍처 설계의 중요성에 대한 회고입니다.

AI-Driven DevelopmentClean ArchitectureAntigravityTDDVibe Coding

2026.03.015 min

프로젝트 사례형

NestJS 인증은 Middleware와 Guard 중 하나를 고르는 문제가 아니었다

Express에 익숙했던 당시에는 인증과 쿠키 갱신을 Middleware에, 관리자 등급 확인을 Guard에 나눴습니다. 구현 당시의 선택을 합리화하지 않고, 지금 다시 설계한다면 Global Auth Guard와 별도 권한 Guard로 책임을 나누겠다는 판단까지 정리했습니다.

BackendNestJSAuthenticationArchitectureRetrospective

2026.03.016 min

프로젝트 사례형

[Next.js x NestJS] 프론트엔드와 백엔드의 도메인 분리와 BFF 설계

A-domain.com의 브라우저가 api.A-domain.com을 직접 호출할 때 인증 쿠키의 저장·전달 실패를 확인했습니다. Next.js reverse proxy로 요청 Origin을 맞춘 뒤 새로 드러난 Cloudflare 서버 요청 경계까지, 실제 구현과 스테이징 검증 범위로 정리했습니다.

ArchitectureNext.jsNestJSAuthenticationBFF

2026.03.015 min

프로젝트 사례형

구글과 네이버는 왜 비밀번호를 평문으로 보낼까? (개발자 도구의 착시와 HTTPS의 진실)

개발자 도구의 Request Payload를 네트워크 평문으로 오해해 비밀번호 전송용 클라이언트 암호화를 구현했다가 제거했습니다. 애플리케이션 Payload, TLS 전송과 서버 bcrypt 저장의 서로 다른 경계를 실제 경험 범위로 정리했습니다.

SecurityHTTPSAuthenticationFrontendBackend

2026.02.275 min

프로젝트 사례형

로그는 남기는 것보다 조회할 수 있어야 한다: 외부 API 로그 분리기

외부 PMS 연동 로그가 업무 DB에 수백만 건 쌓이면서, 정작 예약 장애를 조사해야 할 때 로그 테이블에 접근할 수 없었습니다. 로그 저장 경로를 syslog로 분리해 당사 기록으로 요청과 응답을 추적할 수 있게 만든 경험입니다.

BackendLoggingPHPOperations

2026.02.279 min

프로젝트 사례형

LIKE에서 FULLTEXT·토큰 검증까지: RDBMS 검색을 단계적으로 개선한 과정

약 77만 자의 교재를 기존 MySQL 환경에서 검색해야 했습니다. 2023년 LIKE 기반 검색의 응답을 약 1500ms에서 약 400ms로 줄인 뒤, 유지보수 과정에서 FULLTEXT의 한국어 토큰화 한계를 확인하고 토큰별 LIKE 검증을 결합한 구조로 발전시킨 기록입니다.

BackendPerformanceMySQLNode.js

2026.02.266 min

프로젝트 사례형

React API Key 노출을 서버 경계로 옮기며 배운 BFF의 필요성

개발계 테스트 중 React 빌드 산출물에 API Key가 포함될 수 있음을 확인하고 모든 요청을 PHP Proxy 뒤로 옮겼습니다. 당시의 단순 Proxy 구현과 지금 생각하는 BFF의 적용 기준을 구분해 정리합니다.

ArchitectureSecurityReactBFF

2026.02.265 min

프로젝트 사례형

UUID Soft FK만으로는 부족했다: 분리된 회원 데이터의 조회 경계

중앙 회원 서버의 UUID를 서비스 데이터와 연결했지만, 관리자 화면과 장애 추적에서는 사람이 식별할 수 있는 별도의 읽기 경계가 필요하다는 점을 운영 과정에서 확인했습니다.

BackendAuthenticationArchitectureData Modeling

데이터를 불러오는 중입니다...