Feature/1208 health desk bot (#10)

* CHECK-1208: Kill http-server if test not running on CI

* CHECK-1208: Will posttest exit with code 0, please?

* CHECK-1208: Fix env var name. LOL

* CHECK-1208: What is wrong with me??

* CHECK-1208: Fix READMEs; Run health-desk-bot locally

Author: amoedoamorim

README.md

@@ -21,7 +21,13 @@ This bot is at `exif.js`. It does the following:
 * Listens to the `create_project_media` event. If it's an uploaded image, it extracts EXIF data and posts it to Check as a comment, with a link for the full report.
 * Listens to the `create_annotation_task_geolocation` and `update_annotation_task_geolocation`. If it's an uploaded image, it extracts GPS data, geocodes it and posts the result as a task response to any **unanswered** geolocation task.
 
-## Usage
+### 3. Health Desk Bot
+
+* Listens to event `create_project_media` events and looks up similar content in Health Desk articles indexed in Alegre.
+
+See details in `./health-desk-bot/README.md`
+
+## Usage (Deploying to AWS)
 
 * Copy `config.js.example` to `config.js` and define your configurations
 * Run `npm run build`
@@ -32,7 +38,6 @@ This bot is at `exif.js`. It does the following:
 ## Local usage
 
 * Copy `config.js.example` to `config.js` and define your local configurations with `checkApiUrl: http://localhost:3000`.
-* Run `npm run exif` or `npm run youtube` to spin up a local server for either bot - note the port number.
 * Start Check locally
-* Find out the local host IP from the Check container as per https://stackoverflow.com/a/33103501
-* On the Check side, the bot request URL is the IP above with the port obtained when starting the bot.
+* The `check-bots` container should start `server.js` on port `8586`
+* On the Check side, the bot request URL should be set to `http://bots:8586/<bot-slug>` ('exif', 'youtube' or 'health-desk').

health-desk-bot/README.md

@@ -0,0 +1,39 @@
+# Health Desk Bot
+
+This bot listens for new item creation events and it looks up similar content in Health Desk articles indexed in Alegre.
+The functionality is split across two different lambda functions.
+
+`health-desk-bot-lambda`, receives the events from Check-API and starts the lookup jobs by the second lambda `health-desk-bot-lambda-bg` which will respond with a note to the Check item if the content matches a Health Desk article.
+
+## Usage
+
+The Health Desk Bot depends on having the Health Desk articles indexed in Alegre.
+This first step ensures this prerequisite.
+
+### 1. Indexing Health Desk content from CSV file in Alegre
+
+* Copy `config.js.example` to `config.js` and define your configurations
+* Run `node ingest-csv.js <csv-file>`
+
+### 2. Usage (Deploying to AWS)
+
+For the first lambda `health-desk-bot-lambda`:
+
+* Copy `config.js.example` to `config.js` and define your configurations
+* Run `npm run build`
+* Create an AWS Lambda function with an API gateway and upload the ZIP file from the previous step
+* Copy the API gateway URL as the Request URL of the Check API bot
+
+For the second lambda `health-desk-bot-lambda-bg`:
+
+* Copy `config.js.example` to `config.js` and define your configurations
+* Run `npm run build`
+* Create an AWS Lambda function - no API gateway required - and upload the ZIP file from the previous step
+* It's important to add this lambda to the right VPC in AWS so it can access Alegre
+
+## Local usage
+
+* Copy `config.js.example` to `config.js` and define your local configurations with `checkApiUrl: http://localhost:3000`.
+* Start Check locally
+* The `check-bots` container should start `server.js` on port `8586`
+* On the Check side, the bot request URL should be set to `http://bots:8586/health-desk`

health-desk-bot/alegre-data-ingest/README.md

@@ -14,5 +14,8 @@
     "axios": "^0.24.0",
     "lokka": "^1.7.0",
     "lokka-transport-http": "^1.6.1"
-  }
+  },
+  "scripts": {
+    "build": "rm -f health-desk-bot-lambda-bg.zip && zip -9 -r --exclude=*configurator* --exclude=*test* health-desk-bot-lambda-bg.zip * && echo 'Now upload health-desk-bot-lambda-bg.zip to AWS Lambda'",
+  },
 }

health-desk-bot/health-desk-bot-lambda-bg/package.json

@@ -15,5 +15,8 @@
     "axios": "^0.24.0",
     "lokka": "^1.7.0",
     "lokka-transport-http": "^1.6.1"
-  }
+  },
+  "scripts": {
+    "build": "rm -f health-desk-bot-lambda.zip && zip -9 -r --exclude=*configurator* --exclude=*test* health-desk-bot-lambda.zip * && echo 'Now upload health-desk-bot-lambda.zip to AWS Lambda'",
+  },
 }

health-desk-bot/health-desk-bot-lambda/package.json

@@ -23,6 +23,7 @@
   "scripts": {
     "pretest": "http-server -p 7777 test &",
     "test": "mocha",
+    "posttest": "[ -z $CONTINUOUS_INTEGRATION ] && pkill -f http-server || :",
     "build": "rm -f check-bots.zip && zip -9 -r --exclude=*configurator* --exclude=*test* check-bots.zip * && echo 'Now upload check-bots.zip to AWS Lambda'",
     "start": "node server.js"
   },

package.json

@@ -36,6 +36,23 @@ functions.forEach(function(name) {
         response.status(500).end();
      }
   });
+
+  app.post('/health-desk', function(request, response){
+    const lambda = require('./health-desk-bot/health-desk-bot-lambda-bg').handler;
+    console.log('health-desk', util.inspect(request.body));
+    try {
+      lambda(request.body, null, () => {}).then(() => {
+        response.end();
+      }, (error) => {
+        console.error(error.message);
+        response.status(500).end();
+      });
+     }
+     catch (e) {
+        console.error(e.message);
+        response.status(500).end();
+     }
+  });
 });
 
 console.log('Starting check-bots on port ' + port);