Pular para o conteúdo principal

Documentação

Pasta organizada por tipo. Use isto para achar o documento certo e para saber o que pode ser apagado depois.

PastaO que entraPode remover?
arquitetura/Como o sistema funciona: módulos, domínio, integrações, planos de migraçãoNão, enquanto o conteúdo ainda descrever o produto
seguranca/Permissões, RBAC e matriz de endpointsNão — é referência viva
front/Padrões de UI e mapa de estrutura do dashboardNão, enquanto o front seguir esses padrões
extra/Demanda pontual, snapshot de auditoria, changelog datadoSim — candidatos a remoção

arquitetura/​

Referência permanente de produto e técnica.

ArquivoPara que serve
manual-tecnico.mdVisão geral do portal: módulos, stack, pastas, como criar módulo novo
mapa-dominio-gevtech.mdAtores, entidades, bounded contexts e fluxo de negócio
modulos-tarefas.mdEspecificação completa do módulo de Tarefas
google-agenda-setup.mdSetup da integração OAuth com Google Agenda
plano-migracao-psr4.mdPlano 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.

ArquivoPara que serve
permissoes-guia-nova-flag.mdChecklist para criar uma permissão nova
permissoes-matriz-endpoints.mdMatriz viva endpoint → flag
rbac-tenant-design.mdDesenho do RBAC em dois níveis (White Label + usuário)

front/​

Padrões visuais e estrutura do dashboard.

ArquivoPara que serve
design-system/tailwind-padroes.mdTokens e contrato HTML das listagens Tailwind
front-dashboard-refactor-map.mdMapa 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.

ArquivoPor que está aquiQuando remover
ANALISE_PROJETO.mdAnálise única (15/09/2026) de segurança, qualidade e débitoDepois de tratar (ou descartar) os findings
security-hardening-20260807.mdChangelog do hardening de 07/08/2026Já aplicado; só histórico
schema-usage-audit.mdSnapshot de uso de tabelas (05/08/2026). Regenerado por php tools/audit_schema_usage.phpPode apagar o arquivo; o script gera de novo
nonessential-files-audit.mdSnapshot de arquivos candidatos a remoção (28/07/2026)Depois de confirmar que o cleanup já foi feito
modal_trocar_representante.mdNota da demanda do modal; caminhos config/ já estão desatualizadosO fluxo já existe no produto; o doc não precisa ficar