# QA — `v7_implementation`

Data: 2026-10-21. Escopo: `sucesu_analise/v7_implementation/` (51 unidades).
Referência: `_contract/IMPLEMENTATION.md`, `09_reimplementacao/pilha-alvo-public-v7.md`.

> **Atualização 2026-10-21:** este QA é estrutural. Ele não prova alinhamento
> constitucional; há divergências materiais em auth/RBAC, auditoria, ETL, tokens
> legados e sintaxe PHP. Ver [`alignment-public-v7.md`](alignment-public-v7.md).

## 1. Resultado

| Métrica | Valor |
|---|---|
| Unidades implementáveis | 51 |
| Documentos de unidade | 51 (`README.md`) |
| Linhas de plano | ~11.400 |
| Pastas de serviço | 13 |
| Pastas de módulo | 20 |
| Pastas de fundação/feature | 11 |
| Pastas de UI | 3 |
| Pastas de dados | 3 |
| Não implementados | 1 |
| Erros estruturais | 0 |

A árvore cobre todos os `SVC-*` implementáveis, todos os `MOD-*` (incluindo o
`ExemploAPI` como referência), as features de Core (boot, rotas, auth, segurança, dados,
regional, controllers, helpers, runtime, satélites, anatomia), UI (CMS, portal,
acessibilidade), seeds e grupos vazios. `ARCH-OVERVIEW`, `SVC-INDEX` e `MOD-INDEX` são
meta-documentos: o primeiro e o último estão no README/anatomia; o índice de serviços não
é unidade de código.

## 2. Estrutura de cada documento

Todos os documentos têm front-matter (`id`, `tipo`, `status`, `token`, `camada`,
`unidade_fonte`, `adrs`, `depende_de`) e as 11 seções: Contrato, Estrutura alvo,
Implementação, Dados e migração, Fluxos e estados, Segurança e limites, Testes, Validação,
Aceite, Riscos e armadilhas, Evidências.

Os 51 documentos passam `tools/check_impl.py`:

```text
Unidades verificadas: 51 | com erro: 0
```

## 3. O que foi verificado

- Front-matter completo e valores válidos.
- Seções obrigatórias presentes e não vazias.
- Pelo menos 3 trechos de código por unidade.
- Sem `TODO`/`PREENCHER`/`FIXME`.
- Links relativos resolvem.
- Rotas/tabelas vieram dos índices parciais do corpus (não foram inventadas).
- Rotas nomeadas foram normalizadas apenas nos snippets; as tabelas de rotas ainda
  contêm `v2.*` (ver `alignment-public-v7.md`).
- Testes têm caso, camada e resultado observável.
- Comandos de validação e checklist de aceite presentes.

## 4. Limites conhecidos

0. **Alinhamento semântico não verificado.** O checker não compila PHP, não valida
   nomes de rota/tabela/view e não lê as ADR. O parecer de alinhamento está em
   [`alignment-public-v7.md`](alignment-public-v7.md).

1. **Código não compilado.** O repositório-alvo (`src/`, Laravel 12) ainda não existe; os
   snippets são prescritivos e usam tipos/interfaces que devem ser criados. A compilação e
   os testes reais são o gate da implementação, não desta árvore.
2. **Nomes físicos de tabela.** O corpus usa `v2_*`; os planos mostram o nome legado e
   apontam para o mapa `LG-ALVO-02`. Alguns testes de schema usam o nome sem prefixo como
   placeholder explícito; o mapa definitivo deve ser aprovado antes da E1.
3. **Arquétipos.** Módulos simples compartilham o mesmo esqueleto de provider/controller/
   request; módulos críticos (Notícias, Unidade Regional, SupportConfigs, MailAudit,
   painel do Feed, importação) têm ações específicas. Cada unidade ainda exige revisão do
   dono antes de codar.
4. **Serviços complexos.** Os contratos estão corretos por unidade, mas a implementação
   interna (ex.: parser AST, pipeline de mídia, assinatura PDF) é resumida no plano; os
   docs de corpus continuam sendo a referência de comportamento.
5. **UI.** Os planos definem shell, componentes, estados e testes; a fidelidade visual
   (Tailwind/daisyUI) só se prova no e2e/axe, não no markdown.

## 5. Gates executados

```text
python3 tools/check_impl.py        -> 51 unidades, 0 erros
python3 tools/lint_docs.py         -> 129 docs do corpus, 0 erros
python3 tools/coverage.py --docs --complete -> 56/56, 930/930
python3 tools/merge_indices.py --check     -> Índices OK
git -C sucesu-cms status --porcelain       -> vazio
```

`lint_docs.py` e `coverage.py` ignoram `v7_implementation/` de propósito: o corpus valida a
engenharia reversa; `check_impl.py` valida os planos de implementação.

## 6. Próximos passos

1. Aprovar o mapa `v2_* → token` (LG-ALVO-02) e a modalidade de migração (LG-ALVO-01).
2. Implementar `core/boot` → `core/rotas` → `core/autenticacao` → `core/dados`.
3. Trocar os arquétipos pelos contratos reais ao criar cada módulo, começando por Notícias.
4. Rodar `make check` no repositório-alvo e substituir os testes prescritivos pelos reais.