Meatballs 🍔

Meatballs is a web application born with the intent to satiate food-related needs of our clients, keeping an eye on the ambient and on the wallet, the whole with the ultimate goal to provide a healthy and tasty diet. What Meatballs consists of is a user friendly chatbot who will supply many options for your diet, eventually taking into account food intolerances, ingredients you already possess and don't want to waste and many others features.

• In-depth view of the chatbot working scheme can be found here: Chatbot Scheme
• The architecture of the project can be found here: Project Architecture

Technologies Used

• Runtime environment

  • Node.js

• Node web Framework

  • Express

• Websocket endpoints

  • Express-ws

• HTTP client library (from Mashape)

  • Unirest

• Database Management System

  • MongoDB

REST API Used

• Spoonacular

  • https://spoonacular.com/food-api/docs

• Google

  • https://developers.google.com/docs/api

• Twitter

  • https://developer.twitter.com/en/docs

OAUTH

• Google Calendar (Create events:calendar:)
• Twitter (Share tweets:bird:)

Getting Started

A working copy of the project can be obtained by cloning the repository on Github.

Prerequisites

The Node.js modules you have to install in the project folder in order to get the application working properly are:

$ npm install express
$ npm install express-ws
$ npm install dotenv
$ npm install oauth
$ npm install express-session
$ npm install unirest
$ npm install swagger-ui-express
$ npm install request
$ npm install opener
$ npm install events
$ npm install mongoose
$ npm install twitter

The module dotenv, installed before through $ npm install dotenv, allows you to load environment variables in a file called .env. Such file will contain all the sensitive data or credential you don't want to share with the public. Our .env file contains the following data:

CONSUMER_KEY
CONSUMER_SECRET
GOOGLE_API_KEY
GOOGLE_CLIENT_ID
GOOGLE_CLIENT_SECRET
MONGODB_URI
X_RAPIDAPI_HOST
X_RAPIDAPI_KEY

To interact with the application, a socket chat is needed.

Authors

• Alberto Coluzzi
• Gabriele De Santis
• Alessandro Gaeta
• Alessandro Lamin

License

This project is licensed under the MIT License - see the LICENSE file for details

Acknowledgments

• Inspiration
  • Reti di Calcolatori lectures held at Università degli Studi di Roma "La Sapienza" (course year: 2020)