Resource/Version model alignment changes

[duglin]

Proposal:

• add versionid to Resources and Versions - this will be the ID of the Version being shown. In the Resource's case this will always be the default Version's ID
• repurpose id on Version to be the ID of the Resource
• the versions map Key/ID is now the Version's versionid not id
• show all Version properties (including isdefault) in the Resource. This will allow a Resource's URL and a Version's URL to be interchangeable at least w.r.t. the Version's attributes. The remaining attributes in the Resource entity will then be more like administrative attributes
• Resource admin attributes become:
  • defaultversionid, defaultversionurl, defaultversionsticky, versionscount, versionsurl, versions (when inlining)
  • notice the rename of stickydefaultversion - to have it start with defaultversion, so defaultversionsticky now
  • notice that we don't have versionurl like we once did during our brainstorming on this, it's defaultversionurl

{
  "id": "STRING",                          # The Resource id
  "self": "URL",                           # Resource URL, not Version

  # These are inherited from the default Version (excluded on export)
  "versionid": "STRING",                   # Same a defaultversionid
  "name": "STRING", ?
  "epoch": UINTEGER,
  "isdefault": true,
  "description": "STRING", ?
  "documentation": "URL", ?
  "labels": { "STRING": "STRING" * }, ?
  "origin": "URI", ?
  "createdat": "TIME",
  "modifiedat": "TIME",
  "contenttype": "STRING, ?

  "RESOURCEurl": "URL", ?                  # If not local
  "RESOURCE": ... Resource document ..., ? # If local & inlined & JSON
  "RESOURCEbase64": "STRING", ?            # If local & inlined & ~JSON

  # These are Resource-only attributes
  "xref": "URL", ?                         # Ptr to other Resource

  "defaultversionsticky": BOOLEAN, ?
  "defaultversionid": "STRING",            # Same as versionid above
  "defaultversionurl": "URL",

  "versionsurl": "URL",
  "versionscount": UINTEGER,
  "versions": {                            # Only if inlined/nested
    "ID": {                                # The Version's versionid
      "id": "STRING",                      # The Resource id
      "self": "URL",                       # Version URL
      "versionid": "STRING",
      "name": "STRING", ?
      "epoch": UINTEGER,
      "isdefault": BOOLEAN, ?
      "description": "STRING", ?
      "documentation": "URL", ?
      "labels": { "STRING": "STRING" * }, ?
      "origin": "URI", ?
      "createdat": "TIME",
      "modifiedat": "TIME",
      "contenttype": "STRING", ?

      "RESOURCEurl": "URL", ?                  # If not local
      "RESOURCE": ... Resource document ..., ? # If inlined & JSON
      "RESOURCEbase64": "STRING" ?             # If inlined & ~JSON
    } *
  }
}