Skip to content

chore: 릴리즈 — 커스텀 케이크 주문과 계좌이체 결제·취소·환불·정산 - #588

Merged
chanwoo7 merged 72 commits into
mainfrom
develop
Nov 18, 2026
Merged

chanwoo7 merged 72 commits into
mainfrom
develop

Conversation

@chanwoo7

Copy link
Copy Markdown
Member

커스텀 케이크 주문과 계좌이체 결제·취소·환불·정산 흐름을 운영에 반영합니다. 주문은 이제 입금 대기로 시작해 관리자 입금 확인 뒤 판매자에게 접수되고, 상품별 커스텀(슬롯형 문구·자유 편집, 3D 편집기)을 주문에 스냅샷으로 남깁니다.

운영 반영 사항입니다.

  • 마이그레이션 6건이 적용됩니다.
    • 20261118150004_order_payment_schema: 결제·환불·입금 기록·정산 테이블, enum 값 추가(끝에 덧붙여 INSTANT), 이력 주체 백필
    • 20261118155816_custom_product_settings: 상품 커스텀 방식·문구 자리 스타일·좌표, product.base_design_image_url·템플릿 is_active·option_requires_* 삭제
    • 20261118170655_option_item_three_d_key, 20261118182831_order_custom_snapshot(crop_image_url 삭제), 20261118190324_order_custom_upload, 20261118203227_conversation_image_order_card
  • 운영 DB 읽기 전용 점검(2026-11-19 07:4x KST, SET SESSION TRANSACTION READ ONLY, 마지막 적용 마이그레이션 20261102144339_order_item_region_label_snapshot)
    • 주문 0건(삭제 포함), 상품 0건, 계정 7개, 매장 1곳
    • submitted_at NULL 주문 0, 활성 템플릿 상품 0, 좌표 NULL 문구 자리 0
    • 삭제 컬럼에 값이 있는 행: product.base_design_image_url 0, option_requires_* 0, 비활성 템플릿(is_active = 0) 0, order_item_custom_free_edit(crop_image_url) 0
    • 커스텀 문구·자유 편집 주문 행 0
  • 시크릿: 운영 APP_ENV에 ACCOUNT_ENCRYPTION_KEYS·ADMIN_WEB_BASE_URL을 등록해 두었습니다(11-18). 키가 없으면 운영 부팅이 실패합니다.
  • 배포 직후 할 일
    • terraform apply: 앱 IAM에 s3:DeleteObject(order-custom/*)를 더하는 terraform/aws.tf 변경. 늦으면 업로드 정리 크론이 AccessDenied 경보를 내고 미사용 업로드가 쌓입니다(유실 없음).
    • 3D 카탈로그 에셋 운영 버킷 업로드(yarn catalog:upload --bucket <운영 버킷>).
    • 관리자 FE 릴리즈 뒤 '결제 설정'에 입금 계좌·수수료율 입력. 그 전 createOrder는 PAYMENT_ACCOUNT_NOT_CONFIGURED(503)입니다.
  • FE 파괴적 변경(구매자 FE)
    • createOrder: expectedTotalPrice 필수, 결과 상태가 PENDING_PAYMENT, 커스텀 상품은 custom 필수
    • OrderStatusType·NotificationEvent·ConversationBodyFormat 값 추가(exhaustive 매핑이면 tsc 실패)
    • OrderItemFreeEdit.cropImageUrl 삭제(→ 영역 좌표), OrderItemCustomText.valueText nullable
    • 관리자 FE·판매자 앱은 이어지는 각 레포 PR에서 맞춥니다.

릴리즈 PR(head develop)을 Admin이 머지할 때마다 delete_branch_on_merge가 develop을 지워 매번 재생성하고 있었음.
develop-protection에 deletion이 있지만 같은 ruleset의 Admin 우회(always)가 자동 삭제에도 적용됨.

- 우회자 없는 develop-no-deletion ruleset을 새로 두고 deletion을 옮김(우회 권한은 ruleset 단위).
- develop-protection은 PR·CI·force push 규칙과 Admin 우회(릴리즈 뒤 ff 동기화용)만 유지.
- README 관리 범위·import 목록 갱신.

terraform plan(-target 두 ruleset): 1 to add, 1 to change. 실제 차단은 apply 뒤 다음 릴리즈 머지에서 확인.
chore: develop 삭제 금지 ruleset 분리
계좌이체 결제·환불·입금 반환·주간 정산을 받을 기초 스키마. 결제·환불·정산 모델은 입금 확인과 주문 전이를 한 트랜잭션에 두려고 order가 소유한다. 이 커밋은 저장 구조와 기존 데이터 이행만 하고 주문 생성 동작은 그대로(SUBMITTED)다.

- enum: OrderStatus에 PENDING_PAYMENT·NO_SHOW, NotificationEvent 6값, AuditTargetType 5값을 끝에 덧붙임(기존 순번 유지, INSTANT ALTER). OrderActor·OrderCancelReason·OrderCancelFault·결제·환불·입금 기록·정산 enum 신설
- Order: 기본 상태 PENDING_PAYMENT, 요청 사항·입력 해시·수수료율 스냅샷·정산 확정·확정 마감·노쇼 컬럼, 인덱스 4개((account_id, status)는 입금 대기 건수 잠금 읽기용)
- OrderStatusHistory: actor_type(필수)·actor_account_id·취소 사유·사정·환불액
- 신규 모델 Payment·Refund(cancel_order_id unique로 주문당 취소 환불 1건)·DepositRecord·Settlement·StoreSettlementAccount·PaymentSetting(단일 행)·OrderPickupChange. 금전 모델은 deleted_at 없음, 돈이 걸린 선택 관계는 ON DELETE RESTRICT
- 백필: 이력 주체(최초 BUYER, '[관리자] ' 메모 ADMIN, 나머지 SELLER), 기존 취소 이력은 사유 OTHER·환불 0, 입금 대기가 아닌 주문의 submitted_at = created_at, payment_setting id=1. 기존 주문에는 결제 기록을 만들지 않음
- 코드: 이력을 쓰는 세 경로(주문 생성·판매자 상태 변경·관리자 취소)가 주체와 계정을 남김
- SDL: OrderStatusType·NotificationEvent·AuditTargetType 새 값(감사 대상 필터 목록 포함)
- 게이트: enum-sdl-sync spec 신설(NotificationEvent·ConversationBodyFormat·OrderStatus가 SDL에 모두 있는지), 모델 소유권 7개 등록
- 테스트 인프라: createOrder 팩토리는 입금 대기가 아니면 submitted_at을 채움, createPaymentSetting 팩토리
- 시드: 입금 흐름 예시 주문 5건(입금 대기·노쇼·부분 환불·미입금 취소 뒤 반환·입금 확인 접수)과 결제·환불·입금 기록, 테스트 입금 계좌(seedPayments). resetSeedScope는 결제·환불·입금 기록·픽업 변경을 주문보다 먼저, 정산·정산 계좌는 매장 범위로 지우고 결제 설정은 남김

테스트 21건 추가
- migration spec 9: 이력 주체·취소 백필·submitted_at 채움(입금 대기·기존 값 보존)·결제 설정 1행·enum 4개 컬럼 순서 보존·기본값
- enum-sdl-sync 8: 값 하나를 뺀 SDL로 잡히는 반증 3, 정합 3, 부분집합 판정 1, enum 없음 1
- seed-reset-scope 1: 결제 예시가 붙은 시드를 정리·재시드, 결제 설정 보존
- 이력 주체 단언 3(주문 생성·판매자 전이·관리자 취소)
새 상태(PENDING_PAYMENT·NO_SHOW)를 기존 조회·전이 규칙에 분류해 넣는다. 판매자에게는 입금이 확인된 주문만 보이고, 판매자 전이는 허용 목록 밖을 거절해 새 상태로 넘어가지 못한다. 주문 생성은 여전히 SUBMITTED라 기존 동작은 바뀌지 않는다.

- 분류: order/constants/order-status-traits.ts의 ORDER_STATUS_TRAITS(satisfies Record<OrderStatus, …>)에서 IN_PROGRESS_ORDER_STATUSES(입금 대기·접수·확정·제작 완료)를 파생. 새 상태는 분류 전까지 tsc가 막음
- 판매자 노출: submitted_at IS NOT NULL을 목록·건수(storeOrderScopeWhere)·상세·대시보드 집계·상태 변경 잠금 SQL에 건다. 상세 이력은 입금 대기 행을 빼고 접수 이력의 fromStatus를 null로 내림. 관리자 취소는 입금 확인 전 주문이면 판매자 구독으로 발행하지 않음
- 상태 리터럴 4곳을 Prisma enum 파생으로: 관리자·판매자 목록 입력과 판매자 상태 변경 입력은 IsEnum(OrderStatus), 정책 parse는 Object.values(OrderStatus)
- assertSellerTransition을 허용 목록(기본 거절)으로: 기존 6개 전이 외 to는 INVALID_ORDER_STATUS_TRANSITION(취소는 ORDER_NOT_CANCELLABLE). NO_SHOW·PENDING_PAYMENT는 이후 표 기반 전이 정책이 연다
- 대시보드: 판매자 접수 지표 기준을 created_at → submitted_at, SellerDashboard.pendingPaymentQuantity(입금 대기 점유 수량, bookedQuantity에 포함). 관리자 AdminOrderStatusCounts.pendingPayment·noShow, 금액 합에서 취소·입금 대기 제외
- 랭킹 유효 상태에 NO_SHOW, 마이페이지 진행 주문은 IN_PROGRESS_ORDER_STATUSES. 리뷰는 PICKED_UP만이라 노쇼 리뷰 불가(회귀 테스트)
- 조회: adminStoreInProgressOrderSummary(storeId) { storeId totalCount byStatus { status count } }(order.groupBy, 0건 상태 제외·흐름 순), AdminOrderListInput.inProgress(null·false = 전체, status와 AND), SellerOrderListInput.buyerAccountId
- 게이트: roles-coverage admin 접두 59 → 60. admin-query-null-inputs는 input 객체 Query 수 변화 없음(17), inProgress null은 전수 검사에 포함

테스트
- 정책: 판매자 전이 7×7 전수 49, parse(enum 전부 + 잘못된 값 3), 취소 메모 7
- 분류 표 9, DTO 입력 28(관리자 목록·판매자 목록·판매자 상태 변경이 enum 전부를 받는지 21, inProgress 5, buyerAccountId 1, 알 수 없는 status 1)
- 판매자 노출 8(목록·건수, 상세 404, 이력, 상태 변경 404, to=NO_SHOW·PENDING_PAYMENT 거절, buyerAccountId·빈 문자열·"0"), 잠금 SQL 1, 집계 3
- 관리자: inProgress 5(true·false·null·undefined·AND), 진행 주문 요약 3(새 상태·0건·403) + 리졸버 경로 1, 입금 대기·노쇼 취소 400 2, 입금 확인 전 취소 미발행 1
- 대시보드 3(판매자 2·관리자 1 갱신), 랭킹 상태 전수 7, 노쇼 리뷰 불가 2곳(작성 거절·작성 가능 목록 제외), 마이페이지·진행 주문 갱신 2
- 가드 반증: 노출 조건·잠금 SQL·구독 가드·SDL 값을 지우면 해당 테스트가 실패하고, 허용 목록을 되돌리면 정책 테스트 13건이 실패함을 확인
리뷰 지적을 반영한다.
- 주문 생성 리졸버 spec도 truncateAll 뒤 결제 설정 행을 다시 만든다. 이후 결제 계좌 미설정 검사가 들어와도 깨지지 않게 서비스 spec과 맞춘다.
- 매장 진행 주문 요약이 삭제된 주문과 이 매장 품목이 삭제된 주문을 세지 않는지 확인하는 테스트가 없었다.
- aggregateStoreOrdersInRange의 접수 기준 범위가 같은 submitted_at 키로 판매자 노출 조건을 덮어써 조건이 조용히 사라졌다(결과는 범위가 NULL을 빼서 같았다).
- SDL 설명 두 곳이 새 동작과 어긋났다.

변경점
- order.repository: aggregateStoreOrdersInRange에서 노출 조건과 기간 범위를 AND로 묶는다.
- order-subscription.graphql: 입금 확인 전 주문의 취소는 발행하지 않는다고 적는다.
- mypage-overview.graphql: OngoingOrderSummary를 입금 대기부터 제작 완료까지로, 노쇼 제외를 적는다.
- order-checkout-mutation.resolver.spec: beforeEach에서 createPaymentSetting을 부른다.

테스트
- order-admin.service.spec: 진행 주문 요약 삭제 제외 1건 추가. 품목 조건의 activeWhere를 지우면 실패한다.
- AND 안의 노출 조건을 지우면 order.repository·dashboard-seller spec의 입금 대기 제외 2건이 실패한다.
- order-admin.service·order-checkout-mutation.resolver·order.repository·dashboard-seller service·resolver 5 스위트 86건 통과.
feat: 주문 결제·환불·정산 스키마와 입금 대기·노쇼 상태 추가
주문서가 본 금액·입력과 서버가 만드는 주문이 어긋나지 않게 한다. 픽업 달력은 상품 제작 시간을 보지 않아 달력에서 고른 슬롯이 주문 생성에서 거절될 수 있었고, 멱등 replay는 입력을 비교하지 않아 같은 키로 다른 주문서를 보내도 기존 주문을 돌려줬다. 주문 생성 결과 상태는 여전히 SUBMITTED다.

- 픽업 하한 단일화: store-pickup-policy.helper의 effectiveLeadTimeMinutes(매장 리드타임과 상품 제작 시간 중 긴 쪽)를 달력·슬롯·isPickupSlotAvailable이 함께 쓴다(store 배럴로 공개). 하한 자체(지금 + 리드타임/제작 시간)는 그대로
- pickupCalendar·pickupTimeSlots에 productId(선택). store repository가 그 매장의 판매 중 상품 제작 시간을 읽고, 아니면 PRODUCT_NOT_FOUND. 매장 확인이 먼저다
- isPickupSlotAvailable({ storeId, pickupAt, preparationTimeMinutes }). createOrder의 자체 제작 시간 비교를 지우고 이 판정만 쓴다
- CreateOrderInput.expectedTotalPrice: Int!(0 이상). 서버 계산 총액과 다르면 ORDER_PRICE_CHANGED(409), 주문·키를 남기지 않는다
- CreateOrderInput.requestNote(500자). 앞뒤 공백을 지우고 비면 null로 저장. MyOrderDetail·SellerOrderDetail·AdminOrderDetail.requestNote로 내보냄
- 입력 해시: order-input-hash.helper가 productId·optionItemIds(정렬)·pickupAt(ISO)·quantity(생략 = 1)·buyerName·buyerPhone·requestNote·expectedTotalPrice를 키 정렬 JSON(null 키 생략)으로 만든 sha256을 idempotency_input_hash에 저장. replay 세 경로(사전 조회, capacity 거절 뒤 tx 밖·안, 멱등 키 P2002)에서 다르면 IDEMPOTENCY_KEY_INPUT_MISMATCH(400). 해시가 없는 기존 주문은 비교하지 않음
- 에러 카탈로그: ORDER_PRICE_CHANGED, IDEMPOTENCY_KEY_INPUT_MISMATCH

테스트 68건 추가(1건 대체)
- 하루 슬롯 20개 전부에 대해 pickupTimeSlots(productId)의 available ⇔ createOrder 성공(it.each)
- 해시 경우: 같은 입력 replay, 필드별 불일치 6, 기존 해시 null, capacity 거절 뒤 2(tx 밖·안), P2002, quantity 생략 = 1. '입력 비교 없음' 테스트는 불일치 거절로 대체
- 해시 helper 14: 정규화 형식 고정, 옵션 순서·시각 표기·quantity·null 불변, 필드 8개 각각 변화, 따옴표 주입
- productId: 빈 문자열 INVALID_ID·"0"은 버리지 않고 PRODUCT_NOT_FOUND, 다른 매장·비활성·삭제·없는 상품 PRODUCT_NOT_FOUND, 매장 우선, 달력·슬롯 제작 시간 반영, 하한 helper 5
- 기대 금액 ±1원 거절 뒤 같은 키 성공 2, 요청 사항 정규화 3, DTO 6, 3면 출력 단언
- 반증: replay 비교를 경로별로 지우면 각 경로 테스트(6·2·1건)가, 제작 시간 전달을 0으로 바꾸면 슬롯 16건과 제작 시간 테스트가, 금액 비교를 지우면 2건이, 달력의 제작 시간 반영을 지우면 19건이, 상품 매장·판매 조건을 지우면 PRODUCT_NOT_FOUND 테스트가 실패함을 확인
productId를 주면 상품 제작 시간까지 하한에 들어가 미래 날짜도 CLOSED가 될 수 있어 PickupDay 설명을 맞춤.
feat: 주문 생성 기대 금액·입력 해시·요청 사항과 픽업 달력 상품 제작 시간 반영
환불·정산 계좌번호를 암호화해 저장하기 위한 공용 암호기. 키를 회전해도 옛 토큰을 풀 수 있게 토큰에 keyId를 싣고, 용도(AAD)를 묶어 한 칼럼의 토큰을 다른 용도 칼럼에 옮겨 붙이면 풀리지 않게 한다.

- global/crypto: AccountCipher(AES-256-GCM, 토큰 v1.<keyId>.<iv>.<tag>.<ct> b64url, AAD refund-account·settlement-account). 첫 키로 암호화하고 keyId로 복호화, 실패 메시지에 평문·토큰을 싣지 않음. CryptoModule(global)이 설정으로 만들고 개발 키면 경고
- config/account-crypto.config: ACCOUNT_ENCRYPTION_KEYS="k2:<base64 32B>,k1:<base64 32B>". production은 없거나 형식이 틀리면 부팅 실패, 그 외 환경은 고정 개발 키 + 경고. 형식 오류 메시지에 키 값을 싣지 않음. AppModule load 목록에 등록
- 키 회전: yarn accounts:reencrypt(대상 수 먼저 출력, --dry-run은 대상 수만). 환불·매장 정산 계좌·정산 송금 스냅샷의 첫 키가 아닌 토큰을 첫 키로 다시 암호화하고, 읽은 뒤 바뀐 행은 덮어쓰지 않음. 개발 키로는 돌지 않음. 쓰기는 order repository(AccountNumberReencryptRepository) 경유
- 문서: README·README.en 필요 환경 변수·스크립트 표, infra/app.env.example, infra/runbook.md에 키 만들기·백업·회전 절차

테스트
- 설정 파싱: 순서·공백·base64url, 형식 오류 10종이 production에서 부팅 실패이고 비운영은 개발 키로 대신함(반증 표), 메시지에 키 값 없음, production 미설정 실패, 개발 키 고정
- 암호기: 왕복, IV 무작위, 키 회전(새 키 암호화·옛 토큰 복호화·isStale), 옛 키 제거 시 실패, AAD 불일치, 변조 8종(암호문·태그·IV·짧은 태그·다른 키 keyId·버전·조각 수·평문), CryptoModule 배선과 개발 키 경고
- 재암호화 repository(real DB): 세 칼럼 대상 수·재암호화 뒤 0·새 키만으로 원문 복호화·이미 새 키인 행 불변, 대상은 첫 키 기준
- 스크립트를 로컬 DB에 --dry-run으로 돌려 키 미설정 거절·대상 수 출력·알 수 없는 인자 거절을 확인
케이퀵 입금 계좌·판매 수수료율(플랫폼 공통 1개)을 관리자가 설정하고, 매장 정산 계좌를 판매자 본인과 관리자가 등록·수정한다. 정산 계좌번호는 AccountCipher로 암호화해 두고 응답·감사에는 끝 4자리만 남기며, 원문 복호화는 관리자 매장 정산 계좌 조회에서만 한다.

- 은행: order/constants/payment-banks.ts(금융결제원 3자리 25개), 공개 Query paymentBanks: [Bank!]!. 은행 코드는 목록 안(INVALID_BANK_CODE), 계좌번호는 하이픈 제거 뒤 숫자 8~20(INVALID_ACCOUNT_NUMBER), 예금주 1~50자(TEXT_REQUIRED·TEXT_TOO_LONG)
- 결제 설정: adminPaymentSetting(행이 없으면 수수료 0·계좌 없음), adminUpdatePaymentSetting(보낸 필드만 변경, 수수료 0~10000bp INVALID_COMMISSION_RATE, 사유 필수, 첫 변경은 행 생성). 감사 PAYMENT_SETTING(변경 전·후 값 + 사유)이 같은 트랜잭션
- 정산 계좌: sellerSettlementAccount·sellerUpsertSettlementAccount, adminStoreSettlementAccount(storeId)(원문 포함, 등록 전 null)·adminUpsertStoreSettlementAccount(사유 필수). 매장 존재는 store 배럴의 StoreAdminRepository로 확인(STORE_NOT_FOUND). updated_by_role로 판매자 본인·관리자 대리 수정을 가르고, 감사 SETTLEMENT_ACCOUNT(생성·수정, 끝 4자리만)는 매장 ID를 달아 남김
- 판매자 감사 로그에 SETTLEMENT_ACCOUNT 노출(SELLER_AUDIT_TARGET_TYPES, 필터 매핑, SDL 설명)
- 동시 첫 등록: 없는 행을 FOR UPDATE로 잡으면 갭 잠금끼리 교착하므로, 생성 경합은 unique 충돌로 받아 한 번 다시 돌린다(retryOnceOnUniqueConflict, 두 번째는 갱신 경로)
- SDL: order-payment.graphql·order-payment-admin.graphql·order-settlement-seller.graphql, enum OrderActorType 신설(정산 계좌 updatedByRole)
- 오류 코드: INVALID_BANK_CODE·INVALID_ACCOUNT_NUMBER·INVALID_COMMISSION_RATE(400)
- 시드: seed-seller-a 매장 정산 계좌(앱과 같은 키 설정으로 암호화)
- 게이트: roles-coverage seller 56 → 58, admin 60 → 64, enum-sdl-sync에 OrderActor ↔ OrderActorType. admin-query-null-inputs는 input 객체 admin Query가 늘지 않아 그대로(17)

테스트
- 은행·계좌 경계: 은행 코드 전수 통과·잘못된 코드 7, 계좌번호 통과 4·거절 8(7·21자리, 공백·영문·전각·하이픈만 등), 예금주 경계(50자·이모지 50·빈 값·51자)
- 결제 설정(real DB): 행 부재 기본값 read, 첫 upsert 행 생성·감사 before 기본값, 보낸 필드만 변경, 수수료 경계 5(-1·0·10000·10001·1.5), 입력 오류 4종 무변경, 감사 실패 시 설정 미변경(같은 tx), 행 부재 동시 변경 2건
- 정산 계좌(real DB): 없는 매장·삭제된 매장 404, 등록 전 null·원문 복호화, 암호문·끝 4자리 저장과 감사에 원문·암호문 없음, 생성·수정 감사, 입력 오류 5종, 감사 실패 시 미변경, 동시 첫 등록 2건(행 1개, CREATE·UPDATE 각 1), 판매자 등록·관리자 대리 수정 뒤 SELLER 복귀·권한 거절
- 리졸버 경로 3, 판매자 감사 로그(관리자 정산 계좌 기록 노출·다른 관리자 조작 제외, 필터 매핑), 입력 DTO(SETTLEMENT_ACCOUNT 허용·ACCOUNT 거절), 재시도 helper 4, 시드 정산 계좌 복호화와 정리·재시드
- 반증: 동시 첫 등록 재시도·매장 존재 확인·판매자 감사 노출 항목을 각각 지우면 해당 테스트 4건이 실패함을 확인
리뷰 지적을 반영한다.
- 키 회전 재암호화(updateMany)가 @updatedat 때문에 store_settlement_account·refund·settlement의 updated_at을 회전 시각으로 바꿨다. 정산 계좌 updatedAt은 SDL에서 '마지막 변경 시각'으로 updatedByRole과 나란히 내려가, 아무도 바꾸지 않은 계좌를 판매자·관리자가 그 시각에 바꾼 것처럼 보였다.
- 재암호화 스크립트의 안전 가드(알 수 없는 인자 거절, 고정 개발 키 거절)가 main() 안에만 있어 자동 테스트가 없었다.

변경
- AccountNumberReencryptRepository: updated_at도 읽어 updateMany data에 읽은 값을 다시 쓴다. where에도 updated_at을 더해, 읽은 뒤 다른 필드가 바뀐 행(토큰은 그대로)은 건너뛴다. 넣지 않으면 그 행의 최신 updated_at을 옛 값으로 되돌린다. 건너뛴 행은 다음 실행 대상으로 남는다(runbook의 0이 될 때까지 반복과 같음)
- scripts/accounts-reencrypt-args.ts: parseReencryptArgs·assertRotatableConfig로 분리하고 스크립트가 이를 쓴다(동작 동일)

테스트
- 재암호화 repository(real DB): 세 칼럼 재암호화 뒤 updated_at 불변, 읽은 직후 상태가 바뀐 환불은 건너뛰고 updated_at을 되돌리지 않으며 다음 실행 대상으로 남음
- scripts/accounts-reencrypt.spec.ts 9건: 인자 2(없음·--dry-run), 반증 4(--dryrun·--dry-run=true·여분 인자·대시 없음), 키 가드 통과 1·개발 키 거절 2
- 반증: data의 updated_at 보존을 지우면 불변 단언이, where의 updated_at을 지우면 경합 케이스가, 가드 두 곳을 끄면 scripts spec 6건이 실패함을 확인
리뷰 지적을 반영한다.
- adminUpdatePaymentSetting SDL은 사유가 길면 TEXT_TOO_LONG이라고 적었지만, 두 관리자 입력 DTO의 @maxlength(MAX_REASON_LENGTH)가 먼저 걸려 500자 초과 사유는 ValidationPipe의 VALIDATION_FAILED로 거절된다. adminUpsertStoreSettlementAccount도 같은 코드를 따른다고 적혀 있어 둘 다 어긋났다. 다른 관리자 사유 입력(정지·숨김 등)이 DTO MaxLength를 쓰므로 동작은 두고 SDL을 고친다.
- SellerAuditLog 설명이 '판매자 조작'으로만 적혀 있었는데, 관리자가 그 매장에 한 조작(정산 계좌 대리 수정·주문 취소 등)도 함께 보인다.

변경
- order-payment-admin.graphql: 예금주는 비었거나 50자 초과면 TEXT_REQUIRED·TEXT_TOO_LONG, 사유는 비면 TEXT_REQUIRED, 500자 초과면 VALIDATION_FAILED
- store-seller-audit.graphql: SellerAuditLog 설명에 관리자 조작 포함을 적음

테스트
- AdminUpdatePaymentSettingInput·AdminUpsertStoreSettlementAccountInput spec 각 2건: 사유 500자 통과·501자 거절, 예금주 51자는 DTO에서 거르지 않음(서비스가 TEXT_TOO_LONG)
- 반증: 두 DTO에서 사유 MaxLength를 지우면 501자 거절 2건이 실패함을 확인
feat: 계좌번호 암호화와 결제 설정·매장 정산 계좌 API
상품마다 커스텀 방식(없음·슬롯형·3D)을 두고, 슬롯형 문구 자리에 표시 이름·글자색·정렬을 더하며 좌표를 서버가 검증한다. 템플릿 활성 토글은 커스텀 방식이, 상품 바탕 이미지(base_design_image_url)는 템플릿 바탕이, 옵션 커스텀 요구 플래그는 커스텀 방식이 대신해 지운다. 운영 판매자가 없어 레거시 필드는 바로 지우고 기존 데이터는 백필로 옮긴다.

변경점
- 스키마: Product.custom_mode(CustomMode NONE·SLOT·THREE_D), 템플릿 free_edit_enabled·revision, 문구 자리 label VarChar(30)·max_length 기본 20·pos_x..height NOT NULL·text_color Char(7) 기본 #000000·text_align(CustomTextAlign) 기본 CENTER. DROP product.base_design_image_url, product_option_group.option_requires_*, 템플릿 is_active
- 백필: 활성·미삭제 템플릿 상품은 SLOT, label = 키 앞 30자, 기본 문구 50자 절단, max_length를 기본 문구 길이 이상·50 이하로, 좌표가 하나라도 없으면 판매자 앱 기본 배치(템플릿별 활성 순번, 위에서 2000 간격), 좌표를 0~10000으로 자른 뒤 NOT NULL. 순번은 임시 표로 뽑는다(임시 표는 한 문장에서 두 번 읽을 수 없어 백필 검증이 깨진다)
- 준비 상태: product 순수 헬퍼 evaluateProductCustomIssues(배럴 공개). SLOT_TEMPLATE_MISSING, SLOT_NOTHING_TO_EDIT(문구 자리 0 ∧ 자유 편집 꺼짐), 3D는 옵션 3D 연결 칸이 생기기 전까지 THREE_D_GROUP_MISSING
- API: sellerSetProductCustomMode(productId, customMode)(준비 이슈가 있으면 CUSTOM_PRODUCT_NOT_READY, 같은 방식이면 감사 없이 그대로), SellerProduct.customMode·customReadiness(방식별 ready·issues), sellerSetProductCustomTemplateActive 삭제
- 템플릿: freeEditEnabled(생략하면 새 템플릿 false·기존 유지), revision은 템플릿 갱신과 슬롯 등록·수정·삭제·순서 변경 tx 안에서 1씩 올린다
- 문구 자리 검증: 키 ^[a-z0-9]{1,60}$(CUSTOM_TOKEN_KEY_INVALID, 규칙 전 키는 바꾸지 않으면 허용), maxLength 1~50(FIELD_OUT_OF_RANGE), 기본 문구 ≤ maxLength 코드 포인트(CUSTOM_TEXT_DEFAULT_TOO_LONG), 좌표 0~10000·너비·높이 1 이상·x+w·y+h ≤ 10000(CUSTOM_AREA_OUT_OF_BOUNDS), 글자색 #RRGGBB 대문자 저장(INVALID_COLOR_FORMAT). label·textColor·textAlign은 SDL 기본값 없이 생략하면 수정은 유지, 등록은 키·#000000·CENTER
- 조회: 구매자 ProductDetail.customMode·customTemplate(SLOT일 때만, revision·바탕·자유 편집·문구 자리), 관리자 AdminProduct.customMode·thumbnailUrl(삭제 제외 첫 이미지, 목록 include에 images take 1)·템플릿 freeEditEnabled·슬롯 표시 이름·스타일
- 주문 생성의 OPTION_CUSTOMIZATION_REQUIRED 가드와 에러 코드 삭제(플래그 컬럼이 없어짐)
- 게이트: removed-schema-elements에 삭제 출력 필드 8·입력 필드 7·타입 1·루트 필드 1과 입력 필드 판정기(반증 포함), enum-sdl-sync에 CustomMode·CustomTextAlign
- 테스트 인프라: createCustomTemplate·createCustomTextToken 팩토리

테스트
- migration spec 4: SLOT 백필(활성·비활성·삭제·없음), 표시 이름·기본 문구·최대 글자 수(이모지 코드 포인트 포함), 좌표 기본 배치·클램프(삭제 자리 순번·8500 상한·템플릿별 순번), 백필 없이는 NOT NULL 전환 실패(반증). 템플릿 is_active·좌표 NULL은 최신 스키마에서 만들 수 없어 연결 하나에서 같은 이름 임시 표로 가린다
- 준비 상태 표 9, 방식 변경 8(다른 매장 404, 준비 안 됨 3, 슬롯형 전환·감사 2, 없음 전환, 같은 방식 멱등)
- 좌표 경계 표 11, maxLength 4, 기본 문구 코드 포인트 1, 키 형식 6 + 규칙 전 키 1, 글자색 3, 표시 이름 2, 기본값·유지·저장 3
- revision 지점 1(템플릿 갱신·등록 2·수정·순서·삭제가 1씩), 실패한 슬롯 변경은 revision 불변 1, 글자색·정렬 등록 기본값·수정 유지 1
- 구매자 상세 4(SLOT 템플릿·없음·3D·삭제 템플릿), 관리자 목록 썸네일 1(상세 썸네일 단언 추가)·커스텀 필드 1, 판매자 상세 1, DTO 14(문구 자리 11·템플릿 자유 편집 3)
- 가드 반증: 백필 클램프·revision 증가·준비 판정·좌표 경계를 하나씩 깨면 해당 테스트가 실패함을 확인
좌표 네 값을 따로 0~10000으로만 자르면 x+w·y+h가 10000을 넘거나 너비·높이가 0인 자리가 남는다. 이런 자리는 구매자 출력 계약(너비 1~10000, x+w ≤ 10000)을 어기고, 판매자가 좌표를 그대로 둔 채 다른 값만 고쳐도 CUSTOM_AREA_OUT_OF_BOUNDS로 거절된다.

변경점
- 백필 클램프를 서버 좌표 검증과 같은 범위로: 좌표 0~9999로 먼저 자르고, 다음 문장에서 너비·높이를 1~(10000 − 좌표)로 맞춘다(두 문장으로 나눠 SET 평가 순서에 기대지 않음)

테스트
- migration spec 좌표 케이스: 기존 클램프 행 기대값 수정([-5, 20000, 300, 12000] → [0, 9999, 300, 1]), 경계 행 5개(x+w 초과·좌표 10000·음수 너비·꽉 찬 영역·범위 안 그대로) 표 추가, 백필 뒤 모든 자리가 서버 좌표 검증 범위 안인지 단언
- 반증: 이전 클램프 문장으로 되돌리면 이 케이스가 실패함을 확인
방식 변경과 판매자 상품 준비 상태의 '문구 자리 0개' 판정은 상품 조회가 문구 자리에 거는 삭제 제외 조건에 기댄다. 이 조건을 지워도 실패하는 테스트가 없어, 삭제 자리만 남은 템플릿이 슬롯형 준비 완료로 판정되는 회귀를 막지 못했다.

변경점
- sellerSetProductCustomMode spec 1건: 자유 편집 꺼진 템플릿 + 삭제된 문구 자리만 있음 → 슬롯형 전환 CUSTOM_PRODUCT_NOT_READY, 슬롯형 상품 출력의 SLOT 준비 이슈 SLOT_NOTHING_TO_EDIT, 응답 문구 자리 목록에서 삭제 자리 제외

테스트
- 반증: findProductByIdIncludingInactive의 문구 자리 삭제 제외 조건을 지우면 이 케이스가 실패함을 확인(전환이 성공으로 바뀜)
feat: 상품 커스텀 방식과 문구 자리 스타일·좌표 검증
문구 자리 좌표는 바탕 한 변을 10000으로 본 비율이라 바탕이 정사각이어야 뜻이 맞는다. 판매자 앱 크롭에 더해 서버가 업로드된 바탕 이미지의 가로·세로를 읽어 1:1을 강제한다.

변경점
- S3Service.readImageSize(url): 이 버킷 공개 URL의 객체를 Range GET(앞 64KB)으로 읽어 image-size로 크기를 구한다. 크기를 못 구했고 객체가 더 크면(JPEG SOF가 EXIF·ICC 뒤) 전체를 다시 읽는다. 이미지가 아니거나 객체가 없으면(404·416) null, 그 밖의 S3 오류는 로그 + S3_READ_FAILED(503)
- 의존성: image-size 2.0.4 고정(2.x 중 2주 이상 지난 최신)
- sellerUpsertProductCustomTemplate: 바탕 URL이 새로 들어오거나 바뀔 때만 읽는다. 가로·세로 차이 1px 이하만 허용(CUSTOM_BASE_IMAGE_NOT_SQUARE), 읽을 수 없으면 CUSTOM_BASE_IMAGE_UNREADABLE(400)
- 에러 코드 CUSTOM_BASE_IMAGE_NOT_SQUARE·CUSTOM_BASE_IMAGE_UNREADABLE·S3_READ_FAILED 신설, SDL 설명 갱신

테스트
- readImageSize 11: 앞 64KB만 읽음(요청 인자 단언), SOF가 64KB 밖인 JPEG는 전체 재읽기, 작은 비이미지는 재읽기 없이 null, 큰 비이미지는 재읽기 뒤 null, 404·416은 null, 5xx·403·네트워크 오류는 S3_READ_FAILED와 원인 로그, 다른 버킷·URL 아님은 읽지 않음. 이미지는 PNG IHDR·JPEG SOF 바이트를 직접 만든다
- 템플릿 1:1 8: 정사각·가로·세로 1px 허용, 2px·세로로 긴 이미지 거절(템플릿 미생성), 읽기 실패 400, S3 실패 503, URL이 그대로면 읽지 않고 바뀔 때만 읽음. S3 읽기는 결과만 주입
- 가드 반증: 재읽기 분기·허용치·URL 비교를 깨면 해당 테스트가 실패함을 확인
앱 IAM 정책에는 media 버킷 s3:ListBucket이 없어, S3는 없는 키(업로드 실패·미완료)를 404가 아니라 403 AccessDenied로 돌려준다. 그래서 운영에서는 404 분기에 닿지 않고 S3_READ_FAILED(503)와 error 로그가 나서, 판매자가 다시 시도해도 계속 503을 받았다.

변경점
- readObject: 403 AccessDenied는 없는 객체로 보고 null(→ CUSTOM_BASE_IMAGE_UNREADABLE 400). 호출부가 URL이 이 계정 업로드 prefix인지 먼저 검증하므로 그 키의 거부는 객체 없음이다. 정책에서 GetObject가 빠진 경우와 구별되지 않아 warn 로그는 남긴다
- 다른 403(서명 오류 등)·5xx·네트워크 오류는 그대로 error 로그 + S3_READ_FAILED
- ListBucket 권한 추가(terraform apply 필요)는 하지 않음 — 앱 코드만으로 닫는다

테스트
- readImageSize: 403 AccessDenied → null·warn 로그·error 로그 없음 1건 추가, 실패 표의 권한 거부 행을 403 SignatureDoesNotMatch → S3_READ_FAILED로 교체
- 반증: AccessDenied 분기를 끄면 새 케이스가, 403 전체를 null로 넓히면 서명 오류 행이 실패함을 확인
feat: 커스텀 바탕 이미지 1:1 서버 검증
① 무엇·왜
- 주문이 계좌이체 결제로 바뀐다. createOrder는 입금 대기(PENDING_PAYMENT) 주문과 결제(PENDING, 케이퀵 계좌 스냅샷, 1시간 기한)를 만들고, 관리자가 은행 앱에서 입금을 확인하면 접수(SUBMITTED)로 넘어가 그때부터 판매자에게 보인다.
- 계정당 입금 대기는 2건까지다. 같은 계정 요청은 GET_LOCK으로 직렬화하고 건수는 잠금 읽기로 세서 커밋 직전에 잠금이 풀려도 3건째가 생기지 않는다.
- 입금액이 결제 금액과 다르면 확인을 막고(반환 연결로 처리), 픽업이 지난 주문도 확인을 막는다(확인 직후 마감 초과로 접수·취소 알림이 연달아 가는 것을 피한다).

② 변경점
- 주문 생성: 입금자명(생략 시 주문자 이름, 20자 초과 DEPOSITOR_NAME_INVALID), 입금 계좌 세 값이 모두 있어야 받음(PAYMENT_ACCOUNT_NOT_CONFIGURED), 수수료율 스냅샷, 입력 해시에 입금자명 추가, 판매자 구독 발행 제거, CreateOrderOutput.payment
- 생성 tx: READ COMMITTED + timeout 10초, GET_LOCK 3초(시간 초과 CONCURRENT_REQUEST) → 입금 대기 건수 FOR SHARE → capacity 잠금 → 주문·결제·이력. REPEATABLE READ의 갭 잠금은 다른 계정끼리 건수 잠금 읽기 → INSERT에서 교착해 격리 수준을 낮췄다
- 상한 거절도 capacity 거절처럼 같은 키 주문이 있으면 replay한다
- OrderTransitionRepository.confirmPaymentLocked: 주문 → 결제 잠금 뒤 재판정, 결제 CONFIRMED(처리자 라벨·메모), 주문 SUBMITTED(확정 마감 = min(확인 + 24시간, 픽업)), 이력·감사(입금액)·outbox(order.status_changed + order.submitted)
- 관리자: adminConfirmPayment, adminPendingPayments(claimedOnly는 '입금했어요' 시각 복합 커서, 금액·입금자명 필터, null = 생략), adminTaskCounts(claimedPayments·pendingPayments)
- 구매자: markMyOrderDepositSent(기한 전 첫 누름만 기록, 다시 누르면 멱등), MyOrderDetail.payment, MyOrderSummary.paymentExpiresAt
- 판매자·관리자 출력: SellerOrderDetail.paymentMethod, AdminOrderDetail.payment(처리자 라벨·메모), SellerOrderUpdate.kind(SUBMITTED·STATUS_CHANGED·PICKUP_RESCHEDULED)
- 알림: 입금 확인(→ SUBMITTED)에 구매자 ORDER_PAYMENT_CONFIRMED, 판매자 '새 주문' 푸시는 확정 마감까지 2시간 미만이면 마감 시각을 싣는다(order.submitted.confirmDeadlineAt)
- 에러 9종, ADMIN_QUERY_COUNT 18, admin 접두 루트 필드 67, createPayment 팩토리

③ 테스트
- 결제·이력·계좌 스냅샷, 입금자명 경계(생략·공백·20자 이모지·21자·주문자 이름 21자), 계좌 미설정 4경우, 해시 입금자명 불일치
- 입금 대기 2건 경계·다른 상태/삭제/다른 계정 제외·상한에서 replay·동시 2요청·미커밋 행 대기 뒤 거절·GET_LOCK 시간 초과·다른 계정 동시 주문 무교착(5라운드)
- 반증: REPEATABLE READ면 다른 계정 동시 주문 2건이 교착으로 실패, FOR SHARE를 빼면 미커밋 대기 케이스가 3건째를 받음, GET_LOCK을 빼면 동시 2요청이 둘 다 받음, RELEASE_LOCK을 빼면 실패 tx 뒤 잠금이 남음
- 입금 확인: 일치 성공·마감 두 경우·outbox·판매자 노출·구독 kind·구매자 알림, 불일치·0/음수·취소/확인됨/결제 없음 409·픽업 정각/경과·기한 지난 클레임 확인·없음/삭제·메모 길이·동시 확인 1건, 정책 전수 표
- 입금 대기 목록 순서·커서·claimedOnly 복합 커서·필터·null 입력·잘못된 커서, 처리 대기 건수
- '입금했어요' 기록·멱등·기한 정각/뒤/1ms 전·상태별 409·다른 계정/삭제 404
주문 생성 tx가 timeout(10초)을 넘기면 Prisma가 ROLLBACK 뒤 연결을 풀로 돌려줘 finally의 RELEASE_LOCK이
만료된 tx 오류로 서버에 가지 않는다. MySQL 풀 반납은 ROLLBACK만 보내 세션 잠금(GET_LOCK)이 그 연결에 남고,
같은 계정의 주문은 다른 연결에서 3초씩 기다린 뒤 CONCURRENT_REQUEST를 받는다(연결이 닫힐 때까지).
GET_LOCK 이름은 서버 전역이라 같은 서버를 쓰는 다른 스키마(테스트 워커 DB 등)의 같은 계정 id와도 겹쳤다.

- withPendingPaymentLock: GET_LOCK과 함께 CONNECTION_ID()를 읽어 두고, RELEASE_LOCK이 실패하면
  tx 밖 클라이언트로 KILL을 보내 그 세션을 끊는다. KILL 실패(세션이 이미 없음)는 무시하고 원래 오류를 그대로 던진다.
- 잠금 이름을 CONCAT(DATABASE(), ':pending-payment:', id)로 바꾸고 pendingPaymentLockName으로 내보내
  테스트의 수동 GET_LOCK·IS_USED_LOCK도 같은 이름을 쓴다.

테스트: timeout 1초 tx 안에서 SLEEP(2)로 만료시킨 뒤 IS_USED_LOCK이 NULL이고 같은 계정의 다음 주문이 받아지는지
1건 추가. KILL을 빼면 잠금이 남아(IS_USED_LOCK = 연결 id) 실패하는 것을 확인했다.
confirmPaymentLocked는 주문·결제를 FOR UPDATE로 잠근 뒤 판정 재료(주문 상태·결제 상태·금액·픽업 일시)를
일관성 읽기(findUniqueOrThrow)로 다시 읽었다. 후속 중계 연동처럼 호출 tx가 앞서 일반 SELECT로 스냅샷을 만든 상태
(REPEATABLE READ)라면 잠금을 기다리는 사이 다른 관리자가 커밋한 확인을 보지 못하고 PENDING으로 판정해
이중 확인(이력 2건, order.submitted·감사 중복, 처리자 덮어쓰기)한다.

- 주문은 SELECT id, status, pickup_at … FOR UPDATE, 결제는 SELECT id, status, amount … FOR UPDATE의 결과로
  판정하고 findUniqueOrThrow를 지웠다. raw는 INT UNSIGNED를 bigint로 돌려줘 금액은 number로 바꿔 넘긴다.

테스트: 바깥 tx가 payment.count()로 스냅샷을 만든 사이 confirmPayment(ADMIN)가 커밋하고, 이어서 같은 tx에서
confirmPaymentLocked(AUTO)를 부르면 PAYMENT_NOT_PENDING이고 이력 1건·처리 경로 ADMIN이 유지되는지 1건 추가.
일관성 읽기로 되돌리면 두 번째 확인이 성공해 실패하는 것을 확인했다.
판매가 0원(MIN_SALE_PRICE 0) 상품의 주문은 결제 금액이 0원인데, 입금액 1 이상 검사와 금액 일치 검사가 겹쳐 어떤 입금액으로도 확인할 수 없어 입금 대기에 묶였다.

- adminConfirmPayment: 음수·비정수만 DEPOSIT_AMOUNT_INVALID, 0은 금액 일치 검사로 넘김
- 오류 메시지·SDL 설명·DTO 주석을 0 이상으로 정정
- 테스트: 0원 주문 입금액 0 접수, 30,000원 주문에 0은 DEPOSIT_AMOUNT_MISMATCH, 1.5는 DEPOSIT_AMOUNT_INVALID
feat: 입금 대기 주문과 관리자 수동 입금 확인
① 무엇·왜
- 입금 확인은 관리자 수동 처리라 1시간 안에 확인해야 한다. 새 입금 대기 주문과 구매자 '입금했어요'를 관리자 디스코드로 알려 목록을 계속 들여다보지 않아도 되게 한다.
- 업무 알림은 장애 경보와 같은 채널로 가므로 info 레벨 색으로 가르고, 주문별 key라 쌓이는 억제 기록은 창이 지나면 지운다.

② 변경점
- 이벤트: createOrder tx에 order.payment_pending(금액·입금자명·입금 기한), '입금했어요' tx에 payment.deposit_claimed. 둘 다 주문 aggregate라 상태 전이와 같은 파티션이다
- OrderAdminAlertConsumer(worker): deposit-pending:{orderId}·deposit-claim:{orderId} key, 금액(천 단위)·입금자명·입금 기한(KST)·처리 화면 링크(/tasks/deposits?orderId=). 상태를 바꾸지 않고 재전달 중복은 억제 창 안에서만 막는다
- AlertService: AlertLevel info(파랑), 웹훅이 없을 때 info는 일반 로그, notify 때 억제 창이 지난 key 삭제, 재전송은 더 새 시도가 있을 때만 건너뜀(창이 지나 key가 지워진 경우는 보냄)
- ADMIN_WEB_BASE_URL(선택, admin-web.config): 쿼리·해시 없는 http(s) 주소만, 끝 슬래시 제거, 틀리면 부팅 실패. app.module load 등록, README·infra/app.env.example·guide §8 갱신

③ 테스트
- 이벤트 payload·같은 tx·capacity 거절/replay 미발행, '입금했어요' 첫 누름만 1건(다시 누름·기한 지남·404는 0건)
- 소비자: 문구·key·딥링크, 주소 없으면 링크 없음, 같은 이벤트 재전달 1회·같은 주문의 다른 알림은 따로, 형식 오류·모르는 이벤트는 던짐
- AlertService: info 로그, 만료 key 정리, key가 지워진 뒤 재전송, 색 3종
- 반증: key 정리를 빼면 정리·재전송 테스트 2건, 재전송 조건을 되돌리면 재전송 테스트가 실패
- 설정 파싱 표(정규화 4·미설정 3)와 부팅 차단 반증 5
억제 창이 지난 key를 지우는 정리를 넣으면서, 재전송 직전 '더 새 시도가 있었는지'를 억제 창 맵으로 판정할 수 없게 됐다. 창이 재전송 간격보다 짧으면 새 시도가 성공한 뒤 다른 key 알림이 key를 지운 경우 묵은 경보가 다시 나갔다.

- key별 대기 재전송 타이머(pendingRetries)를 억제 창 맵과 따로 두고, 같은 key의 새 시도가 시작되면 취소
- 테스트: 창 1초, t=0 실패 → t=2 성공 → t=4 다른 key가 정리 → 재전송 없음
새 시도가 묵은 시도의 전송이 끝나기 전에 성공하면 취소할 대기 타이머가 아직 없어, 늦게 실패한 묵은 시도가 재전송을 예약했다(old, new, old).

- 전송 전에 key별 시도 번호(전역 증가)를 등록하고, 재전송 예약 직전·실행 직전에 최신인지 확인
- 억제 창 정리와 독립, 전송·재전송이 끝나면 번호를 지워 쌓이지 않음
- 대기 타이머 맵(pendingRetries)은 제거
- 테스트: 겹친 전송에서 재전송 없음·번호 정리(이전 구현에서 3회 호출로 실패 확인)
feat: 입금 대기·입금했어요 관리자 디스코드 알림
feat: 채팅 이미지 첨부와 주문 카드 메시지
① 무엇·왜
- 환불이 생기면 구매자가 돌려받을 계좌를 넣고(취소와 함께 넣을 수도 있다) 관리자가 송금한 뒤 완료로 기록한다. 계좌번호는 암호화해 두고 원문은 관리자 환불 상세에서만 푼다.
- 결제로 확인하지 않은 입금은 주문의 반환 대상으로 연결해 입금액 전액 환불을 만든다. 주문 상태와 관계없이 그 주문의 구매자에게 돌려주며 주문·결제·정산은 건드리지 않는다. 주인 모를 입금은 메모와 함께 종결 기록하고, 나중에 주인을 찾으면 같은 기록을 반환으로 바꿔 같은 돈이 두 번 기록되지 않게 한다.
- 진행 주문(입금 대기~제작 완료)이나 송금이 끝나지 않은 환불(종류 무관)이 있으면 구매자 탈퇴를 막는다. 탈퇴하면 환불 계좌를 받을 수 없다.
- 명세에 없던 결정: 종결 기록을 반환으로 바꾸는 mutation 이름은 adminLinkUnidentifiedDeposit, 오류는 DEPOSIT_RECORD_NOT_FOUND(404)·DEPOSIT_RECORD_ALREADY_LINKED(409). 환불 목록은 처리 순서(오래된 것부터), 입금 기록 목록은 최근 기록부터. 입금 기록 금액 하한(1원)을 기존 DEPOSIT_AMOUNT_INVALID로 거절하도록 메시지를 두 경로에 맞게 바꿨다.

② 변경점
- SDL: submitMyRefundAccount, CancelMyOrderInput.refundAccount(RefundAccountInput), MyOrderDetail.refunds, adminRefunds·adminRefund·adminDepositRecords, adminCompleteRefund·adminCreateDepositReturn·adminRecordUnidentifiedDeposit·adminLinkUnidentifiedDeposit, DepositRecordKindType, AdminTaskCounts.refundsAwaitingAccount·refundsAwaitingTransfer, deleteMyAccount 설명
- RefundRepository: 계좌 입력·덮어쓰기(환불 행 잠금, 송금 완료면 거절) → 송금 대기 + outbox refund.account_submitted, 송금 완료(송금 대기만) + 감사 REFUND + outbox refund.completed, 관리자 목록·상세
- DepositRecordRepository: 반환 연결(주문 잠금 → 입금 기록 → 환불 → refund.requested), 종결 기록, 종결 → 반환 전환(주문 → 입금 기록 잠금), 감사 DEPOSIT_RECORD
- OrderTransitionRepository.cancelLocked: 취소와 함께 받은 계좌로 환불을 바로 송금 대기로 만든다(환불이 없으면 버린다)
- 이벤트: refund.requested에 accountSubmitted(없던 이벤트는 false), refund.account_submitted·refund.completed 신설(공통 payload)
- 알림: 계좌가 이미 있는 refund.requested는 구매자 계좌 요청 대신 관리자 경보, refund.account_submitted도 관리자 경보(key refund-ready:{refundId}, info, /tasks/refunds 딥링크), refund.completed는 구매자 REFUND_COMPLETED 알림
- 탈퇴 차단: common 포트 WithdrawalBlockingOrderQuery(abstract class), order 구현 OrderWithdrawalBlockingRepository, auth는 첫 호출 때 ModuleRef(strict: false)로 찾고 ACCOUNT_HAS_ACTIVE_ORDERS(409, 건수)로 거절. guide §1(c)에 포트 추가
- 에러 7종(REFUND_NOT_FOUND·REFUND_NOT_READY·REFUND_ALREADY_COMPLETED·ACCOUNT_HAS_ACTIVE_ORDERS·DEPOSIT_NOTE_REQUIRED·DEPOSIT_RECORD_NOT_FOUND·DEPOSIT_RECORD_ALREADY_LINKED), 게이트: ADMIN_QUERY_COUNT 20, roles-coverage admin 74, enum-sdl-sync DepositRecordKind, module-wiring 탈퇴 차단 포트 resolve(api·ws·worker), 팩토리 createRefund

③ 테스트
- 관리자 환불: null 필터 = 전체·상태×종류 AND·키셋, 상세 원문 복호화·입금 기록, 송금 완료(처리자·메모·감사·구매자 알림), 계좌 입력 전·완료 뒤 거절과 무변경
- 입금 반환: 취소 환불과 공존·주문·결제·정산 불변, 주문 상태 6종 연결, 처리자 라벨 null 관리자, 입력 오류 6경우, 삭제된 주문
- 종결·전환: 메모 필수(빈 문자열·공백), 환불·이벤트 없음, 같은 기록 전환·감사 UPDATE, 이미 반환·없는 기록·없는 주문
- 구매자: 취소와 함께 계좌(송금 대기·암호문 복호화·accountSubmitted), 환불 없는 취소는 계좌를 버림, 계좌 형식 오류면 취소 안 함, 입력·덮어쓰기, 완료 뒤 거절, 남의·삭제된 주문 환불, 상세 refunds 순서
- 탈퇴: 상태 7종 표, 미완료 반환(계좌 입력 대기·송금 대기)·진행 주문 합산, 완료 뒤 허용·다른 구매자·삭제 주문 제외
- 소비자: 관리자 경보 key·문구·딥링크·계좌 없는 생성 미전송·억제 창, 구매자 완료 알림·계좌 있는 생성 미알림·재전달 멱등, 이벤트 파서 반증
- 반증: 탈퇴 차단 조건·OrderModule 포트 제공·계좌 있는 생성 건너뛰기를 지우면 해당 테스트 11건이 실패하는 것을 확인
feat: 환불 계좌 입력·환불 완료와 입금 반환·종결 기록, 탈퇴 차단
- 무엇·왜
  - 판매자 전용 전이 표를 주체 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 루트 필드 수 갱신.
feat: 노쇼 처리와 주문 자동 전이 크론, 관리자 픽업 완료
- 무엇·왜
  - 판매자가 접수·확정·제작 완료 주문의 픽업 일시를 바꾼다(커스텀 내용은 그대로). 검사는 영업일·특별휴무·슬롯 시각·
    지난 시각·예약 가능 기간·일일 제작 수량이고, 리드타임·상품 제작 시간은 보지 않는다. 숨긴 매장의 진행 주문도 옮길 수 있다.
  - 변경 이력을 남기고 구매자에게 '픽업 일시가 {M/d HH:mm}로 변경되었어요.' 알림을 보낸다. 접수 상태면 확정 마감을
    min(접수 + 24시간, 새 픽업)으로 다시 재고 미리 알림 표시를 지운다.
- 변경점
  - SDL: sellerRescheduleOrderPickup(input), sellerOrderPickupCalendar(orderId, yearMonth)·sellerOrderPickupTimeSlots(orderId, date),
    type OrderPickupChange { id fromPickupAt toPickupAt changedAt note }, Seller·Admin·MyOrderDetail.pickupChanges(오래된 순)
  - PICKUP_RESCHEDULE_NOT_ALLOWED·PICKUP_UNCHANGED(400) 신설, 수량·슬롯이 맞지 않으면 PICKUP_NOT_AVAILABLE
  - store: isPickupSlotAvailable에 leadTime 'APPLY'|'SKIP'·storeActiveOnly, 변경 시트용 rescheduleCalendar·rescheduleTimeSlots
    (리드타임 없음·숨긴 매장 허용·옮길 주문 점유 차감 bookedAdjustment)
  - order: capacity 재집계를 order-capacity.helper로 빼고 excludeOrderId 추가, OrderPickupChangeRepository(주문 → capacity 행
    FOR UPDATE, 이력·감사 ORDER/UPDATE·outbox order.pickup_rescheduled 같은 tx), 커밋 뒤 판매자 구독 kind PICKUP_RESCHEDULED
  - 확정 마감 계산을 confirmDeadlineFor 하나로 모아 입금 확인과 픽업 변경이 같이 쓴다
- 테스트
  - 상태 표(옮길 수 있음 3·불가 3·입금 대기/남의 주문 404), 같은 일시, 검사 5종(지난 시각·슬롯 정렬·영업시간·특별휴무·기간),
    오늘 남은 슬롯, 자기 수량 차감(같은 날)·다른 주문 점유 초과, 숨긴 매장, 마감 재계산·미리 알림 초기화·도입 전 주문 불변,
    잠금 전 삭제 경합, 변경 시트 달력·슬롯, store 판정(SKIP·숨긴 매장·차감 반증), 구매자 알림·이벤트 파서, 상세 3곳 이력
  - 반증: excludeOrderId·leadTime SKIP·storeActiveOnly를 되돌리면 해당 테스트가 실패함을 확인
기본 격리(REPEATABLE READ)에서는 잠금 SQL의 품목 서브쿼리·품목 조회가 스냅샷을 먼저 잡는다.
그래서 order_store_daily_limit 잠금을 기다렸다 받은 뒤의 점유 재집계가 그사이 커밋된 주문 생성·픽업 변경을 보지 못하고 일일 제작 수량을 넘겨 통과했다.
주문 생성(createPendingPaymentOrder)처럼 READ COMMITTED를 명시한다.

- OrderPickupChangeRepository.reschedule: $transaction에 isolationLevel ReadCommitted(본문은 들여쓰기만 바뀜)
- order-capacity.helper: forUpdate가 READ COMMITTED tx에서만 직렬화한다고 주석 정정
- 회귀 테스트 1건: capacity 2·점유 1에서 다른 tx가 9/17 capacity 행을 잡고 주문 하나를 옮긴 채(미커밋) 픽업 변경이 잠금을 기다리게 한 뒤 커밋하면 PICKUP_NOT_AVAILABLE, 픽업·이력 불변
- 반증: 격리 수준을 빼면 픽업 변경이 성공해(3/2 점유) 테스트가 실패한다.
- 잠금 대기 관측은 innodb_trx 캐시(직전 읽기 뒤 100ms 안에는 갱신 안 함) 때문에 150ms 간격으로 읽는다.
- src/features/order 57 스위트 1,410건 통과.
판매자 픽업 변경 달력은 자기 점유만 빼고 공용 판정(booked >= capacity, 한 건 더 들어가는지)을 써서, 수량 2 주문을 남은 자리 1인 날짜로 옮길 수 있다고 보여 주고 실제 변경은 PICKUP_NOT_AVAILABLE로 실패했다.

- 공용 판정 입력에 required(이 날짜에 더 들어가야 하는 수량, 기본 1)를 더해 booked + required > capacity로 판정. 기본 1은 기존과 같다
- 픽업 변경 달력·슬롯은 required = 옮길 주문의 수량
- 테스트: 수량 2 주문에서 capacity 2·예약 1 날짜는 소진(슬롯 전부 마감), capacity 3·예약 1 날짜는 선택 가능. 이전 코드에서 실패 확인
feat: 판매자 픽업 일시 변경과 변경 시트 달력·슬롯
정산이 확정된 주문(픽업 완료·노쇼·구매자 사정 취소의 남은 금액)을 worker가 매주 월요일 05:00(KST)과 부팅 때 지난주(월~일)까지 확정분으로 매장별 정산(PENDING)에 묶는다. 관리자는 은행 앱에서 송금한 뒤 송금 완료로 처리하고 월 수수료를 매장별로 본다. 판매자는 정산 내역과 주문 상세의 수수료율·정산 예정 금액을 본다. 주간 정산 생성은 관리자 디스코드에 주 단위로 한 번 알린다.

변경점
- 주간 정산: SettlementRepository.createWeeklySettlement가 매장마다 별도 tx에서 대상 주문(settlement_finalized_at < 이번 주 월요일 00:00 KST ∧ settlement_id 없음 ∧ 기준액 > 0, raw SQL에 deleted_at 직접)을 id 순 FOR UPDATE로 잡고 다시 고른 뒤, 정산 행·주문 settlement_id·outbox settlement.created를 같은 tx에 남긴다. (store_id, period_start) 정산이 이미 있으면 건너뛰어 재실행이 멱등이고, 그때 남은 주문은 다음 주 정산에 묶인다. 매장은 첫 품목(남은 품목 중 최소 id), 매장명은 가장 최근 주문의 스냅샷
- SettlementScheduler: 월 05:00 KST 크론 + worker 부팅 1회, 역할 게이트(부팅 훅은 전 역할에서 돌아 필수), 겹친 실행 건너뜀, 매장별 실패는 다른 매장을 막지 않고 warn 경보(key order-cron:weekly-settlement)
- 관리자: adminSettlements(status·storeId·periodStart 필터, null = 전체, 계좌 등록 여부), adminSettlement(포함 주문·현재 계좌 원문·송금 계좌 끝 4자리·처리자 라벨), adminMarkSettlementPaid(PENDING → PAID, 그때 매장 정산 계좌를 paid_*에 스냅샷, 감사 SETTLEMENT는 끝 4자리만), adminMonthlyCommissions(확정 시각의 KST 월로 매장별 건수·기준액·수수료)
- 판매자: sellerSettlements(내 매장, 키셋)·sellerSettlement(포함 주문·송금 계좌 끝 4자리)
- 주문 상세: SellerOrderDetail·AdminOrderDetail에 commissionRateBps·expectedPayoutAmount·settlementBaseAmount·commissionAmount, 관리자는 settlementFinalizedAt·settlementId도. 정산 예정 금액은 확정 뒤 실제 지급액, 확정 전 결제액 − 수수료(원 미만 버림), 미입금 null, 확정 없이 취소된 주문 0
- adminTaskCounts.pendingSettlements(환불 대기 두 필드와 함께), OrderAdminAlertConsumer가 settlement.created를 info·key settlement-week:{periodStart}·/tasks/settlements?periodStart= 링크로 보낸다
- 오류: SETTLEMENT_NOT_FOUND(404)·SETTLEMENT_ALREADY_PAID(409)·SETTLEMENT_ACCOUNT_REQUIRED(400). SDL SettlementStatusType·SettlementOrder·SettlementPaidAccount, kst-time에 kstWeekStart·formatDateOnly
- 게이트: ADMIN_QUERY_COUNT 20 → 22(필수 형식 입력 month는 필드 이름 최소값 표로 유효값), roles-coverage 판매자 63 → 65·관리자 75 → 79, enum-sdl-sync에 SettlementStatus. 팩토리 createFinalizedOrder·createSettlement

테스트
- 주간 정산 14건(real DB): 일 23:59:59.999 포함·월 00:00 다음 주, 실행 시각 일 23:59:59.999면 전주, 재실행 멱등, 같은 주 정산이 있으면 늦은 주문은 다음 주로, 묵은 주문, 미확정·기준액 0·이미 정산·주문 삭제·품목 전부 삭제 제외, 적재 뒤 tx 실패 시 정산·연결·이벤트 모두 없음, 매장별 실패 격리, 후보 조회 실패 경보, 겹친 실행, api·ws 부팅·크론 미실행
- 관리자 정산 23건: 목록 커서·계좌 등록 여부, 필터 AND·null = 전체, 형식 오류, 송금 완료 스냅샷·감사·이후 계좌 변경, 이미 송금 409·동시 2회, 계좌 미등록, 감사 실패 롤백, 월 경계(10/31 23:59:59.999·11/1 00:00·11/30 23:59:59.999·12/1 00:00)·삭제 제외·최근 매장명
- 판매자 정산 3건, 정산 예정 금액 표 7건, 주문 상세 2건, 경보 key·링크·주 1회 3건, 이벤트 9건, kstWeekStart 4건·formatDateOnly 1건, 리졸버 1건
- 반증: tx 밖 적재·경계 <=·부팅 역할 게이트 제거·판매자 매장 범위 제거가 각각 해당 테스트를 실패시키는 것을 확인하고 되돌렸다
- 무엇·왜
  - 월 집계 매장명은 SDL 설명대로 '그 달 가장 최근 확정 주문의 스냅샷'이어야 하는데, 윈도 정렬이 주문 id라 먼저 생성되고 늦게 확정된 주문의 이름을 놓쳤다.
- 변경점
  - monthlyCommissions의 FIRST_VALUE 정렬을 settlement_finalized_at DESC, id DESC로 바꿈(같은 시각이면 최근 주문)
- 테스트
  - 생성 순서와 확정 순서가 엇갈린 같은 매장 주문 2건에서 늦게 확정된 주문의 이름이 나오는지 확인. id 정렬로 되돌리면 실패
  - 같은 주 정산이 이미 있어 건너뛸 때·재실행 때 경보가 나가지 않는지 단언 추가. 기존 정산 가드를 빼면 실패
플랜 7절 크론 공통 규칙(후보 id만 고른 뒤 배치 100, 상한 1000)을 SettlementScheduler에도 적용한다. 이전에는 후보 매장을 한 번에 전부 읽었다. 상한에 걸려 남은 매장은 다음 실행(부팅 1회·다음 주 크론)에서 정산되고, 정산 생성은 (store_id, period_start) 기준으로 멱등(같은 기간 정산이 있으면 건너뜀 + uk_settlement_store_period)이라 재실행이 안전하다. 다음 주 크론까지 밀리면 그 매장의 남은 주문은 다음 주 정산에 함께 묶인다(묵은 주문).

변경점
- SettlementRepository.findUnsettledStoreIds: (before, afterStoreId, limit) 키셋 한 페이지(store_id 오름차순, LIMIT)
- SettlementScheduler: SETTLEMENT_BATCH_SIZE 100·SETTLEMENT_MAX_PER_RUN 1000. 후보를 store_id 키셋으로 넘기며 매장마다 기존 별도 tx(FOR UPDATE → 재검사 → 정산 생성)를 연다. 실패한 매장은 키셋이 지나가 같은 실행에서 다시 잡지 않는다
- 상한에 닿으면 남은 매장이 있는지 1곳만 더 보고, 있으면 warn 로그(경보 아님)로 다음 매장 id를 남긴다
- settleLastWeek(limits)는 테스트만 작은 값을 넘긴다. 크론·부팅은 기본값(100·1000)

테스트
- 배치 경계 2건(real DB, 운영 값): 후보 100곳·101곳이 100곳씩 두 쪽으로 나뉘고(두 번째 쪽 afterStoreId = 100번째 매장) 모두 정산, 경고 없음
- 운영 상한 1건: 배치 100·상한 1000 단언, 후보 1050곳에서 1000곳만 처리하고 남은 매장 확인 1회와 경고(조회·생성은 stub)
- 상한 2건(real DB, 배치 2·상한 5): 7곳 중 id 순 5곳만 정산·경고·경보 없음, 다음 실행에서 남은 2곳을 같은 주로 정산(정산·이벤트 7건). 후보가 상한과 같으면 경고 없음
- 키셋 1건(real DB): 주문 id 순과 어긋난 매장 id 오름차순, 실패한 첫 매장은 같은 실행에서 다시 잡지 않음
- 반증: 상한 가드 제거·SQL LIMIT 제거·스케줄러 배치 제거·키셋 조건 제거·경고 제거가 각각 위 테스트를 실패시키는 것을 확인하고 되돌렸다
feat: 주간 정산·월 수수료 집계와 판매자 정산 조회
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Nov 18, 2026 •

Copy link
Copy Markdown
Codex Review Summary: ✅ Completed

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-11-18T22:57:21.916432Z b2ee9d3 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@coderabbitai

coderabbitai Bot commented Nov 18, 2026

Copy link
Copy Markdown

Important

Review skipped

Too many files!

This PR contains 397 files, which is 297 over the limit of 100.

To get a review, reduce the PR to 100 files or fewer by splitting it into smaller PRs or changing its base branch.

Upgrade to a paid plan to raise the limit.

Usage-priced reviews support at most 300 files.

Run configuration

Commits

Reviewing files that changed from the base of the PR and between 130b831 and b2ee9d3.

Files ignored due to path filters: 14

  • assets/custom-3d-catalog/v1/deco/number-0.png is excluded by !**/*.png
  • assets/custom-3d-catalog/v1/deco/number-1.png is excluded by !**/*.png
  • assets/custom-3d-catalog/v1/deco/number-2.png is excluded by !**/*.png
  • assets/custom-3d-catalog/v1/deco/number-3.png is excluded by !**/*.png
  • assets/custom-3d-catalog/v1/deco/number-4.png is excluded by !**/*.png
  • assets/custom-3d-catalog/v1/deco/number-5.png is excluded by !**/*.png
  • assets/custom-3d-catalog/v1/deco/number-6.png is excluded by !**/*.png
  • assets/custom-3d-catalog/v1/deco/number-7.png is excluded by !**/*.png
  • assets/custom-3d-catalog/v1/design/drip.png is excluded by !**/*.png
  • assets/custom-3d-catalog/v1/design/heart.png is excluded by !**/*.png
  • assets/custom-3d-catalog/v1/design/phrase.png is excluded by !**/*.png
  • assets/custom-3d-catalog/v1/design/sparkle.png is excluded by !**/*.png
  • assets/custom-3d-catalog/v1/design/wave.png is excluded by !**/*.png
  • yarn.lock is excluded by !**/yarn.lock, !**/*.lock
Files selected for processing: 397

  • Dockerfile
  • README.en.md
  • README.md
  • docs/guide/architecture-conventions.md
  • infra/app.env.example
  • infra/runbook.md
  • package.json
  • prisma/migrations/20261118150004_order_payment_schema/migration.sql
  • prisma/migrations/20261118155816_custom_product_settings/migration.sql
  • prisma/migrations/20261118170655_option_item_three_d_key/migration.sql
  • prisma/migrations/20261118182831_order_custom_snapshot/migration.sql
  • prisma/migrations/20261118190324_order_custom_upload/migration.sql
  • prisma/migrations/20261118203227_conversation_image_order_card/migration.sql
  • prisma/schema.prisma
  • prisma/seed.ts
  • prisma/seed/admins.ts
  • prisma/seed/idempotent.ts
  • prisma/seed/orders.ts
  • prisma/seed/payments.ts
  • prisma/seed/reviews.ts
  • scripts/accounts-reencrypt-args.ts
  • scripts/accounts-reencrypt.spec.ts
  • scripts/accounts-reencrypt.ts
  • scripts/catalog-upload-plan.ts
  • scripts/catalog-upload.spec.ts
  • scripts/catalog-upload.ts
  • src/app.module.ts
  • src/common/errors/error-catalog.spec.ts
  • src/common/errors/error-catalog.ts
  • src/common/ports/withdrawal-blocking-order.port.ts
  • src/common/utils/kst-time.spec.ts
  • src/common/utils/kst-time.ts
  • src/common/utils/prisma-error.spec.ts
  • src/common/utils/prisma-error.ts
  • src/common/utils/text-cleaner.ts
  • src/config/account-crypto.config.spec.ts
  • src/config/account-crypto.config.ts
  • src/config/admin-web.config.spec.ts
  • src/config/admin-web.config.ts
  • src/features/audit-log/audit-log.types.graphql
  • src/features/audit-log/constants/audit-log.constants.ts
  • src/features/auth/auth-user-profile.graphql
  • src/features/auth/resolvers/auth-user-profile.resolver.spec.ts
  • src/features/auth/services/auth-user-profile.service.spec.ts
  • src/features/auth/services/auth-user-profile.service.ts
  • src/features/conversation/constants/conversation.constants.ts
  • src/features/conversation/conversation-inquiry.graphql
  • src/features/conversation/conversation-seller.graphql
  • src/features/conversation/conversation.module.ts
  • src/features/conversation/conversation.types.graphql
  • src/features/conversation/dto/inputs/seller-send-conversation-message.input.spec.ts
  • src/features/conversation/dto/inputs/seller-send-conversation-message.input.ts
  • src/features/conversation/dto/inputs/send-conversation-image-message.input.spec.ts
  • src/features/conversation/dto/inputs/send-conversation-image-message.input.ts
  • src/features/conversation/repositories/conversation.repository.ts
  • src/features/conversation/resolvers/conversation-center.resolver.spec.ts
  • src/features/conversation/resolvers/conversation-inquiry-mutation.resolver.ts
  • src/features/conversation/resolvers/conversation-inquiry.resolver.spec.ts
  • src/features/conversation/resolvers/conversation-seller.resolver.spec.ts
  • src/features/conversation/services/conversation-attachment.helper.ts
  • src/features/conversation/services/conversation-center-mappers.helper.spec.ts
  • src/features/conversation/services/conversation-center-mappers.helper.ts
  • src/features/conversation/services/conversation-events-mappers.helper.spec.ts
  • src/features/conversation/services/conversation-events-mappers.helper.ts
  • src/features/conversation/services/conversation-events.service.spec.ts
  • src/features/conversation/services/conversation-inquiry-mappers.helper.spec.ts
  • src/features/conversation/services/conversation-inquiry-mappers.helper.ts
  • src/features/conversation/services/conversation-inquiry.service.spec.ts
  • src/features/conversation/services/conversation-inquiry.service.ts
  • src/features/conversation/services/conversation-seller.service.spec.ts
  • src/features/conversation/services/conversation-seller.service.ts
  • src/features/conversation/services/conversation-subscription.service.spec.ts
  • src/features/conversation/types/conversation-output.type.ts
  • src/features/conversation/types/conversation-seller-output.type.ts
  • src/features/dashboard/constants/dashboard.constants.ts
  • src/features/dashboard/dashboard-admin.graphql
  • src/features/dashboard/dashboard-seller.graphql
  • src/features/dashboard/services/dashboard-admin.service.spec.ts
  • src/features/dashboard/services/dashboard-seller.service.spec.ts
  • src/features/dashboard/services/dashboard-seller.service.ts
  • src/features/dashboard/types/dashboard-admin-output.type.ts
  • src/features/dashboard/types/dashboard-seller-output.type.ts
  • src/features/mypage/mypage-overview.graphql
  • src/features/mypage/services/mypage-overview.service.spec.ts
  • src/features/mypage/services/mypage-review.service.spec.ts
  • src/features/notification/constants/notification-messages.ts
  • src/features/notification/notification.types.graphql
  • src/features/notification/services/notification-outbox.consumer.spec.ts
  • src/features/notification/services/notification-outbox.consumer.ts
  • src/features/notification/services/notification-payloads.helper.spec.ts
  • src/features/notification/services/notification-payloads.helper.ts
  • src/features/notification/services/seller-push-messages.helper.spec.ts
  • src/features/notification/services/seller-push-messages.helper.ts
  • src/features/notification/services/seller-push-outbox.consumer.spec.ts
  • src/features/notification/services/seller-push-outbox.consumer.ts
  • src/features/order/constants/order-admin.constants.ts
  • src/features/order/constants/order-cancel-reasons.ts
  • src/features/order/constants/order-custom-upload-purposes.ts
  • src/features/order/constants/order-status-traits.spec.ts
  • src/features/order/constants/order-status-traits.ts
  • src/features/order/constants/payment-banks.ts
  • src/features/order/dto/inputs/admin-cancel-order.input.ts
  • src/features/order/dto/inputs/admin-complete-order-pickup.input.ts
  • src/features/order/dto/inputs/admin-complete-refund.input.ts
  • src/features/order/dto/inputs/admin-confirm-payment.input.ts
  • src/features/order/dto/inputs/admin-create-deposit-return.input.ts
  • src/features/order/dto/inputs/admin-deposit-record-list.input.ts
  • src/features/order/dto/inputs/admin-link-unidentified-deposit.input.ts
  • src/features/order/dto/inputs/admin-mark-settlement-paid.input.ts
  • src/features/order/dto/inputs/admin-monthly-commission.input.ts
  • src/features/order/dto/inputs/admin-order-list.input.spec.ts
  • src/features/order/dto/inputs/admin-order-list.input.ts
  • src/features/order/dto/inputs/admin-pending-payment-list.input.ts
  • src/features/order/dto/inputs/admin-record-unidentified-deposit.input.ts
  • src/features/order/dto/inputs/admin-refund-list.input.ts
  • src/features/order/dto/inputs/admin-settlement-list.input.ts
  • src/features/order/dto/inputs/admin-update-payment-setting.input.spec.ts
  • src/features/order/dto/inputs/admin-update-payment-setting.input.ts
  • src/features/order/dto/inputs/admin-upsert-store-settlement-account.input.spec.ts
  • src/features/order/dto/inputs/admin-upsert-store-settlement-account.input.ts
  • src/features/order/dto/inputs/cancel-my-order.input.ts
  • src/features/order/dto/inputs/create-order-custom.input.ts
  • src/features/order/dto/inputs/create-order.input.spec.ts
  • src/features/order/dto/inputs/create-order.input.ts
  • src/features/order/dto/inputs/refund-account.input.ts
  • src/features/order/dto/inputs/seller-cancel-order.input.ts
  • src/features/order/dto/inputs/seller-order-list.input.spec.ts
  • src/features/order/dto/inputs/seller-order-list.input.ts
  • src/features/order/dto/inputs/seller-reschedule-order-pickup.input.ts
  • src/features/order/dto/inputs/seller-settlement-list.input.ts
  • src/features/order/dto/inputs/seller-update-order-status.input.spec.ts
  • src/features/order/dto/inputs/seller-update-order-status.input.ts
  • src/features/order/dto/inputs/seller-upsert-settlement-account.input.ts
  • src/features/order/dto/inputs/submit-my-refund-account.input.ts
  • src/features/order/events/order-confirm-reminder-due.event.spec.ts
  • src/features/order/events/order-confirm-reminder-due.event.ts
  • src/features/order/events/order-payment-pending.event.spec.ts
  • src/features/order/events/order-payment-pending.event.ts
  • src/features/order/events/order-pickup-rescheduled.event.spec.ts
  • src/features/order/events/order-pickup-rescheduled.event.ts
  • src/features/order/events/order-status-changed.event.spec.ts
  • src/features/order/events/order-status-changed.event.ts
  • src/features/order/events/order-submitted.event.spec.ts
  • src/features/order/events/order-submitted.event.ts
  • src/features/order/events/payment-deposit-claimed.event.spec.ts
  • src/features/order/events/payment-deposit-claimed.event.ts
  • src/features/order/events/refund-account-submitted.event.ts
  • src/features/order/events/refund-completed.event.ts
  • src/features/order/events/refund-requested.event.spec.ts
  • src/features/order/events/refund-requested.event.ts
  • src/features/order/events/settlement-created.event.spec.ts
  • src/features/order/events/settlement-created.event.ts
  • src/features/order/index.ts
  • src/features/order/order-admin.graphql
  • src/features/order/order-checkout.graphql
  • src/features/order/order-deposit-admin.graphql
  • src/features/order/order-my.graphql
  • src/features/order/order-payment-admin.graphql
  • src/features/order/order-payment.graphql
  • src/features/order/order-refund-admin.graphql
  • src/features/order/order-seller-pickup.graphql
  • src/features/order/order-seller.graphql
  • src/features/order/order-settlement-admin.graphql
  • src/features/order/order-settlement-seller.graphql
  • src/features/order/order-subscription.graphql
  • src/features/order/order.module.ts
  • src/features/order/order.types.graphql
  • src/features/order/policies/order-cancel.policy.spec.ts
  • src/features/order/policies/order-cancel.policy.ts
  • src/features/order/policies/order-lifecycle.policy.spec.ts
  • src/features/order/policies/order-lifecycle.policy.ts
  • src/features/order/policies/order-status-transition.policy.spec.ts
  • src/features/order/policies/order-status-transition.policy.ts
  • src/features/order/policies/payment-confirm.policy.spec.ts
  • src/features/order/policies/payment-confirm.policy.ts
  • src/features/order/repositories/account-number-reencrypt.repository.spec.ts
  • src/features/order/repositories/account-number-reencrypt.repository.ts
  • src/features/order/repositories/deposit-record.repository.ts
  • src/features/order/repositories/order-capacity.helper.ts
  • src/features/order/repositories/order-custom-snapshot.migration.spec.ts
  • src/features/order/repositories/order-custom-upload-attach.helper.ts
  • src/features/order/repositories/order-custom-upload.repository.ts
  • src/features/order/repositories/order-inquiry.repository.spec.ts
  • src/features/order/repositories/order-inquiry.repository.ts
  • src/features/order/repositories/order-lifecycle.repository.ts
  • src/features/order/repositories/order-payment-schema.migration.spec.ts
  • src/features/order/repositories/order-pending-payment-lock.helper.ts
  • src/features/order/repositories/order-pickup-change.repository.ts
  • src/features/order/repositories/order-settlement-finalizer.helper.spec.ts
  • src/features/order/repositories/order-settlement-finalizer.helper.ts
  • src/features/order/repositories/order-transition.repository.spec.ts
  • src/features/order/repositories/order-transition.repository.ts
  • src/features/order/repositories/order-withdrawal-blocking.repository.ts
  • src/features/order/repositories/order.repository.spec.ts
  • src/features/order/repositories/order.repository.ts
  • src/features/order/repositories/payment-setting.repository.ts
  • src/features/order/repositories/payment.repository.ts
  • src/features/order/repositories/refund.repository.ts
  • src/features/order/repositories/settlement.repository.ts
  • src/features/order/repositories/store-settlement-account.repository.ts
  • src/features/order/resolvers/order-admin-mutation.resolver.ts
  • src/features/order/resolvers/order-admin-query.resolver.ts
  • src/features/order/resolvers/order-admin.resolver.spec.ts
  • src/features/order/resolvers/order-checkout-mutation.resolver.spec.ts
  • src/features/order/resolvers/order-checkout-mutation.resolver.ts
  • src/features/order/resolvers/order-deposit-admin-mutation.resolver.ts
  • src/features/order/resolvers/order-deposit-admin-query.resolver.ts
  • src/features/order/resolvers/order-deposit-admin.resolver.spec.ts
  • src/features/order/resolvers/order-my-mutation.resolver.ts
  • src/features/order/resolvers/order-my.resolver.spec.ts
  • src/features/order/resolvers/order-payment-admin-mutation.resolver.ts
  • src/features/order/resolvers/order-payment-admin-query.resolver.ts
  • src/features/order/resolvers/order-payment-query.resolver.ts
  • src/features/order/resolvers/order-payment.resolver.spec.ts
  • src/features/order/resolvers/order-refund-admin-mutation.resolver.ts
  • src/features/order/resolvers/order-refund-admin-query.resolver.ts
  • src/features/order/resolvers/order-refund-admin.resolver.spec.ts
  • src/features/order/resolvers/order-seller-mutation.resolver.ts
  • src/features/order/resolvers/order-seller-pickup-mutation.resolver.ts
  • src/features/order/resolvers/order-seller-pickup-query.resolver.ts
  • src/features/order/resolvers/order-seller-pickup.resolver.spec.ts
  • src/features/order/resolvers/order-seller.resolver.spec.ts
  • src/features/order/resolvers/order-settlement-admin-mutation.resolver.ts
  • src/features/order/resolvers/order-settlement-admin-query.resolver.ts
  • src/features/order/resolvers/order-settlement-seller-mutation.resolver.ts
  • src/features/order/resolvers/order-settlement-seller-query.resolver.ts
  • src/features/order/resolvers/order-settlement.resolver.spec.ts
  • src/features/order/services/order-admin-alert-messages.helper.ts
  • src/features/order/services/order-admin-alert.consumer.spec.ts
  • src/features/order/services/order-admin-alert.consumer.ts
  • src/features/order/services/order-admin-mappers.helper.ts
  • src/features/order/services/order-admin.service.spec.ts
  • src/features/order/services/order-admin.service.ts
  • src/features/order/services/order-bank-account.helper.spec.ts
  • src/features/order/services/order-bank-account.helper.ts
  • src/features/order/services/order-checkout.service.custom.spec.ts
  • src/features/order/services/order-checkout.service.spec.ts
  • src/features/order/services/order-checkout.service.ts
  • src/features/order/services/order-custom-design.helper.spec.ts
  • src/features/order/services/order-custom-design.helper.ts
  • src/features/order/services/order-custom-upload-cleanup.scheduler.spec.ts
  • src/features/order/services/order-custom-upload-cleanup.scheduler.ts
  • src/features/order/services/order-customization.service.spec.ts
  • src/features/order/services/order-customization.service.ts
  • src/features/order/services/order-deposit-admin.service.spec.ts
  • src/features/order/services/order-deposit-admin.service.ts
  • src/features/order/services/order-events-mappers.helper.ts
  • src/features/order/services/order-events.service.spec.ts
  • src/features/order/services/order-events.service.ts
  • src/features/order/services/order-input-hash.helper.spec.ts
  • src/features/order/services/order-input-hash.helper.ts
  • src/features/order/services/order-lifecycle.scheduler.spec.ts
  • src/features/order/services/order-lifecycle.scheduler.ts
  • src/features/order/services/order-my.service.spec.ts
  • src/features/order/services/order-my.service.ts
  • src/features/order/services/order-output-mappers.helper.spec.ts
  • src/features/order/services/order-output-mappers.helper.ts
  • src/features/order/services/order-payment-admin.service.spec.ts
  • src/features/order/services/order-payment-admin.service.ts
  • src/features/order/services/order-payment-mappers.helper.ts
  • src/features/order/services/order-refund-admin.service.spec.ts
  • src/features/order/services/order-refund-admin.service.ts
  • src/features/order/services/order-refund-mappers.helper.ts
  • src/features/order/services/order-seller-mappers.helper.ts
  • src/features/order/services/order-seller-pickup.service.spec.ts
  • src/features/order/services/order-seller-pickup.service.ts
  • src/features/order/services/order-seller.service.spec.ts
  • src/features/order/services/order-seller.service.ts
  • src/features/order/services/order-settlement-admin.service.spec.ts
  • src/features/order/services/order-settlement-admin.service.ts
  • src/features/order/services/order-settlement-mappers.helper.spec.ts
  • src/features/order/services/order-settlement-mappers.helper.ts
  • src/features/order/services/order-settlement-seller.service.spec.ts
  • src/features/order/services/order-settlement-seller.service.ts
  • src/features/order/services/order-settlement.scheduler.spec.ts
  • src/features/order/services/order-settlement.scheduler.ts
  • src/features/order/services/order-subscription.service.spec.ts
  • src/features/order/services/order-subscription.service.ts
  • src/features/order/types/create-order-output.type.ts
  • src/features/order/types/order-admin-output.type.ts
  • src/features/order/types/order-my-output.type.ts
  • src/features/order/types/order-output.type.ts
  • src/features/order/types/order-payment-output.type.ts
  • src/features/order/types/order-refund-output.type.ts
  • src/features/order/types/order-seller-output.type.ts
  • src/features/order/types/order-settlement-output.type.ts
  • src/features/product/constants/custom-3d-catalog.constants.spec.ts
  • src/features/product/constants/custom-3d-catalog.constants.ts
  • src/features/product/constants/product-seller.constants.ts
  • src/features/product/dto/inputs/admin-create-upload-url.input.spec.ts
  • src/features/product/dto/inputs/seller-create-option-group.input.spec.ts
  • src/features/product/dto/inputs/seller-create-option-group.input.ts
  • src/features/product/dto/inputs/seller-create-option-item.input.ts
  • src/features/product/dto/inputs/seller-create-product.input.ts
  • src/features/product/dto/inputs/seller-create-upload-url.input.spec.ts
  • src/features/product/dto/inputs/seller-create-upload-url.input.ts
  • src/features/product/dto/inputs/seller-set-product-custom-template-active.input.spec.ts
  • src/features/product/dto/inputs/seller-set-product-custom-template-active.input.ts
  • src/features/product/dto/inputs/seller-update-option-group.input.ts
  • src/features/product/dto/inputs/seller-update-option-item.input.ts
  • src/features/product/dto/inputs/seller-update-product.input.ts
  • src/features/product/dto/inputs/seller-upsert-product-custom-template.input.spec.ts
  • src/features/product/dto/inputs/seller-upsert-product-custom-template.input.ts
  • src/features/product/dto/inputs/seller-upsert-product-custom-text-token.input.spec.ts
  • src/features/product/dto/inputs/seller-upsert-product-custom-text-token.input.ts
  • src/features/product/index.ts
  • src/features/product/product-admin.graphql
  • src/features/product/product-custom-catalog.graphql
  • src/features/product/product-detail.graphql
  • src/features/product/product-seller-upload.graphql
  • src/features/product/product-seller.graphql
  • src/features/product/product-upload.types.graphql
  • src/features/product/product.module.ts
  • src/features/product/product.types.graphql
  • src/features/product/repositories/custom-product-settings.migration.spec.ts
  • src/features/product/repositories/product-admin.repository.ts
  • src/features/product/repositories/product.repository.spec.ts
  • src/features/product/repositories/product.repository.ts
  • src/features/product/resolvers/product-custom-catalog-query.resolver.spec.ts
  • src/features/product/resolvers/product-custom-catalog-query.resolver.ts
  • src/features/product/resolvers/product-home-query.resolver.spec.ts
  • src/features/product/resolvers/product-seller-mutation.resolver.ts
  • src/features/product/resolvers/product-seller.resolver.spec.ts
  • src/features/product/services/custom-3d-preset.helper.ts
  • src/features/product/services/custom-order-input.helper.spec.ts
  • src/features/product/services/custom-order-input.helper.ts
  • src/features/product/services/product-admin-mappers.helper.ts
  • src/features/product/services/product-admin.service.spec.ts
  • src/features/product/services/product-custom-catalog.service.ts
  • src/features/product/services/product-custom-readiness.helper.spec.ts
  • src/features/product/services/product-custom-readiness.helper.ts
  • src/features/product/services/product-detail-mappers.helper.ts
  • src/features/product/services/product-detail.service.spec.ts
  • src/features/product/services/product-home.service.spec.ts
  • src/features/product/services/product-seller-custom-template.service.spec.ts
  • src/features/product/services/product-seller-custom-template.service.ts
  • src/features/product/services/product-seller-lifecycle.service.spec.ts
  • src/features/product/services/product-seller-lifecycle.service.ts
  • src/features/product/services/product-seller-mappers.helper.ts
  • src/features/product/services/product-seller-option.service.spec.ts
  • src/features/product/services/product-seller-option.service.ts
  • src/features/product/services/product-seller-query.service.spec.ts
  • src/features/product/services/three-d-design.helper.spec.ts
  • src/features/product/services/three-d-design.helper.ts
  • src/features/product/types/product-admin-output.type.ts
  • src/features/product/types/product-custom-catalog-output.type.ts
  • src/features/product/types/product-detail-output.type.ts
  • src/features/product/types/product-seller-output.type.ts
  • src/features/review/repositories/review-order-item-snapshot.helper.ts
  • src/features/review/repositories/review-order-item-snapshot.migration.spec.ts
  • src/features/store/constants/store-ranking.constants.ts
  • src/features/store/dto/inputs/seller-audit-log-list.input.spec.ts
  • src/features/store/index.ts
  • src/features/store/repositories/store-admin.repository.ts
  • src/features/store/repositories/store-catalog-query.repository.interface.ts
  • src/features/store/repositories/store-catalog-query.repository.spec.ts
  • src/features/store/repositories/store-catalog-query.repository.ts
  • src/features/store/repositories/store-stats.repository.spec.ts
  • src/features/store/repositories/store.repository.ts
  • src/features/store/resolvers/store-pickup-schedule-query.resolver.spec.ts
  • src/features/store/resolvers/store-pickup-schedule-query.resolver.ts
  • src/features/store/services/store-pickup-policy.helper.spec.ts
  • src/features/store/services/store-pickup-policy.helper.ts
  • src/features/store/services/store-pickup-schedule.service.spec.ts
  • src/features/store/services/store-pickup-schedule.service.ts
  • src/features/store/services/store-seller-audit.service.spec.ts
  • src/features/store/services/store-seller-audit.service.ts
  • src/features/store/store-pickup-schedule.graphql
  • src/features/store/store-seller-audit.graphql
  • src/global/alerting/alert.service.spec.ts
  • src/global/alerting/alert.service.ts
  • src/global/alerting/discord-webhook.spec.ts
  • src/global/alerting/discord-webhook.ts
  • src/global/alerting/index.ts
  • src/global/crypto/account-cipher.service.spec.ts
  • src/global/crypto/account-cipher.service.ts
  • src/global/crypto/crypto.module.ts
  • src/global/storage/constants/storage.constants.ts
  • src/global/storage/s3.service.delete-objects.spec.ts
  • src/global/storage/s3.service.read-image-size.spec.ts
  • src/global/storage/s3.service.spec.ts
  • src/global/storage/s3.service.ts
  • src/global/storage/types/storage.types.ts
  • src/graphql/removed-schema-elements.spec.ts
  • src/test/account-cipher.ts
  • src/test/admin-query-null-inputs.spec.ts
  • src/test/enum-sdl-sync.spec.ts
  • src/test/factories/custom-template.factory.ts
  • src/test/factories/index.ts
  • src/test/factories/order.factory.ts
  • src/test/model-ownership.ts
  • src/test/module-wiring.spec.ts
  • src/test/roles-coverage.spec.ts
  • src/test/seed-reset-scope.spec.ts
  • terraform/README.md
  • terraform/aws.tf
  • terraform/main.tf

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

@github-actions

Copy link
Copy Markdown

🧹 knip — dead-code 리포트

Unused exports (1)
Unused exported types (4)
전체 리포트
Unused exports (1)
effectiveLeadTimeMinutes  src/features/store/index.ts:20:10
Unused exported types (4)
OrderPickupRescheduledPayload  type  src/features/order/index.ts:44:8  
ProductCustomIssue             type  src/features/product/index.ts:11:8
ThreeDDesignSource             type  src/features/product/index.ts:16:8
ThreeDDesignV1                 type  src/features/product/index.ts:17:8

청소 후보(오탐 가능) · 기준 docs/guide/architecture-conventions.md

@github-actions

Copy link
Copy Markdown

🩺 NestJS Doctor — 90/100 (Excellent)

진단 539건 (error 14).

Category error warning info
architecture 2 2 46
correctness 0 295 0
performance 0 44 29
schema 0 0 87
security 12 22 0
architecture / security 상위 항목
  • error security/security/no-hardcoded-secrets: Variable 'SEED_PASSWORD' appears to contain a hardcoded secret.
  • error architecture/architecture/no-manual-instantiation: Manual instantiation of 'AccountNumberReencryptRepository' detected. Use dependency injection instead.
  • warning security/security/no-weak-crypto: Weak hashing algorithm 'md5' used in createHash().
  • error architecture/architecture/no-manual-instantiation: Manual instantiation of 'OutboxRepository' detected. Use dependency injection instead.
  • info architecture/architecture/no-barrel-export-internals: Barrel file re-exports internal type 'IAuditLogRepository'.
  • warning security/security/no-exposed-env-vars: Direct 'process.env.NODE_ENV' access in 'AuthController'. Use ConfigService instead.
  • warning security/security/require-guards-on-endpoints: Endpoint 'start' has no @UseGuards() at class or method level.
  • warning security/security/require-guards-on-endpoints: Endpoint 'callback' has no @UseGuards() at class or method level.
  • warning security/security/require-guards-on-endpoints: Endpoint 'refresh' has no @UseGuards() at class or method level.
  • warning security/security/require-guards-on-endpoints: Endpoint 'logout' has no @UseGuards() at class or method level.
  • warning security/security/require-guards-on-endpoints: Endpoint 'sellerLogin' has no @UseGuards() at class or method level.
  • warning security/security/require-guards-on-endpoints: Endpoint 'sellerRefresh' has no @UseGuards() at class or method level.
  • warning security/security/require-guards-on-endpoints: Endpoint 'sellerLogout' has no @UseGuards() at class or method level.
  • warning security/security/require-guards-on-endpoints: Endpoint 'devIssueToken' has no @UseGuards() at class or method level.
  • warning security/security/require-guards-on-endpoints: Endpoint 'adminLogin' has no @UseGuards() at class or method level.

오탐 포함 가능 · 기준 docs/guide/architecture-conventions.md

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: b2ee9d3b73

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

"""
수수료 기준액 합계(원).
"""
settlementBaseAmount: Int!

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Use a wider scalar for monthly monetary aggregates

When the platform's monthly settlement base exceeds 2,147,483,647 won, toAdminMonthlyCommissionReport() returns that sum unchanged, but this non-null GraphQL Int cannot serialize it, causing the monthly report query to fail. For example, 43,000 finalized orders of 50,000 won already cross the limit even though every individual order is valid. Use an amount scalar capable of representing aggregate totals consistently for the report and per-store monetary fields; the per-order amount limit does not bound these sums.

Useful? React with 👍 / 👎.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

미반영(기록): #586에서 같은 지적에 답한 대로, 플랫폼 월 합계가 약 21억 원을 넘어야 생기는 한계라 현재 규모(운영 주문 0건) 밖이고 금액 스칼라 도입은 SDL·관리자 FE에 걸친 새 장치. 후속 #587.

@github-actions

Copy link
Copy Markdown

Coverage report

St.❔
Category Percentage Covered / Total
🟢 Statements
98.44% (+0.42% 🔼)
13419/13631
🟢 Branches
93.84% (+0.87% 🔼)
5254/5599
🟢 Functions
98.08% (+0.53% 🔼)
2712/2765
🟢 Lines
98.91% (+0.32% 🔼)
12211/12345
Show new covered files 🐣
St.❔
File Statements Branches Functions Lines
🟢
... / withdrawal-blocking-order.port.ts
100% 100% 100% 100%
🟢
... / order-cancel.policy.ts
100% 100% 100% 100%
🟢
... / deposit-record.repository.ts
100% 100% 100% 100%
🟢
... / refund-requested.event.ts
100% 100% 100% 100%
🟢
... / refund.repository.ts
100% 100% 100% 100%
🟢
... / refund-account-submitted.event.ts
100% 100% 100% 100%
🟢
... / refund-completed.event.ts
100% 100% 100% 100%
🟢
... / order-custom-upload.repository.ts
100% 100% 100% 100%
🟢
... / order-inquiry.repository.ts
100% 100% 100% 100%
🟢
... / order-status-traits.ts
100% 100% 100% 100%
🟢
... / order-lifecycle.repository.ts
100% 83.33% 100% 100%
🟢
... / order-confirm-reminder-due.event.ts
100% 100% 100% 100%
🟢
... / order-lifecycle.policy.ts
100% 100% 100% 100%
🟢
... / order-pickup-change.repository.ts
100% 78.57% 100% 100%
🟢
... / order-pickup-rescheduled.event.ts
100% 88.89% 100% 100%
🟢
... / order-capacity.helper.ts
100% 87.5% 100% 100%
🟢
... / order-payment-pending.event.ts
100% 100% 100% 100%
🟢
... / order-custom-upload-attach.helper.ts
100% 100% 100% 100%
🟢
... / order-pending-payment-lock.helper.ts
100% 100% 100% 100%
🟢
... / order-settlement-finalizer.helper.ts
100% 100% 100% 100%
🟢
... / payment.repository.ts
100% 100% 100% 100%
🟢
... / payment-deposit-claimed.event.ts
100% 100% 100% 100%
🟢
... / order-transition.repository.ts
98.92% 90.79% 100% 100%
🟢
... / order-withdrawal-blocking.repository.ts
100% 100% 100% 100%
🟢
... / payment-setting.repository.ts
100% 100% 100% 100%
🟢
... / settlement.repository.ts
98.18% 95.45% 100% 100%
🟢
... / settlement-created.event.ts
100% 100% 100% 100%
🟢
... / store-settlement-account.repository.ts
100% 100% 100% 100%
🟢
... / account-cipher.service.ts
100% 100% 100% 100%
🟢
... / admin-complete-order-pickup.input.ts
100% 100% 100% 100%
🟢
... / order-cancel-reasons.ts
100% 100% 100% 100%
🟢
... / order-bank-account.helper.ts
100% 100% 100% 100%
🟢
... / payment-banks.ts
100% 100% 100% 100%
🟢
... / order-custom-design.helper.ts
100% 100% 100% 100%
🟢
... / product-custom-readiness.helper.ts
100% 100% 100% 100%
🟢
... / custom-3d-catalog.constants.ts
100% 100% 100% 100%
🟢
... / product-custom-catalog-query.resolver.ts
100% 100% 100% 100%
🟢
... / product-custom-catalog.service.ts
100% 100% 100% 100%
🟢
... / custom-3d-preset.helper.ts
100% 100% 100% 100%
🟢
... / three-d-design.helper.ts
100% 100% 100% 100%
🟢
... / custom-order-input.helper.ts
100% 93.75% 100% 100%
🟢
... / order-payment-mappers.helper.ts
100% 100% 100% 100%
🟢
... / order-settlement-mappers.helper.ts
100% 78.95% 100% 100%
🟢
... / create-order-custom.input.ts
100% 100% 100% 100%
🟢
... / order-custom-upload-purposes.ts
100% 100% 100% 100%
🟢
... / order-customization.service.ts
100% 98.72% 100% 100%
🟢
... / order-input-hash.helper.ts
100% 100% 100% 100%
🟢
... / order-deposit-admin-mutation.resolver.ts
100% 100% 100% 100%
🟢
... / admin-confirm-payment.input.ts
100% 100% 100% 100%
🟢
... / order-deposit-admin.service.ts
100% 100% 100% 100%
🟢
... / payment-confirm.policy.ts
100% 100% 100% 100%
🟢
... / order-deposit-admin-query.resolver.ts
100% 100% 100% 100%
🟢
... / admin-pending-payment-list.input.ts
100% 100% 100% 100%
🟢
... / order-my-mutation.resolver.ts
100% 100% 100% 100%
🟢
... / cancel-my-order.input.ts
87.5% 100% 0% 87.5%
🟢
... / refund-account.input.ts
100% 100% 100% 100%
🟢
... / submit-my-refund-account.input.ts
100% 100% 100% 100%
🟢
... / order-payment-admin-mutation.resolver.ts
100% 100% 100% 100%
🟢
... / admin-update-payment-setting.input.ts
100% 100% 100% 100%
🟢
... / admin-upsert-store-settlement-account.input.ts
100% 100% 100% 100%
🟢
... / order-payment-admin.service.ts
100% 100% 100% 100%
🟢
... / order-payment-admin-query.resolver.ts
100% 100% 100% 100%
🟢
... / order-payment-query.resolver.ts
100% 100% 100% 100%
🟢
... / order-refund-admin-mutation.resolver.ts
100% 100% 100% 100%
🟢
... / admin-complete-refund.input.ts
100% 100% 100% 100%
🟢
... / admin-create-deposit-return.input.ts
100% 100% 100% 100%
🟢
... / admin-link-unidentified-deposit.input.ts
100% 100% 100% 100%
🟢
... / admin-record-unidentified-deposit.input.ts
100% 100% 100% 100%
🟢
... / order-refund-admin.service.ts
100% 100% 100% 100%
🟢
... / order-refund-mappers.helper.ts
100% 100% 100% 100%
🟢
... / order-refund-admin-query.resolver.ts
100% 100% 100% 100%
🟢
... / admin-deposit-record-list.input.ts
100% 100% 100% 100%
🟢
... / admin-refund-list.input.ts
100% 100% 100% 100%
🟢
... / seller-cancel-order.input.ts
100% 100% 100% 100%
🟢
... / order-seller-mappers.helper.ts
100% 100% 100% 100%
🟢
... / order-seller-pickup-mutation.resolver.ts
100% 100% 100% 100%
🟢
... / seller-reschedule-order-pickup.input.ts
100% 100% 100% 100%
🟢
... / order-seller-pickup.service.ts
100% 100% 100% 100%
🟢
... / order-seller-pickup-query.resolver.ts
100% 100% 100% 100%
🟢
... / order-settlement-admin-mutation.resolver.ts
100% 100% 100% 100%
🟢
... / admin-mark-settlement-paid.input.ts
100% 100% 100% 100%
🟢
... / order-settlement-admin.service.ts
100% 100% 100% 100%
🟢
... / order-settlement-admin-query.resolver.ts
100% 100% 100% 100%
🟢
... / admin-monthly-commission.input.ts
100% 100% 100% 100%
🟢
... / admin-settlement-list.input.ts
100% 100% 100% 100%
🟢
... / order-settlement-seller-mutation.resolver.ts
100% 100% 100% 100%
🟢
... / seller-upsert-settlement-account.input.ts
100% 100% 100% 100%
🟢
... / order-settlement-seller.service.ts
100% 100% 100% 100%
🟢
... / order-settlement-seller-query.resolver.ts
100% 100% 100% 100%
🟢
... / seller-settlement-list.input.ts
100% 100% 100% 100%
🟢
... / order-admin-alert.consumer.ts
100% 100% 100% 100%
🟢
... / order-admin-alert-messages.helper.ts
100% 100% 100% 100%
🟢
... / order-custom-upload-cleanup.scheduler.ts
100% 91.67% 100% 100%
🟢
... / order-lifecycle.scheduler.ts
100% 91.67% 100% 100%
🟢
... / order-settlement.scheduler.ts
100% 89.47% 100% 100%
🟢
... / conversation-attachment.helper.ts
100% 100% 100% 100%
🟢
... / send-conversation-image-message.input.ts
100% 100% 100% 100%
🟢
... / account-number-reencrypt.repository.ts
100% 100% 100% 100%
Show files with reduced coverage 🔻
St.❔
File Statements Branches Functions Lines
🟢
... / review-order-item-snapshot.helper.ts
100%
90.91% (-1.4% 🔻)
100% 100%
🟢
... / s3.service.ts
99.02% (+1.02% 🔼)
80.95% (-4.76% 🔻)
100% 100%
🟢
... / product-seller-lifecycle.service.ts
95.59% (-0.25% 🔻)
92% (-0.59% 🔻)
100% 100%
🟢
... / order-seller.service.ts
98.55% (+0.51% 🔼)
91.67% (-0.64% 🔻)
100% 100%
🟢
... / notification-outbox.consumer.ts
100%
87.1% (-12.9% 🔻)
100% 100%
🟢
... / seller-push-messages.helper.ts
100%
88.89% (-11.11% 🔻)
100% 100%

Test suite run success

6646 tests passing in 444 suites.

Report generated by 🧪jest coverage report action from b2ee9d3

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant