one big json doc for boi schema -- Schema accepts_nested_attributes for field_sets
convert all api persistance methods to ActiveRecord's xxxxx! version - and handle raised exceptions