Skip to content

feat: 업무카드 허용 행동·Renewal 실행 사유 계약 보완 - #221

Merged
hywznn merged 1 commit into
mainfrom
feat/220-task-available-actions
Aug 20, 2026
Merged

feat: 업무카드 허용 행동·Renewal 실행 사유 계약 보완#221
hywznn merged 1 commit into
mainfrom
feat/220-task-available-actions

Conversation

@hywznn

@hywznn hywznn commented Aug 20, 2026

Copy link
Copy Markdown
Member

배경

OCR 검토·자동 Renewal 이후 기존 승인이 무효화된 업무에서도 Client가 task_type만 보고 Renewal 실행을 다시 노출해 RENEWAL_EXECUTION_NOT_ALLOWED가 발생했습니다. 화면이 상태를 추측하지 않도록 Server가 현재 가능한 행동을 명시합니다.

Closes #220

변경 내용

  • Task 상세 응답에 next_action, available_actions, blocked_reason 추가
  • Task 상태, 필수 체크리스트, 누락 Slot, OCR·안내문·생성 문서 상태를 기준으로 다음 행동 계산
  • 허용된 Task에만 RUN_RENEWAL 제공하고 재승인이 필요하면 REQUEST_APPROVAL 반환
  • 승인 완료 후에도 증빙 없이 바로 완료할 수 있다고 노출하지 않도록 허용 행동을 보수적으로 제한
  • AI 요청 계약 오류와 Workflow 불일치를 각각 RENEWAL_REQUEST_CONTRACT_INVALID, RENEWAL_WORKFLOW_MISMATCH로 구분
  • Flyway·DB 변경 없음

검증

  • ./gradlew clean test
  • 허용 행동 Resolver 단위 테스트 ✅
  • Renewal 오류 계약 통합 테스트 ✅
  • OpenAPI snake_case 필드 계약 테스트 ✅

연동 순서

이 PR을 먼저 병합·배포한 뒤 Client의 연동 PR을 병합합니다.

@hywznn
hywznn marked this pull request as ready for review August 20, 2026 04:13
@hywznn
hywznn merged commit 4547048 into main Aug 20, 2026
4 checks passed
@hywznn
hywznn deleted the feat/220-task-available-actions branch August 20, 2026 04:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Task][P0] 업무카드 허용 행동·Renewal 실행 사유 계약 보완

1 participant