버전 기록

이전 버전을 확인하고 변경 내용을 검토하며 공유 문서를 복원합니다.

버전 기록은 협업에서 확정된 변경을 탐색 가능한 버전으로 정리합니다. 작성자, 시간, 작업과 과거 내용을 확인하고 권한이 있으면 복원할 수 있습니다. 페이지를 새로 고쳐도 기록을 조회할 수 있습니다.

버전 기록의 원리

편집 내용을 제출할 때 실행됩니다. 사용자 또는 Agent의 변경을 Mutation으로 표현하고 Changeset으로 묶어 협업 서비스에 제출한 뒤 확정하여 저장합니다.

100%

Revision은 문서 기록에서 확정된 제출의 위치를 나타냅니다. History는 확정된 Changeset의 색인을 만들고 시간과 작업에 따라 그룹화하여 버전 타임라인을 구성합니다.

과거 버전을 선택할 때 실행됩니다. Snapshot은 특정 revision의 전체 콘텐츠 상태입니다. 기준 Snapshot과 목표 revision까지의 후속 Changeset을 읽고 Mutation을 순서대로 재실행하여 읽기 전용 기록 화면을 만듭니다.

100%

예: revision 10의 Snapshot + revision 11~15의 Changeset = revision 15의 콘텐츠.

이 버전 복원을 선택할 때 실행됩니다.

대상 버전 선택 → 복원 Mutation 제출 → 협업에서 확정 → 현재 문서를 갱신하고 새 revision 생성

복원 작업도 새 기록을 만들며 이전 버전은 계속 유지됩니다.

일정 시간 내의 수정은 그룹으로 묶일 수 있습니다. 기록 항목은 각 키 입력이나 Snapshot 생성과 일대일로 대응하지 않습니다.

색상은 변경 유형을 나타냅니다. 텍스트 교체는 추가와 삭제를 함께 표시할 수 있으며, 강조 범위는 제품 뷰어가 결정합니다.

다음은 영문 Northstar 프로젝트 예시입니다. 펼친 타임라인과 콘텐츠를 함께 보여 줍니다.

Launch Budget 에서 예산, 예측값, 행 추가 및 삭제를 확인합니다.

Product Launch Brief 에서 출시일, 문단 서식, 고객 준비 사항을 검토합니다. 삭제된 텍스트에는 빨간 취소선이 표시됩니다.

Launch Review 에서 목표 수치와 슬라이드 개체 변경을 추적합니다.

Launch Tracker 에서 작업, 담당자, 상태 및 레코드와 필드의 변경을 확인합니다.

Release Workspace 에서 계획 카드와 개체 속성 변경을 공간적 맥락 안에서 확인합니다.

Coming soon: PDF 버전 기록은 아직 제공되지 않습니다.

서버: Core Collaboration 에 History Service, Endpoint 및 영구 저장용 Database Adapter 를 추가합니다. Unit 생성과 changeset 확정 이벤트로 기록 색인을 만들고 버전 및 변경 조회를 제공합니다.
브라우저: 공통 기록 기능과 제품별 History / History UI 플러그인을 등록하고 기록 API 에 연결합니다. 뷰어는 선택한 revision 과 차이를 불러옵니다. 사용자 정의 콘텐츠에는 해당 뷰어 플러그인이 필요합니다.
권한: 애플리케이션이 인증 및 인가를 제공하고 서버가 기록 조회와 복원 권한을 확인합니다. 과거 버전에는 현재 삭제된 데이터도 포함될 수 있습니다.

협업 확장과 History 예제를 참고하여 서비스를 구성하고 제품별 가이드로 UI 를 연결하세요.

기록 색인은 다시 만들 수 있는 파생 데이터이며 확정된 changeset 이 권위 있는 원본입니다. 영구 저장과 보존 정책은 애플리케이션이 관리합니다. 기록 패널은 백업을 대체하지 않습니다.