# 🎓 EducaGest - SaaS Educacional Premium

O **EducaGest** é uma plataforma SaaS (Software as a Service) de alta performance para gestão educacional, construída sobre o ecossistema Laravel. Projetado para rodar de forma eficiente tanto em servidores dedicados quanto em hospedagens compartilhadas (cPanel/aaPanel).

[![Laravel Version](https://img.shields.io/badge/Laravel-13-FF2D20?style=for-the-badge&logo=laravel)](https://laravel.com)
[![PHP Version](https://img.shields.io/badge/PHP-8.4-777BB4?style=for-the-badge&logo=php)](https://php.net)
[![AdminLTE 4](https://img.shields.io/badge/AdminLTE-4-accent?style=for-the-badge&logo=bootstrap)](https://adminlte.io)

---

## 🚀 Novidades da Versão 2.0 (Stable)

Esta atualização transforma o EducaGest em um ecossistema auditável e focado em produtividade mobile:

- **🛡️ Auditoria 360º**: Rastreamento completo de alterações (Created/Updated/Deleted) com histórico de "Antes e Depois".
- **📡 Hub de Comunicação Pro**: Integração com WhatsApp (Anti-Ban Engine) e SMTP Dinâmico para cada unidade.
- **📱 PWA Premium**: App instalável com cache offline, sincronização inteligente e pastas de mídia locais.
- **📊 Inteligência Analítica**: Dashboards dinâmicos com Timeline de Atividades em tempo real.
- **❓ Central de Ajuda HTML**: Nova documentação interativa com ilustrações 3D e diagramas de fluxo automáticos.
- **🛠️ Auto-Recuperação de Emergência**: Motor de bootstrap inteligente que detecta falhas de config, gera `APP_KEY` automaticamente e repara o `.env` sem intervenção técnica.

---

## 📖 Documentação Interativa

Acesse manuais de uso, fluxos técnicos e guias de integração diretamente no sistema:

👉 **[Visualizar Central de Ajuda](http://localhost:8000/ajuda)**

---

## 🛠️ Stack Tecnológica

| Componente | Tecnologia |
| :--- | :--- |
| **Backend** | Laravel 13 (PHP 8.4) |
| **Frontend** | AdminLTE 4 (Bootstrap 5.3), Vitest |
| **PWA** | Service Workers, Workbox, IndexedDB |
| **Comunicação** | WhatsApp (Evolution API), SMTP Dinâmico |
| **Segurança** | Multi-Tenancy (Scope Isolation), Auditoria Nativa |

---

## 📦 Estrutura de Módulos Operacionais

- **`app/Modules/Core`**: Fundação, Administração, PWA, Auditoria e Documentação.
- **`app/Modules/Academic`**: Gestão de Cursos, Turmas, Alunos, Chamadas e Notas.
- **`app/Modules/Financial`**: Cobranças, Pagamentos e Billing da Plataforma.
- **`app/Modules/Communication`**: Central de Mensageria (WhatsApp/Email).

---

## 🚀 Deploy & Instalação

### Ocultar `/public` da URL (Apache / cPanel)

O projeto inclui um `.htaccess` na **raiz** que redireciona automaticamente todo tráfego para `public/`. Basta apontar o domínio para a raiz do projeto — não é necessário configurar o Document Root manualmente.

> **Alternativa cPanel**: Se preferir, aponte o Document Root diretamente para `public/` nas configurações do domínio.

### Instalador Automático

Ao fazer o primeiro deploy, acesse qualquer URL do sistema — você será redirecionado automaticamente para `/instalacao`:

| Etapa | Descrição |
| :--- | :--- |
| **1. Requisitos** | Verifica PHP ≥ 8.3, extensões (PDO, mbstring, OpenSSL, cURL, XML, bcmath) e permissões de escrita |
| **2. Banco de Dados** | Testa conexão MySQL em tempo real e salva no `.env` |
| **3. SuperAdmin** | Roda migrations, seeders e cria a conta principal do sistema |
| **4. Conclusão** | Gera `storage/installed.lock` e libera o acesso ao sistema |

> ⚠️ Após a instalação, o acesso a `/instalacao` é bloqueado automaticamente. Para reinstalar, remova o arquivo `storage/installed.lock`.

### Checklist de Deploy

```bash
# 1. Clone ou faça git pull
git pull origin master

# 2. Instale dependências PHP (não precisa de npm)
composer install --no-dev --optimize-autoloader

# 3. Configure permissões
chmod -R 775 storage bootstrap/cache

# 4. Acesse o domínio → Instalador automático
```

---

## 📄 Licença

Este software é proprietário. Desenvolvido para uso exclusivo no ecossistema EducaGest.

---
**EducaGest** - *A inteligência que transforma a educação.*

