Add a `README.md` and a useful diagram of how some of the flows work

[MgenGlder]

Summary

Now that we have a working service, it would be useful to introduce a README.md file that explains the purpose of the repo, as well as shows a few diagrams so newcomers can understand the flows of things.