Guia de implantação

Antes da ativação

1. Definir com a TI onde o formulário e o banco serão hospedados e quem administrará o domínio. Nesta hospedagem, o banco é Cloudflare D1 e o painel usa login com o ChatGPT.
2. Validar com o PSTU o aviso de privacidade, a localização do banco, os prestadores envolvidos, o canal de atendimento e o prazo de guarda. Definir quem pode consultar, imprimir e exportar fichas e quem atende pedidos de correção e exclusão.
3. Verificar no Resend um domínio ou subdomínio administrado pelo PSTU. Criar uma chave com permissão de envio restrita a esse domínio.

Configuração nesta hospedagem

DB

Banco D1 com as migrações do formulário e do painel aplicadas.

RESEND_API_KEY e EMAIL_FROM

Chave secreta de envio e remetente do domínio verificado.

DATA_ENCRYPTION_KEY

Chave aleatória com pelo menos 32 caracteres, guardada como segredo no servidor e no cofre institucional. Guarde a mesma chave junto ao plano de recuperação. A troca direta impede a leitura das fichas antigas.

ADMIN_EMAILS

E-mails das contas administrativas autorizadas, separados por vírgula. Confirme o acesso de cada operador antes de divulgar o formulário.

PRIVACY_EMAIL e PRIVACY_RETENTION

Canal oficial de privacidade e texto aprovado sobre guarda de dados, exibidos no aviso.

COLLECTION_ENABLED

Sem essa variável, o formulário fica em demonstração. O valor false pausa novos envios. O valor true libera o formulário somente com a configuração completa. Publique a revisão após atualizar os parâmetros.

Teste antes de divulgar

Em um ambiente de homologação restrito, com banco separado, use fichas fictícias e um endereço de e-mail da equipe. Confirme a chegada do código, o protocolo e a consulta no painel. Imprima a ficha e confira o registro da confirmação no rodapé. Teste os filtros, a exportação, a aprovação e a marcação de registro no FILIA. Verifique que uma conta fora da lista não acessa os registros e teste a restauração de uma cópia do banco com a chave correspondente.

Operação do painel

A equipe autorizada acessa a área administrativa para revisar os pedidos, imprimir fichas e gerar relatórios. Após a aprovação, a ficha aparece na fila Aguardando FILIA. Depois de lançar o pedido manualmente no sistema do TSE, marque a ficha como registrada no painel.

O formulário é criptografado no servidor. O Resend recebe o e-mail e o código de confirmação. Pedidos não confirmados são elegíveis para limpeza após 24 horas, executada quando a API volta a ser utilizada. A equipe precisa operar a retenção dos pedidos confirmados conforme o aviso aprovado.

O código confirma acesso ao e-mail informado. A análise do pedido e a eventual exigência de assinatura seguem o procedimento adotado pelo partido.

Domínios no Resend · Localização do D1 · Transferência internacional de dados