ims-laravel-admin-starter
es un panel de administración optimizado y una aplicación de inicio de API creada utilizando el potente marco Laravel 10 y Filment 3.
Nuestro objetivo principal es brindarle un proyecto inicial de desarrollo local listo para usar y sin complicaciones.
A diferencia de los generadores de API o generadores de código tradicionales, este proyecto simplifica el proceso de configuración de su entorno de desarrollo local. Le permite impulsar el desarrollo de su API basada en Laravel y el desarrollo del panel de administración sin complejidades innecesarias. Esto le permite concentrarse en desarrollar la lógica de su aplicación en lugar de perder tiempo en la configuración inicial.
Sistema de autenticación completo : implemente un sistema de autenticación sólido utilizando el paquete Laravel Jetstream para una gestión segura de usuarios y una funcionalidad de inicio de sesión.
Sistema de autorización basado en roles y permisos : cree un sistema de autorización flexible utilizando el paquete Laravel-Permission, que le permite definir roles y permisos para un control de acceso detallado.
Gestión de usuarios : administre los usuarios de manera eficiente, incluido el registro de usuarios, las actualizaciones de perfiles y las funciones de los usuarios.
Configuración de perfil : permite a los usuarios personalizar sus perfiles, incluida información personal y preferencias.
Soporte en múltiples idiomas : haga que su aplicación sea accesible para una audiencia global con la ayuda de los paquetes Filament Translations y Laravel Lang para soporte multilingüe.
Personalización del tema : personalice la apariencia de la aplicación y la interfaz de usuario utilizando el poder de Tailwind CSS para crear diseños visualmente atractivos.
Soporte Docker : implemente y administre fácilmente su aplicación en un contenedor Docker con la conveniencia de Laravel Sail para flujos de trabajo de implementación y desarrollo optimizados.
Elija su herramienta de desarrollo local:
Seleccione su herramienta de desarrollo local preferida, como Laragon, XAMPP, WAMP o cualquier otra herramienta que se adapte a sus necesidades.
Configure su entorno:
Actualice su archivo .env
con las credenciales de base de datos correctas.
Instalar dependencias:
Ejecute el siguiente comando para instalar las dependencias requeridas usando Composer:
composer install
Ejecute el siguiente comando para instalar las dependencias requeridas usando npm y compílelas:
npm install
npm run build
Migrar y inicializar la base de datos: inicialice y inicialice la base de datos con datos predeterminados usando:
php artisan migrate --seed
Ahora su proyecto está listo para usar. Puede acceder al panel de administración a través de la ruta proporcionada. Si ejecutó el comando seed, inicie sesión con las credenciales proporcionadas. Personalice y amplíe su aplicación según sea necesario.
Una vez que haya configurado el Proyecto siguiendo las instrucciones proporcionadas, puede acceder al panel de administración visitando la ruta /admin
en su navegador web.
Si ejecutó el comando seed durante el proceso de configuración, puede iniciar sesión con las siguientes credenciales:
email: [email protected]
password: 123456
email: [email protected]
password: 123456
ims-laravel-admin-starter
admite operaciones basadas en roles y permisos para controlar el acceso a diversas funcionalidades dentro de su panel de administración. Puede definir roles con permisos específicos y asignarlos a los usuarios según sea necesario.
Explore este proyecto y experimente la conveniencia de un entorno de desarrollo local listo para usar para sus API y paneles de administración basados en Laravel.
Aumente la accesibilidad y la facilidad de uso de este proyecto inicial al adoptar varios idiomas. Con la ayuda de Filament Translations y el paquete Laravel Lang, este proyecto inicial ofrece soporte multilingüe integral.
Para obtener una guía detallada sobre cómo trabajar con varios idiomas y traducciones, visite nuestra página wiki dedicada.
Descubra un mundo de posibilidades con una perfecta localización de idiomas, garantizando que su aplicación llegue a una audiencia global.
Para obtener una guía más completa, visite la página WIKI en GitHub:
Ejecutando la aplicación con Docker y Laravel Sail - Wiki
Este recurso detallado proporciona instrucciones paso a paso e información adicional para garantizar una experiencia fluida al configurar y ejecutar su aplicación con Docker y Laravel Sail.
Para garantizar la confiabilidad y corrección de su aplicación, es esencial ejecutar pruebas. Siga estos sencillos pasos:
Cree una base de datos de prueba separada:
Comience creando una base de datos de prueba dedicada para su aplicación. Puede nombrarlo ims-admin-testing
para diferenciarlo de su base de datos de producción.
Si está utilizando Docker y Laravel Sail, puede omitir este paso y, en su lugar, actualizar el archivo phpunit.xml para agregar una base de datos de prueba:
< env name = " DB_DATABASE " value = " testing " />
Ejecutar pruebas:
Tiene dos opciones convenientes para ejecutar pruebas:
Usando plagas:
Ejecute pruebas con Pest, un delicioso marco de pruebas de PHP. Simplemente ejecute el siguiente comando:
./vendor/bin/pest
Si está ejecutando Sail, puede usar este comando:
./vendor/bin/sail test
# or if you have an alias configured:
sail test
Usando Artesano:
La herramienta de línea de comandos Artisan de Laravel proporciona capacidades de prueba perfectas. Ejecute las pruebas con el siguiente comando Artisan:
php artisan test
Si está ejecutando Sail, puede usar este comando:
./vendor/bin/sail artisan test
# or if you have an alias configured:
sail artisan test
La ejecución de pruebas es crucial para garantizar la confiabilidad y corrección de la funcionalidad de su aplicación. Los comandos anteriores iniciarán el proceso de prueba y le brindarán información valiosa sobre la calidad de su código base.
Algunos consejos de rendimiento para el filamento
Para optimizar el rendimiento de la aplicación Filament, puede utilizar el comando php artisan icons:cache
para almacenar en caché los iconos. Este comando precarga y almacena en caché los íconos utilizados en su aplicación, lo que resulta en tiempos de carga más rápidos.
php artisan icons:cache
Si tiene problemas de rendimiento y desea acelerar su aplicación, considere deshabilitar la función de recopilación de vistas en la barra de depuración. Así es como puedes hacerlo:
Navegue hasta el archivo de configuración debugbar.php
ubicado en el directorio config
de su aplicación.
Dentro del archivo debugbar.php
, encontrará una matriz llamada collectors
. Localice el recopilador de 'views'
dentro de esta matriz.
Para deshabilitar la colección de vistas, simplemente configure el recopilador 'views'
en false
, así:
' collectors ' => [
...
' views ' => false, // Views with their data
],
Este cambio evitará que la barra de depuración recopile y muestre datos de visualización, lo que puede ayudar a mejorar el rendimiento de su aplicación, particularmente en un entorno de desarrollo.
Este proyecto proporciona comandos Artisan adicionales para simplificar su flujo de trabajo y mejorar la productividad.
Genere archivos auxiliares IDE generales para mejorar la navegación y el autocompletado de código ejecutando:
php artisan ide-helper:generate
Genere archivos auxiliares de modelo IDE sin escribir en archivos de modelo usando:
# use any one of this two commands
php artisan ide-helper:models -N
php artisan ide-helper:models --nowrite
php artisan csfixer:run
Este comando garantiza que su código cumpla con los estándares de codificación predefinidos, lo que hace que su código base sea limpio y legible.
Crear servicios para su aplicación se hace sin esfuerzo. Utilice el siguiente comando para generar un servicio:
php artisan make:service subfolder/ServiceName
Reemplace la subcarpeta y el nombre del servicio con los valores reales que necesita. También puedes crear un servicio sin subcarpeta:
php artisan make:service TestService
El servicio recién creado estará ubicado en app/Http/Services/TestService.php
, listo para manejar la lógica empresarial de su aplicación.
Los rasgos son componentes de código reutilizables que mejoran la organización del código. Para crear un nuevo rasgo, simplemente ejecute:
php artisan make:trait TestTrait
Este comando genera un nuevo archivo de rasgos para su proyecto, lo que promueve la reutilización y el mantenimiento del código.
Aproveche estos comandos de Artisan para optimizar su proceso de desarrollo y mantener una base de código bien estructurada.
Este proyecto es presentado por Innovix Matrix System y se lanza como software de código abierto bajo la licencia MIT.
No dude en utilizar, modificar y distribuir este proyecto inicial de acuerdo con los términos de la licencia del MIT. Fomentamos la colaboración y agradecemos las contribuciones de la comunidad para hacer que este proyecto sea aún mejor.