DO.SR.02 Group

DO.SR.02 Group

A group is a collection of related individuals in the social registry. This data entity is used to cluster associated members and define shared attributes such as poverty scores and registration dates.

Attribute	Type	Cardinality	Description
group_identifier		0...*	Identifier for a group that individual members are linked to
group_type	CD.IBR.01 assistance_unit	0...1	Type of grouping of individuals in a registry
place	DO.COM.07 Place	0...1	Geographical location of the group
address		0...1	Address of the group
place_address	DT.COM.06 Boolean	0...1	1 for place and 0 for address to decide what attributes need to be filled place or address
poverty_score	DT.COM.04 decimal	0...1	A metric generated based on the assessment of various household characteristics
poverty_score_type	DT.COM.02 string	0...1	Types of poverty scores that are to be measured and that categorise the level of poverty
group_head_info	DO.SR.03 Member	0...1	Personal details of the head of the group
group_size	DT.COM.03 integer	0...1	Total number of members in the group
member_list	DO.SR.03 Member	0...*	List of the related individuals in a group
registration_date	DF.COM.STRING.01 date_time	0...1	Date the details of the group were registered
last_updated	DF.COM.STRING.01 date_time	0...1	Date the details of the group were last updated
additional_attributes	DT.COM.05 array	0...*	Additional attributes of the group

Example of JSON Data for a Group Data Object

The provided JSON snippet outlines a group's record, including details about the group head and members.

{
  "@context": {
    "spdci": "https://schema.spdci.org/extensions/social/v1/",
    "rdfs": "http://www.w3.org/2000/01/rdf-schema#",
    "xsd": "http://www.w3.org/2001/XMLSchema#",
    "owl": "http://www.w3.org/2002/07/owl#",
    "common": "https://schema.spdci.org/common/v1/"
  },
  "@id": "https://example.org/group/001",
  "@type": "spdci:Group",
  "group_identifier": [ {
        "@type": "Identifier",
        "identifier_type": "NationalID",
        "identifier_value": "G9876543210"
      }],
  "group_type": "family",
  "place": {
    "@type": "Place",
    "geo": {
      "@type": "GeoCoordinates",
      "latitude": "40.712776",
      "longitude": "-74.005974"
    },
    "address": "123 Main St, Anytown, CountryName"
  },
  "place_address": 1,
  "poverty_score": 45.2,
  "poverty_score_type": "income-based",
  "group_head_info": {
    "@type": "spdci:Member",
    "@id": "https://example.org/member/987654321",
    "member_identifier":  [ {
        "@type": "Identifier",
        "identifier_type": "NationalID",
        "identifier_value": "M9876543210"
      }],
    "demographic_info": {
      "@type": "SRPerson",
      "identifier": [ {
        "@type": "Identifier",
        "identifier_type": "NationalID",
        "identifier_value": "9876543210"
      }],
      "name": {
        "@type": "Name",
        "surname": "Smith",
        "given_name": "Alice",
        "prefix": "Ms.",
        "suffix": ""
      },
      "sex": "female",
      "address": {
        "@type": "Address",
        "street_address": "123 Main St",
        "city": "Anytown",
        "postal_code": "12345",
        "country": "CountryName"
      },
      "birth_date": "1985-05-20T00:00:00Z",
      "registration_date": "2022-01-10T08:00:00Z",
    },
    "is_disabled": false,
    "marital_status": "married",
    "registration_date": "2022-01-10T08:00:00Z"
  },
  "group_size": 4,
  "member_list": [
    {
      "@type": "Member",
      "@id": "https://example.org/member/987654321",
      "member_identifier": [ {
          "@type": "Identifier",
          "identifier_type": "NationalID",
          "identifier_value": "M9876543210"
        }],
      "demographic_info": {
        "@type": "SRPerson",
        "identifier":[ {
          "@type": "Identifier",
          "identifier_type": "NationalID",
          "identifier_value": "9876543210"
        }],
        "name": {
          "@type": "Name",
          "surname": "Smith",
          "given_name": "Alice",
          "prefix": "Ms.",
          "suffix": ""
        } ,
        "sex": "female",
        "address": {
          "@type": "Address",
          "street_address": "123 Main St",
          "city": "Anytown",
          "postal_code": "12345",
          "country": "CountryName"
        },
        "birth_date": "1985-05-20T00:00:00Z",
        "registration_date": "2022-01-10T08:00:00Z",
      },
      "is_disabled": false,
      "marital_status": "married",
      "registration_date": "2022-01-10T08:00:00Z"
    },
    {
      "@type": "Member",
      "@id": "https://example.org/member/123456789",
      "spdci:member_identifier": [ {
          "@type": "Identifier",
          "identifier_type": "NationalID",
          "identifier_value": "M9876543210"
        }],
      "demographic_info": {
        "@type": "SRPerson",
        "spdci:identifier": [ {
          "@type": "Identifier",
          "identifier_type": "NationalID",
          "identifier_value": "1234567890"
        }],
        "name": {
          "@type": "Name",
          "surname": "Smith",
          "given_name": "Bob",
          "prefix": "Mr.",
          "suffix": ""
        },
        "sex": "male",
        "address": {
          "@type": "Address",
          "street_address": "123 Main St",
          "city": "Anytown",
          "postal_code": "12345",
          "country": "CountryName"
        },
        "birth_date": "1982-03-15T00:00:00Z",
        "registration_date": "2022-01-10T08:00:00Z",
      },
      "is_disabled": false,
      "marital_status": "married",
      "registration_date": "2022-01-10T08:00:00Z"
    },
    {
      "@type": "Member",
      "@id": "https://example.org/member/987654322",
      "member_identifier": [ {
          "@type": "Identifier",
          "identifier_type": "NationalID",
          "identifier_value": "9876543210"
        }],
      "demographic_info": {
        "@type": "SRPerson",
        ":identifier": [{
          "@type": "Identifier",
          "identifier_type": "NationalID",
          "identifier_value": "9876543221"
        }],
        "name": {
          "@type": "cName",
          "surname": "Smith",
          "given_name": "Charlie",
          "prefix": "",
          "suffix": ""
        },
        "sex": "male",
        "address": {
        "@type": "Address",
          "street_address": "123 Main St",
          "city": "Anytown",
          "postal_code": "12345",
          "country": "CountryName"
        },
        "birth_date": "2010-07-05T00:00:00Z",     
        "registration_date": "2022-01-10T08:00:00Z"
      },
      "is_disabled": false,
      "marital_status": "single",
      "registration_date": "2022-01-10T08:00:00Z"
    },
    {
      "@type": "Member",
      "@id": "https://example.org/member/987654323",
      "member_identifier": "M987654323",
      "demographic_info": {
        "@type": "SRPerson",
        "identifier": [{
          "@type": "Identifier",
          "identifier_type": "NationalID",
          "identifier_value": "9876543232"
        }],
        "name": {
          "@type": "Name",
          "surname": "Smith",
          "given_name": "Daisy",
          "prefix": "",
          "suffix": ""
        },
        "sex": "female",
        "address": {
          "@type": "Address",
          "street_address": "123 Main St",
          "city": "Anytown",
          "postal_code": "12345",
          "country": "CountryName"
        },
        "birth_date": "2012-09-22T00:00:00Z",
        "sregistration_date": "2022-01-10T08:00:00Z"
      },
      "is_disabled": false,
      "marital_status": "single",
      "spdci:registration_date": "2022-01-10T08:00:00Z"
    }
  ],
  "registration_date": "2022-01-10T08:00:00Z",
  "last_updated": "2023-06-15T10:00:00Z",
  "additional_attributes": ["services":"receives_subsidy"]
}

https://github.com/spdci/schemas/blob/main/extensions/social/v1/Group.jsonld

{
    "@context": {
      "spdci": "https://schema.spdci.org/extensions/social/v1/",
      "rdfs": "http://www.w3.org/2000/01/rdf-schema#",
      "xsd": "http://www.w3.org/2001/XMLSchema#",
      "owl": "http://www.w3.org/2002/07/owl#",
      "schema": "http://schema.org/"
    },
    "@id": "spdci:Group",
    "@type": "rdfs:Class",
    "rdfs:comment": "A group unit represents a group of related individuals in the social registry",
    "rdfs:label": "Group",
    "rdfs:subClassOf": [
      {
        "@type": "rdfs:Class",
        "rdfs:label": "Structured Entity"
      }
    ],
    "rdfs:property": [
      {
        "@id": "spdci:group_identifier",
        "@type": "rdfs:Datatype",
        "rdfs:domain": "spdci:Group",
        "rdfs:range": {
          "@id": "spdci:Identifier",
          "@type": "rdfs:Class",
          "@container": "@list"
        },
        "rdfs:comment": "A unique identifier assigned to each individual."
      },
      {
        "@id": "spdci:group_type",
        "@type": "rdfs:Datatype",
        "rdfs:domain": "spdci:Group",
        "rdfs:range": "common:GroupTypeEnum",
        "rdfs:comment": "The entity representing the group"
      },
      {
        "@id": "spdci:geographical_location",
        "rdfs:comment": "Physical location where the group is living",
        "@type": "rdfs:Datatype",
        "rdfs:domain": "spdci:Group",
        "rdfs:range": "common:Place"
      },
      {
        "@id": "spdci:address",
        "@type": "rdfs:Datatype",
        "rdfs:domain": "spdci:Group",
        "rdfs:range": {
             "@id": "spdci:Address",
             "@type": "rdfs:Class",
             "@container":"@list"
        },
        "rdfs:comment": "Current residential address of the group, represented as an address object."
      },
      {
        "@id": "spdci:place_address",
        "@type": "rdfs:Datatype",
        "rdfs:domain": "spdci:Member",
        "rdfs:range": "xsd:boolean",
        "rdfs:comment": "added place or address? place (1) or address (0)."
      },
      {
        "@id": "spdci:poverty_score",
        "@type": "rdfs:Datatype",
        "rdfs:domain": "spdci:Group",
        "rdfs:range": "xsd:decimal",
        "rdfs:comment": "A metric generated based on the assessment of various group characteristics."
      },
      {
        "@id": "spdci:poverty_score_type",
        "@type": "rdfs:Datatype",
        "rdfs:domain": "spdci:Group",
        "rdfs:range": "xsd:string",  
        "rdfs:comment": "The types of poverty scores that are is to measure and categorize the level of poverty."
      },
      {
        "@id": "spdci:group_head_info",
        "@type": "rdfs:Datatype",
        "rdfs:domain": "spdci:Group",
        "rdfs:range": {
             "@id": "spdci:Member",
             "@type": "rdfs:Class"
        },
        "rdfs:comment": "Personal details of the head of the group."
      },
      {
        "@id": "spdci:group_size",
        "@type": "rdfs:Datatype",
        "rdfs:domain": "spdci:Group",
        "rdfs:range": "xsd:integer",
        "rdfs:comment": "The total number of members in the group."
      },
      {
        "@id": "spdci:member_list",
        "@type": "rdfs:Datatype",
        "rdfs:domain": "spdci:Group",
        "rdfs:range": {
          "@id": "spdci:Member",
          "@type": "rdfs:Class",
          "@container": "@list"
        },
        "rdfs:comment": "A list of the related individuals in a group."
      },
      {
        "@id": "spdci:registration_date",
        "@type": "rdfs:Datatype",
        "rdfs:domain": "spdci:Group",
        "rdfs:range": "common:DateTime",
        "rdfs:comment": "The date the details of the group were registered."
      },
      {
        "@id": "spdci:last_updated",
        "@type": "rdfs:Datatype",
        "rdfs:domain": "spdci:Group",
        "rdfs:range": "common:DateTime",
        "rdfs:comment": "The date the details of the group were last updated."
      },
      {
        "@id": "spdci:additional_attributes",
        "@type": "rdf:Property",
        "rdfs:domain": "spdci:Group",
        "rdfs:range": {
          "@type": "@id",
          "@container": "@list"
        },
        "rdfs:comment": "Additional attributes of the group, represented as a list of key-value pairs.",
        "schema:value": {
          "@type": "xsd:string"
        }
      }
    ] }