Specs¶
Spec Driven Development¶
Specs são contratos de engenharia, não documentação.
A sequência é deliberada: spec primeiro, código depois. O código é a consequência formal de uma spec aprovada — nunca o contrário.
Como funciona o fluxo¶
Spec (Draft)
└── revisão técnica + arquivística
└── Spec (Implemented) ← código entregue
└── testes de aceitação validados
└── Spec (Verified)
└── revisão jurídica / institucional
└── Spec (Accepted) ← encerrado
| Estado | Significado | Próxima ação |
|---|---|---|
Draft |
Em discussão — não implementar ainda | Revisão + aprovação de escopo |
Implemented |
Código entregue | Rodar acceptance tests |
Verified |
Tests passando | Revisão jurídica / arquivística |
Accepted |
Aprovado formalmente | — (encerrado) |
Regra fundamental
Nenhum item da spec pode ser implementado antes de estar aprovado como Draft final.
Código que precede a spec é débito técnico por definição — não feature.
Índice de specs¶
00 · Visão Geral
Draft
Objetivo, topologia de produção Azure, referências normativas e fluxo alvo da cadeia de digitalização.
EnfaseCloud.ScanEnfaseCloud.WebApiEnfaseCloud.LibraryEnfaseCloud.WebAppEnfaseCloud.IDP
01 · Requirements
Draft
Requisitos funcionais formais (Quando X, o sistema deve Y) para captura, PDF/A, OCR, manifesto, assinatura, WebApi, multi-tenant, LGPD e preservação.
EnfaseCloud.ScanEnfaseCloud.WebApiEnfaseCloud.LibraryEnfaseCloud.WebAppEnfaseCloud.IDP
02 · Design Arquitetural
Draft
Baseline Azure, contratos entre componentes, modelo de dados e fluxos de integração.
EnfaseCloud.ScanEnfaseCloud.WebApiEnfaseCloud.LibraryEnfaseCloud.WebAppEnfaseCloud.IDP
03 · Scan / PaperStream / fi-7160
DraftImplemented
Estação on-prem: driver TWAIN/PaperStream, captura controlada fi-7160, perfis de captura e detecção de páginas em branco.
EnfaseCloud.ScanEnfaseCloud.Library
04 · PDF/A · Hash · VeraPDF
DraftImplemented
Geração PDF/A-2b, cálculo SHA-256, validação formal por VeraPDF e integridade de artefatos.
EnfaseCloud.ScanEnfaseCloud.LibraryEnfaseCloud.WebApi
05 · OCR e PDF Pesquisável
DraftImplemented
Extração de texto, camada pesquisável embutida, threshold de confiança e elegibilidade por tipo documental.
EnfaseCloud.ScanEnfaseCloud.Library
Manifesto de digitalização, XMP CONARQ (mcgi:), metadados mínimos Decreto 10.278/2020 e cadeia de hash.
EnfaseCloud.ScanEnfaseCloud.LibraryEnfaseCloud.WebApi
Upload chunked, validação de hash/PDF/A/metadados, isolamento de tenant e persistência Azure SQL/Storage.
EnfaseCloud.ScanEnfaseCloud.WebApi
PAdES/ICP-Brasil, cadeia de certificação, validação temporal e valor probatório substitutivo.
EnfaseCloud.ScanEnfaseCloud.WebApiEnfaseCloud.IDP
09 · LGPD e Segurança
Draft
Dados pessoais em documentos digitalizados, controle de acesso, sigilo e conformidade LGPD.
EnfaseCloud.ScanEnfaseCloud.WebApiEnfaseCloud.IDPEnfaseCloud.WebApp
Fixidade de hash, migração controlada, trilha de auditoria e observabilidade de preservação digital.
EnfaseCloud.WebApiEnfaseCloud.WebApp
Interface operacional: estado de conformidade, alertas, fluxos de aprovação e painel de preservação.
EnfaseCloud.WebAppEnfaseCloud.WebApi
Autenticação de estação, contexto de usuário/tenant, perfis e controle de acesso a documentos.
EnfaseCloud.IDPEnfaseCloud.ScanEnfaseCloud.WebApi
13 · Rollout e Migração
Draft
Plano de ativação por tenant, migração de dados legados e estratégia de rollout incremental.
EnfaseCloud.ScanEnfaseCloud.WebApiEnfaseCloud.WebAppEnfaseCloud.IDP
14 · Acceptance Tests
Draft
Critérios de aceitação verificáveis por componente — o elo entre spec e CI.
EnfaseCloud.ScanEnfaseCloud.WebApiEnfaseCloud.LibraryEnfaseCloud.WebAppEnfaseCloud.IDP
15 · Backlog e Épicos
Draft
Épicos, histórias e priorização do backlog derivado dos requisitos da spec.
EnfaseCloud.ScanEnfaseCloud.WebApiEnfaseCloud.LibraryEnfaseCloud.WebAppEnfaseCloud.IDP
Entidades operacionais do GED: projeto, caixa e lote — distinção de tenant/cliente/tipo documental.
EnfaseCloud.WebApiEnfaseCloud.WebApp
QC de digitalização: revisão de páginas, rejeição por qualidade e fluxo de re-captura.
EnfaseCloud.ScanEnfaseCloud.WebApi
Modelo de dados, contratos de API e entidades do domínio GED.
EnfaseCloud.WebApiEnfaseCloud.WebApp
Performance, disponibilidade, segurança, escalabilidade e observabilidade da plataforma.
EnfaseCloud.ScanEnfaseCloud.WebApiEnfaseCloud.LibraryEnfaseCloud.IDP
Mapa de cobertura dos requisitos, itens pendentes e caminho para conformidade total.
EnfaseCloud.ScanEnfaseCloud.WebApiEnfaseCloud.LibraryEnfaseCloud.WebAppEnfaseCloud.IDP
Registro local de produtividade por operador e cliente (páginas/arquivos/sessões) no Scan, sincronizado para a nuvem via catálogos. Painel WebApp e endpoints WebApi.
EnfaseCloud.ScanEnfaseCloud.WebApiEnfaseCloud.WebApp