Boilerplate Profissional

Starter moderno e “Enterprise-Ready” com Docker Compose V2, ferramentas de QA, análise estática, testes e CI/CD configurados.

---

📋 Sobre o Projeto

Este repositório fornece uma fundação sólida para projetos em Laravel 11, com foco em qualidade, padronização, testes e automação.
Tudo já configurado para um ambiente profissional e escalável, ideal tanto para estudos quanto para uso corporativo.

---

📚 Documentação de Referência

Centralizamos aqui todos os manuais necessários para trabalhar neste projeto:

• 📖 Documentação Oficial do Laravel 11 Referência completa sobre o framework, rotas, controllers e segurança.

• 📘 Guia Técnico do Projeto Entenda as decisões de arquitetura e soluções para ambiente Docker.

• 📙 Conceitos Técnicos & Glossário Explicação detalhada sobre Sail, Pint, Larastan, Vite e configurações do PHP.

---

🛠️ Tecnologias e Recursos

• Framework: Laravel 11
• Linguagem: PHP 8.2+
• Frontend: Tailwind CSS + Vite
• Banco de Dados: PostgreSQL 16 (Docker)
• Ambiente de Desenvolvimento: Laravel Sail (Docker Compose V2)
• Code Style: Laravel Pint (PSR-12)
• Análise Estática: Larastan (PHPStan – Level 5)
• CI/CD: GitHub Actions
• Extras: IDE Helper, Redis, Mailpit

---

🚀 Instalação

⚙️ Requisitos do Ambiente (php.ini)

Caso você opte por rodar o projeto sem Docker (instalação nativa), garanta que as seguintes extensões estejam habilitadas no seu arquivo php.ini:

• ctype
• curl
• dom
• fileinfo
• filter
• hash
• mbstring
• openssl
• pcre
• pdo
• pdo_pgsql (Driver do Banco de Dados)
• session
• tokenizer
• xml

Nota: Se você estiver usando Laravel Sail (Docker), pode ignorar esta lista. O container já vem com todas essas extensões configuradas e otimizadas automaticamente.

---

1. Clone o Repositório

git clone https://github.com/SEU-USUÁRIO/laravel-v11.git
cd laravel-v11

2. Instale as Dependências

Opção A — Composer Local

composer install

Opção B — Composer via Docker

docker run --rm -u "$(id -u):$(id -g)" \
  -v "$(pwd):/var/www/html" -w /var/www/html \
  laravelsail/php82-composer:latest \
  composer install --ignore-platform-reqs

3. Configure o Ambiente

cp .env.example .env
./vendor/bin/sail up -d

Garanta no .env:

DB_CONNECTION=pgsql
DB_PORT=5432

4. Setup Final & Frontend

Gere a chave, migre o banco e compile os assets do Tailwind:

# Backend Setup
./vendor/bin/sail artisan key:generate
./vendor/bin/sail artisan migrate

# Frontend Setup (Instala e compila o CSS/JS)
./vendor/bin/sail npm install
./vendor/bin/sail npm run build

Aplicação disponível em: http://localhost

---

🛡️ Qualidade e Ferramentas de QA

🎨 Formatação — Laravel Pint

./vendor/bin/sail bin pint

🔎 Análise Estática — Larastan

./vendor/bin/sail bin phpstan analyse

🧪 Testes Automatizados

./vendor/bin/sail artisan test

🧠 Atualizar IDE Helper

./vendor/bin/sail artisan ide-helper:generate

---

🤖 CI/CD — GitHub Actions

O workflow laravel.yml executa automaticamente:

1. Verificação de padrão de código (Pint)
2. Análise estática (Larastan)
3. Testes completos

Tudo isso ao enviar alterações para a branch main.

---

📂 Arquivos Importantes

• compose.yaml — Serviços Docker (App, DB, Redis, Mailpit)
• phpstan.neon — Regras do PHPStan / Larastan
• pint.json — Configurações do Laravel Pint
• .editorconfig — Padronização entre editores

---

👩‍🎓 Autoria

Desenvolvido com 💛 por Angel Luz.

Se quiser conversar, colaborar ou oferecer uma oportunidade:

📬 E-mail: [email protected]
🐙 GitHub: @angelluzk
💼 LinkedIn: linkedin.com/in/angelitaluz
🗂️Website / Portfólio: meu_portfolio/

---

“Transformando código em fluxo, e ideias em movimento.”