quota-monitor

What it monitors

Quota monitor tracks the appointment quota for renewing Hong Kong identity cards at the immigration department in real time, and when new slots are released it automatically notifies users through Feishu group chat and Feishu direct messages. The README explains two ways to receive alerts: joining a Feishu group where a bot pushes quota changes with messages arriving in seconds, or subscribing via direct message to a bot that supports filtering by date, by office, or by both. The direct message bot lets a user subscribe to specific dates, all dates, or view, modify and cancel subscriptions, and replies can be as simple as sending a date range like 08/15 or 08/20 to 08/25. A dashboard hosted on GitHub Pages shows real time quota status across offices, a heatmap of release patterns, a phone booking tutorial and a management backend.

Notification flow and privacy

When new quota is detected, the system pushes group broadcast across multiple groups in parallel first, then direct message to subscribers whose date filters match, with both arriving almost simultaneously. Privacy and security are addressed by storing Feishu user data with AES 256 GCM encryption so it is unreadable in the repository, and the tool only reads quota data that the immigration department publishes openly. A disclaimer states the system is a third party open source tool and not an official immigration department service, and users should rely on the official website. The README also credits the data source as the immigration department's quota enquiry client and a phone booking tutorial from a social media creator.

Automation and licensing

The project runs fully automatically on GitHub Actions, which is how the monitoring and notification happen without a continuously managed server. It is written in JavaScript, licensed under MIT by Deng Zheyi, and carries a note that the project is for learning and communication only and should not be used for commercial profit. The repository carries 24 stars and 5 forks with 2 open issues, the default branch is main, and the homepage is the GitHub Pages dashboard. The practical value is a free, self updating alert system for a specific bureaucratic appointment bottleneck, with both group and private notification channels and a public dashboard, though users must supply their own Feishu bot credentials to receive messages.

Editorial conclusion

Quota monitor is an MIT licensed JavaScript tool on the main branch with 24 stars that runs on GitHub Actions to track Hong Kong ID renewal appointment quota and alert users via Feishu groups and direct messages, storing user data with AES 256 GCM encryption and noting it is an unofficial third party tool.