Skip to content

feat: 주문 생성 커스텀 입력 검증과 스냅샷 저장 - #577

Merged
chanwoo7 merged 3 commits into
developfrom
feat/order-custom-checkout
Nov 18, 2026
Merged

chanwoo7 merged 3 commits into
developfrom
feat/order-custom-checkout

Conversation

@chanwoo7

Copy link
Copy Markdown
Member

개요

주문 생성(createOrder)이 커스텀 입력을 함께 받아 주문 시점 상품 설정과 대조하고, 통과한 값을 품목 스냅샷으로 저장합니다. 선업로드한 커스텀 이미지는 주문 트랜잭션 안에서 잠가 확인한 뒤 주문에 연결합니다.

  • 커스텀 방식이 있는 상품(슬롯형·3D)은 커스텀 입력이 필수이고 수량은 1입니다. 커스텀이 없는 상품에 커스텀 입력을 보내면 거절합니다.
  • 커스텀은 가격을 바꾸지 않습니다. 3D 모양·크기 등의 가격은 지금처럼 옵션 추가금으로만 들어옵니다.
  • 저장 모델(문구·자유 편집·3D 디자인·커스텀 이미지)과 업로드 발급 기록은 앞 PR(커스텀 주문 업로드·스냅샷 스키마)이 만든 것을 써서 마이그레이션은 없습니다.
  • 같은 멱등 키 재요청 판정(입력 해시)에 커스텀 입력도 넣었습니다. 커스텀이 없는 주문의 해시는 이전과 같습니다.
  • SDL은 입력을 더하기만 했습니다. 다만 커스텀 상품을 커스텀 없이 주문하던 흐름은 이제 CUSTOM_INPUT_REQUIRED로 거절됩니다.

변경 사항

  • 입력(SDL·DTO) CreateOrderInput.custom: CreateOrderCustomInput { slot | threeD }
    • 슬롯형 CreateOrderSlotCustomInput
      • templateRevision: 꾸미기를 시작할 때 본 템플릿 revision
      • texts: [{ tokenId, valueText }]: 문구 자리마다 1건
      • compositeImageUrl: 구매자가 본 그대로의 합성 이미지
      • freeEdits: [{ posX posY width height descriptionText referenceImageUrls }] = []
    • 3D CreateOrderThreeDCustomInput
      • design: ThreeDDesignInput(JSON v1, 출력 ThreeDDesign과 같은 모양)
      • renderImages: [{ kind: CustomImageKindType, imageUrl }]
    • 전역 ValidationPipe(whitelist·forbidNonWhitelisted)를 통과하도록 중첩 필드 전부에 검증 데코레이터를 달았고, 필수 중첩 객체는 IsDefined로 막습니다. 개수·글자 수·좌표 범위는 상품 설정과 함께 봐야 해서 서비스가 도메인 코드로 판정합니다.
  • 검증 OrderCustomizationService.resolve(order)
    • 순서는 방식 대조(CUSTOM_INPUT_REQUIRED·CUSTOM_INPUT_MISMATCH) → 수량 1(CUSTOM_QUANTITY_FIXED) → 준비 상태(evaluateProductCustomIssues, CUSTOM_PRODUCT_NOT_READY) → 방식별 검증 → 이미지 URL입니다.
    • 3D 상품에 슬롯형 입력(자유 편집 포함)을 보내면 방식 불일치라, 3D에는 자유 편집이 들어갈 수 없습니다.
    • 슬롯형(revision → 문구 자리 집합 → 값 → 자유 편집 순)
      • revision이 다르면 CUSTOM_TEMPLATE_CHANGED(409)입니다.
      • texts의 자리 집합이 템플릿 자리와 정확히 같아야 합니다. 빠짐·남음·중복은 CUSTOM_SLOT_TEXTS_MISMATCH, 형식이 틀린 id는 INVALID_ID입니다.
      • 값은 CRLF·CR을 LF로 바꾸고 앞뒤 공백을 지운 뒤 코드 포인트로 셉니다(줄바꿈·이모지 허용). 비었으면 필수 자리는 CUSTOM_SLOT_TEXT_REQUIRED, 선택 자리는 '문구 없음'(null)입니다. 자리의 max_length를 넘으면 CUSTOM_SLOT_TEXT_TOO_LONG입니다.
      • 자유 편집은 판매자가 켠 상품에서만, 5건까지, 영역 010000(너비·높이 1 이상, 바탕 안), 설명은 정리 뒤 12000자, 참고 사진 3장까지입니다. 어긋나면 CUSTOM_FREE_EDIT_INVALID이고 메시지에 위치(freeEdits[0].descriptionText 형식)를 담습니다.
    • 3D
      • validateThreeDDesign에 고른 옵션의 three_d_key를 넘겨 모양·크기·디자인·맛을 대조하고(CUSTOM_3D_OPTIONS_CHANGED 409), 카탈로그·한도를 검증한 정규형을 저장합니다.
      • 렌더 이미지는 윗면·앞·뒤·왼쪽·오른쪽이 정확히 1장씩이어야 합니다(CUSTOM_RENDER_IMAGES_INVALID).
    • 이미지 URL은 모두 assertOwnedUploadUrl로 본인이 그 용도(합성 COMPOSITE, 참고 사진 REFERENCE, 렌더 RENDER)로 발급받은 경로인지 보고, 한 주문 안에서 같은 파일(객체 키)을 두 번 쓰면 CUSTOM_UPLOAD_INVALID입니다.
  • 저장(order.repository.ts)
    • 품목: custom_mode_snapshot, 바탕 이미지(슬롯형), 대표 이미지(슬롯형 합성·3D 윗면)
    • 문구 자리: tokenId·key·label·기본 문구·값·순서·좌표·글자색·정렬 스냅샷(템플릿 자리 순)
    • 자유 편집: 영역·설명·참고 사진(입력 순)
    • 3D: 디자인 JSON(검증된 정규형)과 스키마 버전, 렌더 5장(종류 선언 순)
    • 슬롯형은 합성 이미지를 SLOT_COMPOSITE 커스텀 이미지로도 남깁니다.
  • 업로드 연결(repositories/order-custom-upload-attach.helper.ts)
    • 잠금 순서는 계정(GET_LOCK) → 입금 대기 건수 → capacity → 커스텀 업로드입니다. 업로드 행을 object_key IN (…) FOR UPDATE로 잠그고 계정·용도·상태를 확인한 뒤, 품목 생성 직후 같은 tx에서 ATTACHED로 바꿉니다.
    • 잠긴 행은 정리 크론(SKIP LOCKED)이 건너뜁니다. 이 잠금이 없으면 크론이 검사와 ATTACHED 표시 사이에 행을 PURGING으로 커밋하고, 주문은 지워질 파일을 참조한 채 커밋됩니다.
    • 발급 기록이 없거나 계정·용도가 다르거나 이미 다른 주문에 붙었으면 CUSTOM_UPLOAD_INVALID, 정리 중(PURGING)이면 CUSTOM_UPLOAD_EXPIRED입니다.
    • 취소·만료된 주문에 쓴 업로드도 ATTACHED라 다시 쓸 수 없습니다. 기기에 남은 초안으로 재주문하면 이미지를 새로 올려 URL을 바꿔야 합니다(SDL 설명에 명시, 머지 턴 FE 전달 항목).
    • 키 컬럼 콜레이션이 대소문자를 가리지 않아, 잠근 행과 요청 키를 코드에서 정확히 비교합니다.
    • tx 안 업로드 거절도 capacity·입금 대기 건수 거절처럼 같은 키 replay를 먼저 확인합니다. 응답을 못 받은 재시도가 자기 주문이 붙인 업로드에 걸려 실패하지 않게 하기 위해서입니다.
  • 입력 해시
    • canonicalizeCustomOrderInput(product 순수 헬퍼, 입력은 product 구조 타입 CustomOrderInputSource)를 hashCreateOrderInput의 custom으로 넣었습니다.
    • 순서가 의미 없는 목록(문구 자리는 tokenId, 렌더 이미지는 종류)은 정렬하고, 그리는 순서·입력 순서가 의미인 3D 항목·자유 편집·참고 사진은 그대로 둡니다. 생략한 자유 편집·참고 사진은 빈 배열과 같고, 슬롯·3D가 모두 없으면 커스텀 없음과 같습니다.
  • 에러 코드 11종(CUSTOM_TEMPLATE_CHANGED만 409, 나머지 400)
    • CUSTOM_INPUT_REQUIRED·CUSTOM_INPUT_MISMATCH·CUSTOM_QUANTITY_FIXED·CUSTOM_TEMPLATE_CHANGED·CUSTOM_SLOT_TEXTS_MISMATCH·CUSTOM_RENDER_IMAGES_INVALID·CUSTOM_UPLOAD_INVALID·CUSTOM_UPLOAD_EXPIRED
    • 함수형 메시지: CUSTOM_SLOT_TEXT_REQUIRED('{label}'), CUSTOM_SLOT_TEXT_TOO_LONG('{label}'·{max}), CUSTOM_FREE_EDIT_INVALID({field})
  • 정리
    • 업로드 용도 표(CUSTOM_UPLOAD_PURPOSES)를 order 상수로 옮겨 발급과 주문 생성이 같이 씁니다.
    • product 배럴에 canonicalizeCustomOrderInput·CustomOrderInputSource·CUSTOM_AREA_SCALE을 공개했습니다.
  • 게이트
    • model-ownership: OrderItemCustomText·OrderItemCustomFreeEdit·OrderItemCustomFreeEditAttachment·OrderItemCustomDesign·OrderItemCustomImage의 writer를 order로 열었습니다.
    • 새 모델·경계 read·admin Query·루트 필드가 없어 read-boundary·admin-query-null-inputs·roles-coverage는 그대로입니다.
  • 플랜에 코드가 정해지지 않아 정한 것
    • 문구 길이 초과와 자유 편집 규칙 위반의 에러 코드(CUSTOM_SLOT_TEXT_TOO_LONG, CUSTOM_FREE_EDIT_INVALID 하나에 위치 표시)
    • 이미지 중복을 URL이 아니라 객체 키로 판정(쿼리만 다른 같은 파일 차단)
    • 업로드 행의 계정·용도도 tx 안에서 다시 확인(URL 접두 검사와 이중)
  • 크기·커밋
    • +2,907/−27줄이고 그중 spec이 +1,912줄입니다. 플랜에 이 PR의 분할 경계가 없어 나누지 않았습니다.
    • 커밋은 3개입니다.
      • 기능 1개
      • 리뷰 반영 2개: 업로드 잠금 회귀 테스트(test), 슬롯형 문구 값을 자유 편집보다 먼저 검증(fix)

테스트

  • OrderCustomizationService 84건(DB 없음, S3 소유 판정은 실물)
    • 방식 표 12행(커스텀 없는 상품·슬롯형·3D × 생략·null·빈 객체·다른 방식·둘 다), 수량 3, 준비 상태 4(템플릿 없음·삭제·편집할 것 없음·크기 그룹 없음)
    • 슬롯형: 스냅샷 전체, revision 앞뒤, 자리 집합 5(빠짐·없는 자리·중복·표기만 다른 중복·"0") + 빈 id
    • 문구 값 표 18: 기본 문구 그대로, CRLF·CR, 앞뒤 공백, 이모지, 합자 이모지(코드 포인트 5), 상한 정확히·+1, 선택 자리 지움(null·생략·공백) / 필수 자리 지움 4 / 초과 3(메시지의 자리 이름·상한까지)
    • 자유 편집 20: 5건·6건, 꺼짐(빈 목록은 허용), 영역 경계 안 2·밖 6, 설명 1자·2000자·정리 뒤 2000자·빈 값·공백만·2001자, 참고 사진 3장·4장
    • 검증 순서 2: 필수 자리를 지우고 꺼진 상품에 자유 편집 1건·켜진 상품에 6건을 보내면 CUSTOM_SLOT_TEXT_REQUIRED(자유 편집 거절보다 먼저)
    • 3D 10: 정규형·렌더 순서·대표 이미지·업로드 목록, 옵션 불일치 3(409), 카탈로그 밖 시트 색, 렌더 4장·6장·윗면 2장·합성 섞임·없음
    • 업로드 9: 외부 URL, 다른 계정, 다른 용도 3방향, %2e%2e로 다른 계정 경로 우회, 같은 참고 사진 두 번, 쿼리만 다른 같은 파일, 같은 렌더 파일을 두 자세에
  • createOrder 커스텀(real DB) 14건
    • 슬롯형 스냅샷 전체·업로드 ATTACHED(연결 시각)·가격 불변(판매가 그대로)
    • 3D 디자인 JSON·렌더 5장·윗면 대표 이미지·업로드 5건 연결·가격은 정가 + 옵션 추가금
    • 한 번 주문에 쓴 이미지 재사용 거절
    • ATTACHED·PURGING(CUSTOM_UPLOAD_EXPIRED)·용도 다른 기록은 주문·연결을 남기지 않음
    • 발급 기록 없는 본인 경로·다른 계정 기록·대소문자만 다른 키 거절
    • 주문 tx가 업로드를 잠근 뒤·품목 생성 전에 정리 크론(claimForPurge, 별도 커넥션)을 돌리면 크론은 0건을 잡고, 주문이 업로드를 ATTACHED로 붙임
    • 연결 뒤 tx 실패(outbox 장애 주입)면 주문·스냅샷 없이 업로드가 PENDING으로 남고, 같은 업로드로 다시 주문됨
    • 같은 키 replay(문구 자리 순서만 다름)는 기존 주문, 문구만 달라도 IDEMPOTENCY_KEY_INPUT_MISMATCH
    • 사전 replay 조회를 지나 업로드 잠금에서 걸린 같은 키 재시도는 replay, 입력이 다르면 불일치
    • revision 변경 시 업로드 그대로, 3D 옵션 불일치, 3D 커스텀 누락
  • 입력 해시: 커스텀 정규형 문자열 고정 1, 커스텀 없음과 같은 경우 3, 같은 해시 5(자리 순서·null과 생략·빈 배열과 생략 2·렌더 순서), 다른 해시 8, 슬롯·3D 구분 1. 기존 정규형 고정 테스트(커스텀 없음)는 그대로 통과합니다.
  • canonicalizeCustomOrderInput 6, DTO 중첩 검증 통과 3·거절 8(전역 파이프와 같은 옵션), 에러 카탈로그 렌더 파라미터 3종
  • 반증: 아래를 하나씩 깨면 해당 테스트가 실패하는 것을 확인했습니다(되돌린 뒤 통과 재확인).
    • model-ownership writer를 비우면 게이트 1건
    • tx 안 업로드 검사 결과를 무시하면 real DB 5건
    • 업로드 잠금(FOR UPDATE)을 빼면 크론 끼어들기 테스트(크론이 업로드 2건을 잡음)
    • 자유 편집 켜짐·개수 검사를 문구 값 검사 앞으로 되돌리면 검증 순서 2건
    • 키 비교를 대소문자 무시로 바꾸면 대소문자 변형 키 테스트
    • 해시에서 커스텀을 빼면 해시 spec과 real DB를 합쳐 11건
    • 중복을 URL로 판정하면 3건, 준비 상태 검사를 끄면 4건, 렌더 개수 검사를 빼면 1건, 자유 편집 꺼짐 검사를 빼면 1건, 수량 고정을 빼면 2건, revision 대조를 빼면 2건
  • 경로 지정 실행
    • yarn test src/features/order src/test src/graphql src/features/product/services src/common/errors: 95 suites, 2,390 tests 통과
    • 새 spec 3개(order-checkout.service.custom·order-customization.service·custom-order-input.helper): 3 suites, 104 tests 통과
  • 정적 검사: lint·tsc·dto:check·docs:check·arch:check 통과. 전체 jest는 pre-push에서 돕니다.

플랜 대조

플랜 항목 BE-12 불릿 상태
custom 입력(SDL CreateOrderInput.custom과 11절 입력 타입) 한 것
DTO(입력 타입마다 class, dto:check 일치) 한 것
OrderCustomizationService.resolve: 모드 대조 → 수량 1 → 준비 상태 → SLOT(revision·tokenId 집합·값·자유 편집) / THREE_D(validateThreeDDesign·렌더 5종) → 모든 URL 소유·중복 한 것(슬롯형 값 → 자유 편집 순서는 리뷰 반영 커밋에서 바로잡음)
4절 6단계 위치(옵션 선택 해석 뒤 resolve), 5단계 OPTION_CUSTOMIZATION_REQUIRED 가드 삭제 한 것(가드와 코드는 상품 커스텀 설정 PR에서 이미 삭제됨)
persist: 품목 커스텀 방식·바탕·대표 이미지, 문구·자유 편집 스냅샷, 3D 디자인·커스텀 이미지 한 것
attach: 주문 tx 안 object_key IN (…) FOR UPDATE → 계정·용도·상태 검사(CUSTOM_UPLOAD_INVALID, PURGING CUSTOM_UPLOAD_EXPIRED) → ATTACHED 한 것
해시 포함: 입력 해시 대상에 custom(canonicalizeCustomOrderInput()), 해시 경우 테스트 갱신 한 것(canonicalizeCustomOrderInput은 10절대로 product 순수 헬퍼)
writers: OrderItemCustomText·FreeEdit·Attachment를 order로, 신규 모델(Design·Image) 등록 한 것
13절 커스텀 에러 코드 중 11절 코드 한 것(길이 초과·자유 편집 코드는 위 '정한 것')
가격 불변(커스텀 추가금 없음, 3D는 옵션 추가금만) 한 것
머지 턴 #212 본문 갱신 안 한 것 — 머지 턴 작업이라 머지 때 갱신합니다(customDraftId 전제 삭제, 커스텀 입력 인라인, OPTION_CUSTOMIZATION_REQUIRED 소멸, 멱등 + 입력 해시, 취소·만료 주문 초안으로 재주문 시 이미지 재업로드)
테스트: 모드·수량·준비 상태 한 것
테스트: 슬롯 문구(기본·지움·CRLF·이모지·경계) 한 것
테스트: 자유 편집 한 것
테스트: 3D 정상·옵션 불일치·렌더 5장 한 것
테스트: 업로드 소유·중복·만료 한 것(잠금 중 정리 크론 끼어들기 포함)
테스트: 롤백 시 PENDING 유지 한 것
테스트: 가격 불변 한 것
결정 이 PR에서 한 일 상태
D29 커스텀 주문 수량 1(CUSTOM_QUANTITY_FIXED) 한 것
D33 입력 해시에 커스텀 입력 포함 한 것
D35 커스텀 방식이 있는 상품은 커스텀 필수(CUSTOM_INPUT_REQUIRED) 한 것
D38 슬롯형·자유 편집 추가금 없음(가격 불변 테스트) 한 것
D44 렌더에 필요한 값(효과·위치·크기·순서) 전부를 디자인 JSON으로 저장 한 것
D45 렌더 5장 저장, 윗면이 대표 이미지 한 것
D46 면당 꾸미기·글자 10, 글자 30자 서버 검증(주문 생성에서 적용) 한 것
D47 카탈로그의 선택 가능 항목만 허용(주문 생성에서 적용) 한 것
D49 3D 디자인 JSON + 스키마 버전 저장, 서버 검증 한 것
D50 기본 문구로 시작, 지우면 필수 거절·선택 '문구 없음' 한 것
D51 문구의 이모지·줄바꿈 허용(슬롯형·3D) 한 것
D53 문구 길이를 자리의 maxLength(기본 20·상한 50)로 검증 한 것
D56 슬롯 지정은 tokenId, 스냅샷에 key·label·좌표·스타일·바탕 이미지 한 것
D58 자유 편집은 영역 좌표만 저장(0~10000) 한 것
D59 자유 편집은 판매자가 켠 상품에서만, 최대 5건·건당 사진 3장 한 것(장당 10MB·형식은 업로드 정책)
D60 슬롯형 합성 이미지 1장 저장 한 것
D61 presign 선업로드 URL 제출, 소유 검증 재사용 한 것
D69 #212 본문 갱신 안 한 것 — 머지 턴 작업
D76 3D 상품 준비 상태(모양·크기 필수, 맛·디자인 선택)를 주문 생성에서도 확인 한 것
D84④ 3D 상품에는 자유 편집 없음(3D 입력에 자유 편집이 없고 슬롯형 입력은 방식 불일치) 한 것

커스텀 상품(슬롯형·3D)은 createOrder가 커스텀 입력을 함께 받아 주문 시점 상품 설정과 대조하고, 통과한 값을 품목 스냅샷으로 저장한다. 커스텀 방식이 있는 상품은 커스텀이 필수이고 수량은 1이며, 커스텀은 가격을 바꾸지 않는다(3D 모양·크기 등은 옵션 추가금으로만 들어온다). 선업로드한 이미지는 주문 tx 안에서 잠가 소유·용도·상태를 확인한 뒤 ATTACHED로 바꿔 정리 크론 대상에서 뺀다. 같은 멱등 키 재요청 판정(입력 해시)에 커스텀 입력도 포함한다.

변경점
- SDL·DTO: CreateOrderInput.custom: CreateOrderCustomInput { slot | threeD }
  - 슬롯형: templateRevision, texts[{ tokenId, valueText }], compositeImageUrl, freeEdits[{ posX..height, descriptionText, referenceImageUrls }] = []
  - 3D: design(ThreeDDesignInput, JSON v1), renderImages[{ kind: CustomImageKindType, imageUrl }]
  - 전역 ValidationPipe(whitelist·forbidNonWhitelisted)를 통과하도록 중첩 필드 전부에 검증 데코레이터, 필수 중첩 객체는 IsDefined
- OrderCustomizationService.resolve(order): 방식 대조(CUSTOM_INPUT_REQUIRED·CUSTOM_INPUT_MISMATCH) → 수량 1(CUSTOM_QUANTITY_FIXED) → 준비 상태(evaluateProductCustomIssues, CUSTOM_PRODUCT_NOT_READY)
  - 슬롯형: revision(CUSTOM_TEMPLATE_CHANGED 409) → 문구 자리 집합(CUSTOM_SLOT_TEXTS_MISMATCH) → 값(CRLF·CR→LF, trim, 코드 포인트 ≤ max_length; 필수 자리 지움 CUSTOM_SLOT_TEXT_REQUIRED, 선택 자리 지움 null) → 자유 편집(켜짐·5건·영역 0~10000·설명 1~2000자·참고 사진 3장)
  - 3D: validateThreeDDesign(고른 옵션의 three_d_key와 대조) → 렌더 5종 정확히 1장씩(CUSTOM_RENDER_IMAGES_INVALID)
  - 모든 이미지 URL: assertOwnedUploadUrl(용도별 접두) + 같은 파일 중복 금지(CUSTOM_UPLOAD_INVALID)
- 저장(order.repository): 품목 custom_mode_snapshot·바탕(슬롯형)·대표 이미지(슬롯형 합성, 3D 윗면), 문구 자리 스냅샷(tokenId·key·label·기본 문구·값·좌표·색·정렬), 자유 편집 영역·설명·참고 사진, 3D 디자인 JSON(검증된 정규형)·버전, 커스텀 이미지(렌더는 종류 순)
- 업로드 연결: 계정 잠금 → 입금 대기 건수 → capacity 뒤에 order_custom_upload를 object_key IN (…) FOR UPDATE로 잠그고 검사, 품목 생성 뒤 같은 tx에서 ATTACHED. tx 안 거절('upload-invalid'·'upload-expired')도 capacity 거절처럼 같은 키 replay를 먼저 확인한다
- 입력 해시: canonicalizeCustomOrderInput(product 순수 헬퍼, 입력은 product 구조 타입)을 hashCreateOrderInput에 더했다. 커스텀이 없으면 기존 해시와 같다
- 업로드 용도 표(CUSTOM_UPLOAD_PURPOSES)를 order 상수로 옮겨 발급과 주문 생성이 같이 쓴다. product 배럴에 CUSTOM_AREA_SCALE을 공개했다
- 게이트: model-ownership의 OrderItemCustomText·FreeEdit·FreeEditAttachment·Design·Image writers를 order로
- 에러 코드 11종 신설(CUSTOM_TEMPLATE_CHANGED만 409)

명세에 없던 결정
- 문구 길이 초과는 CUSTOM_SLOT_TEXT_TOO_LONG('{label}'·{max}), 자유 편집 규칙 위반은 CUSTOM_FREE_EDIT_INVALID 하나로 두고 메시지에 위치(freeEdits[0].descriptionText 형식)를 담는다
- 이미지 중복은 URL이 아니라 객체 키로 가린다(쿼리만 다른 같은 파일 차단). 키 컬럼 콜레이션이 대소문자를 가리지 않아 잠근 행과 키를 코드에서 정확히 비교한다
- 발급 기록이 없거나 이미 다른 주문에 붙은 업로드는 CUSTOM_UPLOAD_INVALID, 정리 중(PURGING)이면 CUSTOM_UPLOAD_EXPIRED
- 해시 정규형은 문구 자리(tokenId)·렌더 이미지(종류)를 정렬하고, 그리는 순서·입력 순서가 의미인 3D 항목·자유 편집·참고 사진은 그대로 둔다. 생략한 자유 편집·참고 사진은 빈 배열과 같다
- custom이 {}(슬롯·3D 모두 없음)이면 커스텀 없음과 같다

테스트
- OrderCustomizationService 82건(DB 없음): 방식 표 12, 수량 3, 준비 상태 4, 슬롯형 스냅샷, revision, 자리 집합 5 + 빈 ID, 문구 값 표(기본·CRLF·CR·trim·이모지·합자 이모지·경계·지움) 18, 자유 편집(5건·6건·꺼짐·영역 경계 8·설명 6·사진 3/4), 3D 정상·옵션 불일치 3·디자인 무효·렌더 5종 5, 업로드 소유·중복 9
- createOrder 커스텀(real DB) 13건: 슬롯형 스냅샷·ATTACHED·가격 불변, 3D 디자인·렌더·가격(옵션 추가금만), 재사용 업로드, ATTACHED·PURGING·용도 다른 기록, 미발급·다른 계정 기록·대소문자 변형 키, 연결 뒤 tx 실패 시 PENDING 유지와 재주문, 같은 키 replay·커스텀 불일치, 업로드 잠금에서 걸린 같은 키 replay, revision 변경, 3D 옵션 불일치, 3D 커스텀 누락
- 입력 해시: 커스텀 정규형 고정 1, 커스텀 없음 3, 같은 해시 5, 다른 해시 8, 슬롯·3D 구분 1. canonicalizeCustomOrderInput 6. DTO 중첩 검증 통과 3·거절 8. 에러 카탈로그 렌더 파라미터
- 반증: writers 비움, 업로드 검사 무시, 키 대소문자 무시, 해시에서 커스텀 제외, URL 기준 중복, 준비 상태·렌더 개수·자유 편집 꺼짐·수량·revision 검사 제거가 각각 실패함을 확인했다
주문 tx는 업로드 행을 object_key IN (…) FOR UPDATE로 잠근 뒤 검사하고 같은 tx에서 ATTACHED로 바꾼다. 이 잠금이 없으면 정리 크론(claimForPurge, SKIP LOCKED)이 검사와 표시 사이에 같은 행을 PURGING으로 커밋하고, 이어지는 ATTACHED 갱신은 0행으로 끝나 주문이 크론이 지울 파일을 참조한 채 커밋된다. 지금까지 이 잠금을 반증하는 테스트가 없었다.

변경점
- order-checkout.service.custom.spec(real DB): insertPendingPaymentOrder를 감싸 잠금 뒤·삽입 전에 별도 커넥션으로 claimForPurge를 부르고, 크론이 0건을 잡으며 업로드가 ATTACHED인지 단언한다

테스트
- 새 테스트 1건. FOR UPDATE를 지우면 크론이 2건을 잡아 실패함을 확인했다(되돌린 뒤 통과)
슬롯형 검증 순서는 revision → 문구 자리 집합 → 값 → 자유 편집인데, 자유 편집의 켜짐·5건 검사가 문구 값 검사보다 먼저 돌았다. 그래서 필수 자리를 지우고 꺼진 자유 편집(또는 6건)을 함께 보내면 CUSTOM_SLOT_TEXT_REQUIRED 대신 CUSTOM_FREE_EDIT_INVALID가 나갔다.

변경점
- resolveSlot: 문구 스냅샷(slotValue 포함)을 자유 편집 검사 앞에서 계산한다

테스트
- OrderCustomizationService 2건: 필수 자리를 지우고 꺼진 상품에 자유 편집 1건·켜진 상품에 6건을 보내면 CUSTOM_SLOT_TEXT_REQUIRED. 순서를 되돌리면 2건 모두 실패함을 확인했다
@coderabbitai

coderabbitai Bot commented Nov 18, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

Run configuration

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

Use the checkbox below for a quick retry:

  • Trigger review
  • 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

@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-18T21:33:20.888441Z 54490aa 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.

@github-actions

Copy link
Copy Markdown

🩺 NestJS Doctor — 90/100 (Excellent)

진단 515건 (error 14).

Category error warning info
architecture 2 1 44
correctness 0 275 0
performance 0 43 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

@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:12:10
Unused exported types (4)
RefundRequestedPayload  type  src/features/order/index.ts:19: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

Coverage report

St.❔
Category Percentage Covered / Total
🟢 Statements
98.33% (+0.03% 🔼)
12317/12526
🟢 Branches
93.75% (+0.1% 🔼)
4848/5171
🟢 Functions
97.94% (+0.04% 🔼)
2469/2521
🟢 Lines
98.83% (+0.02% 🔼)
11203/11336
Show new covered files 🐣
St.❔
File Statements Branches Functions Lines
🟢
... / order-custom-upload-attach.helper.ts
100% 100% 100% 100%
🟢
... / custom-order-input.helper.ts
100% 93.75% 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%
Show files with reduced coverage 🔻
St.❔
File Statements Branches Functions Lines
🟢
... / order-checkout.service.ts
98.25% (+0.05% 🔼)
96.84% (-0.13% 🔻)
100%
98.17% (+0.06% 🔼)

Test suite run success

6070 tests passing in 429 suites.

Report generated by 🧪jest coverage report action from 54490aa

@chanwoo7
chanwoo7 merged commit 6d62b0b into develop Nov 18, 2026
17 checks passed
@chanwoo7
chanwoo7 deleted the feat/order-custom-checkout branch November 18, 2026 21:35
@codecov

codecov Bot commented Nov 18, 2026

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 99.09502% with 2 lines in your changes missing coverage. Please review.

Files with missing lines Patch % Lines
...ures/order/services/order-customization.service.ts 98.95% 0 Missing and 1 partial ⚠️
...ures/product/services/custom-order-input.helper.ts 93.75% 0 Missing and 1 partial ⚠️

📢 Thoughts on this report? Let us know!

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