/happyProject

Um breve projeto proposto pela equipe da RocketSeat durante a NextLevelWeek#3

Primary LanguageTypeScript

🚧 Happy 1.0 🚀 em construção... 🚧

GitHub language count License Stargazers

💻 Sobre o projeto

📝 Happy - é um projeto proposto pela equipe da RocketSeat durante a terceira NLW, onde um aplicativo para facilitar o contato entre orfanatos e visitantes foi criado e desenvolvido ao longo da semana. Neste aplicativo é possível verificar os orfantos próximos na região, verificar as informações sobre o orfanato tais como horário de funcionamento e instruções para visita, também é possível cadasstrar um orfanato com suas respectivas informações e fotos.

Os usuários terão acesso ao aplicativo móvel, onde poderão:

  • Ver os orfanatos próximos no mapa
  • Ver as informações sobre o orfanato selecionado
  • Entrar em contato com o orfanato via WhatsApp
  • Traçar a rota até o orfanato
  • Registrar um orfanato no mapa
  • Enviar imagens do orfanato

🎨 Layout

O layout mobile da aplicação está disponível no Figma:

Made by Thlindustries

Mobile

Happy Happy Happy

Veja uma demonstração em GIF neste Link

🎨 Layout

O layout web da aplicação está disponível no Figma:

Made by Thlindustries

Web

Happy

🛠 Tecnologias

As seguintes ferramentas foram usadas na construção do projeto:

🚀 Como executar o projeto

Podemos considerar este projeto como sendo divido em três partes:

  1. Back End (pasta backend)
  2. Mobile (pasta mobile)
  3. Web (pasta web)

💡Para o correto funcionamento do app mobile é necessário que o servidor backend esteja rodando.
💡Detalhe, é necessário também que exista um banco de dados postgres nomeado como happy na porta :5432
💡Após subir um banco de dados com o nome happy na porta :5432 é necessário rodar o seguinte comando para que o banco seja configurado:

  • yarn typeorm migration:run


# 💡>>>>>>>>>>ATENÇÃO<<<<<<<<<< - Se precisar mudar a porta do servidor, o arquivo está em *happyProject/backend/src/shared/infra/http/server.ts /* - Lembre-se se mudar o **IP** do servidor em sua **API** tanto da aplicação **WEB** quanto **MOBILE**

Pré-requisitos

Antes de começar, você vai precisar ter instalado em sua máquina as seguintes ferramentas: Git, Node.js. Além disto é bom ter um editor para trabalhar com o código como VSCode

🎲 Rodando o Back End (servidor)

# Clone este repositório
$ git clone https://github.com/thlindustries/happyProject

# Acesse a pasta do projeto no terminal/cmd
$ cd happyProject

# Vá para a pasta server
$ cd backend

# Instale as dependências
$ yarn

# Execute a aplicação em modo de desenvolvimento
$ yarn dev

# O servidor inciará na porta:3333 - acesse http://localhost:3333 

📱Rodando a aplicação MOBILE

# Instale o Aplicativo do EXPO em seu celular (Basta procurar na sua loja de aplicativos)

# Acesse a pasta do projeto mobile
$ cd mobile

# Instale as dependências
$ yarn

# Inicie o metro bundler do expo
$ yarn start

#Escaneie o QR Code com o APP do EXPO em seu CELULAR

📱Rodando a aplicação WEB

# Acesse a pasta do projeto web
$ cd web

# Instale as dependências
$ yarn 

# Inicie o servidor 
$ yarn start

# Entre em > http://localhost:3000 <

😯 Como contribuir para o projeto

  1. Faça um fork do projeto.
  2. Crie uma nova branch com as suas alterações: git checkout -B my-feature
  3. Salve as alterações e crie uma mensagem de commit contando o que você fez: git commit -m "feature: My new feature"
  4. Envie as suas alterações: git push origin my-feature

Caso tenha alguma dúvida confira este guia de como contribuir no GitHub

👥 Contribuidores

  • Thiago Lorente Kraetzer -> Made by Thlindustries

📝 Licença

Este projeto esta sobe a licença MIT.

Feito com ❤️ por Thiago Lorente Kraetzer 👋🏽 Entre em contato!