changes:
 - extend model:  add tags to spin systems
 - add example of a 'join' query
 - improve doc comments
 - use `json.dumps`s optional `indent` parameter