ESP — Especificação
Autoridade: o ESP é o ponto de vista de maior autoridade sobre o “o quê” do sistema. Todos os demais pontos de vista consomem artefatos publicados pela Especificação.
Responsável por estruturar o conhecimento de negócio, regras, requisitos, integrações, conformidade, autenticação, acessibilidade e comunicação institucional.
Tipos de história da Especificação
Seção intitulada “Tipos de história da Especificação”As histórias do ESP cobrem 11 tipos distintos, organizados por natureza e origem:
HNI — Histórias de Negócio Institucionais
Seção intitulada “HNI — Histórias de Negócio Institucionais”Contêm as definições de negócio de alto nível derivadas de normas, leis, políticas, regras internas, instruções normativas, diretrizes estratégicas e demais orientações da alta gestão.
HNE — Histórias de Negócio Especializadas
Seção intitulada “HNE — Histórias de Negócio Especializadas”Contêm as definições especializadas da área gestora da solução, condicionadas negocialmente às HNI e tecnicamente às histórias de sistemas.
HNU — Histórias de Negócio de Usuário
Seção intitulada “HNU — Histórias de Negócio de Usuário”Contêm as definições técnicas e operacionais das equipes usuárias e executoras do negócio, condicionadas às HNI, HNE e às histórias de sistemas.
HS — Histórias de Sistema
Seção intitulada “HS — Histórias de Sistema”Contêm a tradução técnica estruturada das necessidades de negócio para construção da solução.
HI — Histórias de Integração
Seção intitulada “HI — Histórias de Integração”Contêm requisitos de interoperabilidade, troca de dados, APIs, barramentos, integrações internas, externas e com terceiros.
HRD — Histórias de Regra de Decisão
Seção intitulada “HRD — Histórias de Regra de Decisão”Contêm regras explícitas de decisão, critérios, exceções, condicionantes, parâmetros e lógicas automatizáveis.
HUX — Histórias de Experiência do Usuário
Seção intitulada “HUX — Histórias de Experiência do Usuário”Contêm requisitos de jornada, interface, usabilidade, acessibilidade, comunicação e uso prático da solução.
HC — Histórias de Conformidade
Seção intitulada “HC — Histórias de Conformidade”Contêm requisitos legais, regulatórios, normativos, auditoriais e de controle aplicáveis à solução.
HAI — Histórias de Autenticação e Identidade
Seção intitulada “HAI — Histórias de Autenticação e Identidade”Contêm requisitos de autenticação centralizada, federação de identidade, integração institucional e integração com o gov.br.
HAC — Histórias de Acessibilidade
Seção intitulada “HAC — Histórias de Acessibilidade”Contêm requisitos de acessibilidade digital aplicáveis às interfaces, jornadas, componentes, fluxos e conteúdos.
HIVC — Histórias de Identidade Visual e Comunicação
Seção intitulada “HIVC — Histórias de Identidade Visual e Comunicação”Contêm padrões de identidade visual de governo, padrões institucionais de interface, textos obrigatórios, disclaimers e componentes de comunicação com o usuário.
Ciclo de vida das histórias
Seção intitulada “Ciclo de vida das histórias”Toda história percorre estados definidos antes de ser considerada válida para consumo pelos demais pontos de vista:
Regras obrigatórias
Seção intitulada “Regras obrigatórias”Toda história da especificação deverá possuir identificador único, versão, origem, data de geração, data de revisão, autor ou responsável, dependências, criticidade e vínculo com os demais artefatos afetados.
Toda história deverá possuir rastreabilidade bidirecional entre documentos de origem, protótipos, infraestrutura, código, testes, implantação, operação, documentação e evidências.
Toda história deverá ser submetida a validação de alucinação em dois níveis:
Toda história que envolva usuário externo deverá indicar o mecanismo de autenticação e o nível de autenticação gov.br compatível com a natureza do requisito de negócio.
Toda história que envolva interface, navegação ou interação humana deverá conter requisitos mínimos de acessibilidade.
Toda história que envolva comunicação com o usuário deverá indicar mensagens obrigatórias, disclaimers, avisos institucionais e elementos mínimos de transparência.
Evidências da Especificação
Seção intitulada “Evidências da Especificação”- evidência de origem documental;
- evidência de validação por IA secundária;
- evidência de validação humana;
- evidência de aprovação da história;
- evidência de rastreabilidade com protótipo, código, teste ou infraestrutura.
Documentos estruturantes
Seção intitulada “Documentos estruturantes”| Sigla | Nome | Finalidade |
|---|---|---|
| VIS | Vision Document | Visão de alto nível da solução |
| BRD | Business Requirements Document | Requisitos de negócio formalizados |
| PRD | Product Requirements Document | Requisitos detalhados do produto |
| DOM | Domain Model | Modelo de domínio conceitual |
| STY | Style Guide | Padrão visual e de comunicação |