저장과 버전 관리

var viewer = Inko.mount('#pdf-container', {
  src: '/pdfv/index.html',
  pdfUrl: '/files/contract.pdf',

  onSave: async function (canvasData, ok, msg) {
    if (!ok) { console.error('저장 실패:', msg); return; }

    // ok는 SDK 직렬화 성공. 호스트 저장 성공은 API 응답으로 별도 확인
    var response = await fetch('/api/annotations', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({
        documentId: 'contract-123',
        documentRevisionId: 'pdf-sha256-or-revision-id',
        baseVersion: 7,
        canvasData: canvasData
      })
    });
    if (!response.ok) throw new Error('호스트 저장 API 실패');
  }
});

// 뷰어 내장 저장 버튼 외에, 호스트 쪽 버튼·단축키에서도 트리거 가능
document.querySelector('#my-save-btn').onclick = function () {
  viewer.save();   // 응답은 위 onSave 콜백으로 전달
};

-- append-only 버전 테이블 예시 (PostgreSQL)
CREATE TABLE doc_annotations (
  id                    BIGSERIAL PRIMARY KEY,
  document_id           TEXT        NOT NULL,
  document_revision_id  TEXT        NOT NULL, -- 원본 PDF 개정 식별자/해시
  version_no            BIGINT      NOT NULL, -- 서버 트랜잭션에서 배정
  parent_version_id     BIGINT,
  principal_id          TEXT        NOT NULL, -- 인증 세션에서 서버가 확정
  canvas_data           TEXT        NOT NULL,
  canvas_sha256         CHAR(64)    NOT NULL,
  idempotency_key       UUID        NOT NULL,
  created_at            TIMESTAMPTZ NOT NULL DEFAULT clock_timestamp(),
  UNIQUE (document_id, document_revision_id, version_no),
  UNIQUE (idempotency_key)
);

-- 조회는 "이 문서의 모든 버전" 또는 "최신 1건"
CREATE INDEX idx_doc_annotations_doc
  ON doc_annotations (document_id, document_revision_id, version_no DESC);

-- UPDATE·DELETE 차단, ACL, 보존·백업 정책은 호스트 DB 권한과 운영 규칙으로 적용합니다.

// 1) 서버: 최신 버전 1건 조회
//    SELECT canvas_data FROM doc_annotations
//     WHERE document_id = 'contract-123'
//     ORDER BY version_no DESC LIMIT 1;

// 2) 클라이언트: 받은 값을 그대로 주입
Inko.mount('#pdf-container', {
  src: '/pdfv/index.html',
  pdfUrl: '/files/contract.pdf',
  initialCanvasData: latestCanvasData   // ← 그 시점부터 이어서 편집
});

// 특정 과거 버전부터 다시 작업하려면 그 버전의 canvas_data를 넘기면 됩니다.
// 이후 onSave 결과를 호스트 백엔드가 새 행으로 INSERT하고 UPDATE·DELETE를 제한해야
// 새 버전과 기존 이력이 보존됩니다.

var viewer = Inko.mount('#pdf-container', {
  src: '/pdfv/index.html',
  pdfUrl: '/files/contract.pdf',
  onChange: function (canvasData) {
    // 편집이 발생할 때마다 호출 — 임시 저장에 활용
    sessionStorage.setItem('draft-123', canvasData);
  }
});

// 또는 주기적 자동저장: 마지막 변경분 캐시를 읽어 서버로
setInterval(function () {
  var draft = viewer.getLastCanvasData();
  if (draft) navigator.sendBeacon('/api/annotations/draft', draft);
}, 30000);