# Xertica UI — Auditoria de Documentação

> **Status (2026-06-25):** ✅ **ATUAL** — esta auditoria substitui integralmente o relatório histórico de 2026-05-19. O conteúdo abaixo reflete o estado verificado da documentação contra o código-fonte.

## Resumo Executivo

A documentação está **completa e em bom estado**. Todos os componentes públicos, hooks, contextos e páginas-template possuem cobertura em `docs/`. Nenhum arquivo de documentação está truncado ou contém seções vazias.

| Categoria                        | Total no Código | Com Doc | Sem Doc |
| -------------------------------- | --------------- | ------- | ------- |
| Componentes UI (`components/ui/`)        | 60      | 60      | 0       |
| Componentes Assistant (`components/assistant/`) | 5 | 5    | 0       |
| Componentes Brand (`components/brand/`)  | 6\*     | 6       | 0       |
| Componentes Layout (`components/layout/`)| 2       | 2       | 0       |
| Componentes Media (`components/media/`)  | 3       | 3       | 0       |
| Componentes Blocks (`components/blocks/`)| 12 (6 cards + 6 skeletons) | `card-patterns.md` (cobertura agregada) | 0 |
| Páginas (`components/pages/`)            | 8       | `pages.md` (cobertura agregada) | 0 |
| Hooks/Contextos                          | 10      | `hooks.md` + `use-mobile.md` + `layout.md` | 0 |
| Utilitários (`components/figma/`)        | 1       | `image-with-fallback.md` | 0 |

\* `components/brand/branding/` existe apenas como showcase de Storybook (`.stories.tsx` + `.mdx`), não é um export público.

> Notas de contagem:
>
> - `components/ui/` contém 64 diretórios, dos quais 60 são componentes documentados. Os 4 restantes são módulos internos de configuração/re-export: `map-config`, `map-layers` (hook `useMapLayers`, documentado em `map-layers.md`), `map.exports`, e `google-maps-loader` (documentado em `google-maps-loader.md`).
> - `AssistantChart` reside em `components/ui/assistant-chart/` e é contado como componente UI; aparece de forma cruzada na seção "AI Features" do catálogo de `llms.md`.

## Verificações de Qualidade (2026-06-25)

| Item                                                              | Resultado |
| ---------------------------------------------------------------- | --------- |
| `docs/architecture.md` — título H1 correto (`# Xertica UI — Architecture`) | ✅ OK |
| `docs/installation.md` — menciona `moduleResolution: "bundler"`  | ✅ OK |
| `docs/getting-started.md` — possui seção de Troubleshooting       | ✅ OK |
| `docs/llms.md` — estatísticas reconciliadas com subtotais         | ✅ Corrigido |
| Seções truncadas / vazias em `docs/components/`                    | ✅ Nenhuma encontrada |
| Marcadores TODO / WIP / placeholder reais                         | ✅ Nenhum encontrado |

## Padrões (`docs/patterns/`)

Cobertura atual: `analytics`, `crud`, `dashboard`, `detail-page`, `form`, `login`, `settings`, `wizard` (8 padrões). Os fluxos comuns identificados em auditorias anteriores (wizard/multi-step, detail page, settings page) já estão documentados.

## Pontos de Atenção Menores

- **Convenção de seção "AI Rules":** padronizada em todos os docs de componentes. Verificar novos docs para garantir uso de "AI Rules" (e não variações como "AI Best Practices").
- **`lib/query-client.ts`:** singleton intencionalmente interno; não exposto na API pública e não documentado externamente por design.

## Histórico

O relatório original (2026-05-19) listava lacunas em componentes Assistant, páginas-template, hooks e utilitários. Todas foram resolvidas em auditorias subsequentes (2026-05-21 em diante). Aquele conteúdo foi removido deste arquivo por estar desatualizado e contradizer o estado real verificado.