release: 배포 실패 사유를 분류와 상세로 응답에 싣는다

[dldnsgkr]

develop → main. #168 하나이고 마이그레이션 V32 가 포함된다.

무엇이 달라지나

배포 이력 화면에 FAILED 만 뜨고 사유가 없었다. 응답에 아무것도 없어 FE 가 보여줄 수단이 없었다. 이제 두 필드를 준다.

errorCode:    WORKFLOW_FAILED | RESULT_UNKNOWN | RETRY_EXHAUSTED | null
errorMessage: 사람이 읽을 상세 | null

분류를 값으로 주는 이유는 화면이 문자열을 파싱해 분기하지 않게 하기 위해서다. 서버가 문구를 조금만 바꿔도 조용히 깨지는 구조를 만들지 않는다.

RESULT_UNKNOWN 이 핵심이다. "실패했다"가 아니라 "결과를 확인하지 못했다"이다. 웹훅을 놓친 이력을 회수하려던 워커(#161)가 GitHub 에서 실행을 못 찾고 포기한 경우이고, 사이트는 실제로 떠 있을 수 있다. 운영에 그렇게 닫힌 이력이 한 건 있다(projectId=11, historyId=1) — 지금은 화면에서 그냥 실패로 보인다.

마이그레이션

ALTER TABLE deployment_histories
    ADD COLUMN failure_code VARCHAR(40) NULL AFTER error_message;

컬럼 추가이고 NULL 허용이라 기존 행에 영향이 없다. 옛 이력은 errorCode 가 null 로 남고, FE 는 그 경우 errorMessage 만 표시하기로 합의했다.

검증

• 테스트 8개 추가. 재시도 한도 안이면 분류를 찍지 않는지 / 소진하면 RETRY_EXHAUSTED / 성공하면 옛 분류가 지워지는지(재시도로 되살아난 이력이 실패로 그려지지 않도록) / 회수 워커가 판정 유무로 WORKFLOW_FAILED 와 RESULT_UNKNOWN 을 가르는지
• ./gradlew test 전체 통과 — 통합 테스트가 V32 를 실제로 적용한다
• CI 통과, dev 배포 성공(add427f), dev 기동 확인(마이그레이션 적용 후 /auth/github/url 200)

관련: #161, #164

🤖 Generated with Claude Code