Tarefas Agendadas & Crons no Cloudflare (Cloudflare Cron Triggers)

Tarefas Agendadas (Cron Triggers & Background Tasks)

O Prime Crown utiliza os Cron Triggers nativos do Cloudflare Workers para executar rotinas operacionais assíncronas em segundo plano, sem necessidade de servidores externos.

---

⏰ 1. Visão Geral das Tarefas Agendadas

graph TD
    Cron["Cloudflare Cron Triggers"] -->|Daily 08:00 AM| Reminders["Lembretes de Limpeza (WhatsApp/Push)"]
    Cron -->|Daily 00:00 AM| Overdue["Atualização de Faturas Vencidas"]
    Cron -->|Hourly| Sync["Sincronização de Calendários iCal / Google"]
    Cron -->|Weekly (Sunday)| Audit["Auditoria de Estabilidade (StabilityService)"]

---

🛠️ 2. Rotinas Executadas (/functions/api/cron/*)

A. Lembretes de Agendamento (WhatsApp & Push Notifications)

• Frequência: Diariamente às 08:00 AM.
• Função: Envia mensagens de confirmação para os clientes que possuem limpeza agendada no dia seguinte, incluindo nome da funcionária e horário de chegada.

B. Atualização Automática de Faturas (Invoice State Cron)

• Frequência: Diariamente às 00:00 AM.
• Função: Verifica faturas com status ISSUED cuja due_date expirou, alterando o status para OVERDUE e aplicando taxas de atraso se configurado.

C. Sincronização Externa de Calendários (iCal / Google Sync)

• Frequência: A cada 1 hora.
• Função: Exporta a agenda de atendimentos das funcionárias para seus calendários pessoais (Google Calendar / Apple iCal) via feed ICS seguro.

D. Varredura Semanal de Auditoria (Stability Audit Cron)

• Frequência: Todo domingo às 23:00 PM.
• Função: Executa o StabilityService para detectar inconsistências de faturamento ou choque de rotas antes do início da semana operacional.