Auditoria de Defasagem - 2026-03-10¶
Este documento registra a auditoria entre o estado real de código (billings-ease-backend e billings-ease-web) e a documentação técnica/usuário.
Escopo auditado¶
- Repositórios fonte de verdade:
billings-ease-backend,billings-ease-web. - Repositórios auditados:
billings-ease-documentation,billings-ease-help. - Data de referência: 2026-03-10.
Matriz de lacunas¶
| Lacuna | Evidência no código | Ação aplicada | Documento alvo |
|---|---|---|---|
| Backend ainda citado como Go 1.24 | billings-ease-backend/go.mod usa go 1.25.0 |
Atualizar stack/quickstart/estado atual para Go 1.25 | docs/00-overview/*, docs/02-backend/*, docs/07-guides/desenvolvimento-local.md |
| Web documentado com Yarn | billings-ease-web/package.json usa pnpm@10.31.0 |
Substituir comandos Yarn por pnpm nos documentos de web/devops | docs/00-overview/*, docs/03-frontend/*, docs/06-devops/ci-cd.md |
| Snapshot geral dizendo “sem mudanças no web” | Commits recentes no web com hubs, sidebar tree, tours e command palette | Atualizar snapshot global e estados técnicos | docs/index.md, docs/03-frontend/estado-atual.md |
| Rotas web faltando em docs (hubs e legais) | Rotas em src/routes/*Routes.tsx incluem /admin/marketplace, /professional/educacional, /client/aprendizado, /termos-de-uso, /politica-de-privacidade, /politica-de-cookies, /legal/consent |
Atualizar tabelas de páginas/roteamento | docs/03-frontend/paginas.md, docs/03-frontend/roteamento.md |
| Navegação recente não documentada | src/components/Layout.tsx, src/components/Sidebar.tsx, src/navigation/schema.ts |
Documentar layout persistente e menu por árvore colapsável | docs/03-frontend/estado-atual.md, docs/03-frontend/roteamento.md |
| Command palette não documentada | src/components/NavigationCommandPalette.tsx e eventos globais no header/sidebar |
Documentar atalho, comportamento e escopo por permissão | docs/03-frontend/estado-atual.md, docs/03-frontend/roteamento.md, docs/03-frontend/acessibilidade.md |
| Tours de hubs não documentados | src/modules/shared/product-onboarding/*/hub |
Atualizar seção de onboarding/tour por perfil | docs/03-frontend/estado-atual.md, docs/03-frontend/marketplace-cursos.md |
| Evolução backend marketplace (deleção lógica) parcialmente registrada | Endpoint POST /marketplace/professional/courses/:id/delete e migração 046 |
Consolidar backend marketplace, migrações e estado atual | docs/02-backend/marketplace-cursos.md, docs/02-backend/migracoes.md, docs/02-backend/estado-atual.md |
| Onboarding obrigatório de cliente não documentado (método/PBI) | Novos campos em client_profiles, novos endpoints /client/profile/method-onboarding e /client/profile/pbi, gate no ProtectedRoute e exceção dos 15 dias em symbol_rules.go |
Atualizar domínio, contratos, roteamento e guias de ajuda do cliente | docs/02-backend/api.md, docs/02-backend/migracoes.md, docs/02-backend/dominio-billings.md, docs/02-dominio/regras-criticas.md, docs/03-frontend/*, billings-ease-help/docs/* |
| Help sem cobertura de jornadas novas (cliente/profissional) | Rotas atuais incluem hubs, bundles e materiais/revenue profissional | Criar páginas e atualizar navegação de ajuda | billings-ease-help/docs/**, sidebars.ts, README.md |
| Help sem UX transversal de busca/tour | Web possui ⌘K/Ctrl+K e botão de tour contextual |
Criar guias de busca rápida e tour guiado | billings-ease-help/docs/getting-started/* |
Critérios de fechamento da auditoria¶
- Todo item da matriz com ação refletida em documento versionado.
mkdocs buildsem erros de navegação.pnpm buildno help sem erro de documentação.- Sem referência residual de Yarn para web e sem referência residual a Go 1.24 em backend/quickstart aplicáveis.