데이터 마이그레이션

마이그레이션 페이지는 다른 PC방 관리 시스템에서 HandyCafe로 고객, 제품, 가격 및 기록을 가져옵니다. 이는 설정의 인프라 및 시스템 그룹 아래에 위치합니다.

세 가지 소스를 지원합니다:

페이지 상단의 카드에서 소스를 선택하세요. 아래 패널이 선택에 맞게 변경됩니다.

각 소스의 동작 방식

세 가지 소스는 동일한 작업 모델을 공유합니다. 하나에서 배운 것은 다른 것에도 적용됩니다.

• 소스는 읽기 전용입니다. HandyCafe는 원본 파일을 읽기 위해 열고 절대 쓰지 않습니다. 이전 설치는 그대로 유지됩니다. 언제든지 돌아갈 수 있습니다.
• 가져오기 전에 검사하세요. 검사 버튼은 소스 파일을 읽고 발견한 내용을 보고합니다. 마이그레이션 시작 버튼은 검사가 성공할 때까지 비활성화 상태로 유지됩니다.
• 단계별로 진행 상황이 표시됩니다. 실행 중에 진행 대화 상자가 열리고 진행 중인 단계를 보고합니다. 예를 들어 회원, 제품 또는 거래.
• 다시 실행해도 안전합니다. 이미 가져온 행은 중복되지 않고 제자리에 업데이트됩니다. 마이그레이션이 완료되면 버튼이 마이그레이션 다시 실행으로 변경됩니다.
• 모든 실행은 취소할 수 있습니다. 완료된 실행 후 마이그레이션 취소 버튼이 나타납니다. 해당 소스에서 가져온 모든 행을 제거합니다. 먼저 확인을 요청합니다.
• 경고는 실행을 중단하지 않습니다. 일부 행을 읽을 수 없는 경우 경고와 함께 완료된 것으로 실행이 종료됩니다. 건너뛴 행을 보려면 로그를 엽니다.
• 중단된 실행은 스스로 복구됩니다. 애플리케이션이 닫히거나 중간에 전원이 꺼지면 페이지는 이전 가져오기가 중단되었음을 보고합니다. 다시 시작해도 안전합니다.

패널 하단의 마지막 가져오기 수를 확장하여 가장 최근 실행에서 각 카테고리에 대해 가져온 행 수를 확인하세요.

HandyCafe 레거시

HandyCafe 3.x 또는 4.x 설치에서 가져옵니다. 이는 이전 세대 HandyCafe에서 업그레이드하는 PC방의 소스입니다.

감지

Windows에서는 페이지가 시스템을 스캔하여 레거시 설치를 보고합니다:

아무것도 감지되지 않으면 페이지는 레거시 설치가 발견되지 않았음을 보고합니다. 레거시 파일이 Program Files\HandyCafe 또는 C:\HandyCafe와 같은 표준 위치에 있는지 확인하세요.

macOS 및 Linux에서는 자동 스캔이 실행되지 않습니다. 대신 패널은 폴더 선택기를 제공합니다. 이전 Windows 머신에서 복사한 레거시 Db 폴더를 지정한 후 마이그레이션을 시작하세요.

가져오는 내용

회원, 가격 등급, 제품, 주문, 거래, 로그 및 레거시 INI 파일에 저장된 설정.

시작하기 전에 레거시 서버를 중지하세요. 읽는 동안 소스 데이터베이스에 쓰지 않아야 합니다.

전체 절차는 레거시 설치에서 마이그레이션하는 방법을 참조하세요.

EveryCafe

일반적으로 ecmdata.ecm이라는 EveryCafe 데이터베이스 파일에서 가져옵니다.

1. 찾아보기를 선택하고 .ecm 파일을 선택하세요. .db 또는 .sqlite 확장자를 가진 파일도 허용됩니다.
2. HandyCafe는 파일을 선택하면 자동으로 검사합니다. 경로를 수동으로 편집한 후 검사를 사용하여 다시 확인하세요.
3. 미리보기를 검토한 후 마이그레이션 시작을 선택하세요.

미리보기는 EveryCafe 서버 이름 및 서버 버전과 함께 파일에 포함된 캐셔, 회원, 제품, 가격 목록, 주문 및 세션 수를 보고합니다.

가져오는 내용

캐셔, 회원, 제품, 가격 등급, 주문, 거래 및 Steam 계정. Steam 계정 비밀번호는 HandyCafe 게임 라이선스 풀에 기록될 때 암호화됩니다.

세션 및 가격 목록은 소스 데이터의 크기를 확인할 수 있도록 미리보기에서 계산됩니다. 가져오지는 않습니다.

가격 목록 참조

완료된 실행 후 패널은 원래 EveryCafe 가격 행을 나열하는 가격 목록 참조 테이블을 제공합니다: 가격 목록 ID, 레거시 유형, 시작 가격, 시간당 가격 및 새로 고침 분.

EveryCafe 가격은 HandyCafe 가격 계획과 깔끔하게 매핑되지 않습니다. 이러한 행은 수동으로 가격을 설정하기 위한 참조로 유지됩니다. 카페테리아 제품으로 가져오지는 않습니다. 가격 설정과 함께 사용하여 요금을 재구성하세요.

Pancafe

일반적으로 USDB.DAT라는 Pancafe 데이터베이스 파일에서 가져옵니다. HandyCafe는 Firebird 파일을 직접 읽습니다. Firebird 서버나 클라이언트 라이브러리를 설치할 필요가 없습니다.

1. 찾아보기를 선택하고 USDB.DAT 파일을 선택하세요. .fdb 또는 .gdb 확장자를 가진 파일도 허용됩니다.
2. 미리보기를 검토한 후 마이그레이션 시작을 선택하세요.

미리보기는 감지된 형식(예: Firebird ODS 버전)과 데이터가 포함된 기록 범위를 보고합니다. 또한 발견된 캐셔, 회원, 제품, 현금 장부 항목, 세션 및 회원 지갑 기록 행 수를 나열합니다.

가져오는 내용

캐셔, 지갑 잔액이 있는 회원, 제품, 현금 장부의 수입 항목 및 지출 항목.

세션 행은 미리보기를 위해 읽지만 의도적으로 가져오지 않습니다. 현금 장부는 이미 해당 세션에 대해 수집된 내용을 기록합니다. 둘 다 가져오면 동일한 수익이 두 번 계산됩니다.

시간대

Pancafe는 날짜를 시간대 없이 저장합니다. HandyCafe는 가져오기를 실행하는 컴퓨터의 시간대를 사용하여 이를 변환합니다. 데이터를 계속 사용할 머신에서 마이그레이션을 실행하세요. 다른 곳에서 실행하면 과거 날짜가 몇 시간씩 이동할 수 있습니다.

시작하기 전에

• 먼저 백업을 하세요. 데이터베이스 유지 관리를 열고 지금 백업을 사용하세요. 마이그레이션은 라이브 데이터베이스에 기록됩니다. 새 스냅샷은 마이그레이션 취소 외에 두 번째 복구 방법을 제공합니다.
• 소스 애플리케이션을 닫으세요. 적극적으로 쓰여지는 데이터베이스는 불완전한 읽기를 생성할 수 있습니다.
• 충분한 시간을 허용하세요. 대규모 데이터셋은 몇 분이 걸릴 수 있습니다. 실행이 완료되었다고 진행 대화 상자가 보고할 때까지 HandyCafe를 열어 두세요.
• 실행이 끝나면 수를 확인하세요. 새 시스템에서 거래를 시작하기 전에 예상했던 것과 비교하세요.

관련 페이지

• V3 및 V4 클라이언트 PC가 이 서버에 계속 연결할 수 있도록 하는 레거시 클라이언트 설정.
• 백업 및 복원 지점을 위한 데이터베이스 유지 관리.
• 가져온 기록을 검토하기 위한 회원, 제품 및 세션 가격.