Real time app download visualization

The aim of this project is to show a world map dashboard containing app downloads information. Every time a download is performed, the dashboard should update automatically.

Technologies

The technologies used are the following:

• MongoDB for the persistence using the change streams feature for real time updates
• Go backend server, with pretty much no dependencies beside the mongodb driver (server folder)
• An Angular Frontend Application (frontend folder)
• Mapbox GL JS for the map visualization

The backend server pushes changes to the frontend application using a web socket

Prerequisites

bash docker-compose

Run the app

With Docker

The easiest way to run the whole app is to run the run script

./run.sh

This will spin up all the necessary containers (mongodb, the server app, the angular app) by using docker compose. Additionally it will take care of setting up mongodb as a replicaset, which is needed in order to have change streams

Locally

Either setup up a mongodb with replica set yourself, or run the following script

setup-mongo-rs.sh

To run the server locally, see the instructions in the master folder.

To run the frontend locally, see the instructions in the frontend folder.

Testing

I've written a few unit tests both in the server part and the angular part. Beside that I've written one integration test called test.sh which spins up mongo and the server, connect with a ws to the server, and check that one new record are inserted in mongo those records are then sent through the websocket. To run the test, beside bash and docker, you need websocat and jq