Olá! Seja muito bem-vindo(a) a este projeto. Esta plataforma foi desenvolvida para a empresa MagnoJet e tem como objetivo realizar a pré-postagem através das APIs oficiais dos Correios, oferecendo um fluxo simples, seguro e eficiente para geração de PLPs, etiquetas e integração logística.
Aqui você encontrará todas as informações necessárias para entender, instalar, executar e contribuir com este repositório. Fique à vontade para explorar, abrir issues, sugerir melhorias ou contribuir com pull requests. Toda colaboração é muito bem-vinda! 🚀
- Laravel 12 - Conferir a versão: php artisan --version
- PHP 8.2 ou superior - Conferir a versão: php -v
- MySQL 8.0 ou superior - Conferir a versão: mysql --version
- Composer - Conferir a instalação: composer --version
- Node.js 22 ou superior - Conferir a versão: node -v
- GIT - Conferir se está instalado o GIT: git -v
- Duplicar o arquivo ".env.example" e renomear para ".env".
- Alterar as credenciais do banco de dados.
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=NomedoBanco
DB_USERNAME=NomedoUsuário
DB_PASSWORD=SenhadoBanco
- Para a funcionalidade enviar e-mail funcionar, necessário alterar as credenciais do servidor de envio de e-mail no arquivo ".env".
- Utilizar o servidor fake durante o desenvolvimento: Acessar envio gratuito de e-mail
MAIL_MAILER=smtp
MAIL_SCHEME=null
MAIL_HOST=sandbox.smtp.mailtrap.io
MAIL_PORT=2525
MAIL_USERNAME=nome-do-usuario-na-mailtrap
MAIL_PASSWORD=senha-do-usuario-na-mailtrap
MAIL_FROM_ADDRESS="[email protected]"
MAIL_FROM_NAME="${APP_NAME}"
Instalar as dependências do PHP.
composer install
Instalar as dependências do Node.js.
npm install
Gerar a chave no arquivo .env.
php artisan key:generate
Executar as migration para criar as tabelas e as colunas.
php artisan migrate
Executar seed com php artisan para cadastrar registros iniciais.
php artisan db:seed
Iniciar o projeto criado com Laravel.
php artisan serve
Executar as bibliotecas Node.js.
npm run dev
Acessar o conteúdo padrão do Laravel.
http://127.0.0.1:8000
Criar o projeto com laravel.
Composer create-project laravel/laravel .
Iniciar o projeto criado com laravel.
php artisan serve
Instalar as dependências do Node.js.
npm install
Executar as bibliotecas Node.js.
npm run dev
Acessar o conteúdo padrão do Laravel.
http://127.0.0.1:8000
Criar Controller com php artisan.
php artisan make:controller nome-controller
php artisan make:controller ProjectController
Criar View com php artisan.
php artisan make:view nome-view
php artisan make:view project.index
Criar migration com php artisan.
php artisan make:migration create_nome_table
php artisan make:migration create_project_table
Executar as migration para criar as tabelas e as colunas.
php artisan migrate
Criar seed com php artisan para cadastrar registros iniciais.
php artisan make:seeder NomeSeeder
php artisan make:seeder UserSeeder
Executar seed com php artisan para cadastrar registros iniciais.
php artisan db:seed
Desfazer todas as migrations e executá-las novamente.
php artisan migrate:fresh
Desfazer todas as migrations, executá-las novamente e rodar as seeds.
php artisan migrate:fresh --seed
Criar componente.
php artisan make:component nome --view
php artisan make:component alert --view
Criar o arquivo de Request com validações para o formulário.
php artisan make:request NomeRequest
php artisan make:request UserRequest
Traduzir o Laravel para português Módulo pt-BR
Installar o pacote de auditoria do Laravel.
composer require owen-it/laravel-auditing
Publicar o pacote de auditoria do Laravel.
php artisan vendor:publish --provider "OwenIt\Auditing\AuditingServiceProvider" --tag="config"
php artisan vendor:publish --provider "OwenIt\Auditing\AuditingServiceProvider" --tag="migrations"
Limpar cache de configuração.
php artisan config:clear
Instalar a dependência de permissão.
composer require spatie/laravel-permission
Criar as migrations para o sistema de permissão.
php artisan vendor:publish --provider="Spatie\Permission\PermissionServiceProvider"
Limpar cache de configuração.
php artisan config:clear
Executar as migrations do sistema de permissão.
php artisan migrate
- Criar o repositório "projeto-laravel-12" no GitHub.
- Criar o branch "develop" no repositório.
Baixar os arquivos do Git.
git clone -b <branch_name> <repository_url>.
- Colocar o código fonte do projeto do diretório que está trabalhando.
Alterar o Usuário Globalmente (para todos os repositórios).
git config --global user.name "SeuNomeDeUsuario"
git config --global user.email "[email protected]"
Verificar em qual branch está.
git branch
Baixar as atualizações do GitHub.
git pull
Adicionar todos os arquivos modificados no staging area - área de praparação.
git add .
Commit representa um conjunto de alterações e um ponto específico da história do seu projeto, registra apenas as alterações adicionadas ao índice de praparação. O comando -m permite que insira a mensagem de commit diretamente na linha de comando.
git commit -m "NomeDoCommit"
git commit -m "base projeto"
Enviar os commits locais, para um repositório remoto.
git push <remote> <branch>
git push origin develop
Este projeto foi desenvolvido por Felipe Paraizo e está hospedado no repositório (https://github.com/Fparaiz0/prepostagem_magnojet).
Este projeto está licenciado sob a licença MIT - veja o arquivo LICENSE para mais detalhes.