# 초근알리미 1.5.0

직원 개인용 Edge 오른쪽 사이드바 타이머·기록장·리마인더. 제작: [초실행관](https://choshg.com/).

## 설치 및 업데이트

1. ZIP 파일을 내려받아 압축을 풉니다.
2. Edge 주소창에 edge://extensions를 입력합니다.
3. 개발자 모드를 켜고 압축 풀린 확장 로드 → extension 폴더를 선택합니다.
4. 퍼즐 아이콘에서 초근알리미를 도구 모음에 표시합니다.
5. 초근알리미 아이콘을 누르면 오른쪽 사이드바가 열립니다.

기존 사용자는 기존 설치 폴더에 새 파일을 덮어쓰고 Edge 확장 관리에서 새로고침하세요. 사이드바와 Google 공개 공휴일 조회 권한 승인이 표시되면 승인하세요. 확장을 제거하면 기록이 삭제될 수 있으므로 업데이트 시 제거하지 마세요. 설치 폴더는 계속 보관합니다.

## 오늘 · 기록 · 설정

- 오늘: 시작/종료, 실제 경과시간, 다음 알림, 이달 인정시간, 오늘 기록.
- 조기출근 입력: 출근 시:분만 입력합니다. 오늘 날짜 자동 저장, 08:00 이전(분 입력은 07:59까지)만 인정. 별도 종료 입력 없이 정규 출근 시각(기본 09:00)까지 계산합니다. 정규 출근 전에 입력해도 이미 지난 시간만 누적됩니다. 정규 출근 시각은 공제 설정에서 변경 가능합니다.
- 기록: 같은 사이드바에서 월 선택, 완료 기록 수정/삭제, 실제·공제·인정시간 CSV 다운로드. 조기출근 수정도 출근 시각만 입력합니다.
- 설정: 50/55/60분 알림, 월 기준시간, 알림/소리. 공제·공휴일 설정은 별도 대화상자에서 제공합니다.

## 인정시간과 공휴일

평일 기본 공제 60분. 실제 5시간 → 공제 1시간 → 인정 4시간. 리마인더는 실제 경과시간, 월 누적/기준 경고는 인정시간을 사용합니다. 같은 날 여러 세션과 조기출근을 합산하여 공제는 날짜별 한 번만 적용합니다. 토일·공휴일 기본 공제 0분은 임시값이며 기관 규칙에 맞춰 조정하세요. 기준시간 57시간은 수정 가능한 예시값입니다.

Google Calendar 공개 대한민국 공휴일을 자동 반영합니다. 현재 데이터 스냅샷을 포함하므로 인터넷 없이도 마지막 데이터를 사용합니다. 24시간마다 자동 갱신하고 설정의 지금 갱신 버튼으로 다시 조회할 수 있습니다. 조회 실패 시 기존 데이터를 보존하고 상태를 표시합니다.

설정 달력의 파란 날짜는 Google 공휴일, 주황은 사용자가 추가한 휴일입니다. 날짜를 누르면 추가/해제할 수 있으며 자동 갱신 후에도 추가/제외 설정을 유지합니다. Google 공휴일 데이터와 기관 규칙이 다를 수 있으므로 확인하세요. 정책을 저장하면 기존 기록도 다시 계산합니다.

## 저장·알림 주의사항

근무 기록은 chrome.storage.local에만 저장하며 서버로 전송하지 않습니다. 외부 연결은 공개 Google 공휴일 캘린더 조회에 한정하고 인증·개인 캘린더·회원가입을 사용하지 않습니다. 기관 내부망 등에서 Google 접속이 차단되면 동봉된 공휴일/최근 캐시를 사용합니다.

Edge가 완전히 종료되거나 PC가 꺼져 있으면 알림이 울리지 않습니다. 다시 열면 근무를 복원하고 놓친 확인 알림을 한 번 표시합니다. Windows 집중 지원·절전·알림 설정에 따라 실제 알림과 소리가 달라집니다. 종료를 잊었다면 종료 후 기록을 수정하세요.

CSV는 보관용이며 가져오기와 PC 동기화는 지원하지 않습니다. 실제 인정시간과 수당은 소속 기관 인사시스템을 기준으로 합니다. 인사랑/e-사람 자동 입력·로그인·세션 연장 기능은 없습니다.

## 개발

npm test — 계산/공휴일/복원 테스트
npm run preview — http://127.0.0.1:8787 화면 미리보기 (실제 Edge 알림은 설치 후)
npm run build — 제공 로고의 아이콘 크기 생성 및 파일 검증. 개발용 sharp 패키지 또는 Codex 번들 필요.

소스: extension/, 상세페이지: website/, 원본 및 개정 PRD: docs/.


## 1.5.0 저녁 계산과 알림
평일 저녁은 18시 이후 기록만 인정 계산에 포함합니다. 조기출근이 없으면 기본 공제 구간 18~19시를 제외하여 19시부터 인정합니다. 시작 버튼을 누른 시각과 관계없이 평일 계산 시작은 18:00입니다. 20:00에 시작 버튼을 누르고 23:00에 종료해도 기본 인정시간은 4시간입니다. 같은 날 다시 시작하면 기존 일반 기록을 이어 계산합니다. 수동 수정 기록은 명시한 시각을 존중합니다. 조기출근은 기존 방식대로 하루 공제에 합산합니다. 18시 이전 제외 시간은 기록과 CSV에 표시합니다. 토일·공휴일은 별도 설정을 유지합니다.
기본 첫 알림은 19:55, 이후 20:55, 21:55 순서로 반복합니다. 설정에서 첫 시각과 반복 주기를 바꿀 수 있습니다. 늦게 시작하면 시작 이전 알림은 건너뛰고 다음 예정 시각부터 받습니다.