KINDNICK bedbb1e9ec
Some checks failed
CI / test (push) Has been cancelled
Initial release v2.2.0
핵심 기능:
- 단축근무·표준·반일 등 다양한 근무 패턴 (5개 프리셋 + 사용자 정의)
- Windows 이벤트 뷰어 자동 출퇴근 감지
- 30분 단위 연장근무 적립/사용 시스템
- 1.0/0.5/0.25일 연차·반차·반반차
- 자동 점심·저녁·외출·자동 백업·화면 잠금 자동 외출
- 한국 공휴일 자동 등록 (음력 포함, holidays 패키지)
- matplotlib 차트 기반 주간/월간/패턴 통계
- 미니 위젯 + 시스템 트레이 통합
- 한국어/English i18n
- 자가 업데이트 (updater.exe + Gitea Releases)

아키텍처:
- core/ (db, time_calculator, notifier, i18n, version, settings_keys)
- ui/ (main_window + 9 dialogs + 3 controllers)
- utils/ (backup, lock_detector, debug_log, updater_client, time_format)
- tests/ (66 pytest 단위) + 통합/i18n GUI 검증

CI/CD:
- .gitea/workflows/ci.yml: push 시 pytest + 통합 테스트
- .gitea/workflows/release.yml: v* 태그 push 시 두 .exe 자동 빌드 + Releases 첨부

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-30 12:54:40 +09:00

139 lines
4.0 KiB
Python

"""
Clock-out Time Calculator
퇴근시간 계산 프로그램 - 메인 실행 파일
"""
import sys
import os
# PyQt5 임포트
from PyQt5.QtWidgets import QApplication, QMessageBox
from PyQt5.QtGui import QFont
from PyQt5.QtCore import QLockFile, QDir
from PyQt5.QtNetwork import QLocalServer, QLocalSocket
# 프로젝트 루트를 경로에 추가
sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
from ui.main_window import MainWindow
from core.database import Database
def check_requirements():
"""필수 요구사항 확인"""
try:
import win32evtlog
return True
except ImportError:
return False
def main():
"""메인 함수"""
app = QApplication(sys.argv)
# 애플리케이션 정보
app.setApplicationName("Clock-out Time Calculator")
app.setOrganizationName("DevUtil")
app.setApplicationVersion("1.0.0")
# 중복 실행 방지 - 로컬 서버로 체크
server_name = "ClockOutCalculatorInstance"
# 이미 실행 중인지 확인
socket = QLocalSocket()
socket.connectToServer(server_name)
if socket.waitForConnected(500):
# 이미 실행 중 - 기존 인스턴스에 "show" 신호 전송
socket.write(b"show")
socket.flush()
socket.waitForBytesWritten(1000)
socket.disconnectFromServer()
return 0
# 새로운 인스턴스 - 서버 시작
server = QLocalServer()
# 기존 서버가 남아있을 수 있으므로 제거
QLocalServer.removeServer(server_name)
if not server.listen(server_name):
QMessageBox.warning(
None,
"서버 오류",
"프로그램 인스턴스 서버를 시작할 수 없습니다."
)
return 1
# 폰트 설정
app.setFont(QFont("Segoe UI", 9))
# 필수 패키지 확인
if not check_requirements():
QMessageBox.critical(
None,
"요구사항 오류",
"필수 패키지가 설치되지 않았습니다.\n\n"
"다음 명령어를 실행하세요:\n"
"pip install -r requirements.txt"
)
return 1
# 데이터베이스 초기화 — db_path_override 설정 시 그 경로 사용 (클라우드 폴더 등)
# 부트스트랩: 기본 DB로 한 번 열어 override 키 확인
from core.settings_keys import DB_PATH_OVERRIDE
bootstrap = Database()
override_path = bootstrap.get_setting(DB_PATH_OVERRIDE, '') or ''
if override_path and os.path.exists(os.path.dirname(override_path) or '.'):
db = Database(override_path)
else:
db = bootstrap
# 1일 1회 자동 백업 (조용히 실패 — 백업 실패가 앱 실행을 막으면 안 됨)
try:
from utils.backup import backup_db_if_needed
backup_db_if_needed(db)
except Exception as e:
from utils.debug_log import dlog
dlog(f"backup failed: {e}")
# 메인 윈도우 생성 및 표시
try:
window = MainWindow()
# 서버 연결 처리 - 다른 인스턴스에서 show 신호를 받으면 창을 보여줌
def on_new_connection():
client_socket = server.nextPendingConnection()
if client_socket:
client_socket.waitForReadyRead(1000)
data = client_socket.readAll().data()
if data == b"show":
# 창 표시
window.show()
window.raise_()
window.activateWindow()
client_socket.disconnectFromServer()
server.newConnection.connect(on_new_connection)
window.show()
result = app.exec_()
# 서버 종료
server.close()
return result
except Exception as e:
QMessageBox.critical(
None,
"오류",
f"프로그램 실행 중 오류가 발생했습니다:\n\n{str(e)}"
)
server.close()
return 1
if __name__ == "__main__":
sys.exit(main())