ESP — Especificação: Subpastas & Regras (B)
O ponto de vista ESP (Especificação) é o núcleo de toda a especificação. Todos os demais pontos de vista consomem ou se subordinam às definições feitas aqui. Nenhuma história pode ser implementada sem estar registrada e aprovada no ESP.
Subpastas do ESP
Seção intitulada “Subpastas do ESP”| Subpasta | Documentos esperados | Siglas |
|---|---|---|
00-indice/ | Índice e contexto do projeto | IDX, CTX |
01-visao-geral/ | Visão do produto e requisitos | VIS, BRD, PRD, STY |
02-historias/ | Histórias por tipo (11 subpastas) | HNI, HNE, HNU, HS, HRD, HUX, HC, HAI, HAC, HIVC, HI |
03-decisoes/ | Decisões de escopo e requisitos | DEC |
04-evidencias/ | Validações e aprovações | EVD |
05-checklists/ | Listas de verificação | CHK |
06-modelos/ | Modelos de domínio e guias visuais | DOM, STY, TPL |
07-referencias/ | Referências externas | REF |
08-publicado/ | Versões aprovadas para consumo | — |
Os 11 tipos de história
Seção intitulada “Os 11 tipos de história”Todas as histórias ficam em artefatos/ESP (Especificação)/02-historias/<TIPO>/ e seguem o padrão ESP-<TIPO>-<NNNN>--<slug>.md.
| Tipo | Nome | Página |
|---|---|---|
| HNI | Negócio Institucional | Ver → |
| HNE | Negócio Especializado | Ver → |
| HNU | Negócio de Usuário | Ver → |
| HS | Sistema | Ver → |
| HRD | Regra de Decisão | Ver → |
| HUX | Experiência do Usuário | Ver → |
| HC | Conformidade | Ver → |
| HAI | Autenticação e Identidade | Ver → |
| HAC | Acessibilidade | Ver → |
| HIVC | Identidade Visual e Comunicação | Ver → |
| HI | Integração | Ver → |
Regras de Validação ESP
Seção intitulada “Regras de Validação ESP”- Todo artefato ESP deve ter:
id,tipo,status,autor,data,criterios-de-aceite. - Histórias aprovadas exigem ao menos uma evidência em
ESP/04-evidencias/. - Histórias de sistema (HS) devem referenciar ao menos uma HNU ou HNE de origem.
- Integrações (HI) devem ter correspondência em
IMP/03-decisoes/(API contract). - Apenas artefatos com evidência em
04-evidencias/podem ser movidos para08-publicado/.