Padrão Digital de Governo em Laravel

Template CSS do Padrão Digital de Governo adaptado para utilização no Laravel. A partir desse projeto é possível desenvolver uma aplicação PHP com a interface oficial do governo sem nenhuma configuração adicional de CSS. As classes utilizadas devem ser as mesmas presentes na documentação oficial.

O Padrão Digital de Governo apresenta os padrões de interface que devem ser seguidos por designers e desenvolvedores para garantir a experiência única na interação dos usuários com os sistemas interativos do Governo Brasileiro.

Estrutura de código

• O ambiente BASE foi configurado com LARAVEL SAIL + LARAVEL BREEZE.
• O CSS utilizado é o do padrão oficial do governo. Para mais detalhes, acesse a documentação oficial.
• De forma complementar, foi instalado o laravel-pt-BR-localization, que implementa a tradução do Laravel para PT-BR.

Capturas de tela

Login (Laravel Breeze)

---

Registro de usuário (Laravel Breeze)

---

Painel inicial

---

Template base

---

Menu lateral

---

Perfil de usuário (Laravel Breeze)

---

Instalação e primeiro acesso

Comandos essenciais para rodar

1 - Cria um alias para execurar o Laravel Sail de forma facilitada:

alias sail='sh $([ -f sail ] && echo sail || echo vendor/bin/sail)'

2 - Instala dependências para execurar o Laravel Sail:

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 - Instala dependências NPM:

npm install

4 - Cria o arquivo '.env' a partir do arquivo exemplo:

cp .env.example .env

5 - Após criar o arquivo '.env', é necessário configurar as variáveis FORWARD_DB_PORT, DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE,DB_USERNAME, DB_PASSWORD. Sem essa configuração, o sistema não consegue se comunicar com o banco de dados.

Exemplo de configuração:

  FORWARD_DB_PORT=6543
  DB_CONNECTION=pgsql
  DB_HOST=pgsql
  DB_PORT=5432
  DB_DATABASE=teste
  DB_USERNAME=teste
  DB_PASSWORD=123456

6 - Ainda no arquivo '.env', é necessário criar a variável APP_PORT e atribuir a ela o número da porta desejada para acesso do sistema no navegador.

6.1 - Exemplo de configuração:

  APP_PORT=123
  APP_URL=http://localhost:${APP_PORT}

No exemplo de configuração acima, o sistema estará disponível na seguinte URL:

  http://localhost:123

7 - Configura a APP_KEY do sistema. Por que isso é necessário? Mais detalhes aqui.

php artisan key:generate

8 - Roda os serviços via Laravel Sail, em modo "detached":

sail up -d

9 - Roda todas as migrations do sistema para o Laravel Breeze funcionar. Por que isso é necessário? Mais detalhes aqui.

sail artisan migrate

10 - Compila o CSS:

sail npm run build

11 - Primeiro acesso

No primeiro acesso é necessário cadastrar um usuário. Caso tenha configurado a variável a APP_PORT conforme o exemplo indicado, é possível fazer o procedimento pelo link:

  http://localhost:123/register