update to data model and api design documentation implementing changes discussed at team meetings