""" 경량 i18n. `tr('key')` → 현재 언어의 번역 문자열. 키 미존재 시 ko 폴백, ko도 없으면 키 그대로 반환 (미번역도 동작). 점진 도입 가능. 새 언어 추가: 1. _DICT['en'] 옆에 'ja'/'zh' 등 추가 2. 사용자가 설정 → 언어 콤보에서 선택 """ from __future__ import annotations _current_lang = 'ko' _DICT = { 'ko': { # === 메뉴/버튼 === 'menu.stats': '통계', 'menu.calendar': '캘린더', 'menu.daily_report': '일일보고', 'menu.help': '도움말', 'menu.settings': '설정', 'btn.clock_out': '퇴근하기', 'btn.clock_out_cancel': '🔄 퇴근 취소', 'btn.lunch_add': '점심시간 추가', 'btn.lunch_applied': '점심시간 (적용됨)', 'btn.dinner_add': '저녁시간 추가', 'btn.dinner_applied': '저녁시간 (적용됨)', 'btn.break_out': '🚪 외출 시작', 'btn.break_in': '↩️ 복귀', 'btn.save': '💾 저장', 'btn.close': '닫기', 'btn.apply': '적용', 'btn.cancel': '취소', 'btn.add': '추가', 'btn.delete': '삭제', 'btn.edit': '편집', 'btn.confirm': '확인', 'btn.ok': '확인', # === 윈도우/다이얼로그 제목 === 'window.main_title': '퇴근시간 계산기', 'window.settings': '⚙️ 설정', 'window.help': '📖 사용 설명서', 'window.stats': '📊 근무 통계', 'window.calendar': '📅 캘린더', 'window.mini_widget': '퇴근시간', 'window.clock_in_dialog': '출근 시간', 'window.break_view': '외출 관리', 'window.overtime_view': '연장근무 관리', 'window.leave_view': '연차 관리', # === 라벨 === 'label.remaining': '남은 시간', 'label.overtime_progress': '추가 근무 중', 'label.expected_clock_out': '예상 퇴근', 'label.clock_in_time': '출근 시간', 'label.clock_out_time': '퇴근 시간', 'label.work_hours_label': '하루 기본 근무:', 'label.lunch_default': '점심시간 기본:', 'label.dinner_default': '저녁시간 기본:', 'label.work_pattern': '근무 패턴:', 'label.time_format': '시간 형식:', 'label.theme': '테마:', 'label.language': '언어 / Language:', 'label.unit_hour': '시간', 'label.unit_minute': '분', 'label.unit_day': '일', 'label.unit_count': '개', 'label.weekday_mon': '월', 'label.weekday_tue': '화', 'label.weekday_wed': '수', 'label.weekday_thu': '목', 'label.weekday_fri': '금', 'label.weekday_sat': '토', 'label.weekday_sun': '일', 'label.am': '오전', 'label.pm': '오후', # === 알림 === 'notif.clock_out_soon.title': '⏰ 퇴근 시간 임박', 'notif.clock_out_soon.body': '퇴근까지 {minutes}분 남았습니다.\n마무리 준비를 시작하세요!', 'notif.lunch_reminder.title': '🍱 점심시간 등록', 'notif.lunch_reminder.body': '점심시간을 등록하지 않으셨네요.\n점심시간을 추가하시겠어요?', 'notif.overtime_earning.title': '🔥 연장근무 적립 예정', 'notif.overtime_earning.body': '오늘 {time_str}의 연장근무가 적립될 예정입니다!', 'notif.overtime_threshold.title': '💰 연장근무 적립 알림', 'notif.overtime_threshold.body': '적립된 연장근무가 {hours:.1f}시간 입니다.\n사용을 고려해보세요!', 'notif.health.title': '⚠️ 건강 경고', 'notif.health.body': '{days}일 연속 연장근무 중입니다.\n건강을 챙기세요!', 'notif.weekly_52.title': '🚨 주 52시간 초과', 'notif.weekly_52.body': '이번 주 총 근무시간이 {hours:.1f}시간입니다.\n법정 근로시간을 초과했습니다!', # === 메시지박스 === 'msg.save_success.title': '저장 완료', 'msg.save_success.body': '설정이 저장되었습니다.', 'msg.input_error.title': '입력 오류', 'msg.work_min_too_small': '하루 기본 근무 시간은 최소 30분 이상이어야 합니다.', 'msg.no_clock_in.title': '외출 불가', 'msg.no_clock_in.body': '출근하지 않은 상태입니다.', 'msg.already_break.body': '이미 외출 중입니다.', 'msg.no_record.title': '기록 없음', 'msg.no_record.body': '오늘 출근 기록이 없습니다.', 'msg.confirm_delete.title': '삭제 확인', 'msg.no_data.title': '데이터 없음', # === 트레이 === 'tray.open': '프로그램 열기', 'tray.mini_widget': '📌 미니 위젯', 'tray.toggle_lunch': '🍱 점심시간 토글', 'tray.quit': '종료', 'tray.tooltip_remaining': '퇴근까지: {time}', 'tray.tooltip_overtime': '추가 근무 중: {time}', 'tray.background': '프로그램이 트레이에서 실행 중입니다.', # === 그룹 박스 === 'group.work_time': '근무 시간 설정', 'group.notification': '알림 및 표시 설정', 'group.overtime': '연장근무 설정', 'group.leave': '휴가 설정', 'group.holiday': '공휴일 설정', 'group.data': '데이터 관리', # === StatsView === 'stats.title': '근무 통계', 'stats.tab_weekly': '주간', 'stats.tab_monthly': '월간', 'stats.tab_pattern': '패턴 분석', 'stats.weekly_summary': '이번 주 요약', 'stats.monthly_summary': '이번 달 요약', 'stats.total_hours': '총 근무시간:', 'stats.work_days': '근무일수:', 'stats.avg_hours': '평균 근무시간:', 'stats.total_overtime': '총 연장근무:', 'stats.pattern_insights': '근무 패턴 인사이트', 'stats.analyzing': '데이터를 분석 중입니다...', 'stats.no_data': '아직 충분한 데이터가 없습니다.', # === CalendarView === 'cal.title': '월간 근무 캘린더', 'cal.year_label': '년', 'cal.month_label': '월', 'cal.prev': '◀ 이전', 'cal.next': '다음 ▶', 'cal.today': '오늘', 'cal.no_record': '기록 없음', 'cal.edit_record': '기록 편집', # === HelpView (각 탭의 큰 HTML은 별도 키) === 'help.tab_intro': '👋 시작하기', 'help.tab_work_hours': '🕘 근무시간', 'help.tab_overtime': '🏦 연장근무', 'help.tab_leave': '🌴 연차/휴가', 'help.tab_break': '🚪 외출/저녁', 'help.tab_faq': '❓ 자주 묻는 질문', }, 'en': { # === Menu/Buttons === 'menu.stats': 'Stats', 'menu.calendar': 'Calendar', 'menu.daily_report': 'Daily Report', 'menu.help': 'Help', 'menu.settings': 'Settings', 'btn.clock_out': 'Clock Out', 'btn.clock_out_cancel': '🔄 Cancel Clock-out', 'btn.lunch_add': 'Add Lunch', 'btn.lunch_applied': 'Lunch (Applied)', 'btn.dinner_add': 'Add Dinner', 'btn.dinner_applied': 'Dinner (Applied)', 'btn.break_out': '🚪 Start Break', 'btn.break_in': '↩️ Return', 'btn.save': '💾 Save', 'btn.close': 'Close', 'btn.apply': 'Apply', 'btn.cancel': 'Cancel', 'btn.add': 'Add', 'btn.delete': 'Delete', 'btn.edit': 'Edit', 'btn.confirm': 'Confirm', 'btn.ok': 'OK', # === Windows === 'window.main_title': 'Clock-out Time Calculator', 'window.settings': '⚙️ Settings', 'window.help': '📖 User Guide', 'window.stats': '📊 Statistics', 'window.calendar': '📅 Calendar', 'window.mini_widget': 'Clock-out', 'window.clock_in_dialog': 'Clock-in Time', 'window.break_view': 'Break Management', 'window.overtime_view': 'Overtime Management', 'window.leave_view': 'Leave Management', # === Labels === 'label.remaining': 'Remaining', 'label.overtime_progress': 'Overtime', 'label.expected_clock_out': 'Expected Clock-out', 'label.clock_in_time': 'Clock-in Time', 'label.clock_out_time': 'Clock-out Time', 'label.work_hours_label': 'Daily work:', 'label.lunch_default': 'Lunch break:', 'label.dinner_default': 'Dinner break:', 'label.work_pattern': 'Work pattern:', 'label.time_format': 'Time format:', 'label.theme': 'Theme:', 'label.language': 'Language / 언어:', 'label.unit_hour': 'h', 'label.unit_minute': 'min', 'label.unit_day': 'day(s)', 'label.unit_count': '', 'label.weekday_mon': 'Mon', 'label.weekday_tue': 'Tue', 'label.weekday_wed': 'Wed', 'label.weekday_thu': 'Thu', 'label.weekday_fri': 'Fri', 'label.weekday_sat': 'Sat', 'label.weekday_sun': 'Sun', 'label.am': 'AM', 'label.pm': 'PM', # === Notifications === 'notif.clock_out_soon.title': '⏰ Clock-out Soon', 'notif.clock_out_soon.body': "{minutes} minutes until clock-out.\nWrap things up!", 'notif.lunch_reminder.title': '🍱 Lunch Reminder', 'notif.lunch_reminder.body': "You haven't registered lunch yet.\nWant to add it?", 'notif.overtime_earning.title': '🔥 Overtime Will Accrue', 'notif.overtime_earning.body': "{time_str} of overtime will be banked today!", 'notif.overtime_threshold.title': '💰 Overtime Balance High', 'notif.overtime_threshold.body': "{hours:.1f} hours of overtime banked.\nConsider using some.", 'notif.health.title': '⚠️ Health Warning', 'notif.health.body': "{days} consecutive days of overtime.\nTake care of your health!", 'notif.weekly_52.title': '🚨 Weekly 52h Exceeded', 'notif.weekly_52.body': "This week's total work hours: {hours:.1f}\nLegal limit exceeded!", # === Message Boxes === 'msg.save_success.title': 'Saved', 'msg.save_success.body': 'Settings saved successfully.', 'msg.input_error.title': 'Input Error', 'msg.work_min_too_small': 'Daily work time must be at least 30 minutes.', 'msg.no_clock_in.title': 'Cannot Take Break', 'msg.no_clock_in.body': 'Not clocked in.', 'msg.already_break.body': 'Already on break.', 'msg.no_record.title': 'No Record', 'msg.no_record.body': 'No clock-in record for today.', 'msg.confirm_delete.title': 'Confirm Delete', 'msg.no_data.title': 'No Data', # === Tray === 'tray.open': 'Open Program', 'tray.mini_widget': '📌 Mini Widget', 'tray.toggle_lunch': '🍱 Toggle Lunch', 'tray.quit': 'Quit', 'tray.tooltip_remaining': 'Until clock-out: {time}', 'tray.tooltip_overtime': 'Overtime: {time}', 'tray.background': 'Program is running in the tray.', # === Groups === 'group.work_time': 'Work Time Settings', 'group.notification': 'Notifications & Display', 'group.overtime': 'Overtime Settings', 'group.leave': 'Leave Settings', 'group.holiday': 'Holidays', 'group.data': 'Data Management', # === StatsView === 'stats.title': 'Work Statistics', 'stats.tab_weekly': 'Weekly', 'stats.tab_monthly': 'Monthly', 'stats.tab_pattern': 'Patterns', 'stats.weekly_summary': 'This Week', 'stats.monthly_summary': 'This Month', 'stats.total_hours': 'Total hours:', 'stats.work_days': 'Work days:', 'stats.avg_hours': 'Avg hours/day:', 'stats.total_overtime': 'Total overtime:', 'stats.pattern_insights': 'Work Pattern Insights', 'stats.analyzing': 'Analyzing...', 'stats.no_data': 'Not enough data yet.', # === CalendarView === 'cal.title': 'Monthly Calendar', 'cal.year_label': 'Y', 'cal.month_label': 'M', 'cal.prev': '◀ Prev', 'cal.next': 'Next ▶', 'cal.today': 'Today', 'cal.no_record': 'No record', 'cal.edit_record': 'Edit record', # === HelpView === 'help.tab_intro': '👋 Getting Started', 'help.tab_work_hours': '🕘 Work Hours', 'help.tab_overtime': '🏦 Overtime', 'help.tab_leave': '🌴 Leave', 'help.tab_break': '🚪 Break/Dinner', 'help.tab_faq': '❓ FAQ', }, } # === HelpView 큰 HTML 콘텐츠 (별도 사전) === _HELP_HTML = { 'ko': { 'help.html.intro': """

👋 환영합니다!

퇴근시간 계산기는 출근 시간 자동 감지부터 연장근무 적립·사용까지 하루 근무를 정리해 주는 데스크톱 앱입니다.

한눈에 보는 기본 흐름

  1. 출근 — 컴퓨터 켜진 시각이 자동으로 출근 시간으로 기록돼요.
  2. 근무 중 — 메인 화면에 퇴근까지 남은 시간이 1초마다 갱신됩니다.
  3. 점심/저녁 — 식사 시간 버튼을 누르면 그만큼 근무시간이 늘어납니다.
  4. 외출 — "외출 시작/복귀" 버튼으로 잠깐 자리 비운 시간을 추적합니다.
  5. 퇴근 — 퇴근 버튼을 누르면 연장근무가 30분 단위로 자동 적립됩니다.

처음 켰다면 꼭 확인하세요

""", 'help.html.work_hours': """

🕘 근무시간 설정

표준 근무 / 단축근무 / 시간제 모두 지원

💡 단축근무 사용자 안내

예) 하루 7시간 30분 근무 + 점심 30분

  1. 설정 → 근무 시간 → 근무 패턴에서 "단축근무 7시간 30분 (점심 30분)" 선택
  2. 또는 직접 입력: 하루 기본 근무에 7 시간 30 분, 점심시간 기본에 30 분
  3. 저장 클릭하면 즉시 메인 화면 계산이 갱신됩니다.

점심시간 자동 적용

설정에서 "자동 적용"을 체크하면 출근 후 4시간 경과 시 점심시간이 자동으로 켜집니다.

""", 'help.html.overtime': """

🏦 연장근무 30분 단위 적립 시스템

적립 규칙

정규 퇴근시간 이후 일한 시간은 30분 단위로 절삭되어 적립됩니다.

사용 방법

적립된 연장근무는 메인 화면 "30분 사용" / "1시간 사용" 버튼으로 쓸 수 있어요. 사용한 만큼 그날 퇴근시간이 앞당겨집니다.

주말·공휴일 근무

주말 또는 등록된 공휴일에 일한 시간은 모든 시간이 연장근무로 적립됩니다.

""", 'help.html.leave': """

🌴 연차·반차 관리

연차 잔액 자동 계산

잔액 = 연간 연차 − (프로그램 외 사용분 + 프로그램에서 기록된 사용분)

반차·반반차 지원

단축근무자의 연차 환산

1일 연차의 시간 길이는 설정의 하루 기본 근무를 따릅니다. 예: 7시간 30분 근무자는 1일 연차가 7시간 30분(=450분)으로 환산됩니다.

""", 'help.html.break': """

🚪 외출 / 저녁시간

외출 (잠깐 자리 비움)

병원, 잠깐 외근 등으로 자리를 비울 때 외출 시작 → 복귀 버튼으로 시간을 추적하세요.

화면 잠금 자동 외출

설정에서 "화면 잠금 시 자동 외출/복귀"를 켜면 PC 잠금 시 자동으로 외출이 시작되고, 풀리면 복귀로 처리됩니다.

저녁시간

야근하면서 저녁을 먹는다면 저녁시간 추가 버튼을 눌러주세요.

""", 'help.html.faq': """

❓ 자주 묻는 질문

Q. 출근 시간이 잘못 잡혔어요

메인 화면 출근 시각 옆 편집(연필) 아이콘으로 수정할 수 있어요.

Q. 단축근무 7시간 30분으로 설정하고 싶어요

설정 → 근무 시간 → 근무 패턴에서 프리셋을 선택하거나 시·분을 직접 입력하세요.

Q. 데이터는 어디에 저장되나요?

실행 폴더의 database.db (SQLite). 자동 백업은 ~/.clockout_backups/에 1일 1회 회전됩니다.

""", }, 'en': { 'help.html.intro': """

👋 Welcome!

Clock-out Time Calculator is a desktop app that organizes your daily work — from auto-detecting clock-in time to banking and using overtime.

Basic Flow

  1. Clock in — System boot time is auto-recorded as your clock-in.
  2. Working — Remaining time updates every second on the main screen.
  3. Lunch/Dinner — Press the meal buttons to extend work time.
  4. Break — Track time away with "Start Break / Return" buttons.
  5. Clock out — Press the button; overtime is banked in 30-min units.

First-Time Setup

""", 'help.html.work_hours': """

🕘 Work Time Settings

Supports Standard / Reduced / Part-time

💡 For Reduced-Hours Users

Example: 7h30m daily + 30-min lunch

  1. Settings → Work Time → pick "Reduced 7h30m (30-min lunch)" preset
  2. Or enter directly: 7h 30min daily, 30min lunch
  3. Click Save — main screen recalculates immediately.

Auto Lunch

Enable "Auto Apply" in settings to automatically turn on lunch after 4 hours from clock-in.

""", 'help.html.overtime': """

🏦 30-Minute Overtime Banking

Banking Rule

Time worked past your scheduled clock-out is truncated to 30-min units.

Using Banked Overtime

Use buttons on the main screen to consume banked overtime. Each unit lets you clock out earlier on a chosen day.

Weekend/Holiday Work

All hours worked on weekends or registered holidays are banked entirely as overtime.

""", 'help.html.leave': """

🌴 Annual Leave Management

Auto Balance Calculation

Balance = annual leave − (pre-program usage + recorded usage)

Half / Quarter Day

Reduced-Hours Conversion

1 leave day equals your configured daily work time. Example: 7h30m worker → 1 day = 7h30m (450 min).

""", 'help.html.break': """

🚪 Break / Dinner

Break (Briefly Away)

For short absences (medical, errands), use Start Break / Return.

Auto Break on Screen Lock

Enable "Auto break on screen lock" in settings — when the PC locks, a break starts automatically; on unlock, you return.

Dinner

For overtime with dinner, press Add Dinner.

""", 'help.html.faq': """

❓ FAQ

Q. Clock-in time is wrong

Click the pencil icon next to clock-in time on the main screen to edit.

Q. How to set 7h30m work day?

Settings → Work Time → pick the preset or enter hours/minutes directly.

Q. Where is data stored?

database.db in the program folder (SQLite). Daily auto-backups rotate in ~/.clockout_backups/.

""", }, } def set_language(lang: str) -> None: global _current_lang if lang in _DICT: _current_lang = lang def get_language() -> str: return _current_lang def tr(key: str, **kwargs) -> str: """번역 조회. 키 미존재 시 ko 폴백 → 키 그대로.""" table = _DICT.get(_current_lang, _DICT['ko']) text = table.get(key) or _DICT['ko'].get(key) or key if kwargs: try: return text.format(**kwargs) except (KeyError, IndexError): return text return text def tr_html(key: str) -> str: """HTML 콘텐츠 조회 (HelpView용).""" table = _HELP_HTML.get(_current_lang, _HELP_HTML['ko']) return table.get(key) or _HELP_HTML['ko'].get(key) or f"

missing: {key}

" def available_languages() -> list: return list(_DICT.keys()) def language_label(code: str) -> str: return {'ko': '한국어', 'en': 'English'}.get(code, code)