Busbot
Pasos para ejecutar correctamente la aplicación.
1. Clonar el Repositorio
Primero, clonar el repositorio
2. Navegar a la Carpeta del Repositorio
Después de clonar el repositorio, navegar a la carpeta del proyecto
cd busbot
3. Instalar Dependencias de Composer
Ejecutar el siguiente comando para instalar las dependencias del proyecto
composer install
4. Instalar Dependencias de Node.js
Ejecutar el siguiente comando para instalar las dependencias de JavaScript
npm install
5. Configurar el Archivo de Entorno
Copiar el archivo de entorno de ejemplo .env.example a un nuevo archivo .env
cp .env.example .env
6. Generar la Clave de la Aplicación
Ejecutar el siguiente comando para generar una nueva clave de aplicación Laravel
php artisan key:generate
7. Configurar el Archivo .env
Abrir el archivo .env y configurar las variables necesarias como la conexión a la base de datos.
8. Migrar la Base de Datos
Ejecutar las migraciones de la base de datos para crear las tablas necesarias
php artisan migrate
9. Compilar los Activos Frontend
Compilar los activos frontend con Laravel
npm run dev
10. Ejecutar el Servidor de Desarrollo
Ejecutar el servidor de desarrollo de Laravel
php artisan serve
Esto iniciará un servidor en http://localhost:8000 donde se podrá ver la aplicación en funcionamiento.
11. Acceder a la Aplicación
Abrir el navegador e ingresar a http://localhost:8000 para ver la aplicación en funcionamiento.
Estructura del Flujo de Trabajo
Ramas
main
: Rama principal que contiene el código de producción.
develop
: Rama para desarrollo, donde se integran los cambios de diferentes ramas de características.
feature/nombre-feature
: Ramas individuales para nuevas características o funcionalidades.
bugfix/nombre-bug
: Ramas individuales para corrección de errores.
Pull Requests
- Las nuevas características y correcciones se desarrollan en ramas individuales.
- Una vez completados, se abre un pull request (PR) hacia
develop
.
- El PR debe ser revisado y aprobado por al menos un miembro del equipo antes de fusionarse.
Integración Continua (CI)
- Usamos GitHub Actions para ejecutar pruebas automatizadas y análisis de código en cada push y PR.
- El archivo de configuración se encuentra en
.github/workflows/ci.yml
.
Entrega Continua (CD)
- Las nuevas versiones se despliegan automáticamente cuando se fusiona código en la rama
main
.
- Los scripts de despliegue se encuentran en la carpeta
scripts/deploy
.
Gestión de Proyectos
- Usamos GitHub Issues para rastrear errores y tareas.
- Los proyectos se gestionan con GitHub Projects usando la metodología Kanban.
Documentación
- La documentación del proyecto se encuentra en el archivo
README.md
.
- Documentación adicional y detallada se encuentra en el wiki del repositorio.
Contribución
- Por favor, revisa el archivo
CONTRIBUTING.md
para obtener directrices sobre cómo contribuir al proyecto.
- Todas las contribuciones deben pasar por un proceso de revisión de código.
Seguridad
- Las ramas principales están protegidas para evitar fusiones directas sin revisiones.
- Usamos GitHub Advanced Security para escanear vulnerabilidades en el código y las dependencias.