ims-laravel-admin-starter
é um painel de administração simplificado e um aplicativo inicial de API construído usando a poderosa estrutura Laravel 10 e Filment 3.
Nosso foco principal é fornecer a você um projeto inicial de desenvolvimento local descomplicado e pronto para uso.
Ao contrário dos geradores de API tradicionais ou geradores de código, este projeto simplifica o processo de configuração do seu ambiente de desenvolvimento local. Ele permite que você inicie o desenvolvimento de API baseado em Laravel e o desenvolvimento do painel de administração sem complexidades desnecessárias. Isso permite que você se concentre na construção da lógica do seu aplicativo, em vez de perder tempo na configuração inicial.
Sistema de autenticação completo : Implemente um sistema de autenticação robusto usando o pacote Laravel Jetstream para gerenciamento seguro de usuários e funcionalidade de login.
Sistema de autorização baseado em funções e permissões : Crie um sistema de autorização flexível usando o pacote Laravel-Permission, permitindo definir funções e permissões para controle de acesso refinado.
Gerenciamento de usuários : gerencie usuários com eficiência, incluindo registro de usuários, atualizações de perfil e funções de usuário.
Configurações de perfil : permite que os usuários personalizem seus perfis, incluindo informações e preferências pessoais.
Suporte a vários idiomas : torne seu aplicativo acessível a um público global com a ajuda dos pacotes Filament Translations e Laravel Lang para suporte multilíngue.
Personalização do tema : personalize a aparência do aplicativo e a interface do usuário usando o poder do Tailwind CSS para criar designs visualmente atraentes.
Suporte Docker : implante e gerencie facilmente seu aplicativo em um contêiner Docker com a conveniência do Laravel Sail para fluxos de trabalho simplificados de desenvolvimento e implantação.
Escolha sua ferramenta de desenvolvimento local:
Selecione sua ferramenta de desenvolvimento local preferida, como Laragon, XAMPP, WAMP ou qualquer outra ferramenta que atenda às suas necessidades.
Configure seu ambiente:
Atualize seu arquivo .env
com as credenciais corretas do banco de dados.
Instalar dependências:
Execute o seguinte comando para instalar as dependências necessárias usando o Composer:
composer install
Execute o seguinte comando para instalar as dependências necessárias usando npm e construí-las:
npm install
npm run build
Migrar e propagar o banco de dados: inicialize e propague o banco de dados com dados padrão usando:
php artisan migrate --seed
Agora seu projeto está pronto para uso. Você pode acessar o painel de administração através da rota fornecida. Se você executou o comando seed, faça login com as credenciais fornecidas. Personalize e expanda seu aplicativo conforme necessário.
Depois de configurar o projeto usando as instruções fornecidas, você pode acessar o painel de administração visitando a rota /admin
em seu navegador.
Se você executou o comando seed durante o processo de configuração, poderá fazer login usando as seguintes credenciais:
email: [email protected]
password: 123456
email: [email protected]
password: 123456
O ims-laravel-admin-starter
suporta operações baseadas em funções e permissões para controlar o acesso a várias funcionalidades dentro do seu painel de administração. Você pode definir funções com permissões específicas e atribuí-las aos usuários conforme necessário.
Explore este projeto e experimente a conveniência de um ambiente de desenvolvimento local pronto para suas APIs e painéis de administração baseados em Laravel.
Eleve a acessibilidade e a facilidade de uso deste Projeto Inicial, adotando vários idiomas. Com a ajuda da Filament Translations e do pacote Laravel Lang, este Starter Project oferece suporte multilíngue abrangente.
Para obter um guia detalhado sobre como trabalhar com vários idiomas e traduções, visite nossa página wiki dedicada.
Desbloqueie um mundo de possibilidades com localização de idioma perfeita, garantindo que seu aplicativo repercuta em um público global.
Para um guia mais completo, visite a página WIKI no GitHub:
Executando a aplicação com Docker e Laravel Sail - Wiki
Este recurso detalhado fornece instruções passo a passo e informações adicionais para garantir uma experiência tranquila ao configurar e executar seu aplicativo com Docker e Laravel Sail.
Para garantir a confiabilidade e correção da sua aplicação, é essencial executar testes. Siga estas etapas simples:
Crie um banco de dados de teste separado:
Comece criando um banco de dados de teste dedicado para sua aplicação. Você pode nomeá-lo ims-admin-testing
para mantê-lo distinto do seu banco de dados de produção.
Se estiver usando Docker e Laravel Sail, você pode pular esta etapa e atualizar o arquivo phpunit.xml para adicionar um banco de dados de teste:
< env name = " DB_DATABASE " value = " testing " />
Execute testes:
Você tem duas opções convenientes para executar testes:
Usando pragas:
Execute testes com Pest, uma excelente estrutura de testes de PHP. Basta executar o seguinte comando:
./vendor/bin/pest
Se você estiver executando o Sail, poderá usar este comando:
./vendor/bin/sail test
# or if you have an alias configured:
sail test
Usando Artesão:
A ferramenta de linha de comando Artisan do Laravel fornece recursos de teste contínuos. Execute os testes com o seguinte comando Artisan:
php artisan test
Se você estiver executando o Sail, poderá usar este comando:
./vendor/bin/sail artisan test
# or if you have an alias configured:
sail artisan test
A execução de testes é crucial para garantir a confiabilidade e a correção da funcionalidade do seu aplicativo. Os comandos acima iniciarão o processo de teste e fornecerão informações valiosas sobre a qualidade de sua base de código.
Algumas dicas de desempenho para filamento
Para otimizar o desempenho do aplicativo Filament, você pode usar o comando php artisan icons:cache
para armazenar ícones em cache. Este comando pré-carrega e armazena em cache os ícones usados em seu aplicativo, resultando em tempos de carregamento mais rápidos.
php artisan icons:cache
Se você estiver enfrentando problemas de desempenho e quiser acelerar seu aplicativo, considere desabilitar o recurso de coleta de visualizações na barra de depuração. Veja como você pode fazer isso:
Navegue até o arquivo de configuração debugbar.php
localizado no diretório config
do seu aplicativo.
Dentro do arquivo debugbar.php
, você encontrará um array chamado collectors
. Localize o coletor de 'views'
nesta matriz.
Para desabilitar a coleção de visualizações, basta definir o coletor 'views'
como false
, assim:
' collectors ' => [
...
' views ' => false, // Views with their data
],
Essa alteração impedirá que o Debugbar colete e exiba dados de visualização, o que pode ajudar a melhorar o desempenho do seu aplicativo, principalmente em um ambiente de desenvolvimento.
Este projeto fornece comandos Artisan adicionais para simplificar seu fluxo de trabalho e aumentar a produtividade.
Gere arquivos auxiliares IDE gerais para melhor preenchimento automático e navegação de código executando:
php artisan ide-helper:generate
Gere arquivos auxiliares de modelo IDE sem gravar em arquivos 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 garante que seu código siga os padrões de codificação predefinidos, tornando sua base de código limpa e legível.
A criação de serviços para seu aplicativo é fácil. Use o seguinte comando para gerar um serviço:
php artisan make:service subfolder/ServiceName
Substitua subpasta e ServiceName pelos valores reais necessários. Você também pode criar um serviço sem subpasta:
php artisan make:service TestService
O serviço recém-criado estará localizado em app/Http/Services/TestService.php
, pronto para lidar com a lógica de negócios do seu aplicativo.
Características são componentes de código reutilizáveis que melhoram a organização do código. Para criar uma nova característica, basta executar:
php artisan make:trait TestTrait
Este comando gera um novo arquivo de características para o seu projeto, promovendo a reutilização e manutenção do código.
Aproveite esses comandos Artisan para agilizar seu processo de desenvolvimento e manter uma base de código bem estruturada.
Este projeto é apresentado a você pela Innovix Matrix System e é lançado como software de código aberto sob a licença do MIT.
Sinta-se à vontade para usar, modificar e distribuir este projeto inicial de acordo com os termos da licença do MIT. Encorajamos a colaboração e recebemos contribuições da comunidade para tornar este projeto ainda melhor.