feat: init app user_notifications

[Winzen]

feat: init app user_notifications #961

---

Este PR implementa o fluxo completo de notificação por e-mail para usuários inscritos em atualizações de tabelas, incluindo modelagem, interface administrativa, comando Django, envio de e-mails e execução automática via tarefa agendada.

---

📌 Contexto

Usuários podem se inscrever para acompanhar atualizações de tabelas específicas. Quando uma tabela é atualizada, o sistema deve identificar essas mudanças e notificar os usuários por e-mail, evitando envios duplicados e permitindo controle administrativo das inscrições.

A solução centraliza a lógica em um comando Django reutilizável, que pode ser executado manualmente ou automaticamente em produção.

🔄 Fluxograma do fluxo de notificação

┌──────────────────────────────┐
│ Huey (tarefa periódica)       │
│ Seg–Sex às 07:00              │
└───────────────┬──────────────┘
                │
                ▼
┌──────────────────────────────┐
│ call_command("send_notification") │
└───────────────┬──────────────┘
                │
                ▼
┌──────────────────────────────┐
│ Busca TableUpdateSubscription │
│ com status = True             │
└───────────────┬──────────────┘
                │
                ▼
┌──────────────────────────────┐
│ Para cada subscription        │
│ tabela foi atualizada?        │
└───────────────┬──────────────┘
        ┌───────┴────────┐
        │                │
        ▼                ▼
     Não ignora     Sim adiciona
                     ao grupo
                     do usuário
                         │
                         ▼
┌──────────────────────────────┐
│ Agrupa subscriptions         │
│ por usuário                  │
└───────────────┬──────────────┘
                │
                ▼
┌──────────────────────────────┐
│ Envia 1 e-mail por usuário   │
│ (HTML + texto)               │
└───────────────┬──────────────┘
                │
                ▼
┌──────────────────────────────┐
│ Atualiza subscription:       │
│ - last_notification          │
│ - updated_at                 │
└──────────────────────────────┘

---

✅ O que foi implementado

1. Modelagem de domínio

• Criação do model TableUpdateSubscription, responsável por:

  • Relacionar usuário (Account) e tabela (Table)
  • Controlar status da inscrição
  • Armazenar datas de criação, última notificação e última atualização processada

• Base para rastreabilidade, controle e futuras extensões (ex: histórico, soft-delete).

---

2. Interface administrativa (Django Admin)

• Registro do model no Django Admin com configuração personalizada:

  • Listagem completa (list_display)
  • Filtros por status, tabela e usuário
  • Busca por nome da tabela e username
  • Edição inline do status da inscrição
  • Organização por fieldsets
  • Campos de data protegidos como readonly

• Permite gestão completa das inscrições sem acesso direto ao banco.

---

3. Verificação de atualizações

• Implementação de lógica para verificar se:

  • table.last_updated_at é mais recente que subscription.updated_at

• Apenas inscrições ativas (status=True) são consideradas.

• Subscriptions com atualização são separadas para notificação.

---

4. Agrupamento por usuário

• As subscriptions são agrupadas por usuário antes do envio.
• Garante que cada usuário receba apenas um e-mail, mesmo que múltiplas tabelas tenham sido atualizadas.

---

5. Envio de e-mails

• Envio utilizando EmailMultiAlternatives, com:

  • Corpo em texto
  • Template HTML (update_table_notification.html)

• Após o envio:

  • Atualização de last_notification
  • Sincronização de subscription.updated_at com table.last_updated_at

---

6. Management Command

• Criação do comando Django send_notification, responsável por:

  • Executar a verificação
  • Enviar os e-mails

• Pode ser executado manualmente para testes locais ou troubleshooting.

---

7. Execução automática (Huey + cron)

• Criação de tarefa periódica com @db_periodic_task

• Agendada para rodar:

  • Segunda a sexta-feira
  • Às 07:00

• Protegida pelo decorator @production_task

• A tarefa apenas dispara o command, mantendo a lógica centralizada e reutilizável.

---

🎯 Benefícios

• Automação completa do fluxo de notificação
• Evita spam e envios duplicados
• Código organizado e reutilizável
• Fácil manutenção e extensão futura
• Controle administrativo simples via Django Admin

---