Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/amarcano568/pensionalamedida/llms.txt

Use this file to discover all available pages before exploring further.

En esta guía pondrás en marcha una instancia local de Pensión a la Medida desde cero. Al finalizar tendrás el servidor de desarrollo corriendo en http://localhost:8000, la base de datos migrada y un usuario administrador listo para iniciar sesión. Necesitarás acceso a una terminal y permisos para instalar dependencias en tu máquina.

Requisitos previos

Asegúrate de tener instaladas las siguientes herramientas antes de comenzar:
  • PHP ^7.2.5 con las extensiones mbstring, openssl, pdo, pdo_mysql y tokenizer habilitadas
  • MySQL 5.7+ (o MariaDB equivalente) con un usuario con permisos para crear bases de datos
  • Composer (gestor de dependencias PHP)
  • Node.js + npm para compilar los assets del frontend (Bootstrap 4, Sass, jQuery)

1

Clonar el repositorio

Descarga el código fuente en tu máquina local y entra al directorio del proyecto:
git clone https://github.com/amarcano568/pensionalamedida.git && cd pensionalamedida
2

Instalar dependencias PHP

Instala todos los paquetes definidos en composer.json (Laravel 7, Spatie Permission, DomPDF, DataTables, etc.):
composer install
3

Instalar dependencias JS

Instala los paquetes de Node.js y compila los assets del frontend con Laravel Mix:
npm install && npm run dev
Durante el desarrollo ejecuta npm run watch en lugar de npm run dev para que Laravel Mix recompile automáticamente los assets cada vez que modifiques un archivo CSS o JavaScript.
4

Configurar el entorno

Copia el archivo de ejemplo y ábrelo para editar las variables de conexión a la base de datos:
cp .env.example .env
Edita las siguientes claves en el archivo .env recién creado:
.env
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=pensionalamedida
DB_USERNAME=tu_usuario
DB_PASSWORD=tu_contraseña
Luego genera la clave de aplicación de Laravel:
php artisan key:generate
5

Ejecutar las migraciones

Crea las tablas de la base de datos (asegúrate de que la base de datos indicada en DB_DATABASE ya existe en MySQL):
php artisan migrate
6

Crear el usuario administrador

Abre la consola interactiva de Artisan para crear el primer usuario y asignarle el rol de administrador usando Spatie Laravel Permission:
php artisan tinker
Dentro de la sesión de Tinker, ejecuta:
$user = App\User::create([
    'name'     => 'Administrador',
    'email'    => 'admin@pensionalamedida.test',
    'password' => bcrypt('tu_contraseña_segura'),
]);

$user->assignRole('Administrator');
El registro de nuevos usuarios está desactivado por defecto en routes/web.php (Auth::routes(['register' => false])). Todas las cuentas deben crearse a través de Artisan Tinker o mediante un seeder de base de datos.
7

Iniciar el servidor de desarrollo

Levanta el servidor integrado de PHP con Artisan:
php artisan serve
Abre tu navegador y accede a:
http://localhost:8000
Inicia sesión con las credenciales del usuario creado en el paso anterior y comenzarás a ver el panel principal de Pensión a la Medida.

Build docs developers (and LLMs) love