UNICEF Primero - UNHCR Progres Interoperability

>> See the Github site for the complete project overview and finalized documenation: openfn.github.io/primero-progres/

OpenFn documentation for interoperability interagency referrals exchange solution in Gambella, Ethiopia. See below for the Implementation Checklist.

Change Management

Note that commits to staging and master will be auto-deployed to connected projects on OpenFn.org.

• Always work on a branch!
• Please test all changes on the staging branch/ staging OpenFn.org project FIRST!
• Once changes pass on staging, you can commit* specific change to master.

⚠️ * Consider that jobs on staging branch may have additional logs for troubleshooting and testing assistance. ⚠️

Implementation Checklist

(1) Functional Requirements

• [x] Design POCs identified?
• [x] Business value articulated? Link: Draft SRD document
• [x] User Stories documented?
• [x] User flow diagrams finalized? Link: Draft Visio Diagrams
• [x] Mappings specs - first draft signed off by business owners. See Gambella mapping specs.

(2) System APIs

Primero

• [x] Primero API confirmed? Primero API v2 docs & language-primero
• [x] Access to system dev/test environments? Primero Demo Gambella site
• [x] API authentication tested?

Progres

• [x] Progres API developed?
• [x] Access to system dev/test environments?
• [x] API authentication tested?
• [x] APIs tested? DTP API Endpoints: https://antirrio.azure-api.net/primero-uat/ReceiveIncomingReferral https://antirrio.azure-api.net/primero-uat/ReceiveDecisionOutgoingReferral

(3) Data Flows

• [x] Primero UX documentated? See Slides on UX & Data Entry Steps
• [x] System Data Flow diagrams finalized? See Diagrams
• [x] Technical specifications finalized? See links
• [x] Finalize Mapping specs v2 (with transformation rules, technical specs) finalized? See Gambella mapping specs.
• [x] Assumptions documented? (re: human workflows, data entry, consent, other criteria)
• [x] Testing plan drafted

(4) Flow Triggers

• [x] OpenFn job triggers confirmed?

Proges--> Primero: message filter trigger (event-based): DTP to send notifications to OpenFn Inbox.

Primero --> Progres: timer (cron) trigger: Every X hours, OpenFn to send GET HTTP request to Primero to check for new data.

(5) Sharing & Security

• [ ] Dating sharing agreement finalized? Link: __
• [ ] Security configuration & logging specs sign-off (what information can we log in OpenFn?)

(6) Administration

Provisioning, Hosting, & Maintenance

• [x] Deployment: SaaS
• [x] Configuration: OpenFn
• [ ] Maintenance: Software maintenance, security updates, etc. - confirm roles & responsibilities across systems

Support

• [ ] OpenFn administrator users & access levels confirmed?
• [ ] Support POCs identified for Primero?
• [ ] Support POCs identified for Progres?

Outstanding Items/ Questions

1. How are UNHCR cases eventually closed if related referrals are rejected. Do we keep these cases open over time?
2. Manual process for scenarios where child revokes consent --> how is the other system notified?
3. Documentation on how to localize mappings for every country implementation for: services, protection concerns, languages, Primero focal point username, Progres business units
4. Documentation on Focal Point users setup in Primero (e.g., progresv4_primero_intake user)

Assumptions

1. UNICEF Primero updates on services will not be shared with UNHCR/Progres in this first phase, only the original referral request.
2. If UNICEF Primero user revokes consent for a case, then a manual SOP will be determined for communicating that with UNHCR. The interoperability solution will not communicate this change in case.
3. The exchange of only 4 service types (a.k.a. "intervention types") will be supported between agencies. See mapping here. Primero and Progres users must be trained to NOT send other service types in interagency referral requests.
4. ...