Page Comparison

USE CASE STEP 

USE CASE: Unconditional Social Cash Transfer

STEP: Outreach Communication 

PRECONDITIONS 

(list of conditions that MUST be met in order to be able to successfully execute this process)

• The USCT program has been set up, and its objectives and eligibility criteria have been defined.

• The Ministry of Social Welfare or another leading agency/organization is responsible for organizing the information campaign.

• Communication Digital campaign communication channels (e.g., mobile messaging, emails, village-to-village campaigns) have been established and are available under Messaging BB.

• All necessary building blocks and workflows have been set up.

DATA INPUTS 

Note: Details on Data Inputs will most likely depend on Building Blocks that are not yet available. For now high level inputs are listed.

• Program details (objectives, benefits, constraints, partners, etc.)

• Target beneficiary group(s)

• Communication channels (mobile messaging, radio/television, etc.)

• Content for educational and promotional purposes

• Locations of households and individuals for outreach targets

Scheduler Event

• Name

• Description

• Category

• Host Entity ID

• From

• To

• Deadline

• Subscriber Limit

• Terms

• Status

• Venue

Scheduler Resource

• Name

• Category

• Phone

• Email

• Alert URL

• Alert Preference

Scheduler Entity

• category

• name

• phone

• email

• website

Scheduler Message

• Entity Identifier

• Category

• Message content

Workflow Process

• Name

• Type

• Version

• Description

• Process Body

  • code

  • value

Beneficiary

• First Name 

• Second Name 

• DOB 

• National ID Number 

• Place of residence

• Contact info:

  • Email 

  • Phone Number 

  • Address

• Eligibility criteria [Data required for making decisions on enrollment, e.g. with using Proxy Means Test, can vary between countries]

  • number of children

  • marital status

  • type of settlement [town, village, etc.]

  • employment status

ACTORS 

Human

• Leading Organization (Ministry of Social Welfare or other entity)District / local social welfare officers

• Target beneficiary group(s)

System 

• Messaging BB

• Scheduling BB

• Consent BB

• Identity BB

• Registration BB

• Mobility management BB (not yet developed) (outside of BB use case document)

• Shared Data Repositories BB (not yet developed)

• Terminology BB (not yet developed)

• Collaboration Management BB (not yet developed) (outside of BB use case document)

• Content Management BB (not yet developed) (outside of BB use case document)

• eLearning BB (not yet developed) (outside of BB use case document)

NORMAL COURSE 

Step 1: Prepare outreach campaign content

Step 1.1 Social Welfare worker is authenticated.

Step 1.2 Social Welfare worker creates campaign content

Feature: Prepare Content
Scenario: Leading organization staff creates awareness content using Content Management BB
  Given Social Welfare workers is authenticated and have access to Content Management BB
  And all requirements regarding campain content are established (also stored in shared data repositories?)
  When staff create or update content for outreach and communication
     And created content is complant with content requirements 
  Then the content is stored in the Shared Data Repositories BB
    And the content is available for editing in Content Management BB

Example Content Management BB endpoints (api spec not yet created):

• /content/create

  • Save content assuming that content management is also used as storage.
    In other case Shared Data Repositories would be use to store content)

• /content/update

  • Save content assuming that content management is also used as storage.
    In other case Shared Data Repositories would be use to store content)

• /content/get/{content}

  • Access to specific set of requirements
    

Example Shared Data Repositories BB (api spec not yet created):

• /repositories/data/create

• /repositories/data/update

Step 2: Setup outreach schedule for potential beneficiaries

NORMAL COURSE 

Step 1: Setup outreach schedule for potential beneficiaries

Note: For now we assume that content of the scheduled massage is hard-coded. At the moment definition of Content Management BB is not determined, and therefore we’re sending message directly to the scheduler BB. This will be changed in next iterations (example use of using Content Management BB was presented added in previous version of this document under Prepare outreach campaign content step).

Step 1.1: Create scheduler

Feature: Create scheduler event 
Scenario: Setup outreach event in the scheduler 
  Given timeline of outreach program was determined
    And Outreach channels were determined
    And Social Welfare worker can schedule events  
    And Social Welfare worker has prepared content of the outreach
  When Social Worker create new scheduler bb event 
    And Social Worker attaches event message
  Then new scheduler event is created
    And new scheduler message is created

Relevant Scheduler BB endpoints:

• /event/new

  • Add new event

• /message/new

  • Create content message event 

Note: This assumes that only one event and message will be created. Should we assume that different outreach channels will require different events and messages?

Step 2 Beneficiary targeting Identify target group of potential beneficiaries

Step 2.1 Prepare targeting workflow

Feature: Create schedulernew workflow event 
Scenario: Setup outreach event in the scheduler 
  Given timeline of outreach program was determined Create workflow that adds beneficiary Scheduler BB resources using Digital Registry BB data
  Given Social Worker can create workflows 
    And Outreach channels were determined Workflow is connected to the Digital Registry BB
    And SocialWorkflow Welfareis workerconnected canto schedulethe eventsScheduler BB
   When Social Worker createAnd newFunction/model schedulerto bbevaluate eventpotential beneficiaries is ready
  AndWhen Social Worker creates new attachesworkflow event
message   Then newThen schedulerNew eventworkflow is created 
    And new scheduler message is created Potential beneficiaries who meet the targeting criteria can be identified

Relevant Digital Registries BB endpoints:

• /data/{registryname}/{versionnumber}

  • Access the list of individuals for scoring.

Relevant Scheduler BB endpoints:

• /event/new

  • Add new event

• /message/new

  • Create content message event 

Note: This assumes that only one event and message will be created. Should we assume that different outreach channels will require different events and messages?

• list_details

  • Get information regarding about what event beneficiaries will be appointed to

Relevant Workflow BB endpoints:

• /processes (post)

  • Create new workflow

Step 2.2 Execute targeting workflow

Feature: Schedule notifications for target group

Scenario: List Potentialpotential beneficiaries arefor outreach
 listed forGiven outreachthat   Givena scheduler event washas been created
    And that a targeting workflow process exists
  When Social WorkerWhen queriesthe potentialSocial beneficiariesWorker fortriggers beingthe targetworkflow groupprocess
    And the potential beneficiaries are meet the criteria
    And the potential beneficiaries have signed a consent agreement to be notified
  Then  Then the potential beneficiaries areshould be added as resources in the scheduler BB
    And potentialthey should beneficiariesbe areassociated appointedwith tothe previously created event

Relevant Scheduler BB endpoints:

• /resource/new

  • Save beneficiary in scheduler BB

• /appointment/new

  • Bind potential beneficiary to the event 

Relevant Digital Registries BB endpoints:

• /data/{registryname}/{versionnumber}

  • Query digital registry for target group

Relevant Consent BB endpoints:

• /service/agreement/{agreementId}/

  • Confirm that potential beneficiary has signed the agreement and can be notified about the program

Relevant Workflow BB endpoints:

• /processes/{processId}/start

  • Trigger appointment process

Step 2.3 Notify target group

Feature: Send bulk notifications  
Scenario: Scheduled event is triggered and messages are sent to target group
  Given Target Group was registered in the scheduler BB
    And Scheduler can trigger bulk message in messaging BB
    And Scheduler Alert had been scheduled
  When Alert is triggered
  Then Target group receives notifications through messaging BB
    And Scheduler sets marks action as successfull 

Relevant Scheduler BB endpoints:

• /alert_schedule/new

  • Used to setup trigger for notifying target group

Relevant Messaging BB endpoints:

• /send/email/batch

  • Notify target group. At the moment that’s only available batch endpoint, should be extended when other notification methods are added.

ALTERNATIVE COURSE 

TBA

DATA OUTPUT 

POST-CONDITIONS (SUCCESS CRITERIA)

1. The target audience is aware of the USCT program and its objectives, benefits, constraints, timeline, etc.

2. Potential beneficiaries are encouraged to enroll in the USCT program and they know how to do this.

3. Relevant content has been created and managed for use in the information campaign.

EXCEPTIONS 

1. Target audience doesn’t accept messages used to spread awareness

2. Consent policy to use data to inform about social program has not been created

RELATED BBs

• Messaging BB

• Scheduling BB

• Consent BB

• Identity BB

• Registration BBContent Management BB (not yet developed) (outside of BB use case document)BB

SEQUENCE DIAGRAM