| Ambos lados da revisão anterior Revisão anterior Próxima revisão | Revisão anterior |
| pres:gerti:gestao_de_ativos:portal:er_008 [06/07/2026 19:58] – pramorim | pres:gerti:gestao_de_ativos:portal:er_008 [31/08/2026 20:24] (atual) – pramorim |
|---|
| ====== RF-008 – TCE-Push – Acompanhamento de Processos por E-mail ====== | ====== RF-008 – TCE-Push – Serviço de Acompanhamento de Processos por E-mail ====== |
| |
| Funcionalidade que permite a qualquer cidadão ou entidade receber notificações por e-mail sobre movimentações em processos autuados no Tribunal de Contas do Estado de Goiás, sem necessidade de cadastro com senha. O acesso ao serviço ocorre diretamente na página do processo, via widget inline, e o gerenciamento das inscrições é realizado por links presentes nos próprios e-mails recebidos. | Funcionalidade que permite a qualquer cidadão ou entidade receber notificações por e-mail sobre movimentações em processos autuados no Tribunal de Contas do Estado de Goiás, sem necessidade de cadastro com senha. O acesso ao serviço ocorre diretamente na página do processo, via widget inline, e o gerenciamento das inscrições é realizado por links presentes nos próprios e-mails recebidos. |
| |
| **Local de acesso:** | **Local de acesso:** |
| * Widget de inscrição: ''/processos/{id}'' (bloco abaixo do cabeçalho do processo) | * Widget de inscrição: ''/processo/{id}'' (bloco abaixo do cabeçalho do processo) |
| * Página de confirmação: ''/acompanhar-processo/confirmar?token={token}'' | * Página de confirmação: ''/acompanhar-processo/confirmar?token={token}'' |
| * Página de gerenciamento: ''/acompanhar-processo/gerenciar?token={token}'' | * Página de gerenciamento: ''/acompanhar-processo/gerenciar?token={token}'' |
| |
| ===== Telas ===== | ===== Telas ===== |
| | Bloco exibido inline na página do processo, logo abaixo do cabeçalho, permitindo ao usuário se inscrever para receber notificações por e-mail. O widget transita entre estados sem recarregar a página. |
| | |
| | ==== Tela 01 – Widget de Inscrição (/processo/{id}) ==== |
| |
| ==== Tela 01 – Widget de Inscrição (/processos/{id}) ==== | --- |
| //Estado idle//\\ | //Estado idle//\\ |
| |
| {{:pres:gerti:gestao_de_ativos:portal:pasted:20260706-190742.png}} | {{:pres:gerti:gestao_de_ativos:portal:pasted:20260706-190742.png}} |
| |
| | --- |
| // Estados formulario e loading//\\ | // Estados formulario e loading//\\ |
| {{:pres:gerti:gestao_de_ativos:portal:pasted:20260706-191118.png}} | {{:pres:gerti:gestao_de_ativos:portal:pasted:20260706-191118.png}} |
| |
| | --- |
| //Estado confirmacao-pendente//\\ | //Estado confirmacao-pendente//\\ |
| {{:pres:gerti:gestao_de_ativos:portal:pasted:20260706-195832.png}} | {{:pres:gerti:gestao_de_ativos:portal:pasted:20260706-195832.png}} |
| |
| | --- |
| //Estado inscrito//\\ | //Estado inscrito//\\ |
| {{:pres:gerti:gestao_de_ativos:portal:pasted:20260706-194215.png}} | {{:pres:gerti:gestao_de_ativos:portal:pasted:20260706-194215.png}} |
| |
| Bloco exibido inline na página do processo, logo abaixo do cabeçalho, permitindo ao usuário se inscrever para receber notificações por e-mail. O widget transita entre estados sem recarregar a página. | |
| |
| ^Elemento^Tipo^Obrigatório^Valores Possíveis^Valor Padrão^Observação| | ^Elemento^Tipo^Obrigatório^Valores Possíveis^Valor Padrão^Observação| |
| |Botão "Quero acompanhar"|Botão|-|-|-|Exibido no estado //idle//. Abre o formulário de e-mail ao ser clicado.| | |Botão "Quero acompanhar"|Botão|-|-|-|Exibido no estado //idle//. Abre o formulário de e-mail **na própria página**, sem diálogo sobreposto.| |
| |Cabeçalho do formulário|Texto|-|-|"Acompanhar processo nº {numero}"|Exibido nos estados //formulario// e //loading//. O número do processo é preenchido dinamicamente.| | |Cabeçalho do formulário|Texto|-|-|"Acompanhar processo nº {numero}"|Exibido nos estados //formulario// e //loading//. O número do processo é preenchido dinamicamente.| |
| |E-mail|Campo texto|Sim|Formato RFC 5322|Vazio|Exibido nos estados //formulario// e //loading//. Deve conter um endereço de e-mail válido (RN01). Exibe mensagem de erro inline "Informe um e-mail válido." quando inválido.| | |E-mail|Campo texto|Sim|Formato RFC 5322|Vazio|Exibido nos estados //formulario// e //loading//. Deve conter um endereço de e-mail válido (RN01). Exibe a mensagem "Informe um e-mail válido." abaixo do rótulo do campo quando o valor informado é inválido **ou** quando o campo não é preenchido.| |
| |Botão "Quero acompanhar" (submit)|Botão submit|-|-|-|Exibido no estado //formulario//. No estado //loading//, é substituído por spinner com texto "Enviando...". Desabilitado durante o processamento.| | |Botão "Quero acompanhar" (submit)|Botão submit|-|-|-|Exibido no estado //formulario//. No estado //loading//, é substituído por spinner com texto "Enviando...". Desabilitado durante o processamento.| |
| |Botão "Cancelar"|Botão|-|-|-|Exibido no estado //formulario//. Retorna o widget ao estado //idle// sem enviar a solicitação. Desabilitado durante o processamento.| | |Botão "Cancelar"|Botão|-|-|-|Exibido no estado //formulario//. Retorna o widget ao estado //idle// sem enviar a solicitação. Desabilitado durante o processamento.| |
| |
| Tela acessada pelo link presente no e-mail de confirmação. Valida o token recebido e exibe o resultado da operação. Não possui campos editáveis além do redirecionamento. | Tela acessada pelo link presente no e-mail de confirmação. Valida o token recebido e exibe o resultado da operação. Não possui campos editáveis além do redirecionamento. |
| | |
| | --- |
| | //Confirmação bem sucedida//\\ |
| | {{:pres:gerti:gestao_de_ativos:portal:pasted:20260706-195941.png}} |
| | |
| | --- |
| | //Link expirado//\\ |
| | {{:pres:gerti:gestao_de_ativos:portal:pasted:20260706-200100.png}} |
| |
| ^Elemento^Tipo^Obrigatório^Valores Possíveis^Valor Padrão^Observação| | ^Elemento^Tipo^Obrigatório^Valores Possíveis^Valor Padrão^Observação| |
| |Título "Inscrição confirmada!"|Texto|-|-|-|Exibido no estado //sucesso// após validação bem-sucedida do token (RN02).| | |Título "Inscrição confirmada!"|Texto|-|-|-|Exibido no estado //sucesso// após validação bem-sucedida do token (RN02).| |
| |Mensagem de confirmação|Texto|-|-|-|Exibido no estado //sucesso//. Texto: "Você receberá notificações por e-mail sempre que o processo nº {numero} for movimentado." O número do processo é extraído do token.| | |Mensagem de confirmação|Texto|-|-|-|Exibido no estado //sucesso//. Texto: "Você receberá notificações por e-mail sempre que o processo nº {numero} for movimentado." O número do processo é extraído do token.| |
| |Botão "Consultar processo"|Botão|-|-|-|Exibido no estado //sucesso//. Redireciona para ''/processos/{id}'' do processo recém-confirmado.| | |Botão "Consultar processo"|Botão|-|-|-|Exibido no estado //sucesso//. Redireciona para ''/processo/{id}'' do processo recém-confirmado.| |
| |Botão "Gerenciar meus acompanhamentos"|Botão|-|-|-|Exibido no estado //sucesso//. Redireciona para ''/acompanhar-processo/gerenciar?token=...''.| | |Botão "Gerenciar meus acompanhamentos"|Botão|-|-|-|Exibido no estado //sucesso//. Redireciona para ''/acompanhar-processo/gerenciar?token=...'', **reaproveitando o token recebido no link de confirmação** (RN02, RN09).| |
| |Lista "Seus processos acompanhados"|Lista de cards|-|-|-|Exibida no estado //sucesso//. Lista todos os processos vinculados ao e-mail confirmado, incluindo o recém-adicionado.| | |Lista "Seus processos acompanhados"|Lista de cards|-|-|-|Exibida no estado //sucesso//. Lista os **3 processos mais recentes** vinculados ao e-mail confirmado (ordenados pela data de inclusão do acompanhamento, do mais recente para o mais antigo), incluindo o processo recém-confirmado (RN13). Para ver a lista completa, o usuário acessa "Gerenciar meus acompanhamentos".| |
| |Título "Link inválido ou expirado"|Texto|-|-|-|Exibido no estado //erro// quando o token é inválido ou expirou após 48h (RN02).| | |Título "Link inválido ou expirado"|Texto|-|-|-|Exibido no estado //erro// quando o token é inválido ou expirou após 48h (RN02).| |
| |Mensagem de erro|Texto|-|-|-|Exibido no estado //erro//. Texto: "Este link de confirmação não é mais válido. Os links expiram em 48 horas após o envio. Retorne à página do processo e solicite um novo link."| | |Mensagem de erro|Texto|-|-|-|Exibido no estado //erro//. Texto: "Este link de confirmação não é mais válido. Os links expiram em 48 horas após o envio. Retorne à página do processo e solicite um novo link."| |
| |Indicador de carregamento|Spinner|-|-|-|Exibido no estado //loading// enquanto o token é validado e a lista é carregada. Acompanha o texto "Carregando seus acompanhamentos…".| | |Indicador de carregamento|Spinner|-|-|-|Exibido no estado //loading// enquanto o token é validado e a lista é carregada. Acompanha o texto "Carregando seus acompanhamentos…".| |
| |Identificação do e-mail|Texto|-|-|-|Exibido no estado //lista//. Texto: "Processos acompanhados pelo e-mail: {email mascarado}". O e-mail é parcialmente ocultado pelo servidor.| | |Identificação do e-mail|Texto|-|-|-|Exibido no estado //lista//. Texto: "Processos acompanhados pelo e-mail: {email mascarado}". O e-mail é parcialmente ocultado pelo servidor.| |
| |Card de processo|Card|-|-|-|Exibido no estado //lista// para cada processo acompanhado. Contém: número do processo (link clicável para ''/processos/{id}''), interessado, assunto e ano.| | |Card de processo|Card|-|-|-|Exibido no estado //lista// para cada processo acompanhado. Contém: número do processo (link clicável para ''/processo/{id}''), interessado, assunto e ano.| |
| |Botão "Parar de acompanhar"|Botão|-|-|-|Exibido em cada card no estado //lista//. Abre a confirmação inline no próprio card (RN11).| | |Botão "Parar de acompanhar"|Botão|-|-|-|Exibido em cada card no estado //lista//. Abre a confirmação inline no próprio card (RN11).| |
| |Confirmação inline de remoção|Expansão inline|-|-|Recolhido|Exibida no card após clique em "Parar de acompanhar". Exibe o alerta "Deseja parar de acompanhar este processo?" com os botões "Confirmar" e "Cancelar" (RN11).| | |Confirmação inline de remoção|Expansão inline|-|-|Recolhido|Exibida no card após clique em "Parar de acompanhar". Exibe o alerta "Deseja parar de acompanhar este processo?" com os botões "Confirmar" e "Cancelar" (RN11).| |
| |Botão "Cancelar" (remoção)|Botão|-|-|-|Fecha a confirmação inline sem executar nenhuma ação (RN11).| | |Botão "Cancelar" (remoção)|Botão|-|-|-|Fecha a confirmação inline sem executar nenhuma ação (RN11).| |
| |Mensagem de lista vazia|Texto|-|-|-|Exibida quando todos os processos são removidos ou quando o e-mail não possui acompanhamentos ativos. Texto: "Você não está acompanhando nenhum processo no momento." Acompanha link "Consultar processos no portal" → ''/processos''.| | |Mensagem de lista vazia|Texto|-|-|-|Exibida quando todos os processos são removidos ou quando o e-mail não possui acompanhamentos ativos. Texto: "Você não está acompanhando nenhum processo no momento." Acompanha link "Consultar processos no portal" → ''/processos''.| |
| | |Paginação|Componente de paginação|-|-|-|Exibida no estado //lista// somente quando a quantidade de processos acompanhados ultrapassa **12 itens**. Reaproveita o componente ''Pagination'' já usado em ''/processos'' (mesmo padrão visual). Necessária porque não há limite máximo de processos por e-mail (RN10, RN14).| |
| |Título "Link expirado"|Texto|-|-|-|Exibido no estado //token-expirado// quando o token é inválido (RN02).| | |Título "Link expirado"|Texto|-|-|-|Exibido no estado //token-expirado// quando o token é inválido (RN02).| |
| |E-mail (reenvio de link)|Campo texto|Sim|Formato RFC 5322|Vazio|Exibido no estado //token-expirado//. Utilizado para solicitar novo link de gerenciamento (RN08).| | |E-mail (reenvio de link)|Campo texto|Sim|Formato RFC 5322|Vazio|Exibido no estado //token-expirado//. Utilizado para solicitar novo link de gerenciamento (RN08).| |
| |
| Tela acessada pelo link "Parar de receber este acompanhamento" presente nos e-mails de notificação. Executa o cancelamento imediato do processo referenciado no token e exibe o resultado da operação. Não possui campos editáveis. | Tela acessada pelo link "Parar de receber este acompanhamento" presente nos e-mails de notificação. Executa o cancelamento imediato do processo referenciado no token e exibe o resultado da operação. Não possui campos editáveis. |
| | |
| | --- |
| | //Cancelamnto bem sucedido//\\ |
| | {{:pres:gerti:gestao_de_ativos:portal:pasted:20260706-205654.png}} |
| | |
| | --- |
| | //Link expirado ou já utilizado//\\ |
| | {{:pres:gerti:gestao_de_ativos:portal:pasted:20260706-205738.png}} |
| |
| ^Elemento^Tipo^Obrigatório^Valores Possíveis^Valor Padrão^Observação| | ^Elemento^Tipo^Obrigatório^Valores Possíveis^Valor Padrão^Observação| |
| |Título "Acompanhamento cancelado"|Texto|-|-|-|Exibido no estado //sucesso// após remoção bem-sucedida (RN06).| | |Título "Acompanhamento cancelado"|Texto|-|-|-|Exibido no estado //sucesso// após remoção bem-sucedida (RN06).| |
| |Mensagem de cancelamento|Texto|-|-|-|Exibido no estado //sucesso//. Texto: "Você não receberá mais notificações sobre o processo nº {numero}." O número do processo é extraído do token.| | |Mensagem de cancelamento|Texto|-|-|-|Exibido no estado //sucesso//. Texto: "Você não receberá mais notificações sobre o processo nº {numero}." O número do processo é extraído do token.| |
| |Botão "Ver todos os meus acompanhamentos"|Botão|-|-|-|Exibido no estado //sucesso//. Redireciona para ''/acompanhar-processo/gerenciar?token=...'' (RN07).| | |Botão "Ver todos os meus acompanhamentos"|Botão|-|-|-|Exibido no estado //sucesso//. Redireciona para ''/acompanhar-processo/gerenciar?token=...'', **reaproveitando o token recebido no link de cancelamento** (RN02, RN07, RN09).| |
| |Botão "Consultar processos"|Botão|-|-|-|Exibido no estado //sucesso//. Redireciona para ''/processos''.| | |Botão "Consultar processos"|Botão|-|-|-|Exibido no estado //sucesso//. Redireciona para ''/processos''.| |
| |Título "Link inválido"|Texto|-|-|-|Exibido no estado //erro// quando o token é inválido ou já foi utilizado.| | |Título "Link inválido"|Texto|-|-|-|Exibido no estado //erro// quando o token é inválido ou já foi utilizado.| |
| |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, são remetidos pelo endereço **`push@tce.go.gov.br`** e despachados pelo servidor **`smtp.tce.go.gov.br`**, reaproveitando a camada de serviço compartilhada `IServicoDeEmail`/`ServicoDeEmail` (`TCE.Compartilhado.Servico.Servicos.Contato`), a mesma já utilizada por `ServicoDeUsuarioPush` no legado. O RF-008 não deve implementar um novo mecanismo de envio — apenas montar `DtoEmail` (remetente, destinatário, assunto, corpo HTML) e chamar essa camada compartilhada, como já ocorre em `ServicoDeUsuarioPush.EnviaEmail`. 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. |
| | |
| | ==== E-mail 01 – Confirmação de Inscrição ==== |
| | {{:pres:gerti:gestao_de_ativos:portal:confirme_-_tce_go_push.png?direct&600|}} \\ |
| | |
| | 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| |
| | |Remetente|`push@tce.go.gov.br`|Endereço institucional único para os três e-mails do RF-008.| |
| | |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 único do serviço, validade de 48h, reaproveitável nos demais fluxos (RN02, RN09).| |
| | |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 ==== |
| | {{:pres:gerti:gestao_de_ativos:portal:movimentacao_-_tce_go_push-_localhost_.png?direct&600|}} \\ |
| | |
| | Disparado sempre que houver uma movimentação em um processo já confirmado. **O disparo é executado por outro serviço interno do TCE-GO**, externo ao escopo do RF-008 e ao protótipo: o RF-008 define o conteúdo e os links da mensagem, não a regra que decide quando enviá-la. |
| | |
| | ^Elemento^Conteúdo^Observação| |
| | |Remetente|`push@tce.go.gov.br`|Endereço institucional único para os três e-mails do RF-008.| |
| | |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 ''/processo/{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 único do serviço, uso múltiplo dentro das 48h de validade (RN02, 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 ==== |
| | {{:pres:gerti:gestao_de_ativos:portal:gerenciar_-_tce_go_push-_localhost_.png?direct&600|}}\\ |
| | |
| | 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| |
| | |Remetente|`push@tce.go.gov.br`|Endereço institucional único para os três e-mails do RF-008.| |
| | |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**.| |
| |
| ---- | ---- |
| |
| ^Passo^Ação^Regra^Tela| | ^Passo^Ação^Regra^Tela| |
| |01|Usuário acessa a página de um processo autuado em ''/processos/{id}''| |Tela 01| | |01|Usuário acessa a página de um processo autuado em ''/processo/{id}''| |Tela 01| |
| |02|O sistema exibe o widget TCE-Push no estado idle com o botão "Quero acompanhar"| |Tela 01| | |02|O sistema exibe o widget TCE-Push no estado idle com o botão "Quero acompanhar"| |Tela 01| |
| |03|Usuário clica em "Quero acompanhar"| |Tela 01| | |03|Usuário clica em "Quero acompanhar"| |Tela 01| |
| |04|O sistema exibe o formulário com o campo "Seu e-mail" e o cabeçalho "Acompanhar processo nº {numero}"| |Tela 01| | |04|O sistema exibe o formulário com o campo "Seu e-mail" e o cabeçalho "Acompanhar processo nº {numero}"| |Tela 01| |
| |05|Usuário informa o e-mail e clica em "Quero acompanhar"|RN01|Tela 01| | |05|Usuário informa o e-mail e clica em "Quero acompanhar"|RN01|Tela 01| |
| |05.1|E-mail inválido: o sistema exibe mensagem de erro inline "Informe um e-mail válido." e aguarda nova entrada|RN01|Tela 01| | |05.1|E-mail inválido ou não preenchido: o sistema exibe a mensagem "Informe um e-mail válido." abaixo do rótulo do campo e aguarda nova entrada|RN01|Tela 01| |
| |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 o 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| | |
| |08.1|O sistema exibe o estado inscrito: "Você já está acompanhando este processo" com o e-mail informado|RN04|Tela 01| | |08.1|O sistema exibe o estado inscrito: "Você já está acompanhando este processo" com o e-mail informado|RN04|Tela 01| |
| |10|O sistema identifica que o número do processo não existe|RN05| | | |09|O sistema identifica que o número do processo não existe|RN05| | |
| |10.1|O sistema exibe o estado erro com a mensagem retornada pelo servidor|RN05|Tela 01| | |09.1|O sistema exibe o estado erro com a mensagem retornada pelo servidor|RN05|Tela 01| |
| |
| ==== Fluxo 02 – Confirmação de Inscrição ==== | ==== Fluxo 02 – Confirmação de Inscrição ==== |
| |
| ^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 o 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| |
| |05.1|O sistema vincula o processo ao e-mail|RN02| | | |05.1|O sistema vincula o processo ao e-mail|RN02| | |
| |05.2|O sistema exibe o estado sucesso: "Inscrição confirmada!" com o número do processo|RN02|Tela 02| | |05.2|O sistema exibe o estado sucesso: "Inscrição confirmada!" com o número do processo|RN02|Tela 02| |
| |05.3|O sistema exibe a lista de todos os processos acompanhados pelo e-mail| |Tela 02| | |05.3|O sistema exibe os 3 processos mais recentes acompanhados pelo e-mail|RN13|Tela 02| |
| |06|Token inválido ou expirado|RN02| | | |06|Token inválido ou expirado|RN02| | |
| |06.1|O sistema exibe o estado erro: "Link inválido ou expirado" com botão "Tentar novamente"|RN02|Tela 02| | |06.1|O sistema exibe o estado erro: "Link inválido ou expirado" com botão "Tentar novamente"|RN02|Tela 02| |
| |
| ^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 o 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| |
| |04|O sistema exibe o estado loading: "Carregando seus acompanhamentos…" e valida o token|RN09|Tela 03| | |04|O sistema exibe o estado loading: "Carregando seus acompanhamentos…" e valida o token|RN09|Tela 03| |
| |05|Token válido|RN09| | | |05|Token válido|RN09| | |
| |05.1|O sistema exibe a lista de todos os processos acompanhados pelo e-mail associado ao token, com o e-mail mascarado|RN09|Tela 03| | |05.1|O sistema exibe a primeira página da lista de processos acompanhados pelo e-mail associado ao token, com o e-mail mascarado|RN09|Tela 03| |
| |05.2|Lista vazia: o sistema exibe o empty state "Você não está acompanhando nenhum processo no momento."| |Tela 03| | |05.2|Lista vazia: o sistema exibe o empty state "Você não está acompanhando nenhum processo no momento."| |Tela 03| |
| | |05.3|Lista com mais de 12 processos: o sistema exibe o componente de paginação; usuário navega entre páginas sem recarregar a tela|RN14|Tela 03| |
| |06|Usuário clica em "Parar de acompanhar" em um processo|RN11| | | |06|Usuário clica em "Parar de acompanhar" em um processo|RN11| | |
| |06.1|O sistema exibe, inline no card, o alerta "Deseja parar de acompanhar este processo?" com os botões "Confirmar" e "Cancelar"|RN11|Tela 03| | |06.1|O sistema exibe, inline no card, o alerta "Deseja parar de acompanhar este processo?" com os botões "Confirmar" e "Cancelar"|RN11|Tela 03| |
| |
| ^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 o 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| |
| |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 | | |
| |
| ---- | ---- |
| ^ Regra ^ Descrição ^ | ^ Regra ^ Descrição ^ |
| |RN01|**Validação de formato de e-mail** – O e-mail informado deve ser válido conforme o formato RFC 5322. E-mails inválidos bloqueiam o envio do formulário com mensagem de erro inline.| | |RN01|**Validação de formato de e-mail** – O e-mail informado deve ser válido conforme o formato RFC 5322. E-mails inválidos bloqueiam o envio do formulário com mensagem de erro inline.| |
| |RN02|**Expiração de token** – O token de confirmação de inscrição expira em 48 horas a partir do envio. Após a expiração, o sistema exibe a mensagem de link inválido e o usuário deve solicitar novo acompanhamento.| | |RN02|**Token único do serviço, com validade de 48 horas** – O TCE-Push emite um único tipo de token, válido por 48 horas a partir do envio, utilizável nos fluxos de confirmação, gerenciamento e cancelamento. O token recebido em um e-mail é **reaproveitado** nos links das telas seguintes — não é emitido token novo a cada etapa. Após as 48 horas, o sistema exibe a mensagem de link inválido e o usuário deve solicitar novo link.| |
| |RN03|**Confirmação obrigatória por inscrição (controle de abuso)** – Toda inscrição em um processo requer confirmação explícita por e-mail, independentemente de o endereço ter sido confirmado em processos anteriores. Como o serviço não possui autenticação, a confirmação por link é o único mecanismo que garante que apenas o titular do endereço pode ativar um vínculo processo/e-mail. Sem essa exigência, qualquer usuário poderia inscrever endereços de terceiros em processos arbitrários sem o consentimento do titular.| | |RN03|**Confirmação obrigatória por inscrição (controle de abuso)** – Toda inscrição em um processo requer confirmação explícita por e-mail, independentemente de o endereço ter sido confirmado em processos anteriores. Como o serviço não possui autenticação, a confirmação por link é o único mecanismo que garante que apenas o titular do endereço pode ativar um vínculo processo/e-mail. Sem essa exigência, qualquer usuário poderia inscrever endereços de terceiros em processos arbitrários sem o consentimento do titular.| |
| |RN04|**Vedação de inscrição duplicada** – O mesmo e-mail não pode ser inscrito duas vezes no mesmo processo. O sistema retorna a resposta JA_INSCRITO e exibe a mensagem: "Você já está acompanhando este processo".| | |RN04|**Vedação de inscrição duplicada** – O mesmo e-mail não pode ser inscrito duas vezes no mesmo processo. O sistema retorna a resposta JA_INSCRITO e exibe a mensagem: "Você já está acompanhando este processo".| |
| |RN07|**Escopo do cancelamento por link** – O link "Parar de receber este acompanhamento" presente nos e-mails remove apenas o processo referenciado naquele link. O link "Gerenciar meus acompanhamentos" dá acesso à lista completa.| | |RN07|**Escopo do cancelamento por link** – O link "Parar de receber este acompanhamento" presente nos e-mails remove apenas o processo referenciado naquele link. O link "Gerenciar meus acompanhamentos" dá acesso à lista completa.| |
| |RN08|**Resposta neutra no reenvio de link** – Ao solicitar reenvio do link de gerenciamento, o sistema sempre retorna a mensagem: "Se este endereço possui acompanhamentos ativos, você receberá o link de acesso em breve.", independentemente de o e-mail existir ou não na base de dados.| | |RN08|**Resposta neutra no reenvio de link** – Ao solicitar reenvio do link de gerenciamento, o sistema sempre retorna a mensagem: "Se este endereço possui acompanhamentos ativos, você receberá o link de acesso em breve.", independentemente de o e-mail existir ou não na base de dados.| |
| |RN09|**Token de gerenciamento de uso múltiplo** – O token enviado no link de gerenciamento pode ser utilizado múltiplas vezes enquanto estiver dentro do prazo de validade, ao contrário do token de confirmação de inscrição.| | |RN09|**Uso múltiplo dentro da validade** – O token pode ser utilizado múltiplas vezes, em qualquer dos fluxos, enquanto estiver dentro das 48 horas de validade (RN02). O reenvio do link de gerenciamento não invalida os tokens já emitidos e ainda válidos.| |
| |RN10|**Sem limite de processos por e-mail** – Não há limite máximo de processos que podem ser associados a um único e-mail.| | |RN10|**Sem limite de processos por e-mail** – Não há limite máximo de processos que podem ser associados a um único e-mail.| |
| |RN11|**Confirmação antes de remover na tela de gerenciamento** – Na página de gerenciamento, ao clicar em "Parar de acompanhar", o sistema exibe uma confirmação inline no card do processo com os botões "Confirmar" e "Cancelar". A remoção só é executada após o usuário clicar em "Confirmar".| | |RN11|**Confirmação antes de remover na tela de gerenciamento** – Na página de gerenciamento, ao clicar em "Parar de acompanhar", o sistema exibe uma confirmação inline no card do processo com os botões "Confirmar" e "Cancelar". A remoção só é executada após o usuário clicar em "Confirmar".| |
| |RN12|**Cadastro implícito de usuário (sem tela de cadastro)** – Não existe formulário de nome/senha para o usuário. Internamente, porém, o backend deve localizar ou criar um registro de usuário Push a partir do e-mail informado (reaproveitando a estrutura de dados existente do legado), preenchendo os campos obrigatórios do legado (nome e senha) com valores técnicos não expostos ao usuário. Essa criação/localização de registro é transparente e não pode alterar nome, senha ou o estado "Habilitado" de um cadastro que já exista para aquele e-mail (ver [[#reaproveitamento_de_estruturas_do_legado|Reaproveitamento de Estruturas do Legado]]).| | |RN12|**Cadastro implícito de usuário (sem tela de cadastro)** – Não existe formulário de nome/senha para o usuário. Internamente, porém, o backend deve localizar ou criar um registro de usuário Push a partir do e-mail informado (reaproveitando a estrutura de dados existente do legado), preenchendo os campos obrigatórios do legado (nome e senha) com valores técnicos não expostos ao usuário. Essa criação/localização de registro é transparente e não pode alterar nome, senha ou o estado "Habilitado" de um cadastro que já exista para aquele e-mail (ver [[#reaproveitamento_de_estruturas_do_legado|Reaproveitamento de Estruturas do Legado]]).| |
| | |RN13|**Lista resumida na tela de confirmação** – Na tela de confirmação de inscrição (Tela 02), a lista "Seus processos acompanhados" exibe apenas os **3 processos mais recentes** vinculados ao e-mail, ordenados pela data de inclusão do acompanhamento (mais recente primeiro), incluindo o processo recém-confirmado. Não há paginação nesta tela — para consultar a lista completa, o usuário deve acessar "Gerenciar meus acompanhamentos" (Tela 03).| |
| | |RN14|**Paginação na tela de gerenciamento** – Como não há limite máximo de processos por e-mail (RN10), a lista de acompanhamentos da Tela 03 é paginada em **12 processos por página**, exibindo o componente de paginação somente quando esse total é ultrapassado. O tamanho da página é **fixo** — não há seletor de itens por página. Reaproveita o componente ''Pagination'' já utilizado em ''/processos'' (mesmo padrão visual e de navegação).| |
| | |RN15|**Conformidade de acessibilidade** – Todas as telas do RF-008 seguem a diretriz **e-MAG 3.1** adotada pelo Portal. São verificáveis, em cada tela: nome acessível dos controles e dos campos, contraste mínimo do texto e dos elementos de interface, e aumento de fonte/zoom até 200% sem perda de conteúdo ou de função.| |
| |
| ---- | ---- |
| |`WEB_PACKAGE.PWEB_REMOVEACOMPPROCESSO`|ID interno da autuação (`P_PROAUTU`), ID do usuário Push (`P_PSHUSUA`)|`"0"` sucesso|**Já alinhada ao padrão do RF-008** — recebe o ID de autuação diretamente, sem necessidade de conversão.| | |`WEB_PACKAGE.PWEB_REMOVEACOMPPROCESSO`|ID interno da autuação (`P_PROAUTU`), ID do usuário Push (`P_PSHUSUA`)|`"0"` sucesso|**Já alinhada ao padrão do RF-008** — recebe o ID de autuação diretamente, sem necessidade de conversão.| |
| |
| ==== Endpoints da API Legada (`api/push/*`) ==== | ==== Endpoints da API do Catálogo (`api/push/*`) ==== |
| |
| ^ Endpoint legado ^ Reaproveitamento no RF-008 ^ | ^ Endpoint legado ^ Reaproveitamento no RF-008 ^ |
| |`POST api/push/login`|**Descontinuado.** Dependia de senha; o novo modelo não tem login.| | |`POST api/push/login`|**Descontinuado.** Dependia de senha; o novo modelo não tem login.| |
| |`POST api/push/email` (cadastro)|**Substituído** pelo cadastro implícito descrito acima — o novo `POST /api/push/inscrever` (PRD §7) deve criar o registro em `PSH_USUARIOS` internamente, sem expor os campos `Nome`/`Senha` ao cliente.| | |`POST api/push/email` (cadastro)|**Substituído** pelo cadastro implícito descrito acima — o novo `POST /api/push/inscrever` (PRD §7) deve criar o registro em `PSH_USUARIOS` internamente, sem expor os campos `Nome`/`Senha` ao cliente.| |
| |`GET api/push/verifica/{numeroProcesso}`|**Reaproveitável como base, com correção de parâmetro:** no RF-008 o parâmetro deve ser `idAutuacao`, não o número público — a página do processo (`/processos/{id}`) já tem o ID de autuação em contexto, o usuário não precisa informá-lo.| | |`GET api/push/verifica/{numeroProcesso}`|**Reaproveitável como base, com correção de parâmetro:** no RF-008 o parâmetro deve ser `idAutuacao`, não o número público — a página do processo (`/processo/{id}`) já tem o ID de autuação em contexto, o usuário não precisa informá-lo.| |
| |`PUT api/push/adiciona/processos`|**Reaproveitável como base, com a mesma correção:** a lista recebida deve conter IDs de autuação, não números de processo, antes de repassar para `WEB_PACKAGE.PWEB_ACOMPANHAPROCESSO` (que exigirá a conversão pontual citada acima).| | |`PUT api/push/adiciona/processos`|**Reaproveitável como base, com a mesma correção:** a lista recebida deve conter IDs de autuação, não números de processo, antes de repassar para `WEB_PACKAGE.PWEB_ACOMPANHAPROCESSO` (que exigirá a conversão pontual citada acima).| |
| |`DELETE api/push/remove/{numeroProcesso}`|**Reaproveitável como base:** apesar do nome do parâmetro na rota legada, o valor é repassado como ID interno para `RemoveAcompanhamentoDeProcesso`. No RF-008 o parâmetro deve se chamar explicitamente `idAutuacao`, para não sugerir que aceita o número público.| | |`DELETE api/push/remove/{numeroProcesso}`|**Reaproveitável como base:** apesar do nome do parâmetro na rota legada, o valor é repassado como ID interno para `RemoveAcompanhamentoDeProcesso`. No RF-008 o parâmetro deve se chamar explicitamente `idAutuacao`, para não sugerir que aceita o número público.| |
| |`GET api/push/processos`|**Reaproveitável** como base para `GET /api/push/gerenciar`.| | |`GET api/push/processos`|**Reaproveitável** como base para `GET /api/push/gerenciar`.| |
| |Autenticação `BasicAuthorizationPush` (header `Authorization: Basic {id}@{tokenCriptografado}`, sem expiração — risco S4 do relatório técnico)|**Não reaproveitada.** O RF-008 exige token de e-mail com expiração (RN02) e sem exigência de login prévio; é necessário um mecanismo novo de emissão/validação de token (ex.: JWT com `exp`, conforme recomendação 8.1.3 do relatório técnico), possivelmente reaproveitando o modelo de token já usado pelo componente de Newsletter (`TCE.Newsletters.*`), citado como referência na seção 9 do PRD.| | |Autenticação `BasicAuthorizationPush` (header `Authorization: Basic {id}@{tokenCriptografado}`, sem expiração — risco S4 do relatório técnico)|**Não reaproveitada.** O RF-008 exige token de e-mail com expiração (RN02) e sem exigência de login prévio; é necessário um mecanismo novo de emissão/validação de token (ex.: JWT com `exp`).| |
| | |
| | ==== Serviço de Envio de E-mail Reaproveitado ==== |
| | |
| | ^ Componente ^ Papel no legado ^ Reaproveitamento no RF-008 ^ |
| | |`IServicoDeEmail` / `ServicoDeEmail` (`TCE.Compartilhado.Servico.Servicos.Contato`)|Camada compartilhada de envio, usada por `ServicoDeUsuarioPush`, `ServicoDeFaleConosco`, `ServicoDeOuvidoriaEletronica` e outros serviços do Compartilhado|**Reaproveitada integralmente.** O RF-008 deve montar um `DtoEmail` (remetente `push@tce.go.gov.br`, destinatário, assunto, corpo HTML) e um `DtoConfiguracaoEmail { HostName = "smtp.tce.go.gov.br" }` e chamar `IServicoDeEmail.EnviaEmail(...)` — exatamente como já faz `ServicoDeUsuarioPush.EnviaEmail` para os e-mails de cadastro/alteração/lembrete de senha do Push legado. Não é necessário criar um novo mecanismo de disparo.| |
| | |`smtp.tce.go.gov.br`|Host SMTP institucional, configurado via `SmtpClient` do .NET (`ServicoDeEmail.EnviaEmail`)|**Confirmado como servidor a ser utilizado.** Os três e-mails do RF-008 (seção "E-mails Enviados") devem ser despachados por este host, seguindo o mesmo padrão do restante do portal.| |
| | |`push@tce.go.gov.br`|—|**Endereço de remetente institucional definido para o RF-008.** Utilizado no campo `From` do `DtoEmail` para os três e-mails (Confirmação, Notificação, Reenvio).| |
| |
| ==== Riscos e Pontos de Atenção para o Backend ==== | ==== Riscos e Pontos de Atenção para o Backend ==== |
| * **ID de Autuação como identificador único do processo:** todo o contrato do RF-008 (requisições da API, tokens de confirmação/gerenciamento/cancelamento, parâmetros de rota) deve referenciar o processo pelo ID de autuação. O número público do processo é apenas informação de exibição nas telas e nos e-mails. A única exceção no legado é `WEB_PACKAGE.PWEB_ACOMPANHAPROCESSO`, que exige o número público — tratar como conversão isolada no ponto de integração, sem propagar o número para o restante do fluxo (ver tabela de rotinas acima). | * **ID de Autuação como identificador único do processo:** todo o contrato do RF-008 (requisições da API, tokens de confirmação/gerenciamento/cancelamento, parâmetros de rota) deve referenciar o processo pelo ID de autuação. O número público do processo é apenas informação de exibição nas telas e nos e-mails. A única exceção no legado é `WEB_PACKAGE.PWEB_ACOMPANHAPROCESSO`, que exige o número público — tratar como conversão isolada no ponto de integração, sem propagar o número para o restante do fluxo (ver tabela de rotinas acima). |
| * **Nenhuma estrutura de token existente é reaproveitável tal como está:** o legado não possui tabela/mecanismo de token com expiração para os links de confirmação/gerenciamento/cancelamento; isso é **desenvolvimento novo**, não reaproveitamento. | * **Nenhuma estrutura de token existente é reaproveitável tal como está:** o legado não possui tabela/mecanismo de token com expiração para os links de confirmação/gerenciamento/cancelamento; isso é **desenvolvimento novo**, não reaproveitamento. |
| | |
| | ---- |
| | |
| | ===== Histórico de Revisões ===== |
| | |
| | ^ Data ^ Alteração ^ Motivo ^ |
| | |2026-08-31|Tela 01 e Fluxo 01 passo 05.1 — a mensagem "Informe um e-mail válido." passou a cobrir também o campo não preenchido, exibida abaixo do rótulo|Decisão de Requisitos; o comportamento do campo obrigatório não estava especificado (PD-02)| |
| | |2026-08-31|Fluxo 01 — passos 10 e 10.1 renumerados para 09 e 09.1|Lacuna de numeração corrigida a pedido de Requisitos (PD-13)| |
| | |2026-08-31|RN02 reescrita — token **único** do serviço, validade de 48h, reaproveitável nos fluxos de confirmação, gerenciamento e cancelamento|Decisão de Requisitos: não se emite token novo a cada etapa (PD-04, PD-09)| |
| | |2026-08-31|RN09 reescrita — uso múltiplo em qualquer fluxo dentro das 48h|Alinhamento à RN02 (PD-04, PD-09)| |
| | |2026-08-31|Telas 02 e 04 — botões de acesso ao painel passaram a declarar o reaproveitamento do token recebido|O conflito apontado na análise de estratégia de tokens deixou de existir com a decisão da RN02 (PD-04)| |
| | |2026-08-31|RN14 — registrado que o tamanho da página é fixo, sem seletor de itens|Decisão de Requisitos (PD-15)| |
| | |2026-08-31|**RN15 acrescentada** — conformidade de acessibilidade e-MAG 3.1|O RF não declarava requisito de acessibilidade, embora o escopo de teste o exija (PD-12)| |
| | |2026-08-31|E-mail 02 — o disparo passou a ser atribuído a outro serviço interno do TCE-GO|Decisão de Requisitos: a regra que decide quando enviar está fora do escopo do RF-008 (PD-16)| |
| | |2026-08-31|Rota do detalhe do processo padronizada como ''/processo/{id}''|Decisão de Requisitos: é a rota já desenvolvida na funcionalidade anterior (PD-11)| |
| | |2026-08-31|Tela 01 — o botão "Quero acompanhar" passou a declarar que o formulário abre na própria página, sem diálogo sobreposto|Decisão de Requisitos; o CA02 do PRD deixava a apresentação entre modal e expansão inline (PD-18)| |
| |
| --- | --- |