An open API service indexing awesome lists of open source software.

https://github.com/lucashayashi/projeto-share

Trabalho de conclusão do curso Técnico de Informática - CTI Unesp
https://github.com/lucashayashi/projeto-share

bootstrap laravel mapbox mapbox-gl-js

Last synced: 2 months ago
JSON representation

Trabalho de conclusão do curso Técnico de Informática - CTI Unesp

Awesome Lists containing this project

README

          

## 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](https://git-scm.com/downloads)
- [composer ^2.4](https://getcomposer.org/)
- [XAMPP ^8.1 / ^PHP 8.1](https://www.apachefriends.org/pt_br/)

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](https://github.com/settings/developers).
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](https://console.cloud.google.com/).
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
php artisan route:clear
php artisan key:generate
php artisan storage:link
php artisan migrate
php artisan db:seed
php artisan serve
```