(doc) adds detail on database schema to doc/ files