UPDATED DATA MODEL

based on recent experience using the data, I have changed a few of the
data tables' structure, along with the docs about that.