Engineering Culture
아키텍처 결정에 당시의 맥락 남기기, 작은 재현 예제로 좁혀 가기
결론만 남은 설계 문서는 시간이 지나면 왜 그런 선택을 했는지 설명하지 못한다. 제약이 달라졌을 때 바꿀 부분과 지킬 부분을 구분할 수 있어야 한다. 변수를 줄이는 순서를 중심으로 작은 예제와 확인 기준을 정리합니다.
THE BUILDER’S NOTE
Engineering.
01 / INSIDE THE BUILD만들며 배우고, 배운 것을 나눕니다.
더 나은 제품을 향한 개발의 기록.
최근 이야기
작은 발견부터 깊이 있는 고민까지.
Backend
ETag로 같은 응답 다시 확인하기, 먼저 지킬 계약을 적어 보기
변경되지 않은 자원을 매번 전체로 내려받으면 불필요한 전송이 생긴다. 동작보다 먼저 정할 기준를 중심으로 작은 예제와 확인 기준을 정리합니다.
DevOps
Git bisect로 회귀가 들어온 범위 좁히기, 먼저 지킬 계약을 적어 보기
과거에는 되던 동작이 언제 깨졌는지 모를 때 모든 커밋을 순서대로 읽는 것은 비효율적이다. 명확한 재현 명령이 있으면 변경 범위를 이분 탐색할 수 있다. 동작보다 먼저 정할 기준를 중심으로 작은 예제와 확인 기준을 정리합니다.
Backend
웹훅 서명을 검증하는 위치, 먼저 지킬 계약을 적어 보기
외부에서 들어오는 웹훅은 보낸 쪽을 주장하는 헤더만으로 신뢰할 수 없다. 동작보다 먼저 정할 기준를 중심으로 작은 예제와 확인 기준을 정리합니다.
DevOps
자원 한도와 애플리케이션 동시성 맞추기, 먼저 지킬 계약을 적어 보기
동시 요청을 무조건 많이 받으면 메모리와 데이터베이스 연결이 먼저 고갈될 수 있다. 자원 한도와 내부 큐, 워커 수를 함께 조절해야 한다. 동작보다 먼저 정할 기준를 중심으로 작은 예제와 확인 기준을 정리합니다.
AI & Data
라벨의 정의와 일치도, 먼저 지킬 계약을 적어 보기
같은 사례에 서로 다른 기준으로 라벨을 붙이면 모델의 한계와 데이터의 모호함을 구분하기 어렵다. 동작보다 먼저 정할 기준를 중심으로 작은 예제와 확인 기준을 정리합니다.