Structure & Versioning of the Standards

Structure

Common and Interface-Specific Standards

Some standards can be reused and are valid across multiple interfaces (stored in the common space/main page that you are looking at), others are valid only for their own respective interface (stored in the respective space of their interface linked on the left, e.g. for CRVS, specific in CRVS with SP-MIS standards).

For instance, a name may always be defined in the same manner for multiple different workstreams, which would classify it as common, whereas a person could be defined slightly differently, depending on the use case (payment, CRVS, social registry, etc.), hence, it would fall under interface-specific standards and be stored in the respective interface space.

Three Parts — Process, Data, API

Each standard is split into three main parts:

Process

standards serve as a proof of concept of the implemented data and API interface-specific standards. Hence, when the standards are implemented for a social protection use case—what would the process flow look like? These process flows provide examples of the most relevant implementation use cases, but are of course not exhaustive.

Data

standards ensure a shared language and format for data used across diverse systems and by different organisations. They are further divided into the Data Object such as, e.g. a person (containing attributes like first name, sex, etc.),Code Directory (containing a list of possible values for an attribute like marital status) and Data Types and Formats(e.g. whether it is a string or a decimal and for some types, e.g. a string, how to format them, e.g. a date).

API

standards contain the different specifications per interface that are needed for information exchange. Valid across all interfaces, API standards deal with considerations regarding design principles, including security and versioning.

Versioning

The overall standards are versioned directly in the GitBook via the naming of the space. Hence, CRVS v1.0 is the first version of the CRVS with SP-MIS standards.

The versioning of the APIs is explained in the Design Principles section.

You can find all previous versions of the standards in the respective 'Previous Versions' page at the very end of each space. For instance, this is the Previous Versions page of the CRVS with SP-MIS standards.