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.
| Pasta | O que entra | Pode remover? |
|---|---|---|
| arquitetura/ | Visão do sistema, domínio, módulos e planos estruturais | Não — é a referência viva |
| seguranca/ | RBAC implementado, matriz de flags EN e hardening histórico | Não — guia operacional de autorização |
| front/ | Padrões de UI e plano de refatoração do dashboard | Parcial — o plano de refactor pode sair quando a migração acabar |
| fluxos/ | Explicação detalhada de um fluxo já em produção | Só se o fluxo deixar de existir |
| extra/ | Demanda pontual, dump de chat, auditoria gerada | Sim — candidatos a remoção |
arquitetura/
Referência de como o sistema é e para onde vai.
| Arquivo | Conteúdo |
|---|---|
| manual-tecnico.md | Manual técnico: stack, pastas, módulos e padrão de implementação |
| mapa-dominio-gevtech.md | Atores, entidades e bounded contexts |
| modulos-tarefas.md | Especificação completa do módulo de Tarefas |
| plano-migracao-psr4.md | Plano 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.
| Arquivo | Conteúdo |
|---|---|
| rbac-tenant-design.md | Desenho do RBAC multi-tenant em dois níveis |
| permissoes-matriz-endpoints.md | Matriz viva endpoint → flag |
| permissoes-guia-nova-flag.md | Checklist para adicionar uma permissão |
| security-hardening-20260807.md | Registro do hardening de 07/08/2026 (histórico) |
front/
UI e reorganização do dashboard.
| Arquivo | Conteúdo |
|---|---|
| design-system/tailwind-padroes.md | Padrões visuais Tailwind-first |
| front-dashboard-refactor-map.md | Plano 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.
| Arquivo | Conteúdo |
|---|---|
| google-drive-documentos.md | Como o app lê e grava arquivos no Google Drive |
| solicitacao-informacao-compliance.md | Pedido 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.
| Arquivo | Por que está aqui |
|---|---|
| ANALISE-PROJETO.md | Análise automatizada pontual (15/09/2026) |
| ajustes-estabelecimentos-chat-20260821-20260824.md | Dump do chat de implementação de estabelecimentos |
| modal_trocar_representante.md | Demanda pontual do modal de troca de representante |
| nonessential-files-audit.md | Auditoria de arquivos candidatos a remoção (28/07/2026) |
| schema-usage-audit.md | Relatório gerado por tools/audit_schema_usage.php |
Para gerar de novo o relatório de schema:
php tools/audit_schema_usage.php