Simple notes for better software
개발을 맡기기 전의 판단부터 운영 중의 문제 해결까지, 실무에서 확인할 기준을 정리합니다.
Field notes / 2026
AI API 비용은 단가표만 읽어서 통제되지 않습니다. 요청 예산, 입력 크기, 재시도, 모델 선택, 조직별 사용량을 함께 기록하는 호출 가드레일을 실제 운영 흐름으로 설명합니다.
글 읽기
MCP 서버를 연결할 때 로그인 여부만 확인하면 도구 호출 범위가 과도해질 수 있습니다. 전송 계층 인증, 토큰 대상, 도구별 권한과 승인 기록을 나누는 설계 기준을 정리합니다.
글 읽기
PDF나 이미지에서 AI가 추출한 값은 빈칸과 오인식이 섞일 수 있습니다. 원본 위치를 보존하고 필드별 신뢰 경계를 검증해 사람이 확인할 대상을 줄이는 운영 절차를 설명합니다.
글 읽기
구조화된 AI 출력이 JSON으로 도착해도 업무에 바로 저장할 수 있는 것은 아닙니다. 스키마, 의미, 업무 규칙을 단계별로 검증하는 최소 파이프라인과 실패 복구 예시를 정리합니다.
글 읽기
본문 서명 대신 URL 토큰을 쓰는 웹훅은 인증 정보가 웹서버 access log와 프록시 기록에 남을 수 있습니다. 현재 구현의 경계를 정확히 읽고 마스킹, 회전, 최소 로그 원칙을 운영 절차로 정리합니다.
글 읽기
웹훅은 도착 순서가 업무 발생 순서와 같다고 보장하지 않습니다. 이벤트 의미와 엔터티 식별자를 기준으로 상태를 해석하고, 늦게 도착한 낡은 이벤트가 최신 상태를 덮지 않게 하는 점검법을 안내합니다.
글 읽기
모든 웹훅을 업무 티켓으로 만들면 오분류와 중복 처리가 늘어납니다. 이벤트 유형, 작성자, 고객 식별, 활성 계약을 순서대로 판정하는 결정표와 보류 기준을 실무 예시로 설명합니다.
글 읽기