db & documentation updates

* updated db schema
* updated documentation