Diferenças

Aqui você vê as diferenças entre duas revisões dessa página.

Link para esta página de comparações

Ambos lados da revisão anterior Revisão anterior
pres:gerti:gestao_de_ativos:portal:er_008 [06/07/2026 21:33] pramorimpres:gerti:gestao_de_ativos:portal:er_008 [06/07/2026 21:50] (atual) pramorim
Linha 114: Linha 114:
 |Mensagem de erro|Texto|-|-|-|Exibido no estado //erro//. Texto: "Este link de cancelamento não é mais válido ou já foi utilizado. Acesse seu painel para gerenciar os acompanhamentos."| |Mensagem de erro|Texto|-|-|-|Exibido no estado //erro//. Texto: "Este link de cancelamento não é mais válido ou já foi utilizado. Acesse seu painel para gerenciar os acompanhamentos."|
 |Botão "Acessar painel de acompanhamentos"|Botão|-|-|-|Exibido no estado //erro//. Redireciona para ''/acompanhar-processo/gerenciar?token=...''.| |Botão "Acessar painel de acompanhamentos"|Botão|-|-|-|Exibido no estado //erro//. Redireciona para ''/acompanhar-processo/gerenciar?token=...''.|
 +
 +----
 +
 +===== E-mails Enviados =====
 +
 +Todos os e-mails seguem o padrão visual institucional do TCE-GO. Nenhuma ação dos e-mails depende de login — cada link carrega o token correspondente (RN02, RN09) e o ID de autuação do processo, quando aplicável.
 +
 +**Pendência — mecanismo de disparo:** o legado referenciava o host `smtp.tce.go.gov.br` como servidor de envio (`ServicoDeUsuarioPush.cs`). É necessário alinhar com a equipe de arquitetura qual é o mecanismo de disparo de e-mail em uso hoje (servidor SMTP atual, fila/serviço de mensageria, ou API de envio), para que o RF-008 siga o mesmo padrão adotado pelos demais serviços do portal. Enquanto essa definição não ocorre **esta seção documenta apenas o conteúdo e as ações de cada e-mail**, não o meio de envio.
 +
 +==== E-mail 01 – Confirmação de Inscrição ====
 +
 +Disparado ao final do Fluxo 01 (passo 07.1), sempre que uma inscrição em um processo aguarda confirmação — inclusive para e-mails que já confirmaram outros processos anteriormente (RN03).
 +
 +^Elemento^Conteúdo^Observação|
 +|Assunto|"Serviço de acompanhamento de processos TCE-GO — Confirme o acompanhamento do processo Nº {numero}"|O número do processo é usado apenas para exibição; a comunicação interna do link usa o ID de autuação.|
 +|Corpo|"Você solicitou o acompanhamento do processo Nº {numero} no Serviço de acompanhamento de processos TCE-GO. Clique no link abaixo para confirmar este acompanhamento."|Não há saudação por nome nem qualquer referência a cadastro/senha — o usuário não preenche esses dados (RN12).|
 +|Botão "Confirmar acompanhamento"|Redireciona para ''/acompanhar-processo/confirmar?token={token}''|Aciona o **Fluxo 02**. Token de confirmação, uso único, validade de 48h (RN02).|
 +|Rodapé|"Se você não solicitou este acompanhamento, ignore este e-mail."|Nenhum vínculo é criado até o clique de confirmação — mitigação de abuso (RN03).|
 +
 +==== E-mail 02 – Notificação de Movimentação ====
 +
 +Disparado pelo backend sempre que houver uma movimentação em um processo já confirmado (evento externo ao protótipo, originado de job/scheduler que monitora `PRO_AUTUACAO`).
 +
 +^Elemento^Conteúdo^Observação|
 +|Assunto|"Serviço de acompanhamento de processos TCE-GO — Movimentação no processo Nº {numero}"| |
 +|Corpo|Número do processo, descrição da movimentação e data|Dados somente para leitura; não há ação além dos links abaixo.|
 +|Link "Ver processo completo"|Redireciona para ''/processos/{id}''|Consulta pública do processo, sem necessidade de token.|
 +|Link "Gerenciar meus acompanhamentos"|Redireciona para ''/acompanhar-processo/gerenciar?token={token}''|Aciona o **Fluxo 03**. Token de gerenciamento, uso múltiplo dentro da validade (RN09).|
 +|Link "Parar de acompanhar este processo"|Redireciona para ''/acompanhar-processo/cancelar?token={token}&processo={id}''|Aciona o **Fluxo 04**. Remove apenas o processo referenciado neste link — não afeta os demais acompanhamentos do e-mail (RN07).|
 +
 +==== E-mail 03 – Reenvio de Link de Gerenciamento ====
 +
 +Disparado ao final do Fluxo 05, **somente** quando o e-mail informado possui acompanhamentos ativos na base — o backend nunca confirma nem nega essa condição na resposta exibida ao usuário (RN08). O envio (ou não) deste e-mail é a única diferença observável entre "e-mail existe" e "e-mail não existe".
 +
 +^Elemento^Conteúdo^Observação|
 +|Assunto|"Serviço de acompanhamento de processos TCE-GO — Seu link de gerenciamento"| |
 +|Corpo|Link de acesso ao painel de gerenciamento|O reenvio não invalida tokens de gerenciamento já emitidos e ainda válidos (RN09) — pode haver mais de um link de gerenciamento válido simultaneamente para o mesmo e-mail.|
 +|Link "Gerenciar meus acompanhamentos"|Redireciona para ''/acompanhar-processo/gerenciar?token={token}''|Aciona o **Fluxo 03**.|
  
 ---- ----
Linha 130: Linha 168:
 |06|O sistema transiciona o widget para o estado loading e processa a solicitação| |Tela 01| |06|O sistema transiciona o widget para o estado loading e processa a solicitação| |Tela 01|
 |07|O sistema valida que o e-mail não está inscrito neste processo|RN03 RN04| | |07|O sistema valida que o e-mail não está inscrito neste processo|RN03 RN04| |
-|07.1|O sistema envia e-mail de confirmação com token de validade de 48h. A confirmação é obrigatória para qualquer inscrição, independentemente de histórico anterior do e-mail|RN02 RN03|Tela 01|+|07.1|O sistema envia e-mail de confirmação com token de validade de 48h. A confirmação é obrigatória para qualquer inscrição, independentemente de histórico anterior do e-mail|RN02 RN03|E-mail 01|
 |07.2|O sistema exibe o estado confirmacao-pendente: "Verifique seu e-mail para confirmar"|RN02 RN03|Tela 01| |07.2|O sistema exibe o estado confirmacao-pendente: "Verifique seu e-mail para confirmar"|RN02 RN03|Tela 01|
 |08|O sistema identifica que o e-mail já está inscrito para este processo|RN04| | |08|O sistema identifica que o e-mail já está inscrito para este processo|RN04| |
Linha 140: Linha 178:
  
 ^Passo^Ação^Regra^Tela| ^Passo^Ação^Regra^Tela|
-|01|Usuário recebe e-mail de confirmação com o assunto "TCE-GO Push — Confirme o acompanhamento do processo Nº {numero_processo}"| | |+|01|Usuário recebe e-mail de confirmação com o assunto "Serviço de acompanhamento de processos TCE-GO — Confirme o acompanhamento do processo Nº {numero_processo}"| |E-mail 01|
 |02|Usuário clica no link "Confirmar acompanhamento" contido no e-mail| | | |02|Usuário clica no link "Confirmar acompanhamento" contido no e-mail| | |
 |03|O sistema redireciona para ''/acompanhar-processo/confirmar?token={token}''| |Tela 02| |03|O sistema redireciona para ''/acompanhar-processo/confirmar?token={token}''| |Tela 02|
Linha 155: Linha 193:
  
 ^Passo^Ação^Regra^Tela| ^Passo^Ação^Regra^Tela|
-|01|Usuário recebe e-mail de notificação de movimentação com link "Gerenciar meus acompanhamentos"| | |+|01|Usuário recebe e-mail de notificação de movimentação com link "Gerenciar meus acompanhamentos"| |E-mail 02|
 |02|Usuário clica no link| | | |02|Usuário clica no link| | |
 |03|O sistema redireciona para ''/acompanhar-processo/gerenciar?token={token}''| |Tela 03| |03|O sistema redireciona para ''/acompanhar-processo/gerenciar?token={token}''| |Tela 03|
Linha 175: Linha 213:
  
 ^Passo^Ação^Regra^Tela| ^Passo^Ação^Regra^Tela|
-|01|Usuário recebe e-mail de notificação com link "Parar de receber este acompanhamento"| | |+|01|Usuário recebe e-mail de notificação com link "Parar de receber este acompanhamento"| |E-mail 02|
 |02|Usuário clica no link| | | |02|Usuário clica no link| | |
 |03|O sistema redireciona para ''/acompanhar-processo/cancelar?token={token}&processo={id}''| |Tela 04| |03|O sistema redireciona para ''/acompanhar-processo/cancelar?token={token}&processo={id}''| |Tela 04|
Linha 192: Linha 230:
 |02|Usuário clica em "Receber novo link"| |Tela 03| |02|Usuário clica em "Receber novo link"| |Tela 03|
 |03|O sistema processa a solicitação|RN08| | |03|O sistema processa a solicitação|RN08| |
 +|03.1|Se o e-mail possuir acompanhamentos ativos, o sistema despacha o e-mail de reenvio com o link de gerenciamento (passo interno, não observável pelo usuário)|RN08 RN09|E-mail 03|
 |04|O sistema exibe a mensagem: "Se este endereço possui acompanhamentos ativos, você receberá o link de acesso em breve."|RN08|Tela 03| |04|O sistema exibe a mensagem: "Se este endereço possui acompanhamentos ativos, você receberá o link de acesso em breve."|RN08|Tela 03|
 |04.1|Nota: o sistema não confirma nem nega a existência do e-mail na base de dados, independentemente do resultado interno|RN08| | |04.1|Nota: o sistema não confirma nem nega a existência do e-mail na base de dados, independentemente do resultado interno|RN08| |
- 
----- 
- 
-===== Integrações ===== 
- 
-^ Sistema ^ Tipo ^ Descrição ^ 
-| Catálogo de Serviços TCE (api/push/*) | REST HTTP | Recebe as solicitações de inscrição, validação de token, gerenciamento e cancelamento | 
-| Banco de Dados Oracle | Interno | Armazena os vínculos entre e-mails e processos acompanhados | 
-| Servidor SMTP (smtp.tce.go.gov.br) | E-mail | Envia os e-mails de confirmação, notificação de movimentação e reenvio de link | 
  
 ---- ----
  • pres/gerti/gestao_de_ativos/portal/er_008.txt
  • Última modificação: 06/07/2026 21:50
  • por pramorim