뮤블 동기화 시스템

클라우드 소설의 에피소드와 위키 문서, 플롯 캔버스 변경 사항을 서버와 자동으로 동기화하고 여러 클라이언트의 변경을 반영합니다.

뮤블은 별도의 저장 버튼을 누르지 않아도 에피소드와 위키의 단락, 플롯 캔버스 변경을 자동으로 저장합니다. 클라우드 소설에서는 변경된 부분을 서버와 동기화하고, 로컬 소설에서는 같은 동기화 흐름을 기기의 프로젝트 파일에 반영합니다.

단락 단위 동기화

에피소드와 위키는 문서 전체를 매번 덮어쓰지 않고 변경된 단락을 중심으로 동기화합니다. 서로 다른 단락을 수정한 변경은 함께 반영할 수 있어, 긴 원고 전체를 다시 전송하는 부담과 동시 작업 충돌 범위를 줄입니다.

문서 단위 LWW와의 차이

LWW(Last Write Wins)는 여러 변경 가운데 마지막으로 기록된 변경을 남기는 방식입니다. 문서 전체에 LWW를 적용하면 서로 다른 위치를 고쳤더라도 마지막에 저장한 문서 사본이 앞서 저장된 사본 전체를 덮어쓸 수 있습니다.

예를 들어 집에서는 노트북으로 첫 장면을 다듬고, 이동 중에는 태블릿에 남아 있던 같은 원고를 열어 마지막 장면을 고쳤다고 가정해 보겠습니다. 문서 단위 LWW에서는 태블릿이 나중에 동기화될 때 노트북에서 고친 첫 장면까지 태블릿의 이전 내용으로 돌아갈 수 있습니다. 뮤블은 첫 장면과 마지막 장면을 서로 다른 단락의 변경으로 판단하므로 두 수정 사항을 함께 반영할 수 있습니다.

노트북과 태블릿에서 같은 원고를 편집했을 때

충돌 범위를 문서 전체에서 단락 하나로 좁힙니다

문서 단위 LWW

마지막 문서가 전체를 덮어씀

노트북의 문서 사본도입부 수정

태블릿의 문서 사본결말 수정

도입부 수정중간 원고결말 수정

태블릿이 마지막에 저장되면 노트북에서 고친 도입부까지 이전 내용으로 돌아갈 수 있습니다.

뮤블 단락 단위 동기화

바뀐 단락만 각각 비교

노트북의 변경분도입부 단락만 전송

태블릿의 변경분결말 단락만 전송

도입부 수정중간 원고결말 수정

수정한 단락이 다르면 두 기기의 변경을 한 원고에 함께 남길 수 있습니다.

같은 단락을 동시에 고치면단락 안의 글자를 실시간으로 합치지는 않습니다. 더 최신인 변경을 반영하고 충돌 가능성을 경고합니다.

LWW는 Last Write Wins, 즉 마지막 변경을 남기는 방식입니다. 뮤블은 이 판단을 문서 전체가 아니라 변경된 단락마다 적용합니다.

이 구조는 여러 기기에서 번갈아 집필하거나 협업자가 서로 다른 부분을 고칠 때 특히 유리합니다. 충돌 판단 범위가 문서 전체가 아니라 실제로 수정한 단락으로 줄어들기 때문입니다. 다만 같은 단락을 동시에 수정하면 글자 단위로 내용을 합치지 않으며, 더 최신인 변경을 반영하고 충돌 가능성을 경고합니다.

많은 단락이 한꺼번에 바뀌면 요청을 여러 묶음으로 나누어 처리하며 대량 동기화 중 안내가 표시될 수 있습니다. 완료되기 전에는 문서를 닫거나 앱을 종료하지 않는 편이 안전합니다.

동기화등

에피소드와 위키 편집기, 플롯 캔버스 상단의 작은 동기화등에서 현재 저장 상태를 확인할 수 있습니다. 점 위에 마우스를 올리면 각 상태의 설명도 표시됩니다.

색상	상태	의미
● 회색	입력 대기	사용자가 입력을 이어가는 동안 기다리고 있습니다. 입력이 잠시 멈추면 변경 사항을 저장하기 시작합니다.
● 파란색	저장 중	변경 사항을 저장하거나 서버와 동기화하고 있습니다.
● 초록색	최신 상태	현재까지의 변경 사항이 정상적으로 반영되었습니다.
● 빨간색	오류	동기화 과정에서 오류가 발생했습니다. 인터넷 연결과 로그인 상태를 확인하고, 오류가 계속되면 작업 내용을 다른 곳에 복사해 보호하세요.
● 노란색	알 수 없는 상태	앱이 상태를 정상적으로 판별하지 못한 예외 상황입니다. 계속 표시되면 문서를 안전하게 복사한 뒤 앱을 다시 열어보세요.

뮤블은 저장할 때마다 화면을 스피너로 가리지 않으면서도 내부 동기화 상태를 숨기지 않기 위해 동기화등을 사용합니다. 작은 점의 색만으로 집필을 방해하지 않고 대기·저장·완료·오류를 계속 확인할 수 있도록 만든 표시 방식입니다.

저장되지 않은 변경이 남은 채 페이지를 벗어나려 하면 확인 창이 표시됩니다. 이때는 머무르기를 선택하고 동기화가 끝나는지 확인하는 편이 안전합니다.

동기화등 숨기기

에피소드 편집기의 동기화등이 필요하지 않다면 뮤블 설정하기 → 에피소드 → 에피소드 조작에서 동기화 상태 표시등 숨기기를 켤 수 있습니다. 다만 오류를 알아차릴 수 있는 가장 빠른 표시이므로 일반적인 사용에서는 계속 보이게 두는 것을 권장합니다. 이 설정은 현재 에피소드 편집기의 동기화등에만 적용됩니다.

다른 기기의 변경

다른 기기나 협업자가 문서를 수정하면 현재 화면에도 새 변경이 반영됩니다. 동시에 같은 단락을 고치는 등 일부 변경을 안전하게 반영하지 못한 경우에는 경고가 표시될 수 있습니다. 새로고침한 뒤 해당 단락과 최근 버전을 확인하세요.

동기화는 백업과 다릅니다

동기화는 여러 저장 위치의 최신 내용을 맞추는 기능이므로 삭제나 잘못된 수정도 함께 반영될 수 있습니다. 이전 상태로 돌아가려면 버전 관리 및 복원을, 서버와 별개의 사본이 필요하면 자동 로컬 백업이나 전체 내보내기를 사용하세요.

제작자의 말

실시간 공동 편집만 놓고 보면 CRDT처럼 여러 사용자의 글자 단위 변경을 자동으로 합치는 방식이 더 강력합니다. 하지만 뮤블의 초기 설계에서 동시 편집은 핵심 목표가 아니었습니다. 한 작가가 여러 기기를 오가며 긴 원고를 안전하게 저장하는 상황이 더 우선이었어요.

CRDT를 제대로 적용하려면 최종 문서뿐 아니라 변경 연산과 병합 상태를 저장 형식 전반에서 다뤄야 합니다. 이 구조는 실시간 협업에는 유리하지만, 문제가 생겼을 때 사람이 저장 데이터를 직접 확인하고 판본을 복구하거나 원인을 추적하기는 더 어려워집니다. 당시 뮤블의 사용 규모와 협업 범위에서는 저장 구조와 복구 도구까지 복잡하게 만드는 오버엔지니어링이 될 가능성도 컸습니다.

그래서 뮤블은 원고의 의미 있는 단위인 단락을 개별 데이터로 저장하고, 바뀐 단락만 시간과 문서 버전을 바탕으로 반영하는 방식을 고안했습니다. 실시간 CRDT만큼 세밀하게 동시 입력을 합치지는 않지만, 문서 전체가 덮어써지는 위험을 줄이면서 저장 데이터와 복구 과정을 비교적 단순하게 유지할 수 있습니다.

이후 협업 기능도 이 토대 위에 구현했습니다. 현재는 서로 다른 단락의 변경을 함께 반영하고 동시 작업이나 판본 차이를 감지해 경고하는 수준으로 방어할 수 있지만, 여러 사람이 같은 문장을 실시간으로 함께 쓰는 편집기를 목표로 하지는 않습니다.

관련 설정

다음 항목은 문제를 진단한 뒤에만 바꾸는 고급 설정입니다. 일반적인 사용에서는 기본값을 권장합니다.

관련 설정과 위치, 기본값, 동작
설정	기본값	동작
동기화 상태 표시등 숨기기뮤블 설정하기 → 에피소드 → 에피소드 조작 → 동기화 상태 표시등 숨기기	꺼짐	에피소드 편집기 상단의 동기화등을 숨깁니다. 오류 상태도 보이지 않으므로 일반적으로는 권장하지 않습니다.
동시 클라이언트 작업 경고 무시뮤블 설정하기 → 에피소드 → 에피소드 조작 → 동기화 고급 → 동시 클라이언트 작업 경고 무시	꺼짐	서버가 동시 변경을 병합했을 때 표시되는 경고를 숨깁니다.
다른 클라이언트 변경사항 무시뮤블 설정하기 → 에피소드 → 에피소드 조작 → 동기화 고급 → 다른 클라이언트 변경사항 무시	꺼짐	다른 클라이언트의 변경이 감지되어도 현재 문서를 자동으로 다시 불러오지 않습니다.
대량 동기화 메시지 숨기기뮤블 설정하기 → 에피소드 → 에피소드 조작 → 동기화 고급 → 대량 동기화 메시지 숨기기	꺼짐	많은 변경을 나누어 동기화할 때 진행 안내를 숨깁니다.
동시 클라이언트 작업 경고 무시뮤블 설정하기 → 위키 → 위키 조작 → 동기화 고급 → 동시 클라이언트 작업 경고 무시	꺼짐	서버가 동시 변경을 병합했을 때 표시되는 경고를 숨깁니다.
다른 클라이언트 변경사항 무시뮤블 설정하기 → 위키 → 위키 조작 → 동기화 고급 → 다른 클라이언트 변경사항 무시	꺼짐	다른 클라이언트의 변경이 감지되어도 현재 문서를 자동으로 다시 불러오지 않습니다.
대량 동기화 메시지 숨기기뮤블 설정하기 → 위키 → 위키 조작 → 동기화 고급 → 대량 동기화 메시지 숨기기	꺼짐	많은 변경을 나누어 동기화할 때 진행 안내를 숨깁니다.