동기화 규칙과 한계

판정표#

한 번의 동기화는 원격 매니페스트를 읽어 파일마다 아래처럼 판정. 화면의 미리보기와 실제 동기화가 같은 판정 함수를 사용하므로, 미리보기 결과대로 실행.

• 모든 쓰기는 "원격 file_id 에서 온 파일" 에만 적용. 직접 업로드한 파일은 판정 대상이 아님.
• 체크섬은 저장소가 실제로 기록한 바이트로 계산해 매니페스트와 비교. 전송 중 잘린 파일이 정상 파일로 통과하지 않음. 일치하지 않으면 그 파일만 폐기하고 경고 기록.
• 원격의 파일별 meta 와 원래 파일 이름은 플랫폼 파일의 meta.source 에 보관.
• 같은 file_id 의 이름만 변경되고 내용(sha256)이 같으면 "유지". 플랫폼의 파일 이름은 변경되지 않음.

전송 순서#

어노테이션 파일은 마지막에 내려받음. 어노테이션 검증은 데이터셋에 이미 있는 이미지와 짝을 대조. 매니페스트 순서(0001.json < 0001.png)대로 내려받으면 짝 일치율 0%. 실행 끝에 어노테이션을 한 번 더 검증해, 이미지가 이후 실행에서 추가된 경우에도 짝을 대조.

실행 제어#

API 로 동기화를 시작하면 202 와 실행 행을 즉시 반환. 진행 상황은 GET /api/v1/datasets/{id}/syncs/{sync_id} 나 실행 목록을 다시 읽어 확인, 취소는 POST /api/v1/datasets/{id}/syncs/{sync_id}:cancel. status 는 PENDING → RUNNING → SUCCEEDED · FAILED · CANCELED 순.

curl -b cookies.txt -H "X-Tenant: DEMO" -X POST \
  "http://localhost:10000/api/v1/datasets/<데이터셋 id>/syncs"
# 도는 중에 한 번 더 부르면:
# {"error_id":"…","code":"conflict","message":"a sync is already running for this dataset","detail":null}

서버 설정#

미지원 기능#