My App
환경설정

구글 드라이브 및 저장 환경

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 백업 메타에는 숫자 999 sentinel을 다시 기록하지 않습니다.

복원 시 적용 범위

  • 기존 작품에 복원하는 경우:
    • 작품의 저장 데이터는 백업 내용으로 복원됩니다.
    • 프로젝트 매니저의 상태, 진행률, 커버 정보는 백업 메타를 반영합니다.
    • 기존 작품이 현재 어느 Hall/Masterpiece에 놓여 있는지는 유지됩니다.
  • 새 작품으로 복원하는 경우:
    • 복원 모달에서 선택한 Hall 또는 Masterpiece placement로 새 작품이 생성됩니다.
    • 같은 placement 안에서 정렬 순서가 다시 계산됩니다.
    • 상태, 진행률, 커버 정보는 백업 메타를 반영합니다.
  • 미배포 beta 시점의 hall 기반 백업은 현재 앱의 복원 목록에 표시될 수 있습니다. 현재 앱에서 새 작품으로 복원하면 백업 안의 옛 hall 값이 아니라 복원 모달에서 선택한 placement가 적용됩니다.
  • 현재 앱이 만드는 placement 기반 백업은 이전 beta 앱의 hall 기반 프로젝트 매니저 배치 로직과 호환을 보장하지 않습니다.

On this page