Ports & Adapters (Hexagonal Architecture), 쉽게 이해하기
Hexagonal Architecture를 친근하고 예제 중심으로 설명하는 가이드: port와 adapter가 실제로 무엇인지, 이 아키텍처를 작동시키는 단 하나의 규칙, 그리고 1인 창업자든 엔터프라이즈 팀이든 딱 얼마나 적용해야 하는지.
글
블로그
소프트웨어 아키텍처와 소스 코드 구조에 대한 깊이 있는 글입니다. 입문자도 이해할 수 있으면서, 대규모로 개발하는 팀에도 유용하도록 썼습니다. 다이어그램과 실제 사례를 곁들였고, 두루뭉술한 설명은 없습니다.
주제별로 보기
최신 글
Clean, Onion & Hexagonal Architecture: 하나의 북극성, 세 가지 이름
세 가지 경쟁 아키텍처처럼 보이지만, 사실은 같은 아이디어를 세 가지 방식으로 그린 것입니다 — 의존성은 안쪽을 향하고, 프레임워크는 가장자리에. 각각이 실제로 무엇을 더하는지, 그리고 어떤 상황에 어느 것을 선택해야 하는지 알아봅니다.
Dependency Injection & Inversion of Control, 마법 없이 이해하기
DI 컨테이너는 밑에 있는 단순한 아이디어를 보기 전까지 마법처럼 느껴집니다: 코드가 자신의 의존성을 직접 생성하지 않도록 하고, 대신 외부에서 전달받는 것입니다. 실제 예제와 테스트에서 얻을 수 있는 이점을 포함한 처음부터 끝까지의 가이드.
코드베이스 구조화: 레이어별, 기능별, 또는 도메인별?
최상위 폴더가 controllers/services/models여야 할까요, 아니면 orders/billing/auth여야 할까요? 이 선택은 조용히 코드베이스의 성장 방식을 결정합니다. 레이어별, 기능별, 소리치는 아키텍처의 실용적인 여행 — 각 회사 규모별 트레이드오프와 함께.
모놀리스, Modular Monolith, 마이크로서비스: 솔직한 의사결정 가이드
마이크로서비스는 출발점이 아니라 조직 규모에 대해 지불하는 세금입니다. 모놀리스에서 Modular Monolith, 마이크로서비스까지의 과장 없는 여정 — 언제(그리고 분리할지 여부를) 알려주는 신호와 함께.
마이크로 프론트엔드: 언제 가치가 있고, 무엇이 드는가
프론트엔드를 독립적으로 배포 가능한 조각들로 분리하면 팀을 해방시킬 수도 — 또는 복잡성에 묻힐 수도 있습니다. Angular 호스트 + React 모듈 설정을 규모에서 출시한 경험을 바탕으로: 마이크로 프론트엔드가 보상을 줄 때, 그리고 그것이 가져오는 청구서.
코드 리뷰의 기술: 사람을 무너뜨리지 않고 코드를 비평하는 방법
코드 리뷰는 팀 문화가 만들어지거나 무너지는 곳입니다. 코드가 더 잘 배포되고 작성자도 더 강해져서 돌아오도록 리뷰하는 실용적인 가이드 — 구체적인 표현, 리뷰어 체크리스트, 그리고 리뷰를 조용히 독성으로 만드는 습관들.
Kind Engineering: 친절함이 더 나은 엔지니어를 만드는 이유
친절함은 상냥함이 아니고, 약함도 아닙니다. 친절함은 힘을 배가시키는 것입니다 — 더 명확한 피드백, 더 안전한 장애 대응, 더 빠르게 성장하는 팀원들. '엔지니어링에서의 친절함'이 실제로 무엇을 의미하는지, 그리고 코드 리뷰, 장애 대응, 일상 업무에서 어떻게 실천하는지.
사람들이 실제로 즐겁게 리뷰하는 Pull Request 작성하는 방법
훌륭한 pull request는 리뷰어에게 주는 선물입니다: 작고, 잘 설명되어 있으며, 쉽게 승인할 수 있습니다. 리뷰 가능한 PR의 해부학 — 크기, 제목, 설명, 커밋 위생, 그리고 셀프 리뷰 — 구체적인 before/after 예제와 함께.
잘 전달되는 피드백: 엔지니어로서 비평을 주고받는 방법
대부분의 엔지니어들은 피드백을 주는 방법을 배운 적이 없습니다 — 받는 방법도 마찬가지입니다. 구체적이고, 친절하며, 실행 가능한 피드백에 대한 실전 가이드, 그리고 받는 입장에서 열린 자세를 유지하는 방법 — 바로 쓸 수 있는 스크립트와 함께.
엔지니어 멘토링: 주니어를 시니어로 성장시키는 방법
훌륭한 팀은 채용만으로는 만들어지지 않습니다. 엔지니어링 팀을 이끌어 본 경험에서: 사람들이 빠르게 레벨업하도록 멘토링하는 방법 — 페어링, 가르침으로서의 코드 리뷰, 적절한 크기의 스트레치 과제, 그리고 주니어를 무엇이든 믿고 맡길 수 있는 사람으로 만드는 마인드셋의 전환.