69 lines
2.2 KiB
Markdown
69 lines
2.2 KiB
Markdown
# 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 저장소 접근 권한은 내부 공유 대상자로 제한해야 합니다.
|