LogoLogo
WebsiteGitHubSlack
Social Registry v1.0.0
Social Registry v1.0.0
  • Social Registry and SP-MIS Interface
    • Introduction
    • Assumptions
    • Exception Handling
    • Social Registry with SP-MIS Standards
      • Process
        • PRS.SR.01: SP-MIS queries the social registry to verify eligibility for programme enrolment
          • Example 1: Unconditional Household Cash Transfer Scheme
          • Example 2: Widow Cash Transfer Scheme
          • Example 3: Conditional Girl’s Education Cash Transfer Scheme
          • Example 4: Conditional Child Benefit Cash Transfer Scheme
        • PRS.SR.02: SP-MIS updates attributes for a batch of beneficiaries in the social registry
          • Example 1: Conditional Girl’s Education Cash Transfer Scheme
        • PRS.SR.03: Social registry updates attributes for a batch of beneficiaries in SP-MIS
          • Example 1 : Conditional Child Benefit Cash Transfer Scheme
        • PRS.SR.04: Social registry updates attributes for a batch of beneficiaries in the IBR
      • Data
        • Data Objects
          • DO.SR.01 Person
          • DO.SR.02 Group
          • DO.SR.03 Member
          • DO.SR.04 RelatedPerson
          • DO.SR.05 DisabilityInfo
        • Code Directory
          • CD.COM.01 identifier_type
          • CD.COM.02 marital_status
          • CD.COM.03 sex
          • CD.COM.07: relationship_type
          • CD.COM.10: disability_type
          • CD.COM.11: functional_limitation_type
          • CD.COM.12: functional_severity
          • CD.COM.17: education_level
          • CD.SR.02 employment_status
          • CD.SR.03 income_level
          • CD.SR.04 occupation
        • Data Types and Formats
          • DF.COM.STRING.01 date_time
          • DF.COM.STRING.02 phone_number
          • DF.COM.STRING.07 email
          • DT.COM.03 integer
          • DT.COM.02 string
          • DT.COM.04 decimal
          • DT.COM.05 array
          • Copy of DT.COM.05 array
          • DT.COM.06 boolean
      • API
        • Design Principles
        • Versioning
        • Methods
          • API.COM.01 ASY Search (Async approach)
          • API.COM.01 SYN Search (Sync approach)
          • API.COM.02 Event Subscription
          • API.COM.03 Event Notification
          • API.COM.04 ASY Status (Async approach)
          • API.COM.04 SYN Status (Sync approach)
    • Previous Versions
  • Resources
    • Interoperability in Action #6
    • Standards Committee & Acknowledgments
Powered by GitBook
On this page
  • DO.SR.02 Group
  • Example of JSON Data for a Group Data Object

Was this helpful?

  1. Social Registry and SP-MIS Interface
  2. Social Registry with SP-MIS Standards
  3. Data
  4. Data Objects

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

0...1

Type of grouping of individuals in a registry

place

0...1

Geographical location of the group

address

0...1

Address of the group

place_address

0...1

1 for place and 0 for address to decide what attributes need to be filled place or address

poverty_score

0...1

A metric generated based on the assessment of various household characteristics

poverty_score_type

0...1

Types of poverty scores that are to be measured and that categorise the level of poverty

group_head_info

0...1

Personal details of the head of the group

group_size

0...1

Total number of members in the group

member_list

0...*

List of the related individuals in a group

registration_date

0...1

Date the details of the group were registered

last_updated

0...1

Date the details of the group were last updated

additional_attributes

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"]
}

Last updated 1 month ago

Was this helpful?

DO.SR.03 Member
DO.SR.03 Member
DO.COM.07 Place
DT.COM.04 decimal
DT.COM.02 string
DT.COM.03 integer
DF.COM.STRING.01 date_time
DF.COM.STRING.01 date_time
DT.COM.05 array
DT.COM.06 Boolean
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"
        }
      }
    ] }
  
CD.IBR.01 assistance_unit