obsidian-vault/ligbox-ops-platform/specs/007-mobile-push-notifications/quickstart.md

Quickstart — Spec 007 Push (draft)

Status: 📋 Planejamento — não implementado ainda

---

Visão

Push para equipe Ligbox Ops via:

1. Fase A: app ntfy (Android/iOS) — mais rápido
2. Fase B: Web Push no browser (PWA Desk)

---

Fase A — ntfy (quando implementado)

Usuário (técnico/NOC)

1. Login no Desk → Minha conta
2. Ativar Notificações ntfy
3. Instalar app ntfy no celular
4. Escanear QR ou abrir link do tópico
5. Enviar teste — deve chegar push em segundos

Eventos automáticos (previstos)

Evento	Destinatário
Ticket Wazuh crítico	NOC, ops_lead, root (com opt-in)
Pedido cadastro	root

---

Fase B — Web Push PWA (quando implementado)

1. Desk → permitir notificações no browser
2. (Opcional) «Adicionar à tela inicial» no celular
3. Service Worker recebe push mesmo com aba em background

---

Já existe hoje (Spec 004)

• OTP ativação via ntfy (tópico temporário por pedido de cadastro)
• DESK_NTFY_BASE_URL=https://ntfy.sh
• api/app/ntfy_notify.py

Spec 007 estende isso para usuários logados e alertas operacionais.

---

Referência técnica (Kimi)

Caminho	Uso Ligbox
Web Push + SW	Fase B — Desk PWA
FCM	App nativo futuro
ntfy	Fase A — MVP
OneSignal	Alternativa managed — avaliar se necessário

---

Docs

• specs/007-mobile-push-notifications/spec.md
• specs/007-mobile-push-notifications/tasks.md