Documentação
Pasta organizada por tipo. Use isto para achar o documento certo e para saber o que pode ser apagado depois.
| Pasta | O que entra | Pode remover? |
|---|---|---|
| arquitetura/ | Como o sistema funciona: módulos, domínio, integrações, planos de migração | Não, enquanto o conteúdo ainda descrever o produto |
| seguranca/ | Permissões, RBAC e matriz de endpoints | Não — é referência viva |
| front/ | Padrões de UI e mapa de estrutura do dashboard | Não, enquanto o front seguir esses padrões |
| extra/ | Demanda pontual, snapshot de auditoria, changelog datado | Sim — candidatos a remoção |
arquitetura/
Referência permanente de produto e técnica.
| Arquivo | Para que serve |
|---|---|
| manual-tecnico.md | Visão geral do portal: módulos, stack, pastas, como criar módulo novo |
| mapa-dominio-gevtech.md | Atores, entidades, bounded contexts e fluxo de negócio |
| modulos-tarefas.md | Especificação completa do módulo de Tarefas |
| google-agenda-setup.md | Setup da integração OAuth com Google Agenda |
| plano-migracao-psr4.md | Plano de autoload PSR-4 — pode ir para extra/ depois que a migração terminar |
seguranca/
Governança de acesso. Atualizar sempre que uma flag ou endpoint mudar.
| Arquivo | Para que serve |
|---|---|
| permissoes-guia-nova-flag.md | Checklist para criar uma permissão nova |
| permissoes-matriz-endpoints.md | Matriz viva endpoint → flag |
| rbac-tenant-design.md | Desenho do RBAC em dois níveis (White Label + usuário) |
front/
Padrões visuais e estrutura do dashboard.
| Arquivo | Para que serve |
|---|---|
| design-system/tailwind-padroes.md | Tokens e contrato HTML das listagens Tailwind |
| front-dashboard-refactor-map.md | Mapa da reorganização do front — pode ir para extra/ se a estrutura alvo já estiver consolidada |
extra/
Material pontual. Não é contrato do sistema. Apague quando o contexto morrer.
| Arquivo | Por que está aqui | Quando remover |
|---|---|---|
| ANALISE_PROJETO.md | Análise única (15/09/2026) de segurança, qualidade e débito | Depois de tratar (ou descartar) os findings |
| security-hardening-20260807.md | Changelog do hardening de 07/08/2026 | Já aplicado; só histórico |
| schema-usage-audit.md | Snapshot de uso de tabelas (05/08/2026). Regenerado por php tools/audit_schema_usage.php | Pode apagar o arquivo; o script gera de novo |
| nonessential-files-audit.md | Snapshot de arquivos candidatos a remoção (28/07/2026) | Depois de confirmar que o cleanup já foi feito |
| modal_trocar_representante.md | Nota da demanda do modal; caminhos config/ já estão desatualizados | O fluxo já existe no produto; o doc não precisa ficar |