Repository navigation
feat: 노쇼 처리와 주문 자동 전이 크론, 관리자 픽업 완료 - #583
Conversation
- 무엇·왜
- 판매자 전용 전이 표를 주체 4 × from × to 표 하나로 바꿨다. 확정 주문도 바로 픽업 완료할 수 있고,
노쇼(NO_SHOW)는 확정·제작 완료에서 픽업 시각 ≤ 지금 < 픽업 + 24시간일 때만 연다.
- 노쇼는 환불 없이 픽업 완료와 같은 기준(확인된 결제액)으로 정산을 확정하고 구매자에게 노쇼 알림을 보낸다.
- 판매자·관리자 주문 상세에 확정 마감·자동 픽업 완료 예정·노쇼 시각을 내려 판매자 앱 안내와 노쇼 버튼 활성을 서버가 정한다.
- 변경점
- OrderStatusTransitionPolicy.assertTransition/canTransition({ actor, from, to, now, pickupAt }),
NO_SHOW_NOT_ALLOWED(400) 신설, 판매자 상태 변경은 잠금 뒤 픽업 시각까지 다시 판정
- updateOrderStatusBySeller: NO_SHOW면 no_show_at과 정산 확정
- SDL: SellerOrderSummary.confirmDeadlineAt, SellerOrderDetail.confirmDeadlineAt·autoPickupAt·canMarkNoShow·noShowAt,
AdminOrderDetail.confirmDeadlineAt·autoPickupAt·noShowAt(확정 마감은 접수 상태만, 자동 픽업은 확정·제작 완료만)
- 구매자 알림 ORDER_NO_SHOW '픽업 시간에 방문하지 않아 노쇼로 처리되었어요.'
- 테스트
- 전이 표 196 조합 전수, 취소 허용이 OrderCancelPolicy와 같음, 노쇼 경계 4점(pickupAt−1ms·pickupAt·+24h−1ms·+24h),
자동 픽업 경계 2점
- 판매자 노쇼(정산·이력·이벤트·환불 없음)·구간 밖 거절·확정 → 픽업 완료, 상세 필드 상태별 표, 관리자 상세 필드, 알림 매핑
- 무엇·왜
- worker 크론 4종으로 결제·확정·픽업 마감을 자동 처리한다.
- ① 매분 0초: 입금 기한(주문 + 정확히 1시간)이 지난 입금 대기 중 '입금했어요'를 누르지 않은 주문을 미입금 취소(환불 없음)
- ② 매분 30초: 확정 마감 2시간 전 판매자 푸시 1회. 마감 2시간 미만으로 접수된 주문은 '새 주문' 푸시가 마감을 실었으므로 뺀다
- ③ 매분 15초: 확정 마감이 지난 접수를 미확정 취소(전액 환불)
- ④ 5분: 픽업 + 24시간이 지난 확정·제작 완료를 픽업 완료로 바꾸고 정산 확정
- 숨긴 매장의 주문은 ④에서 빼고 관리자가 건별로 처리한다(정지 판매자 정산이 실제 인도와 무관하게 잡히지 않게). ③은 돈을 돌려주는 쪽이라 그대로 둔다.
- 변경점
- OrderLifecycleScheduler: 후보 id를 100건씩 키셋으로 고르고(틱당 1000건 상한) 건마다 별도 tx에서 잠근 뒤 정책으로 다시 판정.
작업별 running 플래그, 역할 게이트, 건별·틱 실패는 로그 + AlertService(warn, key order-cron:<job>), 커밋 뒤 판매자 구독
- OrderLifecycleRepository(후보 조회·미리 알림 표시 + outbox order.confirm_reminder_due), 순수 정책 order-lifecycle.policy
- OrderTransitionRepository: cancelLocked에 잠금 뒤 대상 재판정(eligible), completePickupBySystem(SYSTEM, 감사 없음) 추가,
잠금·첫 품목 조회 공통화. lockPayment가 기한·클레임 시각도 읽는다
- StoreAdminRepository.findInactiveStoreIds(store 배럴), 판매자 푸시 ORDER_CONFIRM_REMINDER
'{상품명} 주문을 {HH:mm}까지 확정하지 않으면 자동 취소돼요'
- 테스트
- 작업별 대상·비대상(1시간 정각·1ms 전·클레임·마감 없음·숨긴 매장), 미리 알림 1회와 2시간 미만 접수 생략(SQL 후보와 재판정 모두),
결제 도입 전 주문 정산 건너뜀, 같은 주문 동시 tx 1회 전이, 겹친 틱 건너뜀, 키셋 페이지·상한, 건별 실패 경보, api·ws 미실행
- 반증: 숨긴 매장 제외·잠금 뒤 재판정을 끄면 해당 테스트가 실패함을 확인
- 무엇·왜: 품목이 없으면 푸시를 보낼 매장을 몰라 이벤트 없이 발송 표시만 남겨 다음 틱에 다시 고르지 않는다. 이 분기를 테스트로 고정한다. - 변경점: order-lifecycle.scheduler.spec에 1건 추가 - 테스트: 발송 표시 = now, outbox 없음
AdminOrderDetail.autoPickupAt 설명이 '건별로 처리한다'로 관리자가 픽업 완료까지 할 수 있는 것처럼 읽혔다. 관리자 전이는 강제 취소뿐이라, 숨긴 매장 주문은 판매자가 직접 처리하지 않으면 관리자는 강제 취소만 할 수 있다고 적는다. - SDL 설명 한 줄만 바꿨고 타입·동작은 그대로다. - 테스트 변경 없음(docs:check 통과).
사전 검사와 잠금 사이에 픽업 일시가 미래로 바뀌는 경합(다른 기기의 픽업 변경)에서 노쇼를 거절하는지 고정한다. 서비스가 잠금 콜백의 픽업 일시 대신 사전 조회 값을 쓰도록 바뀌어도 기존 테스트는 통과했다. - 사전 조회 직후 pickup_at을 하루 뒤로 옮기고 NO_SHOW를 요청하면 NO_SHOW_NOT_ALLOWED, 상태·노쇼 시각·이력 불변. - 반증: 콜백에 사전 조회한 pickup_at을 넘기면 이 테스트가 실패한다. - order-seller.service.spec 64건 통과.
승인 전 확인 (g) 답은 숨긴 매장 주문에서 자동 픽업 완료를 건너뛰고 관리자가 건별로 픽업 완료·취소하는 것이다.
전이 표의 픽업 완료 주체가 판매자·시스템뿐이라 관리자는 강제 취소만 할 수 있었고, 정지된 판매자의 주문은 실제로
인도됐어도 픽업 완료·정산 확정을 할 수 없었다. 결정 기록에 맞춰 관리자 픽업 완료를 연다.
- 전이 표: 확정·제작 완료 → 픽업 완료에 ADMIN을 더했다. 판매자처럼 시각 조건이 없고, 노쇼 등 다른 전이는 그대로다.
- SDL: adminCompleteOrderPickup(input: AdminCompleteOrderPickupInput { orderId, note }): AdminOrderSummary!
- 오류: 이미 픽업 완료면 ORDER_STATUS_UNCHANGED, 그 밖 상태는 INVALID_ORDER_STATUS_TRANSITION, 없으면 ORDER_NOT_FOUND, 메모 500자 초과 TEXT_TOO_LONG
- AdminOrderDetail.autoPickupAt 설명을 '관리자가 건별로 픽업 완료하거나 취소한다'로, OrderStatusType 설명에 관리자 픽업 완료를 적었다.
- repository: OrderTransitionRepository.completePickupByAdmin
- 주문·결제를 FOR UPDATE로 잠근 뒤 잠금 시점 상태로 판정한다.
- 자동 픽업 완료와 본문을 공유한다(picked_up_at, 확인된 결제액 정산 확정, 이력, outbox order.status_changed).
- 사람 행위만 감사 STATUS_CHANGE를 남기고, 판매자에게 보인 주문이면 매장 id를 붙인다.
- service: AdminOrderService.adminCompleteOrderPickup
- ClockService 시각, 커밋 뒤 판매자 구독 STATUS_CHANGED
- 매장 숨김 여부는 보지 않는다(관리자 강제 취소와 같은 범위).
- roles-coverage admin 접두 루트 필드 67 → 68
테스트
- 전이 표 전수 196조합의 허용 20 → 22(ADMIN 2행), 판매자·관리자 픽업 완료는 픽업 시각 전에도 허용
- order-admin.service.spec 12건
- 확정·제작 완료 성공: 상태·picked_up_at·정산(333bp 버림)·이력 주체 ADMIN·메모·감사·구매자 픽업 완료 알림·판매자 구독
- 숨긴 매장·픽업 시각 전 처리, 결제 도입 전 주문 정산 건너뜀
- 그 밖 5상태 거절(상태·이력·outbox·감사·구독 무변경), 메모 공백·500자·501자, 없거나 삭제된 주문 404, 비관리자 403
- 두 관리자 동시 처리 시 1회 전이, 늦은 쪽 ORDER_STATUS_UNCHANGED
- order-admin.resolver.spec 1건
- 반증: 전이 표에서 ADMIN을 빼면 성공 경로·리졸버·정책 ADMIN 행 10건이, 서비스가 잠금 뒤 판정을 건너뛰면 거절 5건·동시 처리 1건이 실패한다.
- order feature와 게이트(audit-write-path·roles-coverage·role-routes·read-boundary·model-ownership·module-wiring·admin-query-null-inputs·enum-sdl-sync·audit-target-type-sync) 60 스위트 1,613건 통과
rebase 뒤 develop SDL 기준으로 seller·admin 루트 필드 수 갱신.
|
Important Review skippedAuto reviews are disabled on base/target branches other than the default branch. Please check the settings in the CodeRabbit UI or the
|
Codex Review Summary: ✅ CompletedThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
🧹 knip — dead-code 리포트전체 리포트
|
🩺 NestJS Doctor — 90/100 (Excellent)진단 532건 (error 14).
architecture / security 상위 항목
|
Coverage report
Show new covered files 🐣
Show files with reduced coverage 🔻
Test suite run success6503 tests passing in 436 suites. Report generated by 🧪jest coverage report action from 3b7ef38 |
Codecov Report❌ Patch coverage is 📢 Thoughts on this report? Let us know! |
개요
주문 전이 정책을 주체·상태·시각을 함께 보는 표 하나로 바꾸고, 판매자 노쇼 처리와 worker 자동 전이 크론 4종을 넣습니다.
adminCompleteOrderPickup)하거나 취소합니다.feat/order-pickup-reschedule)이 맡습니다.변경 사항
OrderStatusTransitionPolicy)assertTransition·canTransition({ actor, from, to, now, pickupAt }): from → to → 허용 주체 표 하나이고, 표에 없는 조합은 거절합니다(기본 거절).pickupAt ≤ now < pickupAt + 24h일 때만 열립니다(NO_SHOW_NOT_ALLOWED400 신설).pickupAt + 24h부터입니다. 확정 → 픽업 완료(판매자·시스템)를 열고, 확정·제작 완료 → 픽업 완료에 관리자를 더했습니다. 판매자·관리자 픽업 완료에는 시각 조건이 없습니다.OrderCancelPolicy와 같아야 하고, 테스트가 주체 × 상태 전부를 대조합니다.sellerUpdateOrderStatus(CANCELED)는 계속 거절합니다.sellerUpdateOrderStatus(NO_SHOW): 잠금 뒤 상태와 픽업 시각으로 다시 판정하고,no_show_at과 정산 확정(확인된 결제액 기준, 픽업 완료와 같음)을 남깁니다. 환불은 없습니다.ORDER_NO_SHOW: '픽업 시간에 방문하지 않아 노쇼로 처리되었어요.'adminCompleteOrderPickup(input: { orderId, note })→AdminOrderSummary(adminCancelOrder와 같은 출력)ORDER_STATUS_UNCHANGED, 그 밖은INVALID_ORDER_STATUS_TRANSITION(둘 다 400)이고, 없으면 NOT_FOUND, 메모가 500자를 넘으면TEXT_TOO_LONG입니다.OrderTransitionRepository.completePickupByAdmin이 주문·결제를 잠근 뒤 잠금 시점 상태로 판정하고, 자동 픽업 완료와 같은 본문으로picked_up_at·정산 확정(확인된 결제액)·이력(주체 ADMIN, 메모)·outboxorder.status_changed를 남깁니다. 감사ORDER/STATUS_CHANGE도 같은 tx에 남기고, 판매자 감사 로그에 보입니다.STATUS_CHANGED)을 발행하고, 구매자에게는 기존 픽업 완료 알림이 갑니다.OrderLifecycleScheduler, worker)expires_at ≤ now면 미입금 취소(SYSTEM,PAYMENT_NOT_RECEIVED, 환불 없음). 유예 없이 정각에 판정합니다.마감 − 2h ≤ now < 마감∧마감 − 2h > 접수 시각이면 발송 표시와 outboxorder.confirm_reminder_due를 남깁니다. 판매자 푸시ORDER_CONFIRM_REMINDER'{상품명} 주문을 {HH:mm}까지 확정하지 않으면 자동 취소돼요'confirm_deadline_at ≤ now면 미확정 취소(CONFIRM_TIMEOUT, 전액 환불)pickup_at + 24h ≤ now면 픽업 완료(SYSTEM)와 정산 확정. 확인된 결제가 없는 주문(결제 도입 전)은 정산을 건너뜁니다.running플래그로 겹친 틱을 건너뛰고, 역할 게이트(runsBackgroundJobs)를 방어용으로 둡니다.AlertService.notify({ level: 'warn', key: 'order-cron:<job>' })를 남기고 다음 건으로 넘어갑니다.STATUS_CHANGED)을 발행합니다. 입금 전 주문은 발행하지 않습니다.StoreAdminRepository.findInactiveStoreIds()(store 배럴)로 숨긴 매장의 주문을 빼고, ③은 돈을 돌려주는 쪽이라 그대로 적용합니다.OrderTransitionRepository.cancelLocked에 잠금 뒤 대상 재판정(eligible)을,completePickupBySystem(감사 기록 없음)·completePickupByAdmin을 더했습니다. 두 픽업 완료는 본문 하나를 공유하고, 잠금 조회와 첫 품목 조회를 공통 함수로 묶었습니다.OrderLifecycleRepository(후보 조회, 미리 알림 표시)와 순수 정책order-lifecycle.policy(isPaymentExpired·isConfirmTimedOut·isConfirmReminderDue)를 새로 두었습니다.lockPayment가 입금 기한·'입금했어요' 시각도 읽습니다.SellerOrderSummary.confirmDeadlineAtSellerOrderDetail.confirmDeadlineAt·autoPickupAt·canMarkNoShow·noShowAtAdminOrderDetail.confirmDeadlineAt·autoPickupAt·noShowAtadminCompleteOrderPickup·input AdminCompleteOrderPickupInput { orderId: ID!, note: String }OrderStatusType(관리자 픽업 완료 포함)·sellerUpdateOrderStatus설명 갱신roles-coverage의 admin 접두 루트 필드 67 → 68confirm_deadline_at·confirm_reminder_sent_at·no_show_at)과 인덱스는 BE-01에 있어 마이그레이션이 없습니다.테스트
OrderCancelPolicy와 같음(28조합)pickupAt − 1ms·pickupAt·+24h − 1ms·+24hNO_SHOW_NOT_ALLOWED, 확정 → 픽업 완료NO_SHOW_NOT_ALLOWED(상태·노쇼 시각·이력 불변)ClockService고정, 실 DB)picked_up_at·정산(333bp 버림)·이력 주체 ADMIN과 메모·감사(매장 id 포함)·구매자 픽업 완료 알림·판매자 구독INVALID_ORDER_STATUS_TRANSITION, 픽업 완료는ORDER_STATUS_UNCHANGED(상태·이력·outbox·감사·구독 무변경)TEXT_TOO_LONG, 없거나 삭제된 주문 404, 관리자가 아니면 403ORDER_STATUS_UNCHANGEDClockService고정)isPaymentExpired·isConfirmTimedOut·isConfirmReminderDue경계 표ORDER_NO_SHOW문구, 자동 픽업 완료도 픽업 완료 알림,order.confirm_reminder_due파서·푸시 문구·소비자 전송module-wiring·read-boundary·model-ownership·audit-write-path·enum-sdl-sync·roles-coverage·role-routes·admin-query-null-inputs·seed-reset-scope), 에러 카탈로그 135 스위트 2,838건 통과order-seller.service.spec64건, 2/2를 이 위에 다시 쌓은 상태에서 order feature·audit-write-path·read-boundary·model-ownership57 스위트 1,410건 통과audit-write-path·roles-coverage·role-routes·read-boundary·model-ownership·module-wiring·admin-query-null-inputs·enum-sdl-sync·audit-target-type-sync) 60 스위트 1,613건 통과, 2/2를 이 위에 다시 쌓은 상태에서 order·notification·store feature와 같은 게이트 137 스위트 2,704건 통과dto:check·docs:check·arch:check통과. 전체 jest는 pre-push에서 돕니다.플랜 대조
assertTransition({ actor, from, to, now, pickupAt }), NO_SHOW 시간창(NO_SHOW_NOT_ALLOWED), CONFIRMED → PICKED_UP 허용OrderLifecycleScheduler①~④(역할 게이트,running플래그, 배치 100·상한 1000, 건별 tx 잠금 재검사,order-cron:<job>경보, 커밋 뒤 판매자 구독)SettlementSchedulerSellerOrderDetail.confirmDeadlineAt·autoPickupAt·canMarkNoShow·noShowAt,SellerOrderSummary.confirmDeadlineAt,AdminOrderDetail마감·자동 픽업·노쇼SellerOrderDetail.pickupChanges,AdminOrderDetail픽업 변경,OrderPickupChangefeat/order-pickup-reschedule)에서 함sellerRescheduleOrderPickup, 변경 시트 달력·슬롯,isPickupSlotAvailable옵션, 자기 수량 차감)MyOrderDetail.pickupChanges(앞 PR에서 넘어온 항목)adminCompleteOrderPickup을 더했습니다. 7절 전이 표의 픽업 완료 주체(SELLER·SYSTEM)에는 관리자가 없지만, 결정 기록인 (g) 답('관리자가 건별로 픽업 완료·취소한다')을 정본으로 보고 표의 누락을 메웠습니다. 건별 취소는 기존adminCancelOrder로 됩니다.ORDER_NO_SHOW구매자 알림,order.confirm_reminder_due→ 판매자ORDER_CONFIRM_REMINDER푸시ClockService), 1시간 정각, 2시간 미만 접수 생략·1회 발송, 동시 tx 1회 전이, 기존 주문 정산 건너뜀feat/order-pickup-reschedule)