환경설정
구글 드라이브 및 저장 환경
Yuli 내에서 작품 데이터를 관리하는 방식을 설명합니다.
구글 드라이브 및 저장 환경
로컬 저장 기준
- 프로그램 내 작품 데이터는 Yuli 서버에 저장되지 않습니다.
- 윈도우 기준 로컬 저장 위치는
%APPDATA%\\Yuli입니다. - 서버에 저장되는 데이터는 구글 로그인 시 필요한 회원 정보로 제한됩니다.
- 작품 본문, 설정, 로컬 에셋, 프로젝트 매니저 배치 정보는 기기 로컬 저장소와 사용자가 선택한 Google Drive 백업 위치를 기준으로 관리됩니다.
Google Drive 백업 단위
- Google Drive 백업 및 복원은 프로그램 전체가 아니라 작품 단위로 이루어집니다.
- 작품 데이터는 용량이 큰 편이고, 기기마다 서로 다른 작품을 관리할 수 있어야 하므로 전체 workspace를 통째로 동기화하지 않습니다.
- 백업 경로는 작품 ID 단위로 분리되며, 각 작품의
local-yuli-storage, 백업 manifest, 프로젝트 메타가 함께 저장됩니다.
프로젝트 매니저 배치 정보
- 현재 프로젝트 매니저의 전시 위치는
placement값으로 저장됩니다. - 일반 홀은
{ type: "hall", hall: 1 }형태로 저장됩니다. - Masterpiece는 일반 홀 숫자가 아니라
{ type: "special", key: "masterpiece" }형태로 저장됩니다. - 이전 개발/beta 데이터에서 사용되던 숫자 홀 값은 현재 앱에서 읽을 때 정규화됩니다. 특히 과거 Masterpiece용
hall: 999값은 현재 앱에서 Masterpiece placement로 해석됩니다. - 새로 저장되는 프로젝트 메타와 Google Drive 백업 메타에는 숫자
999sentinel을 다시 기록하지 않습니다.
복원 시 적용 범위
- 기존 작품에 복원하는 경우:
- 작품의 저장 데이터는 백업 내용으로 복원됩니다.
- 프로젝트 매니저의 상태, 진행률, 커버 정보는 백업 메타를 반영합니다.
- 기존 작품이 현재 어느 Hall/Masterpiece에 놓여 있는지는 유지됩니다.
- 새 작품으로 복원하는 경우:
- 복원 모달에서 선택한 Hall 또는 Masterpiece placement로 새 작품이 생성됩니다.
- 같은 placement 안에서 정렬 순서가 다시 계산됩니다.
- 상태, 진행률, 커버 정보는 백업 메타를 반영합니다.
- 미배포 beta 시점의
hall기반 백업은 현재 앱의 복원 목록에 표시될 수 있습니다. 현재 앱에서 새 작품으로 복원하면 백업 안의 옛 hall 값이 아니라 복원 모달에서 선택한 placement가 적용됩니다. - 현재 앱이 만드는
placement기반 백업은 이전 beta 앱의hall기반 프로젝트 매니저 배치 로직과 호환을 보장하지 않습니다.