Voyage - A Visual Travel Journal

Demo

App is live on AWS! http://voyage.fkqpxtepmm.us-west-2.elasticbeanstalk.com (at least until my credits run out...)

Screenshots:

And more in the demo/ folder!

Todo

MVP:

• Login (mod_auth): Used Flask session to validate each view when the user log in/out
• Register
• (Basic) Add a landmark (mod_landmark): Used Google Geocode to parse the landmark name entered by the user to a coordinate.
• (Basic) View landmarks & render on map (mod_map): All users' landmarks are queried from the database (see viewMap.js) and drawn on the map as a simple red marker. Ref: Custom style for map and custom markers

More:

• Red marker should be clickable and info about its ratings and photos should be displayed. https://developers.google.com/maps/documentation/javascript/examples/place-details
• Picture needs to be stored in database. Right now the only thing stored is the filename
• Theme management
• Photo collage generator

Installation instructions

Note: The project is created using Python 2.x

1. Instal pip
2. Install virtualenv
3. Clone the repo. Create your own branch to work on.
4. cd Voyage and then virtualenv your-env to create your new virtual environment, and activate it.
5. Install all dependencies: (your-env)$ pip install -r requirements.txt
6. To run the app locally: (your-env)$ python application.py

You must set your environment variables in order to connect to the database

How the app flows

• Example flow of mod_auth:
  • import the controllers in main __init__.py
  • controllers import models (interacting with DB) and forms (dependent module)

Databases

• Install Postgresql

Deployment on AWS

• Flask app deployed on AWS Elasticbeanstalk
• PostgreSQL database deployed on AWS RDS

Materials on Flask

• http://flask.pocoo.org/docs/0.12/
• https://www.digitalocean.com/community/tutorials/how-to-structure-large-flask-applications