SOS Rio Grande do Sul

Este projeto é o frontend de um aplicativo destinado a auxiliar na organização e distribuição de suprimentos, além de coordenar voluntários durante os alagamentos no Rio Grande do Sul. A aplicação visa conectar pessoas afetadas pelas enchentes com recursos essenciais e voluntários dispostos a ajudar.

🧠 Sobre o Projeto

O objetivo deste aplicativo é facilitar uma resposta rápida e eficiente em situações de emergência causadas por enchentes, promovendo a colaboração e o apoio mútuo entre a comunidade e organizações de ajuda.

💻 Tecnologias Utilizadas

📌 Funcionalidades e Backlog

O app inclui as seguintes funcionalidades:

Cadastro de Itens de suprimentos: Permite que voluntários se inscrevam para ajudar.
Busca de abrigos: Gerencia a logística de distribuição de suprimentos para as áreas mais necessitadas.
Alteração de necessidades de abrigos: Exibe um mapa das áreas afetadas e pontos de coleta de suprimentos.
Cadastro de abrigos: Criar tela para cadastro de abrigos (Nome, endereço, capacidade, vagas, aceita pets) e colocar pendende de aprovação.
Alteração de abrigos: Pemitir alterar quantidade de vagas disponívies, se aceita pet ou endereço.
Cadastro de usuários: Criar tela de cadastro (nome, telefone, senha) e login.
Filtro por item e por cidade: Opção de filtrar abrigos por cidade ou que precisam de algum item específico.
Alterar ordenação: Trocar a ordenação atual para ordenação por última atualização.
Adicionar mapa de abrigos: Criar uma tela com um mapa e todos os abrigos. Verificar a posibilidade de usar geolocation para mostrar a posição do usuário no mapa.

📂 Guia de Instalação

Primeiro de tudo, é importante que você tenha o npm instalado em sua última versão.

1. Fork do repositório

Faça um fork deste repositório para a sua conta github.

2. Clonar o repositório

Abra o terminal e rode esse comando para clonar o projeto via HTTPS:

git clone https://github.com/usuario/frontend.git

3. Entrar no diretório

cd frontend

4. Instalar as dependências

npm install

🚀 Iniciando o Projeto

Para começar a desenvolver, rode o seguinte comando via terminal:

npm run dev

O app estará disponível em http://localhost:5173.

👍 Como contribuir

Contribuições são muito bem-vindas! Se você tem interesse em ajudar a melhorar o app, por favor:

Faça um fork do repositório.
Crie uma branch para sua feature (git checkout -b feature/MinhaFeature).
Faça seus commits (git commit -m 'Adicionando uma nova feature').
Faça push para a branch (git push origin feature/MinhaFeature).
Abra um Pull Request.

Canal no Discord

Estamos organizando nossas discussões no Discord.

Link de convite: https://discord.gg/w5QJ7KsZ

🤝 Colaboradores

Agradecemos o seu interesse e apoio. Juntos, podemos fazer uma diferença significativa para as vítimas das enchentes no Rio Grande do Sul!

_{José Geraldo D. F.}	_{Manoel Farias}	_{Matheus Dubin Da Silveira}	_{Rhuam Sena}	_{Rafael Albuquerque}
_{Aléxia Dorneles}	_{Luciano Lima}	_{Elivelton Rodrigues}	_{Luccas Specht}	_{Bruno Vinícius Barreiras de Oliveira}
_{Giovanni Bassi}	_{Filipe Pacheco de Fraga}	_{Felipe Monteiro}	_{André Ferraz}	_{Fernando Gatto}