Repository navigation
feat: 커스텀 주문 이미지 선업로드와 미사용 업로드 정리 크론 - #575
Conversation
구매자가 커스텀 이미지(3D 렌더·슬롯형 합성·자유 편집 참고 사진)를 주문 전에 presign으로 올리고 주문 생성 때 URL을 내도록 발급 API와 발급 기록을 둔다. 주문에 쓰이지 않은 업로드는 worker가 하루 뒤 S3에서 지우고, 주문된 파일은 보관한다. 주문 생성의 업로드 연결(소유·용도·상태 검사 후 ATTACHED)은 다음 PR이 붙인다.
변경점
- 스키마·마이그레이션(order_custom_upload): OrderCustomUpload(account_id, purpose RENDER·COMPOSITE·REFERENCE, object_key unique, content_type, content_length, status PENDING·ATTACHED·PURGING, attached_at, purge_started_at), (status, created_at)·(status, purge_started_at)·account_id 인덱스. 새 표라 백필 없음
- 업로드 용도: TS UploadPurpose·UPLOAD_POLICIES에 ORDER_CUSTOM_RENDER·COMPOSITE·REFERENCE(order-custom/{renders,composites,references}, 10MB, JPEG·PNG·WebP). 판매자·관리자 SDL UploadPurpose에는 섞지 않았다
- createOrderCustomUploadUrl(purpose: OrderCustomUploadPurpose!, contentType, contentLength): UploadUrl!. 구매자 계정만(USER_ONLY), 발급 뒤 PENDING으로 기록한다
- S3Service.deleteObjects(keys): 요청당 1000개, 키별 오류와 요청 실패를 실패 목록으로 돌려주고 던지지 않는다
- 정리 크론(매시 20분, 역할 게이트, 겹친 틱 건너뜀): PURGING ∧ 1시간 경과, PENDING ∧ 24시간 경과를 상태별 인덱스 범위로 LIMIT 500 FOR UPDATE SKIP LOCKED로 잡아 PURGING 표시·커밋 → S3 삭제 → 지워진 행만 하드 삭제. 실패한 키는 PURGING으로 남기고 error 경보(key order-custom-upload:purge), 그 틱에서는 더 잡지 않는다. 한 틱 최대 20묶음
- IAM: terraform/aws.tf 앱 정책에 s3:DeleteObject(order-custom/*) statement. apply는 사람 키로 한다
- resetSeedScope: 시드 사용자의 업로드 기록을 지운다. model-ownership: OrderCustomUpload는 order
테스트
- 정리 크론 7건(real DB, S3·경보 stub): 대상 경계(PENDING 24h·24h−1ms, PURGING 1h·1h−1ms, ATTACHED 72h 미선택), 부분 실패 PURGING 유지·경보·1시간 뒤 재시도, 묶음 이어 잡기·실패 뒤 중단, 주문 tx가 잡은 행 건너뜀, api 역할 미실행, 겹친 틱, DB 실패 경보
- S3 deleteObjects 5건(조용한 모드·키별 오류·요청 실패·1000개 분할·빈 목록), 용도 정책 3종 × 형식·크기
- 발급: 용도 3종 키·기록, 형식·크기·0 거절과 미기록, 판매자 USER_ONLY, 리졸버 1건
- resetSeedScope 업로드 기록 1건
입력 SDL enum OrderCustomUploadPurpose에만 값이 늘면 발급 서비스의 용도 → 업로드 정책 매핑이 비어 S3Service에서 TypeError가 나고 500으로 떨어진다. 매핑은 Prisma enum으로만 satisfies 검사되고, enum-sdl-sync는 출력 방향(Prisma ⊆ SDL)만 대조해 이 어긋남을 잡지 못했다. 변경점 - enum-sdl-sync에 입력 쌍 목록(INPUT_PAIRS)을 두고 반대 방향(SDL ⊆ Prisma)을 대조한다. 첫 쌍은 OrderCustomUploadPurpose - 대조 함수 이름을 방향 중립(missingFrom)으로 바꿨다 테스트 - enum-sdl-sync 20건 통과(입력 방향 2건 추가: 반증 — SDL에 값을 더하면 잡는다, 실제 SDL 대조) - 반증: 실제 SDL에 SKETCH를 더하면 실제 대조가 실패하는 것을 확인하고 되돌렸다
createOrderCustomUploadUrl 설명이 실제로 나는 오류 코드 일부를 빠뜨렸고, 입력 전용 enum에 출력 enum용 문구가 붙어 있었다. 정리 크론의 재시도 주석은 매시 크론이라 실제로는 1~2시간 뒤 다시 지우는 것을 1시간 뒤로 적고 있었다. 변경점 - SDL 설명: INVALID_CONTENT_LENGTH(크기 0 이하)·BUYER_ACCOUNT_NOT_ACTIVE(정지·탈퇴·프로필 없음) 추가, OrderCustomUploadPurpose 설명에서 출력용 문구 삭제 - 정리 크론: 재시도 시점 주석을 '1시간이 지난 뒤의 정리(1~2시간 뒤)'로 정정(판정 기준 1시간은 그대로) 테스트 - 정리 크론·발급 리졸버 spec 통과, docs:check 통과
|
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)진단 515건 (error 14).
architecture / security 상위 항목
|
Coverage report
Show new covered files 🐣
Show files with reduced coverage 🔻
Test suite run success5926 tests passing in 426 suites. Report generated by 🧪jest coverage report action from 0dcb9f1 |
Codecov Report❌ Patch coverage is
📢 Thoughts on this report? Let us know! |
개요
구매자가 커스텀 이미지를 주문 전에 presign으로 올리는 발급 API와, 주문에 쓰이지 않은 업로드를 지우는 정리 크론을 더합니다.
SKIP LOCKED는 그 잠금과 맞물리게 이 PR에 넣었습니다.feat/order-custom-snapshot, 커스텀 스냅샷 스키마·주문 상세 출력) 위에 쌓았고, 그 PR 머지 뒤 develop 기준으로 올립니다.변경 사항
20261118190324_order_custom_upload)OrderCustomUpload { account_id, purpose(RENDER·COMPOSITE·REFERENCE), object_key unique, content_type, content_length, status(PENDING·ATTACHED·PURGING), attached_at?, purge_started_at? },(status, created_at)·(status, purge_started_at)·account_id인덱스. 새 표라 백필이 없습니다.UploadPurpose·UPLOAD_POLICIES에ORDER_CUSTOM_RENDER·ORDER_CUSTOM_COMPOSITE·ORDER_CUSTOM_REFERENCE(order-custom/{renders,composites,references}, 10MB, JPEG·PNG·WebP)를 더했습니다. 판매자·관리자 SDLUploadPurpose에는 섞지 않았습니다.createOrderCustomUploadUrl(purpose: OrderCustomUploadPurpose!, contentType: String!, contentLength: Int!): UploadUrl!USER_ONLY, 정지·탈퇴·프로필 없음은BUYER_ACCOUNT_NOT_ACTIVE).INVALID_CONTENT_TYPE·INVALID_CONTENT_LENGTH·FILE_TOO_LARGE). SDL 설명에 이 오류 코드를 모두 적었습니다.OrderCustomUploadCleanupScheduler, 매시 20분)LIMIT 500 FOR UPDATE SKIP LOCKED잡아 PURGING 표시를 먼저 커밋합니다. 표시 뒤에는 주문이 그 업로드를 붙이지 못하고, 주문 tx가 잡고 있는 행은 건너뜁니다.S3Service.deleteObjects로 지우고 지워진 행만 하드 삭제합니다.order-custom-upload:purge)를 보냅니다. S3 장애일 수 있어 그 틱에서는 더 잡지 않습니다. 한 틱 최대 20묶음입니다.S3Service.deleteObjects(keys)신설: 요청당 1,000개, 키별 오류와 요청 자체의 실패를 실패 목록으로 돌려주고 던지지 않습니다.terraform/aws.tf앱 정책에s3:DeleteObject(order-custom/*) statement를 더했습니다. apply는 사람 키로 하는 사용자 작업이라 하지 않았고, 늦으면 크론이 AccessDenied 경보를 내고 업로드가 쌓입니다(유실 없음).terraform fmt통과.resetSeedScope: 시드 사용자의 업로드 기록을 지웁니다.OrderCustomUpload(order)OrderCustomUploadPurpose입니다.테스트
deleteObjects5건(조용한 모드, 키별 오류, 요청 실패, 1,000개 분할, 빈 목록), 주문 커스텀 용도 정책 3종 × 형식 3·초과/형식 거절USER_ONLY, 리졸버 1건OrderCustomUploadPurpose에 값을 하나 더하면 입력 enum 대조가 실패(2건)yarn test src/features/order src/global/storage src/test src/graphql src/prisma68 suites, 1,145 tests 통과dto:check·docs:check·arch:check통과. 전체 jest는 pre-push에서 돕니다.플랜 대조
UploadPurpose·UPLOAD_POLICIES에ORDER_CUSTOM_RENDER·COMPOSITE·REFERENCE(10MB, JPEG·PNG·WebP)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신설s3:DeleteObject(order-custom/*) statementresetSeedScope에order_custom_upload·커스텀 디자인·이미지 정리, seed-reset-scope spec 갱신order_custom_upload). 커스텀 디자인·이미지는 분할 1/2 PR에서 함feat/order-custom-snapshot)에서 함OrderItemCustomText·FreeEdit·Attachmentwriters를order()로COMPOSITE)