Skip to content

vitormoreiradesenvolvedor/VaiJunto

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

116 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

VaiJunto — Caronas Solidárias para a Comunidade UFLA

Plataforma web de caronas gratuitas para estudantes, professores e servidores da UFLA
Conectando a comunidade universitária em Lavras e São Sebastião do Paraíso


Sobre o Projeto

O VaiJunto é uma aplicação web responsiva que conecta membros da comunidade UFLA que precisam de carona com aqueles que podem oferecê-la, de forma totalmente gratuita.

O sistema implementa um modelo híbrido:

  • Rotas fixas recorrentes: motoristas publicam trajetos regulares
  • Caronas sob demanda: passageiros solicitam caronas em tempo real

Para incentivar a participação de motoristas, o VaiJunto conta com um sistema de gamificação por pontos com benefícios reais.

Problema

Membros da UFLA enfrentam dificuldades diárias de deslocamento. As alternativas existentes são caras (Uber/99), desorganizadas (grupos de WhatsApp) ou com horários escassos (transporte público). Não existe solução centralizada, gratuita e segura para compartilhamento de caronas na comunidade.

Público-Alvo

Perfil Descrição
Estudantes Graduação e pós-graduação da UFLA
Professores Docentes de todos os departamentos
Servidores Técnicos administrativos e terceirizados com vínculo UFLA

Área de cobertura: Lavras/MG e São Sebastião do Paraíso/MG

Stack Tecnológica

Camada Tecnologia
Backend Laravel 11 (PHP 8.3)
Frontend Blade + Livewire + Tailwind CSS
Banco de Dados MySQL 8.0
Mapas Google Maps API
Autenticação OAuth 2.0 com email institucional UFLA
Tempo Real Laravel Reverb (WebSockets)
Deploy Docker + Docker Compose

Equipe

Membro Papel
Gabriel Francisco Borges dos Santos Desenvolvedor
Lucas Silva Meira Desenvolvedor
Maria Luiza Santos Ferreira Desenvolvedora
Rafaella Maciel Pereira Leite Scrum Master
Vitor Moreira dos Santos Product Owner

Cronograma de Sprints

Sprint Data Foco
1 04/04/2026 Definição do problema, visão do produto e organização inicial
2 11/04/2026 Levantamento e priorização de requisitos
3 25/04/2026 Modelagem do sistema
4 02/05/2026 Princípios de projeto e decisões de solução
5 09/05/2026 Aplicação de padrões de projeto
6 16/05/2026 Definição da arquitetura de software
7 23/05/2026 Planejamento e documentação de testes
8 30/05/2026 Consolidação, revisão e evidências finais
Final 15/06/2026 Apresentação final

Como Executar o Projeto

Pré-requisitos

Antes de começar, certifique-se de ter instalado:

  • Docker Desktop
  • Docker Compose (docker compose ou docker-compose)

Passo a passo

1. Clone o repositório

git clone https://github.com/vitormoreiradesenvolvedor/VaiJunto.git
cd vaijunto

2. Inicie os containers Docker

Abra um terminal na raiz do projeto e execute:

docker compose up -d

3. Aguarde os serviços iniciarem

Os seguintes serviços serão iniciados automaticamente:

  • nginx
  • php
  • mysql
  • redis
  • reverb
  • queue-worker

Na primeira execução, a aplicação irá:

  • criar o arquivo .env automaticamente a partir do .env.example
  • instalar as dependências do Composer dentro do container PHP

4. Execute as migrations

docker compose exec php php artisan migrate

5. Acesse a aplicação

Abra no navegador:

http://localhost

Utilizando o Makefile

O projeto possui atalhos úteis via Makefile.

Iniciar containers

make up

Parar containers

make down

Instalar dependências

make install

Executar migrations

make migrate

Configurar tudo automaticamente

make setup

Visualizar logs

make logs

Portas Utilizadas

Serviço Porta
Aplicação 80
Reverb (WebSocket) 8080
MySQL 3306
Redis 6379

Observações

  • Certifique-se de que as portas utilizadas não estejam ocupadas por outros serviços.
  • O ambiente foi configurado para desenvolvimento local utilizando Docker Compose.

Disciplina

Projeto acadêmico desenvolvido para a disciplina GCC188 — Engenharia de Software Universidade Federal de Lavras (UFLA) — Semestre 2026/1 Docentes: Prof. Paulo Afonso Parreira Junior / Prof. Johnatan Oliveira

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

1 watching

Forks

Packages

 
 
 

Contributors

Languages