Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/playeredlc/fazae
[pt] Fazae é uma aplicação simples para simulação de gastos e planejamento de viagens. O usuário recebe uma estimativa do quanto irá gastar em transporte, acomodação, alimentação, etc.
https://github.com/playeredlc/fazae
Last synced: 8 days ago
JSON representation
[pt] Fazae é uma aplicação simples para simulação de gastos e planejamento de viagens. O usuário recebe uma estimativa do quanto irá gastar em transporte, acomodação, alimentação, etc.
- Host: GitHub
- URL: https://github.com/playeredlc/fazae
- Owner: playeredlc
- License: mit
- Created: 2021-11-24T21:51:15.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2021-12-17T00:34:05.000Z (almost 3 years ago)
- Last Synced: 2024-10-20T09:16:12.694Z (about 1 month ago)
- Language: JavaScript
- Homepage: https://fazae.netlify.app/
- Size: 180 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Fazae
Não sabe exatamente quanto vai precisar gastar para realizar aquela viagem com a família ou amigos? Se preocupe com o que importa e deixe que o Fazae faça as estimativas para você.
[](https://github.com/playeredlc/Fazae/blob/master/LICENSE)
[](https://fazae.netlify.app/)
Acesse: [fazae.netlify.app/](https://fazae.netlify.app/)
[Sobre](#about) |
[Tecnologias](#tecnologias) |
[Executando](#executando-localmente)
## Sobre
Fazae é uma aplicação para simulação e planejamento de viagens. Através de uma interface simples o usuário fornece alguns dados a respeito da sua viagem e recebe uma estimativa de quanto irá gastar com transporte, acomodação, alimentação e outros aspectos similares. Esta aplicação foi desenvolvida para evitar cálculos repetitivos ao tentar escolher o melhor formato de viagem.
Este projeto foi desenvolvido na forma de um Monorepo que contém no mesmo repositório tanto o back-end quanto o front-end, utilizando o yarn workspaces para gerenciar as dependências de cada aplicação. Uma implementação de projeto organizada dessa forma me proporcionou alguns desafios extras ao fazer o deploy em plataformas separadas e ao realizar o gerenciamento das dependências de cada uma das aplicações.
## Tecnologias
### Back-end
* [Nodejs](https://nodejs.org/en/) with [Express](https://expressjs.com/)
* [Mapbox API](https://www.mapbox.com/), para obter informações otimizadas sobre determinadas rotas.
### Front-end
* [React JS](https://reactjs.org/)
* [Material UI](https://mui.com/)
* [Mapbox Geocoder](https://docs.mapbox.com/api/search/geocoding/)
* [Formik](https://formik.org/) + [Yup](https://github.com/jquense/yup), para formulários e validação.
### Deployment
* [Heroku](https://devcenter.heroku.com/), para o back-end.
* [Netlify](https://www.netlify.com/), para o front-end.
## Executando localmente
#### Pré-requisitos
Para rodar essa aplicação localmente é necessário ter instalado o [Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git), [Nodejs](https://nodejs.org/en/) e [Yarn](https://yarnpkg.com/getting-started/install).
#### Variáveis de ambiente
É também necessário criar um Access Token do Mapbox e configurá-lo no arquivo .env, no mesmo formato aplicado no arquivo arquivo .env.example.
```bash
# clone o repositório do projeto
$ git clone https://github.com/playeredlc/Fazae/
# instale as dependências do projeto utilizando o yarn
$ yarn install
# iniciando o back-end (na raíz do projeto)
$ node packages/server/server.js
# ou
$ cd packages/server
$ node server.js
# iniciando o front-end (na raíz do projeto)
$ cd packages/web-client
$ yarn start
# o back-end atenderá requisiçoes na porta 3000 do seu localhost
# o front-end poderá ser encontrado na porta 4000 do seu localhost.
# http://localhost:3000 e # http://localhost:4000
```
> Developed by edlc. [Get in touch!](https://github.com/playeredlc) :metal: