비동기 정리 패널

데이터셋과 컬렉션의 삭제는 내부 저장소(S3, ClickHouse, Delta Lake) 정리를 수반하기 때문에 비동기로 처리됩니다. 삭제 요청 후 실제 정리 진행 상황은 화면 우하단의 플로팅 정리 패널에 실시간으로 표시됩니다.

삭제 흐름

1. 사용자가 데이터셋 또는 컬렉션 삭제를 실행합니다.
2. 서버는 즉시 논리 삭제(metadata 정리)를 마친 후 후속 Cleanup 작업을 비동기 큐에 등록합니다.
3. 포털은 플로팅 패널을 열어 Cleanup 진행률을 표시합니다.
4. 사용자는 패널을 유지한 채 다른 작업을 계속할 수 있습니다.

패널 종류

• 데이터셋 정리 패널 (DatasetCleanupPanel): 단건 데이터셋 삭제 시 사용됩니다.
• 컬렉션 정리 패널 (CollectionCleanupPanel): 하위 자산까지 일괄 삭제하는 컬렉션 삭제(delete_items=true) 시 사용됩니다. 데이터셋별 진행 상태를 개별적으로 추적합니다.

표시 정보

• 집계 진행률: 전체 작업 중 완료된 비율
• 개별 작업 상태: 각 데이터셋의 대기 / 진행 / 완료 / 실패 상태
• 트레이스 펼침: 실패한 작업은 클릭하여 상세 트레이스를 인라인으로 확인할 수 있습니다.

자동 닫힘 정책

• 전부 성공: 완료 후 3초 뒤 자동으로 닫힙니다.
• 부분 실패 / 실패: 사용자가 직접 닫기 전까지 유지됩니다.

실패 처리

• 실패한 항목은 패널에 남아 실패 원인과 타임스탬프를 확인할 수 있습니다.
• 필요 시 다시 삭제를 시도하거나, 관리자에게 트레이스를 공유해 문제를 해결합니다.
• 네트워크 오류 등 일시적 실패는 서버 측에서 재시도 정책이 적용됩니다.
• 부분 cascade 실패: 컬렉션 삭제 시 일부 하위 자원만 실패하더라도, 정리 패널은 어떤 자원이 실패했는지 행 단위로 표시하고 트리 캐시는 정합성을 유지합니다(삭제된 자원은 트리에서 즉시 사라지고, 실패한 자원은 그대로 남습니다).

사용자 팁

• 삭제 직후 같은 이름의 자산을 재생성하려 할 때, Cleanup이 끝나지 않으면 이름 충돌이 발생할 수 있습니다. 패널 상태가 완료인지 확인한 뒤 재생성하세요.
• 패널은 브라우저 세션 내에서 유지되며, 페이지 이동 후에도 우하단에 떠 있습니다.