Track your online shipments in this responsive web app.

GoingPostal is the final project created during the Summer 2014 Hackbright Academy Software Engineering Fellowship.

===

1. Fetch my shipment emails from Gmail
2. Login
3. Connect to Gmail API (Gmail OAuth?)
4. Fetch emails (all? last 60 days? upper limit?)
5. Find shipment confirmation emails
6. Parse shipment number (and courier?)
7. Get package tracking numbers
8. Add tracking number, courier info to db
9. Looks up their status and location from the courier
10. Add location data to db
11. Display their paths and current location on a map
12. Send a text message (or call?) after being delivered

===

1. Found UPS tracking number formats (http://www.ups.com/content/us/en/tracking/help/tracking/tnh.html)
2. Found library to help with package tracking (https://github.com/storborg/packagetrack)
3. Wrote regular expressions to look for tracking numbers in tracking.py
4. Encapsulated parsing tracking numbers in to function parse_tracking_numbers()

1. Integrate packagetrack library with my project
2. Use packagetrack library to issue request for package status

1. My current tracking number is not a typical UPS tracking number, having trouble getting tracking info back from UPS

1. Successfully received emails from Gmail API
2. Modified request query to search for shippment keywords
3. Successfully retrieved email body
4. Successfully decoded HTML email body from base64url encoding to something readable

1. My single test email was sent using UPS, so go to UPS see if I can find the format of their tracking numbers,
2. Write regular expression to search for the tracking number in UPS emails
3. Encapsulate the tracking number extraction into a function
4. Process another email/courier...

1. In gmail OAuth prototype, moved gmail client id and secret to more secure location in ~/.bash_profile
2. Authorization granted to gmail, not the random sample service

1. get email body, email query limit

1. How to work with Gmail's response object

1. Got a Reddit OAuth sample app working in Flask
2. Got a stand-alone Google OAuth sample app working in Flask

1. Get an email from Gmail

1. OAuth is hard

1. Lunch with Astha (hints on OAuth)
2. Finished login/logout
3. Added form to manually enter shipments
4. Display shipments list
5. Decided not to stub out the remaining templates or routes

1. Read about Gmail OAuth

OAuth

1. Project approval
2. Created GitHub repo
3. Sketched out (4) wireframes of main pages
4. Created db (v1)
5. Drafted rough project timeline
6. Able to manually register a user, save to db

1. Manually enter a shipment to track
2. Finish login flow
3. Ask for a code review
4. Stub out remaining template pages
5. Stub out remaining routes
6. Read about Gmail API (OAuth)

1. Need to research more about options for getting emails

1. Picked a project idea
2. Picked a project name

1. Project Approval
2. Wireframes
3. Database tables
4. Create GitHub repo
5. Project timeline

1. Project approval
2. How to fake shipment data??

1. git init locally vs. creating a repo on GitHub Can git init on GitHub, just git init in one place or the other. If you init on GitHub, don't forget to check the init checkbox.
2. How do I fake shipment data? Check the courier APIs for test data. Create a page of tracking numbers.
3. How to get email data?? Nick suggested 3 options:
4. Browser extension - add a tracking number from a web page to my app
5. Use IMAP to actually read my email - invasive. Would need to store encrypted, hashed email password
6. OAuth might be possible - check Gmail API docs. Also check Flask mega- tutorial for a Google accounts OAuth example of account creation.

1. Additional email providers
2. Store the info retrieved from carriers for offline support
3. Predict the next location
   1. Based on time of year (winter)
   2. Postal traffic (holidays)
4. Map viewing options
   1. Show timing by time of year
   2. By shipping priority (regular, express, priority, etc.)
   3. Bad weather, holidays...