models refacto - move some logic back basemodel
removed unused _insertOrUpdate method
doc tweak
moved common model attrs into base class