Repository navigation
feat: 주문 커스텀 스냅샷 스키마와 주문 상세 커스텀 출력 - #574
Conversation
주문에 커스텀 방식·바탕·대표 이미지, 문구 자리 표시 이름·좌표·스타일, 자유 편집 영역, 3D 디자인 JSON(스키마 버전 동반)과 커스텀 이미지(3D 렌더 5장·슬롯형 합성 1장)를 스냅샷으로 남기고 구매자·판매자·관리자 상세에 내보낸다. 자유 편집은 크롭 이미지 대신 바탕 위 영역 좌표만 저장한다. 리뷰 Before와 판매자·관리자 목록 '커스텀' 배지는 품목의 커스텀 대표 이미지·방식을 쓴다. 주문 생성의 커스텀 입력·저장은 다음 PR이 붙인다.
변경점
- 스키마·마이그레이션(order_custom_snapshot)
- order_item: custom_mode_snapshot(기본 NONE)·custom_base_image_url_snapshot·custom_preview_image_url
- order_item_custom_text: token_id(FK 없음, 자리 지정 전 주문 null)·label_snapshot·pos_x..height·text_color·text_align, value_text nullable('문구 없음')
- order_item_custom_free_edit: pos_x..height 추가, crop_image_url 삭제
- 신규 order_item_custom_design(order_item_id unique, schema_version, design_json)·order_item_custom_image(kind, image_url, (order_item_id, kind) unique). 주문과 함께 한 번만 쓰여 deleted_at이 없고 가시성은 부모 품목을 따른다(SOFT_DELETE_MODELS 미등록)
- 백필: 기존 문구·자유 편집은 바탕 전체 영역(0/0/10000/10000)·#000000·CENTER, 표시 이름은 키 앞 30자, 살아 있는 문구·자유 편집이 있는 품목은 SLOT. 백필 뒤 좌표·스타일 기본값 제거
- 출력: OrderItemDetail.customMode·customPreviewImageUrl·customBaseImageUrl·customImages(kind 선언 순)·threeDDesign(타입 출력 ThreeDDesign), OrderItemCustomText.tokenId·label·valueText(nullable)·좌표·textColor·textAlign, OrderItemFreeEdit.posX..height(cropImageUrl 삭제). 상세 include 3곳은 공용 조각 하나로 합쳤다
- 저장된 디자인 JSON은 형태·버전을 방어적으로 읽고 어긋나면 디자인만 null + 경고 로그(상세는 내려간다)
- 리뷰 Before 원천을 custom_preview_image_url로 바꿨다(기존 리뷰 불변, 옵션 요약 현행, 문구 미복사)
- 배지: SellerOrderSummary·AdminOrderSummary.hasCustom·firstItemCustomImageUrl, SellerOrderUpdate.hasCustom(발행 매퍼가 행의 첫 품목에서 상품명·커스텀 여부를 함께 읽는다)
- 시드: 문구·자유 편집 새 열, 슬롯형 합성 이미지 예시. resetSeedScope는 디자인·이미지를 주문 품목보다 먼저 지운다
- 게이트: model-ownership(디자인·이미지 order, 앱 writer는 주문 생성 PR에서), removed-schema-elements(OrderItemFreeEdit.cropImageUrl), enum-sdl-sync(CustomImageKind ↔ CustomImageKindType)
테스트
- 마이그레이션 spec 3건(마이그레이션 직전 모양 임시 표에서 열 추가·백필·기본값 제거 실행): 이행 값, 기본값 제거·nullable, SLOT 판정(삭제만 있는 품목 NONE)
- 리뷰 07b 백필 spec은 지워진 crop_image_url을 임시 표로 되살려 그대로 검증
- 디자인 방어 파싱 26건(정상·키 생략·행 없음 + 깨진 형태 23종 → null + 기록)
- 매퍼: 커스텀 출력·없음·tokenId/valueText null·3D 디자인·배지 표
- real DB: 구매자 상세 커스텀 스냅샷·읽을 수 없는 디자인, 판매자 목록 배지 3종·상세 렌더 순서, 관리자 목록 배지·상세, 리뷰 Before 3D·슬롯형·없음, 구독 hasCustom, resetSeedScope 디자인·이미지
쇼케이스는 리뷰의 작성 시점 스냅샷 before_image_url만 읽는데 시드 리뷰가 이 열을 채우지 않아, o4 품목에 커스텀 대표 이미지를 둬도 로컬에서 쇼케이스 후보에서 빠졌다. 변경점 - SeededOrders에 o4 대표 이미지 URL을 싣고 seedReviews가 before_image_url로 복사한다 테스트 - seed-reset-scope spec 통과 - 시드 → listShowcaseReviewIdsByLikes 임시 spec으로 시드 리뷰가 후보 1건으로 잡히고, 시드 변경을 되돌리면 0건인 것을 확인했다(임시 spec은 커밋하지 않음)
|
Important Review skippedAuto reviews are disabled on base/target branches other than the default branch. Please check the settings in the CodeRabbit UI or the
|
Codex Review Summary: ✅ CompletedThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
🧹 knip — dead-code 리포트전체 리포트
|
🩺 NestJS Doctor — 90/100 (Excellent)진단 514건 (error 14).
architecture / security 상위 항목
|
Coverage report
Show new covered files 🐣
Show files with reduced coverage 🔻
Test suite run success5891 tests passing in 424 suites. Report generated by 🧪jest coverage report action from fb80fbf |
Codecov Report✅ All modified and coverable lines are covered by tests. 📢 Thoughts on this report? Let us know! |
개요
커스텀 주문의 스냅샷 스키마와 주문 상세 커스텀 출력을 더합니다.
crop_image_url삭제).OrderItemFreeEdit.cropImageUrl)는 호환 단계 없이 바로 지우고, 기존 행은 마이그레이션 백필로 옮깁니다.feat/order-custom-upload)이 이 PR 머지 뒤에 맡습니다.변경 사항
20261118182831_order_custom_snapshot)order_item:custom_mode_snapshot(기본 NONE)·custom_base_image_url_snapshot·custom_preview_image_urlorder_item_custom_texttoken_id(원본 문구 자리, FK 없음): 자리가 바뀌거나 지워져도 스냅샷은 그대로라 FK를 두지 않았고, 자리 지정 전 주문은 null입니다.label_snapshot,pos_x..height,text_color,text_alignvalue_textnullable: 선택 자리를 지운 '문구 없음'입니다.order_item_custom_free_edit:pos_x..height추가,crop_image_url삭제order_item_custom_design(order_item_idunique,schema_version,design_json)·order_item_custom_image(kind,image_url,(order_item_id, kind)unique)deleted_at을 두지 않았습니다. 가시성은 부모 품목을 따르고SOFT_DELETE_MODELS에 넣지 않았습니다.enum CustomImageKind { THREE_D_TOP THREE_D_FRONT THREE_D_BACK THREE_D_LEFT THREE_D_RIGHT SLOT_COMPOSITE }-- backfill구간)#000000·CENTER로 옮깁니다. 열 추가 때 기본값으로 채우고 백필 뒤 기본값을 지웁니다.OrderItemDetail, 구매자·판매자·관리자 공용)customMode·customPreviewImageUrl·customBaseImageUrl·customImages[{ id kind imageUrl }](kind 선언 순)·threeDDesignthreeDDesign은 타입 출력입니다:ThreeDDesign { schemaVersion basic{ shape size design flavor sheetColor } top side }, 항목ThreeDDesignItem { kind x y size effect{ type intensity } text color decoId },enum ThreeDItemKindType { TEXT DECO }OrderItemCustomText.tokenId·label·valueText(nullable)·posX..height·textColor·textAlignOrderItemFreeEdit.posX..height(cropImageUrl삭제)snapshotReviewOrderItem의 Before 원천을custom_preview_image_url로 바꿨습니다. 기존 리뷰는 바꾸지 않고, 옵션 요약은 현행대로이며 문구는 옮기지 않습니다.SellerOrderSummary·AdminOrderSummary.hasCustom·firstItemCustomImageUrl(첫 품목 기준, 필터 없음)SellerOrderUpdate.hasCustom: 발행 매퍼가 행의 첫 품목에서 상품명과 커스텀 여부를 함께 읽도록 바꿔, 입금 확인·판매자 상태 변경·관리자 취소 세 발행 지점이 같은 값을 냅니다.before_image_url)으로 복사합니다. 기존 시드 리뷰는 이 열을 채우지 않아 로컬 쇼케이스 후보에서 빠져 있었습니다.resetSeedScope: 커스텀 디자인·이미지를 주문 품목보다 먼저 지웁니다.OrderItemCustomDesign·OrderItemCustomImage(order, 앱 writer는 주문 생성 PR에서)OrderItemFreeEdit.cropImageUrlCustomImageKind↔CustomImageKindTypereview-order-item-snapshot.migration.spec)은 지워진crop_image_url을 임시 표로 되살려 그대로 검증합니다.테스트
value_textnullable, 크롭 열 삭제tokenId·valueTextnull, 3D 디자인, 배지 표(NONE·SLOT·THREE_D·품목 없음)hasCustom(판매자 상태 변경 true, 관리자 취소·입금 확인 false)listShowcaseReviewIdsByLikes임시 spec으로 시드 리뷰가 후보 1건으로 잡히고, 시드 변경을 되돌리면 0건인 것을 확인했습니다(임시 spec은 커밋하지 않음).hasCustom(1건)yarn test src/features/order src/features/review src/features/mypage/services/mypage-review.service.spec.ts src/features/product/services/product-home.service.spec.ts src/features/product/resolvers/product-home-query.resolver.spec.ts src/test src/graphql src/prisma84 suites, 1,315 tests 통과dto:check·docs:check·arch:check통과. 전체 jest는 pre-push에서 돕니다.플랜 대조
UploadPurpose·UPLOAD_POLICIES에ORDER_CUSTOM_RENDER·COMPOSITE·REFERENCE(10MB, JPEG·PNG·WebP)feat/order-custom-upload)OrderCustomUploadPurpose { RENDER COMPOSITE REFERENCE }(판매자·관리자UploadPurpose와 분리)OrderCustomUpload모델과createOrderCustomUploadUrl(purpose, contentType, contentLength): UploadUrl!object_key IN (…) FOR UPDATE, 계정·용도·상태 검사,CUSTOM_UPLOAD_INVALID·CUSTOM_UPLOAD_EXPIRED)LIMIT 500 FOR UPDATE SKIP LOCKED, PURGING 커밋 → 삭제 → 성공 행 하드 삭제, 실패 PURGING 유지 + error 경보)S3Service.deleteObjects신설OrderItem커스텀 열 3개,OrderItemCustomText스냅샷 열,OrderItemCustomFreeEdit좌표·crop_image_urlDROPOrderItemCustomDesign·OrderItemCustomImage(deleted_at 없음,SOFT_DELETE_MODELS미등록, 신규 모델 등록)OrderItemCustomText·FreeEdit·Attachmentwriters를order()로order([])로 등록했습니다OrderItemDetail커스텀 필드·threeDDesign(타입 출력),OrderItemCustomText·OrderItemFreeEdit필드,cropImageUrl삭제custom_preview_image_url(기존 리뷰 불변, 옵션 요약 현행, 문구 미복사)hasCustom·firstItemCustomImageUrl(필터 없음),SellerOrderUpdate.hasCustoms3:DeleteObject(order-custom/*) statementresetSeedScope에order_custom_upload·커스텀 디자인·이미지 정리, seed-reset-scope spec 갱신order_custom_upload정리는 그 표와 함께 분할 2/2 PRfeat/order-custom-uploadPR로 나눠 이 PR 뒤에 머지합니다)hasCustom, 필터 없음)와 판매자 구독hasCustomCustomImageKind), 윗면 = 대표 이미지, 관리자 상세 이미지 출력value_textnullablelabel_snapshot)과 백필token_id·키·표시 이름·좌표·스타일·바탕 이미지 스냅샷 열SLOT_COMPOSITE)와 대표 이미지