Assinar Documentos

A assinatura de documentos aplica uma assinatura digital ao PDF, validando oficialmente o documento.

Atores Autorizados

Os seguintes tipos de usuários podem assinar documentos:

• RAD Físico
• RAD Admin
• Administrador

Permissão Necessária

DOCUMENT_SIGN_ACCESS: Permissão para assinar documentos.

Processo de Assinatura

1. Localizar Documento

• Acesse a lista de documentos
• Filtre por status "Falta assinar" se necessário
• Localize o documento que deseja assinar

2. Abrir Documento

• Clique no documento para visualizar
• Ou clique no botão "Assinar" na lista

3. Configurar Assinatura

• Posição: Escolha onde a assinatura será aplicada
  • Top-right (canto superior direito)
  • Top-left (canto superior esquerdo)
  • Bottom-right (canto inferior direito)
  • Bottom-left (canto inferior esquerdo)
• Modo: Tipo de assinatura
  • Simple (simples)
  • First (primeira assinatura)
  • Second (segunda assinatura)
• Orientação: Portrait (retrato) ou Landscape (paisagem)

4. Gerar Código de Assinatura

• O sistema gera um código único (hash) para a assinatura
• Este código identifica a assinatura digitalmente

5. Confirmar Assinatura

• Revise as configurações
• Confirme a assinatura
• O sistema processa a assinatura

O Que Acontece Durante a Assinatura

1. PDF Original: O PDF original é recuperado do AWS S3
2. Aplicação da Assinatura: A assinatura é aplicada ao PDF usando o código hash
3. Novo PDF Assinado: Um novo PDF é gerado com a assinatura
4. Upload para S3: O PDF assinado é enviado ao AWS S3
5. Atualização do Banco: O documento é atualizado com:
   • Status: "Assinado"
   • signedBy: Nome do usuário que assinou
   • signedAt: Timestamp da assinatura
   • hash: Código da assinatura
   • path: Nova URL do PDF assinado
   • s3Key: Nova chave S3 do PDF assinado

Endpoint da API

Método: POST

URL: /document/sign/

Body:

{
  "_id": "documentId",
  "position": "bl",
  "mode": "simple",
  "hash": "código de assinatura",
  "orientation": "portrait"
}

Status Após Assinatura

Após assinar, o documento:

• Status muda para "Assinado"
• Fica disponível para liberação
• PDF original é substituído pelo PDF assinado
• Histórico de assinatura é registrado

Próximos Passos

Após assinar um documento:

• Ele pode ser liberado por RAD Admin ou RAD Físico
• Clientes ainda não podem visualizar (precisa ser liberado)
• Email pode ser agendado após liberação

Considerações Importantes

• Irreversível: A assinatura é permanente e não pode ser desfeita facilmente
• PDF Original: O PDF original é substituído pelo assinado
• Validação: Verifique o documento antes de assinar
• Responsabilidade: Assinar implica em assumir responsabilidade pelo conteúdo

Próximos Passos

• Liberar Documentos - Liberar documento assinado
• Workflow Completo - Voltar ao workflow completo
• Solicitar Correções - Se precisar de correções