[DMP 2024]: Update Mifos PH-EE Mojaloop Connector to vNext

[DavidH-1]

Ticket Contents

Description

Mifos Payment Hub EE (PH-EE) provides a seamless and simply way for DFSPs of any size to connect to and effectively participate in instant inclusive payment systems like Mojaloop. PH-EE and Mojaloop are both digital public goods that have selected as key DPGs for financial inclusion to enable digital public infrastructure that helps to achieve the SDG of no poverty. PH-EE provides an extensible modern orchestration engine to easily add connections to route transactions via new payment systems by building simple connectors. We already have a connector for Mojaloop but it was built to integrate with the APIs for the current versions of Mojaloop, vNow. Since then, a new architecture for Mojaloop has been built, vNext, the underlying API contracts will still be the same but our Mojaloop connector for PH-EE needs to be update to work with vNext. Additional components are now available in vNext to manage security and authentication better and these could now also be worked for the Mojaloop connector for PH-EE.

Goals & Mid-Point Milestone

Goals

• [1] [Research Mojaloop vNext and the new components and how they differ to vNow]
• [2] [Scope out with mentors the design and changes needed to Mojaloop connector]
• [3] [Implement changes to Mojaloop connector in PH-EE to support vNext]
• [4] [Modify or change BPMN flows to work with vNext]
• [5] [Update Mojaloop connector to work with additional security components available in vNext ]
• [6] [Implement tests to ensure working mojaloop connector for vNext with PH-EE\

Setup/Installation

https://github.com/openMF/ph-ee-connector-mojaloop-java

Expected Outcome

DFPSs that are looking to test out Mojaloop vNext can now utilize PH-EE to facilitate integration and participation.

Acceptance Criteria

No response

Implementation Details

• Deploy Mojaloop, Payment Hub EE and Mifos/Fineract locally via Mojafos
• Test out working integration between Mojaloop vNow and Mifos PH-EE
• Deploy Mojaloop vNext
• Update connector component in PH-EE
• Update BPMN diagrams as part of PH-EE
• Update other components in PH-EE to leverage new security/authentication components in vNext
• Implement test cases for updated Mojaloop connect for PH-EE

Mockups/Wireframes

No response

Product Name

Mojaloop vNext Connector for Mifos PH-EE

Organisation Name

The Mifos Initiative

Domain

Financial Inclusion

Tech Skills Needed

Java, Spring Boot, Other

Mentor(s)

Edcable

Category

Backend, Other

[AieshaShetty]

Hi @DavidH-1 , I would like to work on this project. My tech stack includes core Java, Spring Boot, and JPA. Is there any smaller issue to work on this first?

[DavidH-1]

Looping in @Tom

On 21 Apr 2024, at 06:12, Ankita Sahoo @.***> wrote:

Hi @DavidH-1 https://github.com/DavidH-1 , I would like to work on this project. My tech stack includes core Java, Spring Boot, and JPA. Is there any smaller issue to work on this first?

— Reply to this email directly, view it on GitHub https://github.com/openMF/ph-ee-connector-mojaloop-java/issues/20#issuecomment-2067907117, or unsubscribe https://github.com/notifications/unsubscribe-auth/BBRYA4PUHY2IUHQXNCOEC73Y6NDDHAVCNFSM6AAAAABGFTD2PGVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDANRXHEYDOMJRG4. You are receiving this because you were mentioned.

[AbhimanyuSamagra]

Do not ask process related questions about how to apply and who to contact in the above ticket. The only questions allowed are about technical aspects of the project itself. If you want help with the process, you can refer instructions listed on Unstop and any further queries can be taken up on our Discord channel titled DMP queries. Here's a Video Tutorial on how to submit a proposal for a project.

[Ratnesh2003]

I have done the setup for the project and ready to work upon it. I was researching about the Mojaloop connector. Can I have an idea about how can I explore more about vNext and vNow? I couldn't find any specific documentation about the vNow or vNext. Thanks!! @DavidH-1 @edcable

[Ratnesh2003]

@AbhimanyuSamagra Can you help me reach out to the mentor? I haven't received any reply, neither here nor on discord._

[DavidH-1]

Hi @Ratnesh2003 you can find out more details about Vnow and VNext on the Mojaloop forums. @tdaly may also be able to help. We have set up this slack channel for technical questions on alot of our projects that focus around Mojaloop and Mojafos. https://mifos.slack.com/archives/C070ARCGP6Z

[Ratnesh2003]

Hello @DavidH-1 , Thanks for your response, I highly appreciate it. I will definitely checkout the forums for this. However, I believe I can't join the slack channel since that requires an @mifos.org account. Is there any other way where I can contact for help? Or just put up any query here?

[DavidH-1]

Mifos slack is open you can request to join it without a mifos.org account.

[DavidH-1]

I have dropped you an invite from the slack to your DM.

[Ratnesh2003]

Thanks!! I have received and joined the slack.

[merciajeno]

Hello @DavidH-1 , I have experience in Core Java, Spring Boot, JPA , Restful API and Database(MySQL). Can you elaborate what are the other requirements needed to solve the given problem statement?

[Ratnesh2003]

Weekly Learnings & Updates (To be filled by contributor)

Week 1

• Setting up of the environment for the development of ph-ee-mojaloop-connector using Mojafos.
• Helped in resolving bugs and deployment issues of Mojafos.

Week 2

• Learned about kubectl and helm charts for the deployment of Mojafos.
• Learned about camunda zeebe, BPMN diagrams and modeller.
• Studied the documentations of Mojaloop vNext and current APIs being used in the PH-EE ML connector.

Week 3

• Successfully deployed Mojofos for the environment setup.
• Helped in resolving major issues with the deployment of Mojaloop vNext.
• Updated the documentation for deployment of Mojaloop vNext: https://github.com/openMF/mojafos/pull/47
• Was able to run the Mojaloop Connector successfully.

Week 4

• Learned about K3s and deployment using Helm Charts.
• Gained understanding about the architecture of Payment Hub - EE and Mojaloop.
• Setup the postman collection to run Mojaloop APIs for the vNext and test out the differences between vNow and vNext.
• Gone through the code base of PH-EE ML Connector in order and understood about the current Zeebe Worker API mappings

Week 5

• Gained understanding about correct host names for the payment hub deployment through Mojafos.
• Setup the postman collection for the Payment Hub APIs and configure the environment variables of the postman collection for PH-EE.
• Successfully ran ops-bk-sandbox.fynarfin.io host to run operations APIs of Payment Hub through postman.
• Identified issues with ingress controller for bulk transaction APIs in Paymenthub.

Week 6

• Learn about ingress controllers in kubernetes and nginx.
• Tried to fix ops.sandbox.fynarfin.io host by modifying the Mojafos deployment by adding Keycloak and configuring it.

• Tried to fix by changing the host names from suffix as .sandbox.fynarfin.io to .local to point to local services in the deployment.

  Week 7

• Gained understanding about the changes in Gazelle (Mojafos V2) from Mojafos.

[tdaly61]

Weekly Goals (Updated by T Daly a mentor for @Ratnesh2003 )

Week 1

• [x] Env setup and preparation for Mojafos installation
• [x] Understand Mifos and Mojafos environment kubernetes, kubectl , zebee, camuda , Mojaloop vNext

Week 2

• [x] Deploy Mojafos and understand its components , make sure all components deploy

Week 3

• [x] run the Mojaloop conector

Week 4

• [ ] run transactions through the Mojaloop connector document difficulties and raise issues/PR's (Jira) that need to be resolved to enable transactions to be run

Week 5

• [ ] Using the learning and resources from week 5 the goal for this week is to run the postman collection at https://raw.githubusercontent.com/openMF/ph-ee-env-template/master/PostmanCollections/Payment%20Hub.json against existing Mifos/PHEE deployment so as to understand the PHEE APIs and payment flow
• [ ] run this existing workload against ideally the new supplied Mojafos deployment OR alternatively the existing MIfos/PHEE deployment and crucially document the setup in bullet points so others can replicate (collaborate with other C4GT Mojafos contributors in doing this)