Refactor: 매장 픽업 가능 판정 정책 단일화 (today-pickup / pickup-schedule / 주문 생성 공용)

[chanwoo7]

배경

매장별 픽업 가능 판정 규칙(특별휴무 · 요일 영업시간 · 일일 capacity 소진(레코드 없으면 무제한, 취소·soft-delete 제외 수량 합) · 리드타임 컷오프)이 두 서비스에 각각 구현되어 있다:

• store-today-pickup.service.ts (오늘 픽업 가능 매장 리스트)
• store-pickup-schedule.service.ts (상품 상세 월 달력·시간 슬롯, PR feat(store): 매장별 픽업 달력·시간 슬롯 조회(storePickupCalendar/storePickupTimeSlots) #193)

슬롯 생성 헬퍼(buildTodaySlots)만 공유하고 판정 분기 자체는 중복이다.
향후 주문 생성 mutation이 픽업 일시 재검증으로 세 번째 소비자가 될 예정이라, 그 전에 단일화하지 않으면 규칙 불일치(한쪽만 고침) 버그 가능성이 커진다.

목표

• store feature 내부에 픽업 가능 판정 정책 클래스(또는 순수 함수 모듈)를 추출한다.
  예: StorePickupPolicy — 입력(매장 정책 row·영업시간·휴무·capacity·점유·기준 시각) → 판정 결과(가능/사유).
• today-pickup과 pickup-schedule이 동일 정책을 소비하도록 재배선하고, 동작 차이는 회귀 테스트로 0임을 증명한다.
• 주문 생성 구현 시 이 정책을 그대로 재사용한다 (단일 소스).

수행 조건

• 두 서비스의 판정 분기 diff 정리 (의도적 차이 유무 확인 — 예: today-pickup의 "capacity 소진 시 매장 제외" vs 달력의 CAPACITY_FULL 표기)
• 정책 추출 후 기존 spec 전체 green (today-pickup·pickup-schedule 두 스위트 무변경 통과가 기준)
• 주문 생성 설계 문서에서 본 정책 재사용을 전제로 명시

참고

• 아키텍처 진단(2026-08-24)에서 개선 후보 2순위로 식별
• 관련 PR: feat(store): 매장별 픽업 달력·시간 슬롯 조회(storePickupCalendar/storePickupTimeSlots) #193(storePickupCalendar/storePickupTimeSlots), fix: 릴리즈 리뷰 반영 (특별휴무일 픽업 슬롯 빈 배열 반환) #195(특별휴무 슬롯 빈 배열)
• 주문 생성 API는 미구현 상태 — 커스텀 단계 figma 작업과 함께 설계 예정

[chanwoo7]

PR #220으로 반영 완료.

• 수행 조건 ① 판정 분기 diff: 규칙 집합은 두 서비스 동일. 차이는 PAST/OUT_OF_RANGE 유무('오늘'은 항상 통과)·capacity 소진 표현(제외 vs CAPACITY_FULL)·nowMinutes 계산 방식(당일 기준 수학적 동일)뿐으로, 전부 표현 차원 — 의도적 동작 차이 없음 확인.
• 수행 조건 ② 정책 추출 후 기존 spec 무변경 통과: today-pickup.service·pickup-schedule.service·today-pickup.helper 3종 무변경 green + 신규 정책 spec 11케이스. 전체 validate 191 suites 통과.
• 수행 조건 ③ 주문 생성의 정책 재사용: 이슈 작성 이후 createOrder(PR feat(order): 주문 생성 mutation(createOrder) — 정식 API의 확정 부분집합 #208)가 StorePickupScheduleService.isPickupSlotAvailable 경유로 이미 구현되어 충족 — 이번 단일화로 해당 경로도 evaluatePickupDay를 소비한다.