68893236+KINDNICK@users.noreply.github.com c5df37ca57 v2.8.0: 도전과제 시스템 + 다크 디자인 리뉴얼 + 안정성 강화
Added — 도전과제 시스템 (153개 자동 평가)
- core/achievements.py: 16개 카테고리, 5단계 등급, 시크릿 9개, 메타 도전과제
- ui/achievements_view.py: 4탭 다이얼로그 (전체/진행중/완료/시크릿)
- 5분 throttle 자동 평가 + 시스템 알림 + Discord embed push
- achievements 테이블 확장 (code/category/tier/is_secret/progress/target)
- hire_date 자동 추적, 뷰 진입 카운터 8개 settings 키

Changed — 다크 테마 디자인 리뉴얼
- ui/dark_components.py: 재사용 가능한 다크 컴포넌트 (header/card/button/progress)
- 통계/도움말/도전과제 다이얼로그 일관 다크 톤
- matplotlib 차트 다크 테마 적용 (figure/axes/grid/legend)
- 등급별 카드 그라디언트 (브론즈/실버/골드/플래티넘/레전드)

Fixed — 안정성·일관성
- 타임존 자정 경계 버그 (has_notification_today UTC vs localtime mismatch)
- DB 연결 누수: _conn() 컨텍스트 매니저 도입, 40+ 메서드 변환
- DB 이중 부트스트랩 제거 (MainWindow(db=None) 옵션 인자)
- crash_handler 다단계 폴백 (DB → 파일 → stderr)
- updater PID race: 지수 backoff 재시도 (총 ~9초)
- Discord URL 형식 검증 (snowflake regex)
- 일일 보고서 저녁 섹션, MealTimeDialog 출/퇴근 범위 검증
- check_dinner_reminder 신규, 알림 임계값 5개 설정화
- closeEvent timer/notifier 정리 (aboutToQuit hook)
- 마이그레이션 12개 모두 _conn() + try/finally
- DB 인덱스 5개 추가 (break/overtime/leave date)

Tests
- pytest 116/116 PASS, 통합 시나리오 48/48 PASS

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-01 01:11:13 +09:00

78 lines
2.4 KiB
Python

"""
DB 자동 백업 유틸리티.
전략:
- 앱 시작 시 1일 1회만 백업 (last_backup_date 설정 키로 가드)
- 사용자 폴더(`~/.clockout_backups/`)에 회전 보관 (기본 7개)
- SQLite의 안전한 백업 API(sqlite3.Connection.backup) 사용 — 락 안전
"""
from __future__ import annotations
import os
import sqlite3
from datetime import date
from pathlib import Path
from typing import Optional
from core.settings_keys import LAST_BACKUP_DATE
DEFAULT_BACKUP_DIR = Path.home() / '.clockout_backups'
DEFAULT_KEEP = 7
def backup_db_if_needed(db, source_path: str = "database.db",
backup_dir: Optional[Path] = None,
keep: int = DEFAULT_KEEP) -> Optional[Path]:
"""오늘 첫 실행이면 백업 1개 만들고 오래된 것 회전.
Args:
db: Database 인스턴스 (set_setting/get_setting 사용)
source_path: 원본 DB 파일 경로
backup_dir: 백업 저장 디렉토리 (기본 ~/.clockout_backups)
keep: 보관할 백업 개수
Returns:
생성된 백업 파일 경로, 또는 이미 오늘 백업했으면 None
"""
today = date.today().isoformat()
if db.get_setting(LAST_BACKUP_DATE, '') == today:
return None
src = Path(source_path)
if not src.exists():
return None
target_dir = backup_dir or DEFAULT_BACKUP_DIR
target_dir.mkdir(parents=True, exist_ok=True)
target = target_dir / f"database-{today}.db"
# SQLite 백업 API: WAL/락 환경에서도 안전한 일관성 있는 복사
src_conn = sqlite3.connect(str(src))
try:
dest_conn = sqlite3.connect(str(target))
try:
src_conn.backup(dest_conn)
finally:
dest_conn.close()
finally:
src_conn.close()
db.set_setting(LAST_BACKUP_DATE, today)
_rotate(target_dir, keep)
return target
def _rotate(directory: Path, keep: int) -> None:
"""오래된 백업 제거 — 최신 keep개만 유지"""
files = sorted(
(p for p in directory.glob('database-*.db') if p.is_file()),
key=lambda p: p.stat().st_mtime,
reverse=True,
)
for old in files[keep:]:
try:
old.unlink()
except OSError as e:
# 회전 실패 시 로그만 — 다음 실행에 재시도. 누적 시 디스크 압박 가능.
from utils.debug_log import dlog
dlog(f"backup rotation failed for {old}: {e}")