[devlasbe]

요약

릴리즈 메타데이터 수정을 disabled/mandatory 전용 엔드포인트 2개로 분리하고, 웹에서 Mandatory 토글을 지원한다. Slack 알림도 두 액션 모두 발사하며 이모지를 단순화한다.

• PRD: 없음
• Figma: 없음

배경

• 오리지널 CodePush는 patch -m으로 mandatory 변경이 가능했으나, 이 재구현 서버는 PackageInfoUpdateSchema에 isMandatory가 없고 updatePackage도 UPDATE하지 않아 200 응답을 주면서 조용히 무시하는 상태.
• 웹은 Disable/Enable만 가능하고 Mandatory는 배지 표시만 있어, 배포 후 강제 업데이트 전환이 불가능했다.

변경 사항

• management.ts — disabled/mandatory 전용 PATCH 엔드포인트 2개 신설

  • Before: PATCH /release 하나로 appVersion/description/isDisabled만 수정 가능, isMandatory는 침묵 무시
  • After: /release/disabled {label?, isDisabled} / /release/mandatory {label?, isMandatory}로 각 상태를 따로 관리
  • 세부:
    • label 생략 시 최신 릴리즈 대상 (기존 update와 동일 규칙)
    • 권한: Collaborator (기존과 동일 게이트: 401 → 404 → 403)
    • 기존 PATCH /release는 CLI(code-push-standalone patch) 호환을 위해 그대로 유지
    • 각 핸들러가 Slack 알림 발사 (disabled → Disabled/Enabled, mandatory → MandatoryOn/Off)

• d1.ts / storage.ts — updatePackageMetadata 부분 UPDATE 신설

  • Before: updatePackage가 캐시에서 읽은 release의 여러 필드를 통째 SET
  • After: 신규 핸들러는 대상 컬럼만 UPDATE (deploymentId+label+deletedAt 스코프)
  • 세부:
    • 히스토리 캐시가 isolate별 메모리(TTL 5분)라, stale 캐시 기반 전체 SET은 다른 isolate가 방금 바꾼 필드를 되돌릴 수 있음(lost update — 예: 긴급 disable 직후 다른 isolate에서 mandatory 토글 시 disable 풀림) → 부분 UPDATE로 원천 차단
    • 쓰기 후 캐시 무효화는 기존과 동일

• slack.ts — 액션 종류 재구성 + 업로드 실패 알림 추가

  • Before: Uploaded/Enabled/Disabled 3종, 헤더에 큰 원형 이모지 🟢/🔴, 업로드 실패 시 알림 없음
  • After: 종류별 4종 — Uploaded(🚀) / UploadFailed(🚨) / Disabled(🧊) / Mandatory(🔥)
  • 세부:
    • on/off는 헤더 텍스트가 Disabled true/false, Mandatory true/false로 표현 (이모지는 종류 구분만)
    • release.create의 업로드 파이프라인(롤아웃 미완 409/중복 번들 409/R2·D1 오류)을 try-catch로 감싸 실패 시 UploadFailed 알림 발사, 에러 메시지를 본문 코드 블록으로 첨부 (인증·권한 실패는 대상 아님)

• HistoryPage.tsx(web) — Mandatory 토글 + 버튼 단순화

  • Before: 카드마다 빨간 filled(destructive) Disable 버튼, Mandatory는 배지 표시만
  • After: Mandatory/Optional + Enable/Disable 버튼 2개를 무채색 outline으로 통일
  • 세부:
    • disableMutation을 신규 /release/disabled로 교체, mandatoryMutation 신설
    • Mandatory ON confirm에 강제 업데이트 승격 경고 명시 (updateCheck의 mandatory 승격 로직 파급 고지)

• api-client — pnpm generate 재생성 (신규 메서드 2개)

테스트

• 로컬 실서버(677개 릴리즈) E2E: mandatory ON/OFF·disabled ON/OFF → DB 반영 + 캐시 무효화 확인
• 부분 UPDATE 검증 — disabled 토글이 mandatory 값을 건드리지 않음
• label 생략 시 최신 릴리즈 대상 / 미인증 401 / 기존 PATCH /release 200 불변
• tsc·biome ci·vitest 117/117 (server), tsc·build (web)

테스트 후 로컬 DB 상태 원상복구 완료.

참고

• 캐싱·위험성 분석 전체는 Jira 참조: https://yplabs.atlassian.net/browse/FE-67
• 기존 PATCH /release(CLI 경로)에는 전체 필드 SET 패턴이 남아 있음 — pre-existing이며 범위 밖 (별도 트랙 후보)
• DB 마이그레이션 불필요 (is_mandatory 컬럼 기존재)

🤖 Generated with Claude Code