Markdown
LegisFrota é um sistema web open-source desenvolvido em Laravel e totalmente Dockerizado, focado na gestão eficiente de frotas veiculares para órgãos públicos e legislativos.
O sistema permite o controle completo de veículos, motoristas, manutenções, abastecimentos e requisições de uso, garantindo transparência e organização administrativa.
Para rodar este projeto, você não precisa instalar PHP, Composer ou Node.js na sua máquina. Você precisa apenas de:
Siga os passos abaixo para colocar o sistema no ar em poucos minutos:
Baixe o código fonte para o seu servidor ou máquina local:
git clone [https://github.com/j7info/legisfrota.git](https://github.com/j7info/legisfrota.git)
cd legisfrota
2. Configurar o Ambiente (.env)
O Laravel precisa de um arquivo de configuração com as senhas e acessos. Copie o exemplo fornecido:
Bash
cp .env.example .env
3. Subir os Containers
Utilize o Docker Compose para construir as imagens e iniciar os serviços (Nginx, PHP, MySQL):
Bash
docker compose up -d --build
⏳ Aguarde: Na primeira execução, o sistema pode levar de 1 a 2 minutos para configurar o banco de dados e rodar as migrações automáticas. Acompanhe os logs se necessário: docker compose logs -f app.
4. Acessar o Sistema
Abra o navegador e acesse: 👉 http://localhost:8080 (ou o IP do seu servidor na porta 8080)
🔑 Usuário Administrador Inicial
O sistema realiza uma instalação automática e cria um superusuário padrão para o primeiro acesso:
Matrícula: 100
Senha: @frotaAdm
⚠️ Segurança: Recomendamos alterar a senha deste usuário ou criar um novo administrador imediatamente após o primeiro login.
⚙️ Configuração do .env
Abra o arquivo .env gerado no passo 2 e ajuste as configurações conforme sua necessidade.
Banco de Dados (Docker)
Estas configurações já vêm pré-ajustadas para o ambiente Docker padrão deste repositório. Só altere se souber o que está fazendo.
Ini, TOML
DB_CONNECTION=mysql
DB_HOST=db # OBRIGATÓRIO: Nome do serviço no docker-compose
DB_PORT=3306
DB_DATABASE=frota_cmon # Nome do banco
DB_USERNAME=frota # Usuário do banco
DB_PASSWORD=secret # Senha (altere para produção!)
URL da Aplicação
Importante para que os links de redirecionamento e imagens funcionem corretamente.
Ini, TOML
# Para ambiente local de testes:
APP_URL=http://localhost:8080
# Para produção (com domínio configurado):
APP_URL=[https://frota.suacamara.leg.br](https://frota.suacamara.leg.br)
🎨 Personalização
Você pode deixar o sistema com a cara do seu órgão alterando o nome e a logo.
Alterar o Nome da Aplicação
O nome definido aqui aparecerá no título das páginas e nos e-mails do sistema. No arquivo .env:
Ini, TOML
APP_NAME="Câmara Municipal de Exemplo"
Alterar a Logo
Para substituir a logo padrão pela do seu órgão:
Prepare a imagem da sua logo (preferencialmente em formato PNG com fundo transparente).
Nomeie o arquivo como logo.png.
Substitua o arquivo existente no diretório do projeto em: 📂 public/img/logo.png
(Caso utilize Docker, a alteração é imediata, mas pode ser necessário limpar o cache do navegador).
🛠️ Comandos Úteis (Docker)
Como o sistema roda dentro de containers, use os prefixos abaixo para rodar comandos do Laravel:
Limpar Cache Geral: (Útil após alterar o .env)
Bash
docker compose exec app php artisan optimize:clear
Rodar Migrations Manualmente:
Bash
docker compose exec app php artisan migrate
Acessar o Terminal do Container:
Bash
docker compose exec app bash
Verificar Logs de Erro:
Bash
docker compose logs -f app
📄 Licença
Este projeto é open-source e está disponível sob a licença MIT. Sinta-se livre para contribuir ou modificar conforme a necessidade da sua legislatura.
### Dica final antes do push 💡
Certifique-se de que o seu arquivo **`.gitignore`** contém a linha `.env`.
Se você subir o arquivo `.env` original (com suas senhas reais) para o GitHub, ele ficará público para sempre no histórico.
O ideal é que no GitHub exista apenas o `.env.example` (com senhas em branco ou fictícias).