Sistema de Gestão - Marketplace SaaS

📋 Sobre o Projeto

Sistema de Gestão desenvolvido em Laravel para conectar profissionais e clientes em um marketplace SaaS. O projeto segue as melhores práticas de desenvolvimento com foco em segurança, performance e escalabilidade.

🚀 Tecnologias Utilizadas

• Backend: Laravel 12.x (PHP 8.2+)
• Frontend: Tailwind CSS 3.x
• Banco de Dados: MySQL 8.0
• Pagamentos: Mercado Pago API
• Comunicação: WhatsApp-web.js
• Autenticação: Laravel Sanctum
• Documentação: DomPDF
• Imagens: Intervention Image

📦 Dependências Principais

Produção

• laravel/framework: ^12.0
• laravel/sanctum: ^4.2
• barryvdh/laravel-dompdf: ^3.1
• intervention/image: ^3.11
• maatwebsite/excel: ^3.1

Desenvolvimento

• laravel/breeze: ^2.3
• laravel/pint: ^1.24
• phpunit/phpunit: ^11.5.3

🛠️ Instalação

Pré-requisitos

• PHP 8.2 ou superior
• Composer
• Node.js e NPM
• MySQL 8.0
• Git

Passos de Instalação

1. Clone o repositório

git clone https://github.com/dellirios/GestaoEventos.git
cd GestaoEventos

2. Instale as dependências do PHP

composer install

3. Instale as dependências do Node.js

npm install

4. Configure o ambiente

cp .env.example .env
php artisan key:generate

5. Configure o banco de dados Edite o arquivo .env com suas configurações de banco:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=gestao_marketplace
DB_USERNAME=seu_usuario
DB_PASSWORD=sua_senha

6. Execute as migrações

php artisan migrate

7. Execute os seeders (opcional)

php artisan db:seed

8. Compile os assets

npm run build

9. Inicie o servidor de desenvolvimento

php artisan serve

🏗️ Estrutura do Projeto

app/
├── Http/
│   ├── Controllers/
│   │   ├── Api/           # APIs REST
│   │   ├── Auth/          # Autenticação
│   │   └── Web/           # Controllers web
│   ├── Middleware/        # Middlewares customizados
│   ├── Requests/          # Form Requests
│   └── Resources/         # API Resources
├── Models/                # Eloquent Models
├── Services/              # Lógica de negócio
├── Repositories/          # Padrão Repository
└── Jobs/                  # Filas e processamento

🎯 Funcionalidades Principais

Para Clientes

• ✅ Cadastro e autenticação
• ✅ Busca de profissionais por localização
• ✅ Criação de trabalhos/projetos
• ✅ Sistema de propostas
• ✅ Pagamentos via Mercado Pago
• ✅ Sistema de avaliações

Para Profissionais

• ✅ Perfil profissional completo
• ✅ Portfólio de trabalhos
• ✅ Envio de propostas
• ✅ Gestão de trabalhos
• ✅ Recebimento de pagamentos
• ✅ Histórico de transações

Administrativo

• ✅ Dashboard de gestão
• ✅ Controle de usuários
• ✅ Relatórios financeiros
• ✅ Sistema de comissões
• ✅ Monitoramento de transações

🔒 Segurança

• Validação de dados: Form Requests em todas as entradas
• Autenticação: Laravel Sanctum com tokens seguros
• Autorização: Middleware customizado para controle de acesso
• Proteção CSRF: Habilitada em todos os formulários
• Sanitização: Limpeza de dados de entrada
• Criptografia: Senhas com bcrypt e dados sensíveis criptografados

💳 Integração Mercado Pago

O sistema possui integração completa com Mercado Pago para:

• Processamento de pagamentos
• Retenção automática de comissões
• Sistema de custódia
• Repasse automático aos profissionais
• Webhooks para notificações

📱 Responsividade

• Mobile First: Desenvolvimento iniciando pela versão mobile
• Breakpoints: Suporte completo para todos os dispositivos
• Tailwind CSS: Framework CSS utilitário para desenvolvimento ágil

🧪 Testes

Execute os testes com:

php artisan test

Para testes com cobertura:

php artisan test --coverage

📊 Performance

• Consultas otimizadas: Uso de Eloquent com eager loading
• Cache: Sistema de cache para consultas frequentes
• Índices: Banco de dados otimizado com índices estratégicos
• Compressão: Assets minificados e comprimidos

🚀 Deploy

Produção

1. Configure as variáveis de ambiente de produção
2. Execute composer install --optimize-autoloader --no-dev
3. Execute npm run build
4. Configure o servidor web (Apache/Nginx)
5. Configure SSL/HTTPS
6. Configure backups automáticos

Variáveis de Ambiente Importantes

APP_ENV=production
APP_DEBUG=false
APP_URL=https://seudominio.com

# Mercado Pago
MERCADOPAGO_ACCESS_TOKEN=seu_token_producao
MERCADOPAGO_PUBLIC_KEY=sua_chave_publica

# WhatsApp
WHATSAPP_SESSION_PATH=caminho_sessao

📝 Padrões de Código

O projeto segue rigorosamente os padrões estabelecidos:

• PSR-12: Padrão de codificação PHP
• Nomenclatura: Classes em PascalCase, métodos em camelCase
• Comentários: PHPDoc obrigatório em métodos públicos
• Arquitetura: MVC com Services e Repositories
• Validação: Form Requests para todas as entradas

🤝 Contribuição

1. Faça um fork do projeto
2. Crie uma branch para sua feature (git checkout -b feature/nova-funcionalidade)
3. Commit suas mudanças (git commit -am 'Adiciona nova funcionalidade')
4. Push para a branch (git push origin feature/nova-funcionalidade)
5. Abra um Pull Request

Regras de Contribuição

• Seguir os padrões de código estabelecidos
• Escrever testes para novas funcionalidades
• Documentar código complexo
• Validar segurança em mudanças sensíveis

📄 Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

📞 Suporte

Para suporte técnico ou dúvidas sobre o projeto:

• Email: suporte@seudominio.com
• Documentação: [Link para documentação completa]
• Issues: Use o sistema de issues do GitHub

🔄 Versionamento

Utilizamos Semantic Versioning para versionamento. Para as versões disponíveis, veja as tags neste repositório.

📈 Roadmap

Próximas Funcionalidades

• Sistema de chat em tempo real
• Notificações push
• App mobile (React Native)
• Integração com outros gateways de pagamento
• Sistema de afiliados
• API pública para integrações

---

Desenvolvido com ❤️ usando Laravel Framework