> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alforse.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 백업

> 한 회사의 레코드와 파일을 수동 스냅샷으로 저장하고, 각 스냅샷이 현재 Alforse에 여전히 복원되는지 확인하며, 되돌릴 수 있는 안전 스냅샷과 함께 제자리에서 복원합니다.

백업은 한 회사의 레코드와 필요한 경우 업로드된 파일의 저장본을 관리자에게 제공하며, 이를 나중에 같은 회사로 다시 불러올 수 있습니다. 모든 작업은 **설정 → 백업**에서 이루어집니다. 온보딩 중에는 Alforse 직원이 백업 파일로 완전히 새로운 회사를 시드할 수도 있습니다.

HEADS UP

**백업은 재해 복구가 아닙니다**

모든 백업은 사용자가 직접 시작하는 스냅샷이며 단일 회사로 범위가 한정됩니다. 전체 데이터베이스의 덤프가 아닙니다. 예약 실행되는 항목은 없으며 임의의 시점으로 복구할 수도 없습니다. 재해 복구는 별도로 계획하십시오.

## 개요

### 스냅샷의 범위

아카이브에는 회사의 영업, 구매, 품목, 생산, 회계, 품질, 인원 데이터가 담깁니다. **백업 생성**(Create a backup) 옆의 **i** 버튼을 누르면 각 영역별 레코드 수와 전체 합계가 실시간으로 표시됩니다.

HEADS UP

**비밀 값은 포함되지 않습니다**

어떤 백업에도 자격 증명, 연동 토큰, 웹훅은 포함되지 않습니다. 복원이 끝나면 모든 연동을 한 번씩 다시 연결해야 합니다.

### 포함 항목 선택

아카이브에 담을 범위를 선택합니다.

FieldType

<details>
  <summary>**데이터만**</summary>

  고객, 품목, 주문 같은 모든 레코드입니다. 아카이브가 더 작고 더 빨리 끝납니다.
</details>

<details>
  <summary>**데이터 + 파일**</summary>

  레코드와 3D 모델, 문서, 이미지 같은 업로드된 파일입니다.
</details>

## 백업 생성

1. **설정 → 백업**으로 이동합니다.
2. 라벨을 입력하거나 비워 둡니다.
3. **데이터만** 또는 **데이터 + 파일**을 선택합니다.
4. **백업 생성**을 선택합니다.

내보내기는 백그라운드에서 진행됩니다. **백업 생성 중…** 행이 즉시 나타나며, 이를 선택하면 진행 상황이 표시됩니다. 완료되면 행에 날짜, 크기, 상태가 표시되고 **다운로드**와 **삭제**가 함께 나타납니다.

[![설정 → 백업, 데이터만 / 데이터 + 파일 선택과 i 내용 버튼이 있는 백업 생성 카드](https://docs.alforse.com/screens/platform-backups.png)](https://docs.alforse.com/screens/platform-backups.png)

내보내기는 회사의 데이터를 스냅샷으로 저장하며, 내용 팝오버에는 영역별 레코드 수가 실시간으로 표시됩니다.

### 실패한 내보내기에서 복구

내보내기를 완료할 수 없으면 **백업 실패** 배너가 이유를 설명합니다. 다른 회사에 속한 데이터를 가리키는 행이 원인인 경우가 많습니다. 그런 행은 안전하게 다시 불러올 수 없으므로 내보내기가 중단됩니다. **손상된 행 건너뛰고 다시 시도**를 선택하면 나머지를 내보냅니다. 새 백업에는 **N rows excluded**(N개 행 제외)가 표시되며, 정보 팝오버에 건너뛴 각 행이 나열됩니다.

## 백업이 여전히 복원되는지 확인

페이지를 불러올 때마다 Alforse는 현재 앱이 사용하는 스키마를 기준으로 모든 백업을 다시 평가합니다. 판정은 저장되지 않으며 날짜로 만료되는 것도 없습니다. 현재 제품이 읽을 수 있는 한 백업은 계속 사용할 수 있습니다.

FieldType

<details>
  <summary>**준비됨**</summary>

  아무것도 변경하지 않고 현재 앱에 불러옵니다.
</details>

<details>
  <summary>**변경 사항과 함께 복원 가능**</summary>

  불러올 수는 있지만, 스냅샷을 만들 당시의 앱과 더 이상 일치하지 않는 부분이 있습니다. 복원 화면에서 차이점을 확인하고 그 자리에서 확정합니다.
</details>

<details>
  <summary>**복원 불가**</summary>

  사유와 함께 거부됩니다. 복원 동작은 표시되지 않습니다.
</details>

<details>
  <summary>**불완전**</summary>

  모든 데이터를 쓰기 전에 내보내기가 중단되어 파일을 불러올 수 없습니다.
</details>

## 회사를 제자리에서 복원

복원하면 회사의 현재 데이터를 백업에 담긴 내용으로 덮어씁니다.

1. **백업에서 복원**(Restore from a backup)에서 **백업 선택**으로 저장된 백업을 고르거나 **새 백업 업로드…**로 `.alforse.tar.gz` 파일을 제공합니다.
2. 불러올 내용을 결정합니다. **데이터 + 파일**은 레코드와 백업에 저장된 파일을 함께 되살립니다. **데이터만**은 레코드만 되살리고 현재 파일은 그대로 둡니다.
3. **복원…**을 선택합니다.

### 호환성 보고서

**백업에서 이 회사 복원** 화면은 아무것도 실행되기 전에 스냅샷이 현재 앱에 어떻게 맞는지 자세히 알려줍니다. 디스크에서 업로드한 백업은 복원이 시작되는 시점에 검사됩니다.

| 보고서 섹션 | 알려 주는 내용 | 사용자가 할 일 |
| - | - | - |
| 표시된 항목 없음 | 완전히 호환됩니다. | 확정합니다. |
| **기본값으로 채워짐** | 현재의 기본값으로 설정될 필드입니다. | 확정합니다. |
| **폐기됨** | 되살릴 수 없어 버려질 레코드입니다. | `restore`를 입력한 다음 계속합니다. |
| **복원할 수 없습니다** | 백업이 거부된 이유입니다. | 없음. 확정 동작이 없습니다. |

각 섹션에는 영향을 받는 제품 영역(예: 생산 또는 영업)이 표시되며, **"상세 정보"**(Details) 확장 항목에서 정확한 필드를 볼 수 있습니다.

### 유지 또는 복원

먼저 Alforse는 현재 상태의 회사를 스냅샷으로 저장합니다. 복원이 실패해도 현재 데이터는 그대로 유지됩니다. 복원이 성공하면 **복원됨 — 검토 필요** 카드에 두 가지 선택지가 나타납니다.

* **"유지"**(Keep)는 복원된 데이터를 영구적으로 확정합니다.
* **"복원"**(Revert)은 복원 직전에 만든 스냅샷 상태로 회사를 되돌립니다.

NOTE

**한 번에 하나의 복원**

회사는 검토 대기 중인 복원을 하나만 가질 수 있습니다. 다음 복원을 시작하기 전에 **유지** 또는 **복원**으로 결정하십시오.

### 손상된 데이터가 복원을 막는 경우

처음의 안전 스냅샷 자체가 운영 중인 회사의 손상된 행 때문에 중단될 수 있습니다. **손상된 데이터 제거 및 복원**을 선택하면 관련된 행이 표시되며, **삭제 및 복원**을 선택하면 해당 행을 영구 삭제하고 복원을 다시 실행합니다. 그 행 중 하나라도 그룹 내 다른 회사와 공유되고 있으면 Alforse는 아무것도 삭제하지 않으며 복원도 시작되지 않습니다.

## 백업으로 새 회사 시드

온보딩에서도 같은 아카이브 형식을 사용합니다. Alforse 직원이 회사를 생성할 때 **어떻게 시작하시겠습니까?** 단계에서 다음 선택지를 제공합니다.

* **"백업에서 복원"**: 다른 회사에서 만든 Alforse 백업을 업로드하여 새 회사를 구성합니다.
* **"데모 템플릿 사용"**: 백업을 무시하고 선택한 업종에 맞는 샘플 데이터를 생성합니다. [데모 데이터](https://docs.alforse.com/ko/docs/platform/demo-data.md)를 참조하십시오.

## 권한과 플랜

NOTE

**이 페이지를 볼 수 있는 사람**

**settings: update** 권한이 필요하며, 회사가 Business 플랜이어야 합니다. 다른 플랜에서는 **설정**에 **백업**이 표시되지 않습니다. 회사 온보딩 중 백업에서 복원할 수 있는 사람은 Alforse 직원뿐입니다.

## 문제 해결

| 표시되는 내용 | 이유 | 대처 방법 |
| - | - | - |
| 설정에 **백업** 항목이 없음 | 회사가 Business 플랜이 아니거나 **settings: update** 권한이 없습니다. | Business 플랜으로 변경하거나 관리자에게 권한을 요청하십시오. |
| **변경 사항과 함께 복원 가능** | 스냅샷 이후 스키마가 변경되었습니다. | 복원 화면에서 나열된 차이점을 확인하고 진행하십시오. |
| **복원 불가** | 현재 앱이 이 스냅샷을 더 이상 불러올 수 없습니다. | **복원할 수 없습니다** 아래의 사유를 읽고 새 백업을 만드십시오. |
| **불완전** | 내보내기 쓰기가 끝나지 않았습니다. | 해당 행을 삭제하고 다른 백업을 생성하십시오. |
| 회사 외부의 행을 언급하는 **백업 실패** | 행이 회사가 소유하지 않은 데이터를 참조합니다. | **손상된 행 건너뛰고 다시 시도**를 사용하거나 **손상된 데이터 제거 및 복원**으로 정리하십시오. |
| 현재 복원을 먼저 끝내라는 안내 | 이전 복원이 아직 검토 대기 중입니다. | **복원됨 — 검토 필요**에서 **유지** 또는 **복원**을 선택하십시오. |
| 복원 후 연동이 끊어짐 | 자격 증명, 토큰, 웹훅은 백업에 포함되지 않습니다. | 각 연동을 다시 연결하십시오. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.