Move CORM settings and histories to dedicated PostgreSQL database

This commit is contained in:
2026-10-22 17:48:50 +09:00
parent 92986eb1cc
commit 399e91518c
20 changed files with 2058 additions and 84 deletions
+107
View File
@@ -0,0 +1,107 @@
"""Explicit, one-time settings import. No Google writes or automatic overwrite."""
import argparse
import hashlib
import json
import os
import sys
from pathlib import Path
from dotenv import load_dotenv
from settings_store import (
PostgresSettingsStore, SettingsAlreadyInitialized, SettingsNotInitialized,
settings_db_config, validate_rows,
)
BASE_DIR = Path(__file__).resolve().parent
def fingerprint(rows):
encoded = json.dumps(rows, ensure_ascii=False, separators=(",", ":")).encode("utf-8")
return hashlib.sha256(encoded).hexdigest()
def save_snapshot(path, rows, source):
target = Path(path)
target.parent.mkdir(parents=True, exist_ok=True)
payload = {"format": 1, "source": source, "sha256": fingerprint(rows), "rows": rows}
# Never replace an existing backup. Restrict access on systems supporting POSIX modes.
descriptor = os.open(target, os.O_WRONLY | os.O_CREAT | os.O_EXCL, 0o600)
with os.fdopen(descriptor, "w", encoding="utf-8") as stream:
json.dump(payload, stream, ensure_ascii=False, indent=2)
stream.write("\n")
stream.flush()
os.fsync(stream.fileno())
def load_snapshot(path):
payload = json.loads(Path(path).read_text(encoding="utf-8"))
if payload.get("format") != 1 or payload.get("sha256") != fingerprint(payload["rows"]):
raise ValueError("백업 파일 형식 또는 체크섬이 올바르지 않습니다.")
validate_rows(payload["rows"])
return payload["rows"], "backup-file"
def read_google_rows():
# Reuse the application's credential loading and bounded HTTP sessions.
# Do not use get_settings_worksheet(): that helper creates a missing tab.
import main
worksheet = main.get_gspread_client().open_by_key(main.SETTINGS_SPREADSHEET_ID).worksheet("설정")
return worksheet.get_all_values(), "google:" + main.SETTINGS_SPREADSHEET_ID + ":설정"
def build_store():
return PostgresSettingsStore(settings_db_config())
def main(argv=None):
load_dotenv(BASE_DIR / ".env")
parser = argparse.ArgumentParser(description="구글 시트 '설정' 탭 → PostgreSQL 이전 / 검증 / 백업")
commands = parser.add_subparsers(dest="command", required=True)
importer = commands.add_parser("import", help="기본은 읽기 전용 점검. --apply일 때만 DB에 저장")
importer.add_argument("--apply", action="store_true")
importer.add_argument("--backup", help="--apply 필수: 이전 전 원본을 보관할 새 JSON 경로")
importer.add_argument("--input-file", help="구글 대신 이 도구가 만든 JSON 백업에서 읽기")
verifier = commands.add_parser("verify", help="원본과 DB가 같은지 읽기 전용 검증")
verifier.add_argument("--input-file")
exporter = commands.add_parser("export", help="현재 DB 설정을 새 JSON 파일로 백업")
exporter.add_argument("--output", required=True)
args = parser.parse_args(argv)
if args.command == "import" and args.apply and not args.backup:
parser.error("--apply에는 --backup 경로가 필요합니다.")
try:
if args.command == "export":
rows, version = build_store().read()
save_snapshot(args.output, rows, f"postgres:version:{version}")
print(f"DB 설정 백업 완료 (version={version}, sha256={fingerprint(rows)}).")
return 0
rows, source = load_snapshot(args.input_file) if args.input_file else read_google_rows()
config = validate_rows(rows)
print(f"원본 확인: {len(rows)}행 / {len(config.sections())}개 분류 / sha256={fingerprint(rows)}")
if args.command == "verify":
stored, version = build_store().read()
if stored != rows:
print("검증 실패: 원본과 DB 설정이 다릅니다. 전환 전에 차이를 확인해주세요.", file=sys.stderr)
return 1
print(f"원본과 DB 전체 행·셀·순서 일치 (version={version}).")
elif args.apply:
save_snapshot(args.backup, rows, source)
version = build_store().import_rows(rows, source)
print(f"DB 이전 및 트랜잭션 내 전체 데이터 검증 완료 (version={version}).")
else:
print("점검만 완료했습니다. DB·구글 시트에 쓰지 않았습니다.")
return 0
except (SettingsAlreadyInitialized, SettingsNotInitialized) as exc:
print(str(exc), file=sys.stderr)
except Exception as exc:
# Connection errors and parser errors may contain credentials or cell values.
print(f"작업 실패 ({type(exc).__name__}). 접속 환경·원본·백업 경로를 확인해주세요.", file=sys.stderr)
return 1
if __name__ == "__main__":
raise SystemExit(main())