Sobre

Este projeto foi desenvolvido como trabalho de conclusão de curso pelo nosso grupo no CTI Unesp.

O Projeto Share é um ecossistema inovador que facilita a criação e gestão de campanhas de doação para projetos sociais. A plataforma permite que os usuários descubram e interajam com campanhas por meio de um mapa interativo, além de possibilitar a realização de doações de forma prática e acessível.

Atualização (2025)

Em 2025, realizei um upgrade da versão do Laravel, passando do Laravel 8 para o Laravel 12, garantindo maior segurança, desempenho e compatibilidade com novas tecnologias.

---

Se quiser mais ajustes ou mais detalhes técnicos na atualização, me avise! 🚀

Instalação

Para utilização do software é necessário instalar os programas abaixo

• Versão mais recente do Git
• composer ^2.4
• XAMPP ^8.1 / ^PHP 8.1

Depois da instalação do XAMPP, é necessário habilitar a extesão GD no arquivo php.ini seguindo o passo a passo abaixo:

1. Inicie o XAMPP, procure por Apache -> Config
2. Clique na opção PHP (php.ini)
3. Remova o ; da linha: ;extension=gd e salve o arquivo.

Clonando o projeto

É necessário clonar os arquivos do projeto, para isso escolha um diretório de sua preferência, abra o terminal do git execute o comando abaixo:

git clone https://github.com/LucasHayashi/projeto-share.git

Configurações do projeto

Depois que o repositório estiver clonado, é necessário instalar as dependências do projeto. Navegue até a pasta raiz do projeto, e digite na linha de comando composer update

Como o projeto faz o uso de um provedor de e-mail, banco de dados, servidor FTP e autorizadores do Github e do Google, é necessário configurar algumas credenciais para que a aplicação possa funcionar corretamente. Disponibilizamos o arquivo .env.example para que você tenha uma ideia de como configurá-lo. Lembre-se é necessário criar um o arquivo .env na raiz do projeto com todas as informações do arquivo .env.example.

Obtendo Client ID e Client Secret para Login com GitHub e Google

GitHub

1. Acesse GitHub Developer Settings.
2. Clique em New OAuth App e registre seu projeto.
3. Preencha os campos necessários, incluindo a Homepage URL (exemplo: http://127.0.0.1:8000) e a Authorization callback URL (exemplo: http://127.0.0.1:8000/auth/github/callback).
4. Após o registro, você terá acesso ao Client ID e Client Secret.

Google

1. Acesse o Google Cloud Console.
2. Crie um novo projeto ou selecione um existente.
3. Vá para APIs e serviços > Credenciais e clique em Criar credenciais > ID do cliente OAuth.
4. Configure as Origens JavaScript autorizadas (exemplo: http://127.0.0.1:8000) e os URIs de redirecionamento autorizados (exemplo: http://127.0.0.1:8000/auth/google/callback).
5. Após a criação, você poderá visualizar e copiar o Client ID e o Client Secret.

Iniciando o projeto

Para iniciar o projeto é necessário rodar os comandos abaixo na linha de comando ao menos uma vez, exceto o php artisan serve que sempre deve ser executado para iniciar a aplicação.

php artisan route:clear
php artisan key:generate
php artisan storage:link
php artisan migrate
php artisan db:seed
php artisan serve