Simple notes for better software
실제 프로젝트에서 발견한 문제와 오래 가는 해결 방식을 기록합니다.
Field notes / 2026
구조화된 AI 출력이 JSON으로 도착해도 업무에 바로 저장할 수 있는 것은 아닙니다. 스키마, 의미, 업무 규칙을 단계별로 검증하는 최소 파이프라인과 실패 복구 예시를 정리합니다.
글 읽기
본문 서명 대신 URL 토큰을 쓰는 웹훅은 인증 정보가 웹서버 access log와 프록시 기록에 남을 수 있습니다. 현재 구현의 경계를 정확히 읽고 마스킹, 회전, 최소 로그 원칙을 운영 절차로 정리합니다.
글 읽기
웹훅은 도착 순서가 업무 발생 순서와 같다고 보장하지 않습니다. 이벤트 의미와 엔터티 식별자를 기준으로 상태를 해석하고, 늦게 도착한 낡은 이벤트가 최신 상태를 덮지 않게 하는 점검법을 안내합니다.
글 읽기
모든 웹훅을 업무 티켓으로 만들면 오분류와 중복 처리가 늘어납니다. 이벤트 유형, 작성자, 고객 식별, 활성 계약을 순서대로 판정하는 결정표와 보류 기준을 실무 예시로 설명합니다.
글 읽기
웹훅은 재전송과 동시 도착을 전제로 받아야 합니다. 채널톡 연동 코드를 관찰해 원본 이벤트 저장과 업무 요청 생성을 분리하고, 각 단계의 고유 키로 중복을 멈추는 방법을 정리합니다.
글 읽기
LCP·INP·CLS 점수가 낮다는 사실만으로는 수정 순서를 정할 수 없습니다. 필드 데이터와 실험실 데이터를 분리하고, 네트워크·렌더링·레이아웃 원인을 증거로 좁히는 트리아지 절차를 소개합니다.
글 읽기
배포가 끝났는데도 사용자마다 이전 화면이 보인다면 캐시를 무조건 지우기보다 응답 헤더와 캐시 계층을 나눠 확인해야 합니다. 웹 배포 후 Cache-Control, ETag, 무효화 범위를 검증하는 순서를 정리합니다.
글 읽기