Repository navigation
feat: 주문 생성 커스텀 입력 검증과 스냅샷 저장 - #577
Conversation
커스텀 상품(슬롯형·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건 모두 실패함을 확인했다
|
Important Review skippedAuto reviews are disabled on base/target branches other than the default branch. Please check the settings in the CodeRabbit UI or the
|
Codex Review Summary: ✅ CompletedThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
🩺 NestJS Doctor — 90/100 (Excellent)진단 515건 (error 14).
architecture / security 상위 항목
|
🧹 knip — dead-code 리포트전체 리포트
|
Coverage report
Show new covered files 🐣
Show files with reduced coverage 🔻
Test suite run success6070 tests passing in 429 suites. Report generated by 🧪jest coverage report action from 54490aa |
Codecov Report❌ Patch coverage is 📢 Thoughts on this report? Let us know! |
개요
주문 생성(
createOrder)이 커스텀 입력을 함께 받아 주문 시점 상품 설정과 대조하고, 통과한 값을 품목 스냅샷으로 저장합니다. 선업로드한 커스텀 이미지는 주문 트랜잭션 안에서 잠가 확인한 뒤 주문에 연결합니다.CUSTOM_INPUT_REQUIRED로 거절됩니다.변경 사항
CreateOrderInput.custom: CreateOrderCustomInput { slot | threeD }CreateOrderSlotCustomInputtemplateRevision: 꾸미기를 시작할 때 본 템플릿 revisiontexts: [{ tokenId, valueText }]: 문구 자리마다 1건compositeImageUrl: 구매자가 본 그대로의 합성 이미지freeEdits: [{ posX posY width height descriptionText referenceImageUrls }] = []CreateOrderThreeDCustomInputdesign: ThreeDDesignInput(JSON v1, 출력ThreeDDesign과 같은 모양)renderImages: [{ kind: CustomImageKindType, imageUrl }]whitelist·forbidNonWhitelisted)를 통과하도록 중첩 필드 전부에 검증 데코레이터를 달았고, 필수 중첩 객체는IsDefined로 막습니다. 개수·글자 수·좌표 범위는 상품 설정과 함께 봐야 해서 서비스가 도메인 코드로 판정합니다.OrderCustomizationService.resolve(order)CUSTOM_INPUT_REQUIRED·CUSTOM_INPUT_MISMATCH) → 수량 1(CUSTOM_QUANTITY_FIXED) → 준비 상태(evaluateProductCustomIssues,CUSTOM_PRODUCT_NOT_READY) → 방식별 검증 → 이미지 URL입니다.CUSTOM_TEMPLATE_CHANGED(409)입니다.texts의 자리 집합이 템플릿 자리와 정확히 같아야 합니다. 빠짐·남음·중복은CUSTOM_SLOT_TEXTS_MISMATCH, 형식이 틀린 id는INVALID_ID입니다.CUSTOM_SLOT_TEXT_REQUIRED, 선택 자리는 '문구 없음'(null)입니다. 자리의max_length를 넘으면CUSTOM_SLOT_TEXT_TOO_LONG입니다.10000(너비·높이 1 이상, 바탕 안), 설명은 정리 뒤 12000자, 참고 사진 3장까지입니다. 어긋나면CUSTOM_FREE_EDIT_INVALID이고 메시지에 위치(freeEdits[0].descriptionText형식)를 담습니다.validateThreeDDesign에 고른 옵션의three_d_key를 넘겨 모양·크기·디자인·맛을 대조하고(CUSTOM_3D_OPTIONS_CHANGED409), 카탈로그·한도를 검증한 정규형을 저장합니다.CUSTOM_RENDER_IMAGES_INVALID).assertOwnedUploadUrl로 본인이 그 용도(합성 COMPOSITE, 참고 사진 REFERENCE, 렌더 RENDER)로 발급받은 경로인지 보고, 한 주문 안에서 같은 파일(객체 키)을 두 번 쓰면CUSTOM_UPLOAD_INVALID입니다.order.repository.ts)custom_mode_snapshot, 바탕 이미지(슬롯형), 대표 이미지(슬롯형 합성·3D 윗면)SLOT_COMPOSITE커스텀 이미지로도 남깁니다.repositories/order-custom-upload-attach.helper.ts)object_key IN (…) FOR UPDATE로 잠그고 계정·용도·상태를 확인한 뒤, 품목 생성 직후 같은 tx에서ATTACHED로 바꿉니다.ATTACHED표시 사이에 행을PURGING으로 커밋하고, 주문은 지워질 파일을 참조한 채 커밋됩니다.CUSTOM_UPLOAD_INVALID, 정리 중(PURGING)이면CUSTOM_UPLOAD_EXPIRED입니다.ATTACHED라 다시 쓸 수 없습니다. 기기에 남은 초안으로 재주문하면 이미지를 새로 올려 URL을 바꿔야 합니다(SDL 설명에 명시, 머지 턴 FE 전달 항목).canonicalizeCustomOrderInput(product 순수 헬퍼, 입력은 product 구조 타입CustomOrderInputSource)를hashCreateOrderInput의custom으로 넣었습니다.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_EXPIREDCUSTOM_SLOT_TEXT_REQUIRED('{label}'),CUSTOM_SLOT_TEXT_TOO_LONG('{label}'·{max}),CUSTOM_FREE_EDIT_INVALID({field})CUSTOM_UPLOAD_PURPOSES)를 order 상수로 옮겨 발급과 주문 생성이 같이 씁니다.canonicalizeCustomOrderInput·CustomOrderInputSource·CUSTOM_AREA_SCALE을 공개했습니다.OrderItemCustomText·OrderItemCustomFreeEdit·OrderItemCustomFreeEditAttachment·OrderItemCustomDesign·OrderItemCustomImage의 writer를 order로 열었습니다.CUSTOM_SLOT_TEXT_TOO_LONG,CUSTOM_FREE_EDIT_INVALID하나에 위치 표시)테스트
OrderCustomizationService84건(DB 없음, S3 소유 판정은 실물)"0") + 빈 idCUSTOM_SLOT_TEXT_REQUIRED(자유 편집 거절보다 먼저)%2e%2e로 다른 계정 경로 우회, 같은 참고 사진 두 번, 쿼리만 다른 같은 파일, 같은 렌더 파일을 두 자세에createOrder커스텀(real DB) 14건ATTACHED(연결 시각)·가격 불변(판매가 그대로)ATTACHED·PURGING(CUSTOM_UPLOAD_EXPIRED)·용도 다른 기록은 주문·연결을 남기지 않음claimForPurge, 별도 커넥션)을 돌리면 크론은 0건을 잡고, 주문이 업로드를ATTACHED로 붙임PENDING으로 남고, 같은 업로드로 다시 주문됨IDEMPOTENCY_KEY_INPUT_MISMATCHcanonicalizeCustomOrderInput6, DTO 중첩 검증 통과 3·거절 8(전역 파이프와 같은 옵션), 에러 카탈로그 렌더 파라미터 3종FOR UPDATE)을 빼면 크론 끼어들기 테스트(크론이 업로드 2건을 잡음)yarn test src/features/order src/test src/graphql src/features/product/services src/common/errors: 95 suites, 2,390 tests 통과order-checkout.service.custom·order-customization.service·custom-order-input.helper): 3 suites, 104 tests 통과dto:check·docs:check·arch:check통과. 전체 jest는 pre-push에서 돕니다.플랜 대조
custom입력(SDLCreateOrderInput.custom과 11절 입력 타입)dto:check일치)OrderCustomizationService.resolve: 모드 대조 → 수량 1 → 준비 상태 → SLOT(revision·tokenId 집합·값·자유 편집) / THREE_D(validateThreeDDesign·렌더 5종) → 모든 URL 소유·중복resolve), 5단계OPTION_CUSTOMIZATION_REQUIRED가드 삭제object_key IN (…) FOR UPDATE→ 계정·용도·상태 검사(CUSTOM_UPLOAD_INVALID, PURGINGCUSTOM_UPLOAD_EXPIRED) → ATTACHEDcustom(canonicalizeCustomOrderInput()), 해시 경우 테스트 갱신canonicalizeCustomOrderInput은 10절대로 product 순수 헬퍼)OrderItemCustomText·FreeEdit·Attachment를 order로, 신규 모델(Design·Image) 등록OPTION_CUSTOMIZATION_REQUIRED소멸, 멱등 + 입력 해시, 취소·만료 주문 초안으로 재주문 시 이미지 재업로드)CUSTOM_QUANTITY_FIXED)CUSTOM_INPUT_REQUIRED)