Petrohaus

Encuentra los mejores precios de combustibles en tu zona

---

Prerrequisitos

• Nix (con Flakes habilitado): Instalar Nix
  • Habilitar Flakes: mkdir -p ~/.config/nix && echo 'experimental-features = nix-command flakes' >> ~/.config/nix/nix.conf
• Docker y Docker Compose: Instalar Docker
• (Opcional) direnv: Para cargar el entorno automáticamente con .envrc

---

Uso

Desarrollo local (Nix)

1. Entra al entorno de desarrollo:

   nix develop

   O, si usas direnv, solo entra a la carpeta del proyecto y ejecuta direnv allow.
2. Copia el archivo .env.example a .env y configura las variables de entorno.

   cp .env.example .env

3. Inicia los contenedores de PostgreSQL y Buggregator:

   docker compose up -d

4. Instala las dependencias de PHP y Node:

   composer install
   npm install

5. Inicia el servidor de Laravel y el servidor de desarrollo de Vite:

   composer run dev

   Esto ejecuta PHP, la cola, logs y Vite de forma concurrente.
6. Accede a la app en http://localhost:8080

Desarrollo local (Docker)

• La app estará disponible en http://localhost:8080
• La base de datos corre en localhost:5432 (ver docker-compose.yml para credenciales)

Git Hooks

• Al iniciar por primera vez, el entorno Nix ejecuta bin/setup-hooks.sh para instalar un pre-commit hook que corre Pint y PHPStan. Esto no es necesario si se usa direnv.

---

Proceso CI/CD

• El workflow de GitHub Actions corre en pushes y PRs a las ramas main y feature/*.
• Los pasos incluyen:
  • Instalar Nix
  • Instalar dependencias (composer install, npm install)
  • Ejecutar Pint (estilo de código PHP)
  • Ejecutar PHPStan (análisis estático)
• Ver .github/workflows/ci.yml para más detalles.

---