01 - Requisitos¶
Status: Draft
Requisitos funcionais¶
Captura¶
- Quando o operador iniciar uma digitalização, o sistema deve exigir scanner, cliente, tipo documental, operador, local de digitalização e perfil de captura.
- Quando o scanner for fi-7160, o sistema deve permitir captura duplex A4 a 300 DPI via TWAIN/PaperStream.
- Quando uma página for detectada como branca, o sistema deve registrar a detecção e aplicar a política configurada: manter, remover ou enviar para revisão.
- Quando o modo de cor for automático, o sistema deve registrar o modo detectado por página.
PDF/A e integridade¶
- Quando um PDF for gerado pela estação de scan, o sistema deve gerar PDF/A-2b por padrão.
- Quando metadados XMP forem aplicados, o sistema deve recalcular SHA-256 sobre os bytes finais.
- Quando a WebApi receber um upload com hash esperado, o sistema deve rejeitar o arquivo se o hash calculado divergir.
- Quando a WebApi validar PDF/A, o sistema deve registrar o resultado formal do veraPDF.
OCR¶
- Quando o documento for elegível a OCR, o sistema deve extrair texto para indexação.
- Quando o documento for marcado para PDF pesquisável, o sistema deve embutir camada de texto sem invalidar PDF/A.
- Quando a confiança OCR ficar abaixo do limite configurado, o sistema deve marcar o documento para revisão.
Manifesto e metadados¶
- Quando uma digitalização for concluída, o sistema deve gerar manifesto com operador, responsável, equipamento, perfil, datas, páginas, tipo documental, PCDA, TTDA, hash, assinatura e eventos.
- Quando metadados obrigatórios estiverem ausentes, o sistema deve impedir conclusão conforme política do tenant.
- Quando o manifesto for alterado por qualquer processamento, o sistema deve gerar novo hash de manifesto.
Assinatura (exclusivamente na nuvem, pós-upload)¶
A assinatura ICP-Brasil/PAdES é aplicada pela WebApi, nunca pelo
EnfaseCloud.Scan. O Scan entrega o artefato íntegro; a assinatura ocorre após persistência na nuvem.
- Quando a política do tenant exigir valor probatório substitutivo, a WebApi deve acionar o provedor de assinatura ICP-Brasil/PAdES após receber e persistir o artefato.
- A assinatura nunca é responsabilidade da estação de digitalização (
EnfaseCloud.Scan). - Quando uma assinatura for aplicada, a WebApi deve validar cadeia, certificado, validade temporal e integridade do documento.
- Quando a assinatura estiver ausente, inválida ou pendente, o sistema deve refletir esse status no documento — o arquivo permanece acessível com status explícito.
- O manifesto registra o status de assinatura, não o artefato assinado como obrigação da estação.
WebApi e multi-tenant¶
- Quando um arquivo for recebido, a WebApi deve resolver tenant antes de persistir dados ou bytes.
- Quando um upload vier do Vue sem manifesto, o sistema deve tratar como upload comum, nao como digitalização operacional.
- Quando um upload vier do Scan com manifesto, o sistema deve persistir a cadeia de digitalização.
Vue e operação¶
- Quando um documento for visualizado, o Vue deve exibir hash, PDF/A, assinatura, OCR, upload, indexação e preservação.
- Quando houver pendencia de conformidade, o Vue deve mostrar status acionavel sem ocultar o arquivo.
Requisitos nao funcionais¶
- Rastreabilidade: todo evento relevante deve ser auditável.
- Idempotencia: upload chunked deve suportar retomada sem corromper estado.
- Segregação: dados, arquivos, auditoria e configurações devem respeitar tenant.
- Segurança: arquivos locais e cloud devem ter confidencialidade e controle de acesso.
- preservação: hash, PDF/A, metadados e eventos devem permitir verificação futura.
- Compatibilidade: uploads existentes do Vue devem continuar funcionando.