Pular para o conteúdo principal

Documentação

Índice da pasta docs/. Cada subpasta tem um propósito: o que fica de referência e o que pode sumir depois.

Revisão das docs vivas contra o código: 19/09/2026. extra/ é snapshot histórico — não foi reescrito.

PastaO que entraPode remover?
arquitetura/Visão do sistema, domínio, módulos e planos estruturaisNão — é a referência viva
seguranca/RBAC implementado, matriz de flags EN e hardening históricoNão — guia operacional de autorização
front/Padrões de UI e plano de refatoração do dashboardParcial — o plano de refactor pode sair quando a migração acabar
fluxos/Explicação detalhada de um fluxo já em produçãoSó se o fluxo deixar de existir
extra/Demanda pontual, dump de chat, auditoria geradaSim — candidatos a remoção

arquitetura/​

Referência de como o sistema é e para onde vai.

ArquivoConteúdo
manual-tecnico.mdManual técnico: stack, pastas, módulos e padrão de implementação
mapa-dominio-gevtech.mdAtores, entidades e bounded contexts
modulos-tarefas.mdEspecificação completa do módulo de Tarefas
plano-migracao-psr4.mdPlano de adoção PSR-4 (pode arquivar quando a migração terminar)

seguranca/​

Autorização e hardening. Atualize a matriz sempre que criar endpoint ou flag.

ArquivoConteúdo
rbac-tenant-design.mdDesenho do RBAC multi-tenant em dois níveis
permissoes-matriz-endpoints.mdMatriz viva endpoint → flag
permissoes-guia-nova-flag.mdChecklist para adicionar uma permissão
security-hardening-20260807.mdRegistro do hardening de 07/08/2026 (histórico)

front/​

UI e reorganização do dashboard.

ArquivoConteúdo
design-system/tailwind-padroes.mdPadrões visuais Tailwind-first
front-dashboard-refactor-map.mdPlano de reorganização do front (pode arquivar quando estiver feito)

fluxos/​

Como um fluxo real funciona hoje. Não é demanda pontual: é o “por quê” e o “como” de uma feature.

ArquivoConteúdo
google-drive-documentos.mdComo o app lê e grava arquivos no Google Drive
solicitacao-informacao-compliance.mdPedido de informação pelo compliance e o que o EC vê

extra/​

Documentos de sessão: chat, auditoria gerada, demanda feita na hora. Podem ser apagados quando não servirem mais de contexto.

ArquivoPor que está aqui
ANALISE-PROJETO.mdAnálise automatizada pontual (15/09/2026)
ajustes-estabelecimentos-chat-20260821-20260824.mdDump do chat de implementação de estabelecimentos
modal_trocar_representante.mdDemanda pontual do modal de troca de representante
nonessential-files-audit.mdAuditoria de arquivos candidatos a remoção (28/07/2026)
schema-usage-audit.mdRelatório gerado por tools/audit_schema_usage.php

Para gerar de novo o relatório de schema:

php tools/audit_schema_usage.php