# Guía de Contribución - CampaignHub
¡Gracias por tu interés en contribuir a CampaignHub! 🎉
## 🤝 Código de Conducta
Este proyecto sigue un Código de Conducta. Al participar, esperamos que lo respetes.
- Sé respetuoso y constructivo
- Acepta críticas constructivas
- Enfócate en lo que es mejor para la comunidad
- Muestra empatía hacia otros miembros
## 🐛 Reportar Bugs
### Antes de Reportar
1. Verifica que no sea un bug ya reportado en [Issues](https://github.com/tu-org/campaignhub/issues)
2. Asegúrate de estar usando la última versión
3. Intenta aislar el problema
### Cómo Reportar
Abre un issue con:
- **Título claro**: Describe el problema en pocas palabras
- **Descripción**: Explica qué esperabas y qué ocurrió
- **Pasos para reproducir**:
1. Ir a '...'
2. Hacer click en '...'
3. Ver error
- **Contexto**:
- Versión de PHP: `php -v`
- Versión de Node: `node -v`
- Sistema operativo
- Navegador (si aplica)
- **Screenshots**: Si es visual, adjunta capturas
- **Logs**: Incluye `storage/logs/laravel.log` relevantes
## ✨ Proponer Features
Para proponer nuevas funcionalidades:
1. Abre un issue con tag `feature request`
2. Describe el problema que resuelve
3. Propón una solución
4. Explica casos de uso
5. (Opcional) Mockups o wireframes
## 💻 Contribuir Código
### Setup de Desarrollo
1. Fork el repositorio
2. Clona tu fork:
```bash
git clone https://github.com/TU_USUARIO/campaignhub.git
cd campaignhub
```
3. Instala dependencias:
```bash
composer install
npm install
```
4. Crea una rama para tu feature:
```bash
git checkout -b feature/nombre-descriptivo
```
### Estándares de Código
#### Backend (PHP/Laravel)
- **PSR-12**: Sigue el estándar PSR-12
- **Pint**: Ejecuta antes de commit
```bash
./vendor/bin/pint
```
- **Type hints**: Siempre que sea posible
- **Docblocks**: Para métodos públicos
- **Tests**: Toda funcionalidad debe tener tests
**Ejemplo:**
```php
is_active) {
return false;
}
return $user->update(['is_active' => true]);
}
}
```
#### Frontend (Vue 3/TypeScript)
- **ESLint**: Ejecuta antes de commit
```bash
npm run lint
```
- **TypeScript**: Tipado estricto
- **Composition API**: Preferir `
```
### Commits
Usamos [Conventional Commits](https://www.conventionalcommits.org/):
```
():