quota-monitor

# 홍콩 입경사무소 신분증 교체 예약 쿼터 모니터링 본 프로젝트는 홍콩 입경사무소의 **신분증 교체** 예약 쿼터를 실시간으로 추적하며, 새 쿼터가 풀리면 **페이수 그룹 방송**과 **페이수 개인 채팅** 이중 채널을 통해 사용자에게 자동으로 알립니다. ## 핵심 기능 ### 이중 채널 알림 - **페이수 그룹**: 봇이 쿼터 변동을 자동 푸시하며, 메시지가 즉시 도착합니다. 그룹에 참여하기만 하면 설정 없이 사용할 수 있고, 다중 그룹 분산을 지원합니다. - **페이수 개인 채팅 구독**: 봇 'HKID放号自动监测'에게 개인 채팅으로 세 가지 필터 모드를 지원합니다. - 📅 날짜별 필터 — 특정 예약 날짜만 확인 - 🏢 사무소별 필터 — 특정 사무소만 확인 - 🎯 날짜+사무소 — 정확히 일치 - 날짜 범위 입력 지원(예: `08/15, 08/20-08/25`) ### 시각화 대시보드 - 홍콩 전역 각 사무소의 예약 쿼터 상태를 실시간으로 확인 - 쿼터 배정 패턴 히트맵으로 시간대별 배정 빈도를 시각화 - 전화 예약 처리 튜토리얼 내장 - 관리 백엔드에서 구독자 관리, 통계 개요, 이중 채널 일괄 발송 지원 ### 알림 흐름 새 쿼터가 감지되면 순서대로 푸시합니다: **그룹 채팅 방송(다중 그룹 병렬) → 개인 DM(병렬, 일치하는 구독자에게만 푸시)**, 둘은 거의 동시에 도착합니다. ## 개인정보 보호 및 보안 - 페이수 사용자 데이터는 **AES-256-GCM 암호화 저장**되며, 저장소에서 읽을 수 없습니다. - 입경사무소가 **공개한** 쿼터 데이터만 읽습니다. - 비공식 서비스이므로 공식 웹사이트 정보를 기준으로 삼으시기 바랍니다. ## 기술 아키텍처 - GitHub Actions 기반 완전 자동 실행 - 데이터 출처: 홍콩 입경사무소 예약 쿼터 미리보기 공개 인터페이스 - 자세한 아키텍처, 자체 배포 가이드, 암호화 방안은 ARCHITECTURE.md 참조 ## 라이선스 MIT License, 학습 및 교류 목적으로만 사용하며 상업적 이익 목적으로 사용하지 마십시오.