quota-monitor

# Monitoramento de vagas para renovação do bilhete de identidade de Hong Kong Este projeto acompanha em tempo real as vagas de agendamento para **renovação do bilhete de identidade** do Departamento de Imigração de Hong Kong. Quando novas vagas são liberadas, os usuários são notificados automaticamente por dois canais: **transmissão em grupo no Feishu** e **mensagem privada no Feishu**. ## Principais funções ### Notificação por dois canais - **Grupo no Feishu**: o robô envia automaticamente as mudanças de vagas, com mensagens entregues em segundos. Basta entrar no grupo para usar, sem configuração, e há suporte a distribuição por vários grupos. - **Assinatura por mensagem privada no Feishu**: envie mensagem privada ao robô "HKID放号自动监测", com suporte a três modos de filtro: - 📅 Filtrar por data — acompanhar apenas datas específicas de agendamento - 🏢 Filtrar por posto — acompanhar apenas postos específicos - 🎯 Por data + posto — correspondência precisa - Suporte a intervalo de datas (ex.: `08/15, 08/20-08/25`) ### Painel visual - Visualização em tempo real do status das vagas de agendamento em todos os postos de Hong Kong - Mapa de calor dos padrões de liberação de vagas, mostrando a frequência por horário - Tutorial integrado de agendamento por telefone - Painel administrativo com gerenciamento de assinantes, visão geral de estatísticas e envio em massa pelos dois canais ### Fluxo de notificação Quando novas vagas são detectadas, o envio segue a ordem: **transmissão em grupo (vários grupos em paralelo) → mensagem privada (em paralelo, enviada apenas aos assinantes correspondentes)**, com ambos chegando quase ao mesmo tempo. ## Privacidade e segurança - Os dados dos usuários do Feishu são armazenados com **criptografia AES-256-GCM** e não podem ser lidos no repositório - São lidos apenas os dados de vagas **publicados publicamente** pelo Departamento de Imigração - Serviço não oficial; consulte o site oficial para informações definitivas ## Arquitetura técnica - Execução totalmente automática baseada em GitHub Actions - Fonte de dados: interface pública de pré-visualização de vagas de agendamento do Departamento de Imigração de Hong Kong - Arquitetura detalhada, guia de autoimplantação e esquema de criptografia estão em ARCHITECTURE.md ## Licença Licença MIT, apenas para estudo e intercâmbio. Não use para fins comerciais lucrativos.