{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://rangka-os.github.io/rangka-os/schema/0.5/role.json",
  "title": "Rangka role",
  "description": "A role an app defines (apps/<app>/roles/<role>.rk). Model permissions name roles; members get roles in an organisation.",
  "type": "object",
  "required": [
    "name",
    "label"
  ],
  "additionalProperties": false,
  "properties": {
    "$schema": {
      "type": "string"
    },
    "name": {
      "$ref": "model.json#/$defs/name"
    },
    "label": {
      "$ref": "model.json#/$defs/label"
    },
    "description": {
      "$ref": "model.json#/$defs/label"
    },
    "inherits": {
      "type": "array",
      "items": {
        "$ref": "model.json#/$defs/name"
      },
      "description": "Roles whose permissions this role also has"
    },
    "desk": {
      "type": "boolean",
      "description": "Members with this role use the back office (false: portal only)"
    },
    "scope": {
      "type": "object",
      "description": "Row scope: members with this role see only records whose field holds a value from `from` (contract 0010)",
      "required": [
        "field",
        "from"
      ],
      "additionalProperties": false,
      "properties": {
        "field": {
          "anyOf": [
            {
              "$ref": "model.json#/$defs/name"
            },
            {
              "type": "array",
              "items": {
                "$ref": "model.json#/$defs/name"
              },
              "minItems": 1
            }
          ],
          "description": "A field name or a list of names, e.g. outlet or [from_outlet, to_outlet]"
        },
        "from": {
          "type": "string",
          "description": "CEL over user returning a list of record names, e.g. user.outlets"
        }
      }
    }
  }
}
