Saltar al contenido
Facturador

Instalación en Windows

Guía paso a paso para instalar y ejecutar el sistema de facturación en Windows.


Requisitos Previos

Versiones necesarias para el facturador Pro 9:

Tecnología Versión
PHP 8.2
MySQL 5.7 o superior (o MariaDB)
Laravel 9
Node 18

Instalación de Herramientas

1. Laragon

Laragon es el entorno de desarrollo que utilizaremos para ejecutar el facturador.

Descargar: laragon.org/download


2. PHP

Descarga

Acceda al repositorio oficial: Repositorio PHP

Versión recomendada: la última 8.2 para Windows x64 Thread Safe (archivo php-8.2.XX-Win32-vs16-x64.zip). Es la misma rama de PHP que usan los servidores en producción.

Instalación

  1. Descargue el archivo ZIP de PHP

  2. Navegue hasta la carpeta de Laragon: C:\laragon\bin\php

    Carpeta bin

  3. Copie el archivo ZIP dentro de la carpeta php y extraiga usando "Extraer en..."

    Descomprimir PHP

  4. Configure esta versión como predeterminada en Laragon:

    Versión por defecto


3. MySQL

Descarga

Acceda al repositorio oficial: MySQL Archives

Versión recomendada: mysql-8.0.30-winx64.zip

Instalación

  1. Descargue el archivo ZIP de MySQL

    Instalación MySQL

  2. Navegue hasta: C:\laragon\bin\mysql

    Carpeta bin

  3. Copie el archivo ZIP dentro de la carpeta mysql y extraiga usando "Extraer aquí"

    Descomprimir MySQL

  4. Configure esta versión como predeterminada en Laragon:

    MySQL por defecto


Configuración de Laragon

Extensión SOAP

Verifique que la extensión SOAP esté activada en el archivo php.ini:

Extensión SOAP

⚠️ IMPORTANTE: Esta extensión es necesaria para la creación de facturas. Si no está activada, algunas funciones fallarán.


Servicios y Puertos

Si experimenta conflictos de puertos, puede cambiarlos desde:

Laragon → ⚙️ → Servicios & Puertos

Servicios y Puertos


Hostname

Configure el dominio local según su preferencia. Por ejemplo: {name}.test, {name}.pe, {name}.oo

Dominios


Instalación del Proyecto

Paso 1: Abrir Terminal

Abra Laragon y haga clic en Terminal. Trabajará dentro de la carpeta C:\laragon\www

Terminal


Paso 2: Clonar el Proyecto

  1. En la terminal, ejecute:

    git clone https://git.buho.la/facturaloperu/facturador/pro9.git
    
  2. Ingrese su usuario y contraseña (o token) de GitLab cuando se le solicite.


Paso 3: Crear Base de Datos

⚠️ Precaución: Antes de continuar, verifique que no haya otros servicios de MySQL ejecutándose en su máquina. Detenga cualquier servicio MySQL activo antes de proceder.

  1. En Laragon, haga clic en Base de datos

    Base de datos

  2. Seleccione una sesión y presione "Abrir"

    Sesión

    Si no tiene una sesión, créela con el botón "Nueva"

  3. Cree una nueva base de datos:

    • Haga clic derecho en el nombre de la sesión
    • Seleccione la opción para crear base de datos

    Crear DB

💡 Importante: Recuerde el nombre de su base de datos, lo necesitará más adelante.


Paso 4: Configurar el Proyecto

  1. Verifique que esté en la carpeta correcta con el comando ls

  2. Ingrese a la carpeta del proyecto:

    cd pro9
    
  3. Cree el archivo de configuración:

    cp .env.example .env
    
  4. Edite el archivo .env y modifique estas variables:

    APP_URL_BASE=pro9.test
    

    Reemplace pro9 por el nombre de su carpeta y .test según su configuración de Hostname

    DB_DATABASE=nombre_de_su_base_de_datos
    

    Ingrese el nombre de la base de datos creada en el Paso 3


Paso 5: Instalar Dependencias

Ejecute el siguiente comando:

composer install

Paso 6: Configurar el Proyecto

Ejecute estos comandos uno por uno:

php artisan key:generate
composer dump-autoload
php artisan migrate --seed
php artisan storage:link

Paso 7: Iniciar el Servidor

En Laragon, presione el botón "Iniciar todo"

Apache

Esto iniciará el servidor Apache y MySQL.


Paso 8: Acceder al Sistema

  1. En Laragon, haga clic derecho y seleccione la opción "www"

    Ingresar web

  2. Se abrirá la página de login. Use estas credenciales:

    Correo electrónico: admin@gmail.com
    Contraseña: 123456

    Pantalla de acceso del administrador de Pro 9


✅ Instalación Completada

El sistema ya está listo para usar. Si experimenta algún problema, revise cada paso cuidadosamente o contacte al soporte técnico.


Sistema de Facturación Pro 8