시계 위젯 (알람·타이머)

신규 알람 + 타이머 12/24시간

시계 위젯은 큰 디지털 시계 + 시계 알람 + 카운트다운 타이머를 한 위젯에서 함께 관리하는 통합 위젯입니다. 사이드바의 알람 관리 페이지와 양방향 동기화되어 어느 쪽에서 알람을 추가해도 즉시 반영됩니다.

시계 위젯 — 큰 디지털 시계 + 알람 목록 — 시계 위젯 — 클래식 화이트 테마 (12시간 표시 + 알람 2개)

핵심 특징

시계 / 목록 영역 분리

상단 시계 영역과 하단 알람·타이머 목록 영역을 각각 독립적으로 ON/OFF 할 수 있습니다.

12 / 24시간 토글

위젯 설정에서 24시간 표시를 켜면 15:30, 끄면 오후 3:30 형식으로 표시됩니다.

타이머 백그라운드 스케줄링

타이머 카운트다운은 메인 프로세스에서 진행되므로 위젯을 닫아도 종료되지 않으며, 만료 시 팝업과 소리로 알립니다.

알람 양방향 동기화

위젯에서 추가/수정한 알람은 사이드바의 알람 관리 페이지와 동일한 clockAlarms 저장소를 공유합니다.

위젯 화면 구성

┌──────────────────────────────────────────┐
│           [+ 알람]  [+ 타이머]  [⚙]      │ ← 헤더 (드래그 가능)
├──────────────────────────────────────────┤
│                                          │
│            14:32                         │ ← 시계 영역 (글자 16~60px)
│      2026년 5월 8일 (금)                  │
│                                          │
├──────────────────────────────────────────┤
│  ⏰ 기상  07:00  주중      [✏][🗑][●]     │
│  ⏰ 회의 알림 14:30  매일   [✏][🗑][○]     │
│  ⏳ 포모도로 24:18 / 25:00 [▶][↺][🗑]     │
│  ⏳ 휴식    완료!          [▶][↺][🗑]     │
└──────────────────────────────────────────┘
   ↕ 위·아래로만 크기 조절 (가로 폭 320px 고정)

영역	설명
헤더	`+ 알람` / `+ 타이머` / 설정(⚙) 버튼. 시계·목록 영역 토글 아이콘이 함께 노출됩니다.
시계 영역	큰 디지털 시계 + 오늘 날짜. 글자 크기는 16 ~ 60 px 범위에서 슬라이더로 조정.
목록 영역	알람 카드 + 타이머 카드 통합 리스트. 카드별 토글·편집·삭제 버튼 제공.

새 알람 추가하기

위젯 헤더의 + 알람 버튼 클릭
모달에서 다음 항목 입력
- 이름(라벨, 선택) — 예: 기상, 약 먹기
- 시간 — HH:MM
- 반복 — 한 번 / 매일 / 주중 / 주말 / 사용자 지정(요일 체크박스)
- 팝업 토글 — 시스템 토스트 대신 화면 중앙 팝업 창 사용
- 소리 토글
저장 클릭 → 목록에 즉시 추가되고 다음 발화 시각이 자동 예약됩니다.

발화 동작과 절전 복귀 처리, 정밀 스케줄링 같은 시스템 레벨 동작은 알람 관리 문서를 참고하세요. 위젯과 알람 관리 페이지는 같은 데이터(clockAlarms)를 공유합니다.

새 타이머 추가하기

위젯 헤더의 + 타이머 버튼 클릭
모달에서 다음 항목 입력
- 이름(라벨, 선택) — 예: 포모도로, 휴식
- 시간 — 시 : 분 : 초 (분 디폴트 25분)
- 팝업 토글 (디폴트 ON) — 만료 시 화면 중앙 팝업 창
- 소리 토글 (디폴트 ON)
저장 클릭 → 목록에 추가되고 즉시 사용할 수 있습니다.

타이머 카드의 ▶(시작)/⏸(일시정지)/↺(리셋) 버튼으로 직접 제어합니다. 일시정지 후 다시 ▶을 누르면 남은 시간부터 이어서 카운트다운이 진행됩니다.

타이머 만료 알림

타이머가 0에 도달하면 두 가지 방식으로 즉시 알립니다.

플라이아웃(기본 + 위젯 떠있을 때)
팝업 윈도우(팝업 ON)

위젯 좌측 상단에 작게 떠오르는 토스트형 플라이아웃입니다. 타이머 라벨과 “완료!” 안내가 잠시 표시되며 위젯 내부에서만 동작합니다.

시계 영역 / 목록 영역 토글

위젯 헤더에는 시계 ON/OFF 와 목록 ON/OFF 토글이 있습니다. 둘은 서로 독립적입니다.

시계	목록	결과
ON	OFF	큰 시계만 표시. 위젯 높이가 시계 높이로 잠금 — 빈 공간 없이 깔끔.
ON	ON	시계 + 알람·타이머 목록(스크롤). 가장 일반적인 사용 형태.
OFF	ON	알람·타이머 목록만 표시 (시계 영역 숨김).
OFF	OFF	헤더만 표시 (사실상 사용하지 않는 상태).

위젯 설정

헤더의 ⚙(설정) 버튼을 누르면 시계 위젯 전용 설정 팝업이 열립니다.

설정	범위	설명
창 고정	토글	드래그/리사이즈 잠금
24시간 표시	토글	OFF: `오후 3:30` / ON: `15:30`
모서리 둥글기	0 ~ 16 px	위젯 모서리 라운드
시계 글자 크기	16 ~ 60 px	디지털 시계 폰트 사이즈
테마 프리셋	4종	클래식 화이트 / 다크 모던 / 랜덤 / 사용자 설정
테마 불투명도	0 ~ 100 %	프리셋 위에 한 번에 거는 투명도
사용자 상세설정	색상 5종	배경, 글자, 버튼, 카드 배경, 카드 글자 색상 + 배경 불투명도

알람 카드 동작

각 알람 카드는 다음과 같이 동작합니다.

영역	동작
라벨 + 시간 + 반복	알람 정보 표시
🔔/🔕 (스피커)	소리 ON/OFF 즉시 토글
💬/📢 (팝업)	팝업 ON/OFF 즉시 토글
✏(편집)	편집 모달 열기
🗑(삭제)	확인 후 알람 제거
우측 토글	활성/비활성 — OFF 시 발화 안 함

알람 데이터가 변경되면 위젯과 사이드바 알람 관리 페이지가 IPC 이벤트(alarms:updated)로 즉시 동기화됩니다.

타이머 카드 동작

영역	동작
라벨 + 남은 시간 / 전체 시간	`MM:SS / MM:SS` (긴 타이머는 `HH:MM:SS`)
▶ / ⏸	시작 / 일시정지 (만료 상태에선 리셋 후 시작)
↺ (리셋)	처음부터 다시 시작 가능한 상태로 되돌리기
✏(편집)	라벨/시간/팝업/소리 수정
🗑(삭제)	확인 후 타이머 제거
상태 뱃지	`대기 / 진행중 / 일시정지 / 완료!`

데이터 저장 위치

알람: 환경설정의 clockAlarms 키에 JSON 배열로 저장 — 알람 관리와 동일한 저장소
타이머: 메인 프로세스의 SQLite 기반 저장소 — 위젯/PC 재시작 후에도 마지막 상태(라벨, 길이, 일시정지 시각) 유지
위젯 보기 상태: 시계 ON/OFF, 목록 ON/OFF는 localStorage에 저장 (widget-alarms-timers-clock-visible, widget-alarms-timers-list-visible)

위젯 활성화 방법

경로	설명
대시보드 → 위젯 관리	”시계 위젯” 카드를 클릭한 뒤 활성 토글
트레이 메뉴 → 위젯 관리	향후 추가 예정. 현재 빌드는 대시보드 경유만 지원

트러블슈팅

증상	해결
시계가 위젯을 헤더만 남기고 사라짐	시계 영역 토글이 OFF 상태일 가능성 — 헤더의 시계 토글 버튼을 다시 ON.
가로 크기 조절이 안 됨	정상 동작 — 시계 위젯은 가로 폭이 320 px로 고정됩니다.
목록 OFF 인데 위젯이 늘어남	최신 버전에서 자동 잠금 — 업데이트 후 위젯을 재실행하세요.
타이머가 1분 단위로만 작동하는 듯	위젯이 닫힌 동안에도 메인 프로세스에서 1초 단위로 진행됨 — 위젯을 다시 열면 정확한 남은 시간이 표시됩니다.
만료 팝업이 다른 모니터에 뜸	메인 모니터 기준 — 디스플레이 설정에서 주 모니터를 변경하세요.