Proyecto desarrollado para la gestión administrativa de usuarios, implementando autenticación (Login/Registro) con Laravel Breeze y una interfaz CRUD completa para administradores, utilizando PostgreSQL como base de datos.
- Tecnología: Laravel 11+
- Base de Datos: PostgreSQL
- Frontend: Blade & Tailwind CSS (con Vite)
- Seguridad: Autenticación completa (Login, Registro, Recuperación de Contraseña) y protección CSRF.
- Administración: CRUD completo para la entidad
User(/users).
Asegúrate de tener instalado el siguiente software antes de comenzar:
- PHP: Versión 8.2 o superior
- Composer: Última versión estable
- Node.js & npm: (Para la compilación de Tailwind CSS)
- PostgreSQL: Servidor de base de datos operativo.
Sigue estos pasos para poner la aplicación en funcionamiento en tu entorno local.
Si aún no tienes el proyecto, clónalo desde GitHub:
git clone [URL_DE_TU_REPOSITORIO]
cd [name_project] Debes configurar la clave de seguridad y la conexión a la base de datos.
- Crear el archivo
.env: Copia la plantilla de configuración.cp .env.example .env
- Generar la Clave de Aplicación:
php artisan key:generate
- Configurar PostgreSQL: Abre el archivo
.envy ajusta las variables de conexión a tu servidor local de PostgreSQL (Host, Puerto, Base de Datos, Usuario y Contraseña).
Instala las dependencias de PHP y JavaScript/CSS:
composer install
npm installEjecuta las migraciones para crear las tablas y luego inserta el usuario administrador de prueba.
- Ejecutar Migraciones: Crea la tabla
usersy las tablas de autenticación.php artisan migrate
- Ejecutar Seeder de Administrador: Inserta el usuario por defecto.
(Ver las credenciales del Seeder en la sección de Usuarios de Prueba).
php artisan db:seed --class=AdminUserSeeder
Para correr la aplicación, debes tener dos terminales abiertas:
php artisan serveNOTA: Mantén este comando corriendo. Si lo cierras, los estilos de Tailwind CSS no se cargarán.
npm run devUna vez que ambos servidores estén activos, puedes acceder a la aplicación en http://127.0.0.1:8000.
Para acceder a la funcionalidad de administración, inicia sesión con el usuario creado por el Seeder:
| Rol | Correo Electrónico | Contraseña |
|---|---|---|
| Administrador | admin@example.com |
password |
La gestión de usuarios CRUD se encuentra en la ruta /users (solo accesible después de iniciar sesión).
Aquí se listan los comandos clave utilizados para la construcción de este proyecto.
| Comando/Tarea | Propósito |
|---|---|
php artisan breeze:install |
Instalación del scaffolding de Login/Registro/Vistas. |
php artisan make:controller UserController --resource |
Creación del controlador con los 7 métodos CRUD. |
php artisan make:seeder AdminUserSeeder |
Creación del archivo para insertar el usuario administrador. |
| Protección de Rutas | La ruta Route::resource('users', ...) está envuelta en el middleware auth para redirigir al Login. |