🤝 Guía para Contribuidores

¡Gracias por tu interés en colaborar con Koneko ERP! Este proyecto busca ofrecer una suite profesional de administración web y ERP orientado al mercado mexicano y LATAM, bajo licencia Business Source License 1.1 con transición futura a MIT.

📌 Requisitos básicos

Conocimiento de PHP 8.2+ y Laravel 11
Respeto por las buenas prácticas, código limpio y trabajo en equipo
Preferentemente, experiencia en:
- Livewire
- Spatie Permissions & Roles
- Laravel Fortify y Sanctum
- Desarrollo modular con Composer

🌱 Primeros pasos

Forkea este repositorio y clónalo localmente.
Instala las dependencias con Composer:
```
composer install
```
Copia el archivo .env.example a .env y ajusta tus credenciales locales:
```
cp .env.example .env
php artisan key:generate
```
Ejecuta las migraciones y seeders (si aplica):
```
php artisan migrate --seed
```
Inicia el servidor:
```
php artisan serve
```

📀 Convenciones del Proyecto

Antes de contribuir, asegúrate de leer nuestras 📁 Convenciones de Componentes, donde definimos estructura de carpetas, estilo de código y otras buenas prácticas clave para mantener la consistencia del ecosistema Koneko ERP.

📝 Código de Conducta

Consulta nuestro Código de Conducta para conocer las expectativas y reglas que garantizan un ambiente colaborativo, profesional y respetuoso.

🚀 ¡Listo para colaborar!

Una vez que tengas tu entorno configurado:

Busca issues etiquetados como good first issue o help wanted
Lee el archivo CONTRIBUTING.md del módulo específico si estás trabajando en un subpaquete
No olvides seguir las convenciones de estilo PSR-12 y usar php-cs-fixer si lo tienes disponible

Gracias por ser parte de Koneko ERP 💙 ¡Esperamos tu contribución!

2.0 KiB Raw Blame History