Cadastro / Edição de Rotina de Notificação (Admin)
1. O que é
Tela Cadastro de Rotina ou Edição de Rotina. Define nome, vigência, tipo de frequência (e campos derivados), query, observação e canais EMAIL, SMS, PUSH, além de Execução avulsa e Ativo.
Origem: listagem de notificações → Nova Rotina / lápis.
2. Pré-requisitos
- Acesso ao módulo de rotina de notificação.
- Infraestrutura de envio configurada no ambiente.
- Licença válida.
3. Variantes / ações
| Ação | Efeito |
|---|---|
| Salvar | Persiste e volta à listagem |
| Voltar | Listagem |
| Tipo Frequência | Alterna campos exibidos |
Opções de frequência: Minuto, Hora, Dia, Mês (códigos MINUTO, HORA, DIA, MES).
4. Onde configurar
Caminho: Admin → Configurações → Rotinas de Notificação → Nova/Editar.
4.1 Identificação e frequência
| Campo | Uso |
|---|---|
| Rotina | Nome (obrigatório) |
| Dt. Início / Dt. Expiração | Vigência (data/hora) |
| Tipo Frequência | Minuto / Hora / Dia / Mês |
Campos condicionais:
| Frequência | Campos |
|---|---|
| Hora | Qtd. horas para repetição, Horário início, Horário fim |
| Dia | Qtd. dias para repetição, Dia no mês |
| Mês | Qtd. meses para repetição, Meses, Mês tipo, Mês tipo dia |
| Minuto | Qtd. minutos para repetição, Horário início, Horário fim |
4.2 Query e canais
| Campo / flag | Uso |
|---|---|
| Query | Critério de disparo |
| Observação | Texto livre |
| EMAIL (S/N) | Canal e-mail |
| SMS (S/N) | Canal SMS |
| PUSH (S/N) | Canal push |
| Execução avulsa (S/N) | Permite execução fora do ciclo |
| Ativo | Rotina habilitada |
5. Procedimentos relacionados
| Necessidade | Doc |
|---|---|
| Listagem | kpainel-admin-Notificacoes.md |
| Preferências do destinatário | kpainel-admin-CadastroEdicaoUsuarios.md |
6. Publicação / validação
- Salvar rotina ativa com ao menos um canal.
- Ajustar janela de horário/frequência.
- Testar em homologação (evitar spam em produção).
7. Checklist de sustentação
| Sintoma | Verificar |
|---|---|
| Não dispara | Ativo; vigência; frequência; query |
| Canal errado | Flags EMAIL/SMS/PUSH |
| Disparo fora da janela | Horário início/fim |
8. Fluxo resumido
- Nova/Editar rotina.
- Preencher frequência e query.
- Marcar canais → Salvar.
9. Pontos de atenção
- Não incluir senhas, tokens ou dados reais de pacientes na query versionada em documentação.
- Default de novo cadastro: frequência Minuto e Ativo.

