\# Master Plan — Longão Elite Platform \## 1. Visão do Produto O Longão Elite Platform é uma plataforma web para gestão institucional, esportiva, social, administrativa e comercial da Associação Longão Elite. O sistema nasce para atender a Associação Longão Elite, mas será projetado de forma organizada para permitir futura evolução para múltiplas organizações, aplicativos móveis e APIs externas. \--- \## 2. Princípios Arquiteturais \### 2.1 Baixo acoplamento Cada domínio deve ser independente o suficiente para evoluir sem quebrar os demais. \### 2.2 Domínio antes da tela Nenhuma tabela deve existir apenas para atender uma tela. Toda tabela deve representar um conceito real do domínio. \### 2.3 Pessoas e Organizações como cadastros mestres Toda pessoa física será representada pela tabela `pessoas`. Toda pessoa jurídica, órgão, parceiro, patrocinador, igreja, associação, fornecedor ou instituição será representada por `organizacoes`. \### 2.4 Mídia centralizada Todas as imagens, PDFs, documentos e arquivos deverão ser armazenados na tabela `media`. \### 2.5 Regras de negócio em Services Controllers devem ser simples. Regras de negócio relevantes devem ficar em `Services`. \--- \## 3. Domínios Principais \### Núcleo \- Pessoas \- Usuários \- Mídia \- Organizações \- Tipos de Organização \### Associação \- Associados \- Dependentes \- Mensalidades \- Carteirinhas \### Eventos \- Tipos de Evento \- Eventos \- Percursos \- Inscrições \- Check-ins \- Organizações vinculadas ao evento \### CMS \- Configurações do site \- Banners \- Blocos da Home \- Notícias \- Categorias \- Galeria \- SEO \- Redes sociais \### Social \- Campanhas \- Projetos sociais \- Famílias beneficiadas \- Beneficiários \- Doações \- Entregas \### Comercial \- Produtos \- Categorias \- Variações \- Imagens \- Clientes \- Pedidos \- Pagamentos \- Cupons \### Administração \- Usuários \- Perfis \- Permissões \- Logs \- Backups \- Feature Flags \--- \## 4. Estratégia Técnica Backend: \- Laravel \- PHP 8.3+ \- MySQL \- Spatie Permission Frontend: \- Vue 3 \- Inertia.js \- Vite \- Tailwind Arquitetura: \- Models \- Services \- Form Requests \- Policies \- Enums \- Traits \- DTOs quando necessário \- Actions quando necessário \--- \## 5. Estratégia de Evolução \### Fase 1 — Fundação \- Autenticação \- Permissões \- Pessoas \- Organizações \- Mídia \- Eventos \- Associação \### Fase 2 — Administração \- Dashboard \- CRUDs principais \- Uploads \- Perfis de acesso \### Fase 3 — Site Público \- Home \- Notícias \- Galeria \- Parceiros \- Transparência \- Contato \### Fase 4 — Área do Associado \- Carteirinha digital \- QR Code \- Mensalidades \- Dependentes \- Histórico \- Inscrições \### Fase 5 — Social \- Projetos sociais \- Famílias \- Doações \- Entregas \- Relatórios \### Fase 6 — Comercial \- Vitrine \- Produtos \- Pedidos \- Pagamentos \- Loja completa \### Fase 7 — Expansão \- API \- Aplicativo móvel \- Multi-organização \- Integrações externas \--- \## 6. Decisões Importantes \- Usar `pessoas` como cadastro mestre de pessoas físicas. \- Usar `organizacoes` como cadastro mestre de instituições. \- Usar `media` como biblioteca central de arquivos. \- Usar `Services` para regras de negócio. \- Usar `Enums` para status relevantes. \- Usar `Traits` para comportamentos reutilizáveis. \- Usar `Git` com commits frequentes e mensagens padronizadas. \--- \## 7. Próximas Prioridades 1\. Consolidar Models principais. 2\. Aplicar `BaseModel` de forma seletiva. 3\. Revisar migrations restantes. 4\. Criar Services reais. 5\. Criar Policies. 6\. Iniciar painel administrativo.