Paco Librery

Este es un sistema de gestión de librerías desarrollado en PHP sin el uso de frameworks. Utiliza Docker para manejar el entorno de desarrollo con Apache y PostgreSQL.

Requisitos

Asegúrate de tener Docker instalados en tu sistema. Despues de esto recuerda que es importante ejecutar Docker para su funcionamiento

Configuración del Proyecto

---

Antes de ejecutar el contenedor, realiza los siguientes ajustes:

1. Cambia el formato de salto de línea en Visual Studio Code

Esto es necesario para asegurarte de que los archivos tengan saltos de línea compatibles con entornos Linux (LF).

1. Abre Visual Studio Code.
2. Ve a: Archivo > Preferencias > Configuración.
3. En la barra de búsqueda, escribe eol.
4. Encuentra la configuración Files: Eol y cámbiala de auto a \n (LF).

---

2. Configura los saltos de línea en Git

Esto evita que Git convierta los saltos de línea automáticamente al formato CRLF al clonar o extraer repositorios.

1. Abre una terminal Git.
2. Ejecuta el siguiente comando:

   git config --global core.autocrlf input
   

   Esto asegura que Git conserve los saltos de línea en el formato original (LF) del repositorio.

---

---

1. Clonar el repositorio:

   git clone <URL del repositorio>
   cd Paco-librery
   

1.1. Da permisos de ejecución al archivo entrypoint.sh

Esto es necesario para que el archivo entrypoint.sh pueda ejecutarse dentro del contenedor.

1. Abre una terminal en Visual Studio Code.

2. Asegurate que la terminal sea bash

3. Asegúrate de estar en el directorio raíz de tu proyecto.

4. Ejecuta el siguiente comando:

   chmod +x ./docker/entrypoint.sh
   

   Esto asignará permisos de ejecución al archivo.

5. Crear el archivo de entorno: Crea un archivo .env en la raíz del proyecto con las siguientes variables de entorno:

   # Configuración general del entorno
   APP_ENV=
   APP_DEBUG=
   
   # Configuración de la base de datos
   DB_CONNECTION=
   DB_HOST=
   DB_PORT=
   DB_DATABASE=
   DB_USERNAME=
   DB_PASSWORD=
   
   

Configuración de Entornos

• Desarrollo: Configura APP_ENV=development y APP_DEBUG=true en .env para ver los errores y advertencias.
• Producción: Cambia a APP_ENV=production y APP_DEBUG=false para ocultar errores y advertencias en el entorno de producción.

3. Si es la primera vez iniciando Docker, ejecuta este comando:

   docker-compose up --build
   

4. Iniciar los contenedores: Ejecuta el siguiente comando para iniciar el entorno:

   docker-compose up -d
   

5. Acceder al proyecto: Una vez que los contenedores estén en ejecución, abre el navegador y accede a la URL:

   • http://localhost:8000

6. Ejecutar migraciones de la base de datos: Las migraciones se ejecutan automáticamente al iniciar el contenedor. Si deseas ejecutarlas manualmente, usa el archivo src/migrations/init.sql.

7. Apagar el proyecto: Para detener los contenedores, ejecuta:

   docker-compose down
   

8. Las ramas que se estan utilizando se pueden activar con:

git checkout -b Desarrollo remotes/origin/Desarrollo

Se tendria que navegar dependiendo de lo que se quiera programar

## Estructura de Carpetas

- **src/public/**: Contiene los archivos frontend (HTML, CSS, JS) y el archivo `home.php`.
- **src/app/**: Contiene la lógica de backend, organizada en controladores, modelos, vistas y helpers.
- **src/config/**: Configuración del proyecto, incluyendo la conexión a la base de datos.
- **docker/**: Archivos de configuración de Docker, como el Dockerfile y configuraciones de Apache.
- **logs/**: Carpeta para almacenar los logs de Apache y PHP.

## Acceso a Logs

- **Apache logs**: Los logs de Apache se encuentran en `logs/apache/`.
- **PHP logs**: Los logs de PHP están en `logs/php/`.
- Estos logs son útiles para depurar y solucionar problemas en el proyecto.

## Notas

- La base de datos persiste en un volumen llamado `db_data`, por lo que los datos no se perderán cuando se apaguen los contenedores.
- Cualquier cambio en la carpeta `src` se refleja automáticamente en el contenedor.


---

# Guía para Mantener las Ramas Actualizadas sin Conflictos

## 1. **Usar `git fetch` para Traer Cambios sin Fusionarlos Automáticamente**

El comando `git fetch` permite traer los últimos cambios del repositorio remoto sin aplicarlos automáticamente en las ramas locales. Esto es útil para revisar los cambios antes de fusionarlos y evitar conflictos inesperados.

git fetch origin

Esto actualizará la referencia de las ramas remotas en tu repositorio local (como `origin/busqueda-libro`, `origin/develop`, etc.) sin modificar tus ramas locales.

---

## 2. **Verificar los Cambios en las Ramas Remotas**

Para inspeccionar los cambios antes de aplicarlos, puedes comparar tus ramas locales con las versiones en el remoto. Esto es útil para identificar posibles conflictos antes de la fusión.

git diff origin/

Ejemplo para la rama `develop`:

git diff develop origin/develop

---

## 3. **Fusionar los Cambios con `rebase` en Lugar de `merge`**

Utilizar `rebase` en lugar de `merge` ayuda a mantener un historial de cambios más limpio y facilita la resolución de conflictos. Sigue estos pasos para actualizar tu rama:

1. Cambia a la rama local que deseas actualizar:

git checkout

2. Usa `rebase` para aplicar los cambios de la rama remota:

git rebase origin/

Ejemplo para `develop`:

git checkout develop #esto es para moverte entre las ramas que existen en este caso develop git rebase origin/develop

Si hay conflictos, Git solicitará que los resuelvas uno por uno. Después de resolver cada conflicto, usa:

git add git rebase --continue

Si deseas abortar el rebase en cualquier momento, puedes usar:

```b
git rebase --abort

---

4. Trabajar en Ramas de Características (Feature Branches)

Evita trabajar directamente en las ramas principales como main o develop. En su lugar, utiliza ramas de características (feature branches) para cada tarea específica, por ejemplo, busqueda-libro o registro-cliente. Esto permite que los cambios se prueben y validen antes de fusionarlos en las ramas principales.

---

5. Pruebas Locales Antes de Hacer push al Remoto

Antes de subir tus cambios al repositorio remoto:

1. Asegúrate de que todo funcione correctamente en tu entorno local.
2. Haz un último git fetch y git rebase en tu rama de trabajo para asegurarte de que tienes la última versión del remoto y evitar conflictos de último momento.

Para subir tus cambios:

git push origin <rama-local>

---

Ejemplo Completo del Flujo de Trabajo

Aquí tienes un ejemplo del flujo completo, usando la rama busqueda-libro como ejemplo:

1. Trae los cambios del remoto:

   git fetch origin
   

2. Rebasa tu rama busqueda-libro sobre develop del remoto para mantenerla actualizada:

   git checkout busqueda-libro
   git rebase origin/develop
   

3. Resuelve cualquier conflicto si es necesario, luego:

   git add <archivo-con-conflicto>
   git rebase --continue
   

4. Finalmente, sube tus cambios:

   git push origin busqueda-libro
   

---

Siguiendo estos pasos, el equipo puede mantener el repositorio sincronizado y minimizar los conflictos en el proceso de colaboración. Si tienes dudas, consulta con el equipo antes de proceder.

---

Proyecto realizado por:

• Martin Gomez - GitHub
• Anilys Rodriguez - GitHub
• Mariangel Santos - GitHub
• Isabel Flores - GitHub
• Sebastian Herrera - GitHub
• Luis Montenegro - GitHub