Saltar al contenido principal
Version: QrBuho

Instalación en Windows

Este documento detalla cómo instalar el módulo de reseller desde cero utilizando CMD y la terminal de Laragon. Sigue cada paso cuidadosamente para garantizar una instalación correcta.

Requisitos Previos​

Antes de comenzar, asegúrate de descargar e instalar las siguientes versiones:

Clonar el Repositorio​

Abre CMD y ejecuta:

git clone https://gitlab.buho.la/qr-api/app.git
cd APP

Crear el Archivo de Configuración .env​

Copia el archivo de configuración de ejemplo:

cp .env.example .env

Instalar Dependencias del Backend​

Abre la terminal de Laragon y ejecuta:

composer install

Configurar el Entorno de Node.js​

Ejecuta los siguientes comandos en CMD:

nvm use 22.2.0
npm install -g pnpm
pnpm install

Generar Clave de Aplicación​

Ejecuta en la terminal de Laragon:

php artisan key:generate

Configurar la Base de Datos​

  1. Crea una base de datos en MySQL.
  2. Abre el archivo .env y actualiza la variable DB_DATABASE con el nombre de tu base de datos.

Aplicar Migraciones y Poblar la Base de Datos​

Ejecuta en la terminal de Laragon:

php artisan config:cache  # Refrescar configuración
php artisan migrate --seed  # Migrar base de datos con datos iniciales

Configurar Passport para Autenticación​

Ejecuta en la terminal de Laragon:

php artisan passport:keys

Este comando generará dos archivos en storage:

  • oauth-private.key
  • oauth-public.key

Copia su contenido y pégalo en el archivo .env:

PASSPORT_PRIVATE_KEY="(contenido de oauth-private.key)"
PASSPORT_PUBLIC_KEY="(contenido de oauth-public.key)"

Después, actualiza la configuración del proyecto:

php artisan config:cache

Luego, genera un cliente personal de Passport:

php artisan passport:client --personal

Cuando se te pida un nombre, introduce Personal Access Client.

Levantar el Servidor​

Ejecuta en CMD:

pnpm run dev

Acceder al Proyecto​

Abre tu navegador y accede a:

http://app.test/dashboard

Configurar la API​

Dentro del sistema, ve a Configuraciones e ingresa:

  • URL API: https://apievo.qr.buho.la
  • Clave API: gKj07HH4IU7L

Crear un Plan y una Cuenta de Empresa​

Desde el dashboard del reseller, crea un Plan y una Cuenta de Empresa.

nota

Para mejor conocimiento, revisar las secciones de Crear Planes y Crear Cuentas de Empresa

Configurar el Dominio del Cliente​

Edita el archivo hosts en:

C:\Windows\System32\drivers\etc\hosts

Agrega la URL del cliente:

127.0.0.1 demo.app.test
127.0.0.1 admin.app.test

Con estos pasos, el módulo reseller estará correctamente instalado y listo para su uso. 🚀