MEMOIZE

Premise:

Memoize is a Android application built for event notification and discovery. It contains extensive support for location-based notifications, as well as support for time-based notifications in an intuitive and secure setting. Memoize is built on a modern stack of native Android, Django, and PostgreSQL.

To install and run the back-end locally:

The server is hosted at https://memoize.herokuapp.com but if you would like to setup the environment locally follow these steps.

• Navigate to the Django-REST folder
• Create and activate virtual environment.
• brew install postgresql
• pip install -r "requirements.txt"
• Install postgres.app (for mac), available at http://postgresapp.com/; a blue elephant should show up on the top of your toolbar.
• Setup postgresql. Create database with name "memoize_db". Set superuser as "postgres" and password as "password".
  • CREATE DATABASE memoize_db;
  • GRANT ALL PRIVILEGES ON DATABASE "memoize_db" to postgres;
• Perform initial migrations.
  • python manage.py migrate
• Run the server.
  • python manage.py runserver

To Run:

• Run the server (as shown in the installation instructions using python manage.py runserver). If you are using mac, make sure you have executed postgres.app before running the server.

• Run the Android application by opening the Memoize file in Android Studio and pressing the play button (this performs an automated build, executing the gradle build program and running the application on the generic android adb emulator). It should be using the Heroku url. But if you would like to connect to a local server, then if you are using the android emulator change the string in baseURL to "http://10.0.2.2:". If you are using genymotion, use "http://10.0.3.2:". Be sure to also specify the appropriate port number if connecting locally.

• NOTE: if one is using genymotion or another non-native-to-android-studio virtual machine and connecting to a local server, they MUST reference a different address in the baseURL. This was explained further above.

Components:

• Frontend:
  • Java
  • Android Studio
  • Various libraries
    • Fast-Android-Networking
    • Google Maps
• Backend:
  • Python
  • Django 1.10
  • Django REST Framework
  • PostgreSQL

Built By:

Tony Jiang (tjiang11@jhu.edu)
Mariya Kazachkova (mkazach1@jhu.edu)
Sarah Sukardi (smsukardi@jhu.edu)