abhn / Mporter

Mentor Reporter - A flask based multiuser app for automated email reporting to your mentors
https://mporter.co
MIT License
3 stars 1 forks source link
celery email flask postgresql python python3 reporting

Mporter (Mentor Reporter)

Try it out here: https://mporter.co

Build Status codecov License: MIT

A simple flask project for easy reporting daily/weekly/monthly updates to one's mentor. You need to simply add tasks the way you write commit messages, and Mporter will take care of delivering an email to your mentors at a preset time.

Demo

https://mporter.co

One Click Installer

Deploy

Index

Introduction

Have you ever faced the problem of discipline where you had to report your progress with a project or a problem to a person (mentor?), but you totally forgot? I have, and this little project tries to solve that problem.

With Mporter, you just have to keep adding your tasks (things that you did) and the app handles timely reporting to the people that you add as mentors.

Yes, think of it like Twitter but with a twist. Instead of you getting the tweets of people you add, the people you add get your tweets (Tasks) instead.

Features

Screenshots

A list of tasks welcome you as you log into the app

Tasks

You can find your mentors in the mentors tab.

Mentor

For the admin users, there's a panel for easy CRUD operations

Admin

Vocabulary

Installation

To use this application, some preliminary steps have to be performed. While most of it is simple command copy-pasting, it can get thick at times. In those times, use Google and search for error messages.

Following are the steps needed to put this app on Heroku which is a nice place to host hobby projects, but with little more effort, you can put this up on a private server like Digital Ocean's droplet or even your Raspberry Pi.

  1. Clone this repository

  2. Create a new app in heroku on hobby tier

  3. Create two Data instances, which are just Postgres database instances. Select the free tier. One is our prodution database and the other is for running test cases on Travis (optional).

  4. In Elements menu for your app, you need to enable RabbitMQ Bigwig addon. This will be used as our Celery backend to schedule email delivery. Note the broker url in the addon's settings page.

  5. Now in the Deploy tab, select Github and add your cloned repository.

  6. Set automatic deploys so that every push to your master will trigger rebuild and deploy. Do a manual deploy once to check things. It will fail, and that's okay.

  7. Create an account on Mailgun and get their key and sandbox url. Mailgun will deliver our emails. Note that for the free account, you'll have to manually confirm each account that you are planning to send emails to (ask your mentors to trust that email).

  8. We need to set env variables. To set an environment variable, use the command: $ heroku config:set VAR_NAME=var_value You'll be able to use this variable in your app as import os; os.environ.get('VAR_NAME'). Do that for each variable in the list below. For example, $ heroku config:set MPORTER_SECRET='abcd123' and so on.

  9. Set the following env variables. I have created a corresponding env.sh file locally and added it to my .gitignore to not pollute my ~/.bashrc:

    #!/usr/bin/env bash
    
    export FLASK_APP=app
    export MPORTER_SECRET=<some random>
    export RABBITMQ_BIGWIG_URL=<the rabbitmq bigwig url>
    export MAILGUN_API_KEY=<mailgun key>
    export MAILGUN_DOMAIN=<mailgun sandboxurl>
    export DATABASE_URL=<first heroku data addon's url>
    export HEROKU_POSTGRESQL_GRAY_URL=<second heroku data addon's url>
    

    If you're using Heroku (or used the one click installer), all except MPORTER_SECRET will already be present. To view the values (and copy them locally), do a heroku config in your project directory.

  10. Click the deploy manually button again, and your app should (hopefully) be live.

REST API

The app exposes some REST APIs for use via other application (or command line). All APIs are authenticated via JWT, and the JWT can be obtained in exchange of login credentials.

[POST]/api/auth

[POST]/api/task

[GET]/api/task

[POST]/api/mentor

[GET]/api/mentor

Ingredients

TODO

  1. Beautify /mentee page with some CSS and make it mobile responsive.
  2. Implement REST APIs for extending the functionality to non-web apps.
  3. Implement JWT auth for authentication of RESTful APIs
  4. Slack bot for posting task as well as receiving task notification
  5. PWA

Contributing

License

MIT