About this project

# Hong Kong Immigration Department ID Card Replacement Appointment Quota Monitoring This project tracks the Hong Kong Immigration Department's **ID card replacement** appointment quotas in real time. When new slots are released, it automatically notifies users through dual channels: **Feishu group broadcasts** and **Feishu private chats**. ## Core Features ### Dual-Channel Notifications - **Feishu Groups**: The bot automatically pushes quota changes, with messages arriving instantly. Join the group to use it with no configuration required, and multiple groups can be supported for distribution. - **Feishu Private Chat Subscriptions**: Private message the bot "HKID放号自动监测" and choose from three filtering modes: - 📅 Filter by date — only follow specific appointment dates - 🏢 Filter by office — only follow specific offices - 🎯 Filter by date + office — exact matching - Supports date range input (e.g., `08/15, 08/20-08/25`) ### Visual Dashboard - View appointment quota status for all offices across Hong Kong in real time - Slot release pattern heatmap, visualizing release frequency across time periods - Built-in tutorial for booking appointments by phone - Admin backend supports subscriber management, statistics overview, and dual-channel mass messaging ### Notification Flow When new quotas are detected, notifications are pushed in order: **group chat broadcast (multiple groups in parallel) → private chat DM (in parallel, only to matching subscribers)**, with both arriving almost simultaneously. ## Privacy & Security - Feishu user data is stored with **AES-256-GCM encryption** and is unreadable in the repository - Only reads quota data **publicly released** by the Immigration Department - This is an unofficial service; please refer to the official website for authoritative information ## Technical Architecture - Fully automated via GitHub Actions - Data source: Hong Kong Immigration Department appointment quota preview public API - See ARCHITECTURE.md for detailed architecture, self-deployment guide, and encryption scheme ## License MIT License, for learning and communication purposes only. Please do not use for commercial profit.