UNICEF HOPE

HOPE (Humanitarian cash Operations and Programme Ecosystem) est la plateforme de l’UNICEF pour la distribution d’aide monétaire. Elle couvre l’enregistrement des bénéficiaires et des ménages avec dédoublonnage, le ciblage et les cycles de programme, les listes de paiement et leur versement via des prestataires de services financiers, la vérification et le rapprochement des paiements, ainsi que la gestion des plaintes et des retours.

HOPE est distribué sous licence AGPL-3.0. Gratuit — non facturé.

Ce qui est installé

Frontend : un serveur web placé devant HOPE, qui sert aussi ses fichiers statiques.
Backend : l’application HOPE.
Workers en arrière-plan : trois processus (un worker, un worker de tâches périodiques et un planificateur) qui exécutent les tâches en arrière-plan de HOPE.
Init : une étape unique qui vérifie qu’Elasticsearch dispose des plugins nécessaires à HOPE, prépare la base de données, crée le compte administrateur et charge la liste des pays et les codes pays, puis s’arrête.
Base de données : une base de données PostgreSQL avec l’extension PostGIS.
Redis : la file d’attente et le cache des workers en arrière-plan.
Elasticsearch : le moteur de recherche de HOPE. Une étape unique ajoute les plugins de recherche nécessaires à HOPE avant son démarrage.

HOPE est servi depuis une seule adresse web : l’adresse principale de l’installation. Vous pouvez y accéder via l’adresse IP du serveur, ou lui attribuer un domaine.

Avant l’installation

HOPE est publié uniquement pour les serveurs x86-64 (amd64). Installez-le sur un serveur x86-64. Sur un serveur ARM (arm64), il s’exécute en émulation, ce qui est nettement plus lent, et l’assistant ne vous en empêche pas : Adéquation du serveur affiche un avertissement Architecture : arm64, mais vous laisse continuer.
Si vous utilisez un serveur Elasticsearch que vous exploitez déjà, les plugins analysis-phonetic et analysis-icu doivent être installés sur chaque nœud. Pour les installer, exécutez elasticsearch-plugin install analysis-phonetic analysis-icu sur chaque nœud, puis redémarrez Elasticsearch. Avant que HOPE ne prépare sa base de données, l’installation vérifie la présence de ces plugins. S’il en manque un, le déploiement échoue et l’erreur indique le plugin manquant. L’Elasticsearch fourni dispose déjà des deux.
Elasticsearch utilise plus de mémoire que tout autre élément de l’installation. Deployment size (taille de déploiement) définit son tas. Si vous ajoutez un -Xmx plus grand dans Elasticsearch JVM options (options JVM d’Elasticsearch), gardez-le sous la limite du conteneur Elasticsearch : 2 Gio en small, 4 Gio en medium.

Choisissez une Deployment size :

small : 2 workers web, 2 workers en arrière-plan plus 1 pour les tâches périodiques, et un tas Elasticsearch de 1 Gio. Ses conteneurs sont limités à environ 8 Gio de mémoire au total.
medium : 4 workers web, 4 workers en arrière-plan plus 2 pour les tâches périodiques, un tas Elasticsearch de 2 Gio et plus de mémoire pour la base de données, pour des registres de bénéficiaires plus grands, des listes de paiement plus volumineuses et davantage d’utilisateurs simultanés. Environ 14,5 Gio au total.

Vous pouvez changer de taille plus tard avec Redimensionner. Les nouveaux nombres de workers et limites de mémoire s’appliquent au redémarrage de l’installation.

La vérification Adéquation du serveur de l’assistant vous indique si votre serveur est assez puissant pour la taille choisie.

Options

Champ	Rôle
Deployment size	`small` ou `medium`, comme ci-dessus.
Public domain (domaine public)	Le nom d’hôte que HOPE utilise dans les liens des e-mails et des exports, comme `hope.example.org`. Laissez-le vide pour utiliser l’IP du serveur.
Administrator username (nom d’utilisateur administrateur)	Le compte administrateur créé au premier démarrage. Par défaut `admin`. Une mise à niveau ultérieure ne le modifie pas.
Administrator email (e-mail de l’administrateur)	L’adresse e-mail de ce compte. Par défaut `admin@example.org`.
Maximum upload size (taille maximale de téléversement)	Le plus gros fichier pouvant être téléversé, comme `50m` ou `200m`. Augmentez-la pour les imports de bénéficiaires et les fichiers de rapprochement volumineux. Par défaut `50m`.

Avancé contient Allowed hosts (hôtes autorisés, par défaut * ; restreignez-le à votre domaine une fois celui-ci rattaché), Elasticsearch JVM options, et les paramètres d’e-mail sortant : SMTP host (hôte SMTP ; laissez-le vide pour n’envoyer aucun e-mail), SMTP port (port SMTP), SMTP username (nom d’utilisateur SMTP), SMTP password (mot de passe SMTP) et From address (adresse d’expéditeur). SMTP password est scellé et n’est plus jamais affiché. Si vous rattachez plutôt une connexion Outbound email relay (relais d’e-mail sortant), elle remplit tous ces champs pour vous. La base de données s’appelle toujours hopedb. Sur le serveur de base de données fourni, son utilisateur est toujours hope. Vous pouvez aussi utiliser un serveur PostgreSQL, Redis ou Elasticsearch que vous exploitez déjà à la place de ceux fournis. Voir services externes.

Première connexion

Le premier administrateur est le compte indiqué dans Administrator username et Administrator email, que vous saisissez dans l’assistant. La plateforme génère son mot de passe.

Lorsque vous cliquez sur Créer, le portail affiche le mot de passe une seule fois, sous Identifiants de première connexion. Copiez-le dans votre gestionnaire de mots de passe avant de quitter la page.

Ouvrez l’adresse de l’installation et connectez-vous avec ce nom d’utilisateur et ce mot de passe. Pour changer le mot de passe plus tard, changez-le dans HOPE.

Le mot de passe de la base de données et la clé secrète de l’application sont eux aussi générés par la plateforme et scellés. Vous n’avez jamais à les saisir.

Connexions

HOPE peut fournir à une autre installation du même serveur :

Cash transfer programme data (read-only) (données des programmes de transferts monétaires, en lecture seule) : un accès en lecture seule à la base de données HOPE, pour des outils de reporting comme Metabase. Les comptes utilisateurs, les données de connexion, les sessions et les jetons sont exclus.

HOPE peut utiliser depuis une autre installation :

Outbound email relay : permet à HOPE d’envoyer ses notifications de plaintes et de paiements. Facultatif.

Voir connexions.

En savoir plus

Documentation de HOPE