guilhelm / mfdock

Test 1 - mountain peaks

The context of this test is to provide a simple web service for storing and retrieving moutain peaks.

Using the python web framework Django OR PHP web framework on your chosing and a database. (postgresql database is better (postGIS can be used for geo features)), implement the following features:

• models/db tables for storing a peak location and attribute: lat, lon, altitude, name
• REST api endpoints to :
  • create/read/update/delete a peak
  • retrieve a list of peaks in a given geographical bounding box
• add an api/docs url to allow viewing the documentation of the api and send requests on endpoints
• add an html/javascript page to view the peaks on a map (use opensource packages)
• deploy all this stack using docker and docker-compose
• [Optional] add ip filtering with a country whitelist settings. Connections from a country not in the list should return a http 403. An admin page protected with user/password authentication should allow viewing rejected connections.

The source code should be delivered using bitbucket or github with detailed explanations on how to deploy and launch the project.

How to deploy

git clone https://github.com/guilhelm/mfdock.git
cd mfdock
# Admin user/mail/password can be changed in .env file
sudo docker-compose up

How to test

Then on another terminal (adapt with credentials given before) :

# Retrieve :
curl -H 'Accept: application/json; indent=4' -u admin:A11235813 http://0.0.0.0:8000/peaks/peaks/

# Create :
curl --header "Content-Type: application/json" \
  --request POST \
  --data '{
            "name": "Mont Imaginaire 2",
            "lat": "43.22322",
            "lon": "4.32230",
            "altitude": "3499"
        }' \
  -u admin:A11235813 \
  http://0.0.0.0:8000/peaks/peaks/

# Retrieve to check :
curl -H 'Accept: application/json; indent=4' -u admin:A11235813 http://0.0.0.0:8000/peaks/peaks/

# Update id=1
curl --header "Content-Type: application/json" \
  --request PUT \
  --data '{
            "name": "Mont Imaginaire 3",
            "lat": "43.22322",
            "lon": "4.32230",
            "altitude": "3499"
        }' \
  -u admin:A11235813 \
  http://0.0.0.0:8000/peaks/peaks/1/

# Retrieve to check :
curl -H 'Accept: application/json; indent=4' -u admin:A11235813 http://0.0.0.0:8000/peaks/peaks/

# Delete id=1
curl --header "Content-Type: application/json" \
  --request DELETE \
  -u admin:A11235813 \
  http://0.0.0.0:8000/peaks/peaks/1/

# To query within a bounding box : lat between 42 and 44, lon between 3 and 6 (double slash at the end :()
curl -H 'Accept: application/json; indent=4' -u admin:A11235813 http://0.0.0.0:8000/peaks/peaks/42/44/3/6//

Tested with :

dood@elite:~/workspace/mftest$ docker -v
Docker version 20.10.6, build 370c289
dood@elite:~/workspace/mftest$ docker-compose -v
docker-compose version 1.29.0, build 07737305