DSEP Schema Proposal: Languages

[joffinjoy]

Sessions can be in any language. We should be able to search for session based on languages (filtering).

Latest suggestion from @core-wg-admin: Languages can belong to the agent. Like

fulfillment.agent.person.languages = [
    {
        code: 123,
        name: "English"
    },
    {
        code: 456,
        name: "Hindi"
    }
]

cc: @aks30, @vijiurs, @kiranharidas187, @core-wg-admin

[joffinjoy]

@core-wg-admin I have raised a PR to add Languages to Person schema: beckn/protocol-specifications#327. This field specifies all the languages known to a person.

Languages is an array of language objects. And each language object is of the form:

{
	code:123,
	name: English
}

---

NOTE: Further mention of **languages** isn't related to the above mentioned schema change.

---

Additionally I have raised another PR to DSEP Specifications to add examples for item search & on_search apis when filtered by languages: #82

According to the above PR, request body for searching courses/session by languages would be of the form:

{
  "context": {
    "domain": "trainings-and-courses",
    "country": "IND",
    "city": "std:011",
    "action": "search",
    "core_version": "1.0.0-draft",
    "bap_id": "https://exampleapp.io/",
    "bap_uri": "https://api.exampleapp.io/v0/",
    "bpp_id": "https://mymentor.com/",
    "bpp_uri": "https://api.mymentor.com/v0/",
    "message_id": "5ac3dd78-829e-4c7d-9139-a15adbb582cc",
    "timestamp": "2021-03-23T10:00:40.065Z",
    "ttl": "P10S"
  },
  "message": {
    "intent": {
      "item": {
        "descriptor": {
          "name": "AI basics"
        },
        "tags": {
          "Language": [
            {
              "code": "eng",
              "name": "English"
            },
            {
              "code": "hin",
              "name": "Hindi"
            }
          ]
        }
      },
      "fulfillment": {
        "type": "ONLINE"
      }
    }
  }
}

And catalog response:

{
  "context": {
    "domain": "trainings-and-courses",
    "country": "IND",
    "city": "std:011",
    "action": "search",
    "core_version": "0.5.0",
    "bap_id": "https://exampleapp.io/",
    "bap_uri": "https://api.exampleapp.io/uhi/v0/",
    "message_id": "5ac3dd78-829e-4c7d-9139-a15adbb582cc",
    "timestamp": "2021-03-23T10:00:40.065Z"
  },
  "message": {
    "catalog": {
      "bpp/descriptor": {
        "name": "XAcademy"
      },
      "providers": {
        "descriptor": {
          "name": "XAcademy"
        },
        "categories": [
          {
            "id": "1",
            "name": "Software"
          },
          {
            "id": "2",
            "name": "Management"
          }
        ],
        "items": [
          {
            "id": "1",
            "descriptor": {
              "name": "Basics of AI"
            },
            "price": {
              "value": "6000"
            },
            "fulfillment_id": "1",
            "category_id": "1",
            "tags": {
              "languages": [
                {
                  "code": "eng",
                  "name": "English"
                },
                {
                  "code": "hin",
                  "name": "Hindi"
                }
              ]
            }
          },
          {
            "id": "2",
            "descriptor": {
              "name": "AI for Data Analysis"
            },
            "price": {
              "value": "7000"
            },
            "fulfillment_id": "1",
            "category_id": "1",
            "tags": {
              "languages": [
                {
                  "code": "eng",
                  "name": "English"
                },
                {
                  "code": "mal",
                  "name": "Malayalam"
                }
              ]
            }
          }
        ]
      },
      "fulfillments": [
        {
          "id": "",
          "type": "ONLINE"
        }
      ]
    }
  }
}

cc: @aks30, @vijiurs, @kiranharidas187