알림 설정과 동작

이 문서는 Sudapapa Diary가 사용자에게 보여주는 모든 종류의 알림이 언제, 어떻게, 어떤 형태로 표시되는지 설명합니다. 시계 알람의 추가/삭제 같은 운영 절차는 알람 관리, 일정에 알림을 부착하는 절차는 QuickAdd에서 다룹니다.

알림 종류

일정 알림(Reminder) - QuickAdd에서 일정에 부착한 알림. 시작 N분/일 전에 발화.
시계 알람(Clock Alarm) - 알람 관리에서 만든 시간 기반 독립 알림.
시스템 토스트 - Windows 알림 센터에 잠깐 떠올랐다 사라지는 가벼운 알림.
인앱 팝업 - 메인 모니터 중앙에 항상 위로 떠오르는 강한 알림.
트레이 풍선 - 동기화 결과 등 백그라운드 작업의 결과 알림.

일정 알림(Reminder) 동작

일정 알림은 QuickAdd의 알림 영역에서 한 일정에 최대 5개까지 추가할 수 있습니다. 저장 형식은 두 가지입니다.

{ "type": "notification", "minutes": 10, "sound": true, "popup": false }
{ "type": "notification", "days": 3, "time": "09:00", "sound": true, "popup": true }

reminderScheduler.js가 1분 주기로 검사하며, 일정 시작 시각에서 N분(또는 N일 + HH:MM 시점)을 빼서 ±30초 허용 범위에 들어오면 발화합니다.

조건	처리
`is_all_day=1` 인 종일 일정	일정 알림 스킵 (시간 정보 없음)
시간 정보 누락	스킵
이미 시작된 일정	스킵
동일 알림 키 중복	한 번만 발화 (최대 1,000건 추적 후 자동 정리)

표시 방식: 토스트 vs 팝업

각 알림은 popup 플래그에 따라 두 가지 중 하나로 표시됩니다.

시스템 토스트(기본)
인앱 팝업

Windows 알림 센터로 표시되는 가벼운 알림입니다. Electron Notification API를 사용하며, 클릭 시 일정 카드를 열거나 앱을 활성화합니다. 30초~몇 분 후 자동으로 알림 센터로 들어가 사라집니다.

메인 모니터 중앙에 별도 윈도우로 떠올라 일정 제목, 위치, “N분 후 시작” 안내를 큼지막하게 보여줍니다. 항상 위(alwaysOnTop)로 떠오르고 작업표시줄에는 표시되지 않으며 30초(시계 알람은 60초) 후 자동으로 닫힙니다.

알림 본문 형식

언어 설정(app-language/language, auto 시 시스템 로캘로 결정)에 따라 본문이 바뀝니다.

언어	본문 예시
한국어	`📅 회의 / 10분 후 시작 · 14:00 / 📍 회의실`
English	`📅 Meeting / 10min before · 14:00 / 📍 Conference Room`

위치(event.location)가 있으면 두 번째 줄에 📍 이모지와 함께 추가됩니다.

시계 알람 동작

시계 알람도 같은 인프라(reminderScheduler.js)에서 처리되지만 일정과 분리된 키 공간을 사용합니다. 자세한 운영 절차와 반복 옵션은 알람 관리를 참고하세요.

핵심 동작 요약:

환경설정의 clockAlarms 배열에서 활성 알람을 읽음
매일 첫 번째 검사 시 그날 발화 예정 알람을 정확한 시각에 AlarmTimer로 예약
폴링 검사도 병행 (예약 누락 대비 안전망)
발화 시 popup 플래그에 따라 토스트 또는 인앱 팝업 표시
발화 후 clock-{id}-{날짜} 키로 중복 차단 (날짜가 바뀌면 자동 초기화)

절전(슬립) 복귀 처리

PC가 잠자기/절전 상태에 들어가면 setTimeout 기반 타이머가 정지합니다. 복귀 시 다음 절차로 누락된 알림을 보정합니다.

Electron powerMonitor의 suspend/resume 이벤트 구독
복귀 직후 1초 디바운스(macOS resume 중복 발화 방지)
절전 시작 시각 ~ 복귀 시각 범위 또는 최대 5분 전까지의 시계 알람을 즉시 발화
일정 알림은 전체 검사를 한 번 더 수행하여 즉시 보정

환경설정으로 제어

설정 페이지의 알림 섹션에서 모든 알림을 일괄 제어할 수 있습니다.

키	설명
`notifications.enabled`	모든 알림 마스터 스위치
`notifications.disableAll`	”지금 모든 알림 끄기” 단축 토글
`notifications.muteAllSounds`	알림 소리만 모두 음소거 (시각 알림은 유지)
`notifications.dnd.enabled`	방해 금지 시간 활성/비활성
`notifications.dnd.startTime` / `endTime`	방해 금지 시작/종료 (`HH:MM`, 자정 넘김 지원)

방해 금지 시간(DND)

startTime이 endTime보다 작으면 같은 날 범위(예: 09:00~~17:00), 그렇지 않으면 자정을 넘기는 범위(예: 22:00~~07:00)로 해석됩니다. DND 시간대에는 일정 알림과 시계 알람이 모두 표시되지 않습니다.

트레이 풍선 알림

다음 백그라운드 작업의 결과는 시스템 토스트가 아니라 트레이 풍선 알림으로 노출되기도 합니다.

외부 캘린더 동기화 완료/실패
백업 파일 생성 완료
마이그레이션 결과
라이선스/구독 상태 변경

트레이 알림은 Windows 알림 센터로 함께 들어가므로, 잠시 자리를 비웠다가 돌아왔을 때 그동안의 결과를 한꺼번에 확인할 수 있습니다.

동기화 결과 알림

Google, Microsoft/Naver/Kakao 캘린더 동기화 중 다음 이벤트는 알림으로 표시될 수 있습니다.

이벤트	표시
토큰 만료(재로그인 필요)	트레이 풍선 + 인앱 배지
일시적 네트워크 오류	알림 없음 (자동 재시도)
권한 부족(403)	트레이 풍선
새 일정 다수 가져옴	알림 없음 (위젯이 즉시 갱신)

Windows 알림 권한 확인

알림이 보이지 않는다면 다음을 점검하세요.

시작 → 설정 → 시스템 → 알림 - 알림 토글 ON
앱별 알림 목록에서 Sudapapa Diary 활성화 확인
**집중 지원(Focus Assist)**이 우선순위만이면 앱이 차단될 수 있음 - 끄기 또는 우선순위 목록에 추가
잠금 화면 알림을 원한다면 동일 페이지에서 별도로 토글
Windows 11 빌드별 알림 정책이 다를 수 있으므로 최신 누적 업데이트 적용 권장

인앱 팝업 우선 사용

다음과 같은 경우에는 시스템 토스트보다 팝업 ON이 더 적합합니다.

회의 시작 직전 등 절대 놓치면 안 되는 알림
Windows 알림 권한이 회사 정책으로 제한된 환경
듀얼 모니터에서 메인 모니터에 강한 시각 신호가 필요한 상황

팝업은 OS 알림 권한과 무관하게 항상 표시됩니다.

알림 동작 검증

알림이 정상 작동하는지 확인하려면 다음 방법을 권장합니다.

1분 뒤 시각으로 QuickAdd 일정을 만들고 0분 전에 가까운 사용자 설정 알림 추가
또는 1~2분 뒤 시각으로 시계 알람 추가
토스트와 팝업을 각각 다른 알림으로 설정해 둘 다 표시되는지 확인
알림이 보이지 않으면 위 Windows 알림 권한 확인 절차 점검

트러블슈팅

증상	원인/해결
알림이 전혀 안 옴	환경설정 `notifications.enabled` 또는 `disableAll`, Windows 알림 토글 확인
소리만 안 들림	`notifications.muteAllSounds` 또는 알림별 소리 토글 확인, Windows 음량 믹서 확인
정해진 시간보다 늦게 옴	PC가 절전 상태였을 가능성 - 5분 이내라면 복귀 시 자동 발화
같은 알림이 두 번 옴	절전 복귀와 폴링 검사 사이의 경계 - 자동 차단되지만, 재현 시 이슈로 보고 부탁
팝업이 다른 모니터에 뜸	디스플레이 주 모니터 변경 후 재시작
야간에 알림 차단 원함	방해 금지 시간 설정 (예: 22:00~07:00)