# WEHAGO 계정별 원장 스냅샷

이 저장소에는 한맥기술 WEHAGO 계정별 원장 정보를 공유하기 위한 압축 SQLite 스냅샷이 포함되어 있습니다.

## 포함 파일

```text
snapshots/wehago_account_ledger_snapshot_20260605.sqlite3.gz
```

## 포함 데이터

- `ledger_rows`: WEHAGO 계정별 원장 행 47,777건
- `source_files`: 원장 생성에 사용된 원본 파일 메타 136건
- `snapshot_manifest`: 스냅샷 생성일과 행 수 정보

전표 행(`voucher_rows`)과 비교 결과(`comparison_results`)는 이 스냅샷에 포함하지 않았습니다. 계정별 원장 공유 목적에 맞춰 파일 크기와 노출 범위를 줄이기 위해서입니다.

## 복원 방법

저장소를 받은 뒤 아래 명령을 실행합니다.

```bash
cd WEHAGO_DB
python3 scripts/restore_account_ledger_snapshot.py
```

복원 결과:

```text
data/wehago_account_ledger.sqlite3
```

다른 경로로 복원하려면:

```bash
python3 scripts/restore_account_ledger_snapshot.py --output /desired/path/wehago_account_ledger.sqlite3
```

## Gitea에서 직접 받기

Gitea에 로그인한 뒤 아래 raw URL로 접근하면 스냅샷을 직접 받을 수 있습니다.

```text
https://gitea.hmac.kr/YJKIM/WEHAGO_DB/raw/branch/main/snapshots/wehago_account_ledger_snapshot_20260605.sqlite3.gz
```

브라우저에서 404가 보이면 파일이 없는 것이 아니라, 대부분 아래 원인입니다.

- Gitea에 로그인하지 않은 상태입니다.
- 로그인 계정이 `WEHAGO_DB` 저장소 접근 대상이 아닙니다.
- Gitea가 internal 저장소를 권한 없는 사용자에게 404로 숨기고 있습니다.

이 경우 먼저 Gitea에 로그인한 뒤 다시 접근하고, 그래도 404가 유지되면 저장소 소유자에게 해당 Gitea 계정의 접근 권한을 요청해야 합니다.

## 무결성

압축 스냅샷 SHA-256:

```text
dd1e8792d277427f1c95aa95f8eeefe92b208adc51168161ec3ec5b16f0b526f
```

복원 스크립트는 기본적으로 이 체크섬을 검증합니다.

## 주의

이 데이터에는 원장, 거래처, 금액 등 업무 정보가 포함될 수 있습니다. Gitea 저장소 접근 권한은 내부 공유 대상자로 제한해야 합니다.