Update README.md

Adds high level code structure. data flow logic and discussion around design decisions to follow.