Google Drive 동기화

NLook은 Google Drive와 연동하여 데이터를 안전하게 백업하고 복원할 수 있습니다.

개요

Google Drive 동기화를 통해 다음과 같은 기능을 사용할 수 있습니다:

• 자동 백업: 매일 새벽 3시(KST)에 자동으로 데이터가 백업됩니다

• 수동 백업: 언제든지 직접 백업을 생성할 수 있습니다

• 데이터 복원: 백업된 스냅샷에서 데이터를 복원할 수 있습니다

• 스냅샷 관리: 최근 7일간의 백업이 자동으로 관리됩니다

Google Drive 연동하기

1. 설정 > 서비스 연동으로 이동합니다

2. Google Drive 서비스에서 연동하기 버튼을 클릭합니다

3. Google 계정으로 로그인하고 권한을 허용합니다

4. 연동이 완료되면 동기화 기능을 사용할 수 있습니다

백업하기

자동 백업

• Google Drive가 연동되면 매일 새벽 3시(KST)에 자동으로 백업됩니다

• 데이터 변경이 없으면 백업을 건너뜁니다 (불필요한 파일 생성 방지)

• 최근 7일간의 백업만 유지되며, 오래된 백업은 자동 삭제됩니다

수동 백업

1. 설정 > 동기화 섹션으로 이동합니다

2. 지금 백업하기 버튼을 클릭합니다

3. 백업이 완료되면 스냅샷 목록에서 확인할 수 있습니다

복원하기

복원 미리보기

1. 스냅샷 목록에서 복원할 스냅샷을 찾습니다

2. 복원 버튼(다운로드 아이콘)을 클릭합니다

3. 현재 데이터와 스냅샷 데이터를 비교할 수 있습니다

복원 모드

병합 모드 (안전)

• 기존 데이터를 유지하면서 스냅샷의 새로운 데이터만 추가합니다

• 중복된 데이터는 건너뜁니다

• 데이터 손실 위험이 없는 안전한 복원 방식입니다

덮어쓰기 모드

• 기존 데이터를 완전히 삭제하고 스냅샷의 데이터로 대체합니다

• 주의: 이 작업은 되돌릴 수 없습니다

• DB 소실 시 완전 복구가 필요할 때 사용합니다

백업 데이터 구조

저장 위치

백업은 Google Drive의 다음 위치에 저장됩니다:

내 드라이브/
└── NLook Sync/
    ├── data/           # 최신 데이터 (개별 파일)
    │   ├── projects.json
    │   ├── task_lists.json
    │   └── tasks.json
    ├── backups/        # 일별 스냅샷 (7일 보관)
    │   ├── 2024-12-01.json
    │   └── 2024-12-02.json
    └── metadata.json   # 동기화 메타데이터

백업 내용

• 프로젝트(문서): 제목, 내용, 태그, 카테고리, 이미지 정보 등

• 할일 목록: 목록 이름, 색상, 순서 등

• 할일: 제목, 메모, 상태, 우선순위, 일정 등

데이터 포맷 (JSON 스키마)

스냅샷 구조

{
  "version": "1.0",
  "format": "nlook-sync-snapshot",
  "created_at": "2024-12-01T15:00:00Z",
  "user_id": 123,
  "stats": {
    "projects_count": 10,
    "task_lists_count": 3,
    "tasks_count": 25
  },
  "data": {
    "projects": [...],
    "task_lists": [...],
    "tasks": [...]
  },
  "checksums": {
    "projects": "sha256:abc123...",
    "task_lists": "sha256:def456...",
    "tasks": "sha256:ghi789..."
  }
}

프로젝트 데이터

{
  "id": 1,
  "uuid": "unique-project-id",
  "title": "프로젝트 제목",
  "data": "<p>프로젝트 내용 (HTML)</p>",
  "message": "간단한 설명",
  "tags": ["태그1", "태그2"],
  "category_id": 1,
  "is_public": false,
  "background_url": "https://...",
  "thumbnail": "https://...",
  "images": ["https://..."],
  "content_length": 1234,
  "metadata": {},
  "created_at": "2024-01-01T00:00:00Z",
  "updated_at": "2024-12-01T00:00:00Z"
}

할일 목록 데이터

{
  "id": 1,
  "title": "기본 목록",
  "description": "할일 목록 설명",
  "color": "#3b82f6",
  "position": 0,
  "is_default": true,
  "google_tasklist_id": null,
  "created_at": "2024-01-01T00:00:00Z",
  "updated_at": "2024-12-01T00:00:00Z"
}

할일 데이터

{
  "id": 1,
  "title": "할일 제목",
  "notes": "상세 메모",
  "status": "pending",
  "task_list_id": 1,
  "start_date": "2024-12-01T09:00:00Z",
  "due_date": "2024-12-01T18:00:00Z",
  "all_day": false,
  "priority": "high",
  "position": 0,
  "recurrence_type": "none",
  "recurrence_rule": null,
  "completed_at": null,
  "created_at": "2024-01-01T00:00:00Z",
  "updated_at": "2024-12-01T00:00:00Z"
}

자주 묻는 질문

Q: 백업은 얼마나 자주 되나요?

자동 백업은 매일 새벽 3시(KST)에 실행됩니다. 데이터 변경이 없으면 백업을 건너뜁니다.

Q: 백업 파일은 얼마나 보관되나요?

최근 7일간의 백업만 유지되며, 오래된 백업은 자동으로 삭제됩니다.

Q: 다른 계정으로 데이터를 옮길 수 있나요?

현재는 동일 계정 내에서만 복원이 가능합니다. 다른 계정으로 데이터 이전은 향후 지원 예정입니다.

Q: 백업 중 오류가 발생하면 어떻게 되나요?

자동 백업 중 오류가 발생해도 기존 데이터에는 영향이 없습니다. 로그에 오류가 기록되며, 다음 백업 시 재시도됩니다.

Q: 복원하면 현재 데이터가 삭제되나요?

복원 모드에 따라 다릅니다:

• 병합 모드: 기존 데이터를 유지하고 새 데이터만 추가합니다

• 덮어쓰기 모드: 기존 데이터가 삭제되고 스냅샷 데이터로 대체됩니다

Q: Google Drive 용량을 많이 차지하나요?

백업 파일은 JSON 형식으로 압축 없이 저장됩니다. 일반적인 사용량에서는 수 MB 정도이며, Google Drive 무료 용량(15GB) 내에서 충분히 사용 가능합니다.