Overview

Petra is the name of the closed source product whose ideas and concepts are used to lay ground for the new open source software Openpetra, which shall be developed here. Actual in openpetra there exists an inter office communication, but in case of rewriting a software it may be a good idea to improve the communication size and format to actual standard.

The best choice for a new standard to exchange inter office data, it may be the xml-format and the best way to get an overview about the different communication types and communication contents it may be a diagram.

And UML-component diagram may not be the best choice to draw a set of offices sending communication messages from one to each other but actually my software don’t leave me an other choice. So a “component” represents an either an OM-office using an openpetra installation, the ICH using it’s own software and a recipient-information-server (RIS) which shall be developed independently from the openpetra software.

This page does not handle the Message details but only the concept of how to use the different messages in their specific content.

From the view of a recipient there exits three different types of national om offices.

there exist(/s) (an/) office(/s) which (is/are) collecting his gift income for his mission (OM-Office-home).
there exists one office which is actual mission field is assigned to and which is paying his invoices (OM-Office-target-country).
there are offices he is not involved with (this offices are not refered in this documentation)

The ICH is uniqe in the system and responsible for the information exchange and to perform some specific services.

The Recipient Information Server (RIP)

The RIP is a common Webserver and a simple php-content-management-system (CMS) may be a good choice to start. In This case you can use the complete modules in an existing CMS to invoke a recipient account and to let the recipients manage their account data themselve. This means:

Double-Opt-In to create an account
A "todo"-behaviour-List in case of a lost password
Joining the own account with one ore more Open-Petra-Contact-IDs (for each county there may be a different Contact-ID) = Accreditation ...
Manage their own contact data like an address, phone-number and E-Mail
Submitting the actual contact data simultaneously to all recipient joined office(s)
Receiving their gift relevant information (gift comments assigned to the recipients).

This list may be not complete ...

The Roles

The folling roles are relevant

The recipient itself
A cleark in each om-office-home
A cleark in the om-office-target-country
The web Admin of the RIS

The Accreditation Process

The very first step is the accreditation and in this case the recipient itself inserts all the data into a web form creating a data record for common use and for an use only for the communication with one om-home-office. For example his name and address is the same against each of the different offices but he will have different contact numbers and the communication stati are different.

The recipient inserts his data and start a accreditation process to each of his home office. In each of this offices this request will be checked and accepted or rejected. In case of an accepting this request, the user will be enabled to start some other automatic processes like an address or phone number update or something else. Otherwise the RIS-System-Admin will be informed about a possibly hacking attack to be able to investigate this some more detailed.