Mise à jour documentation PCRU

Le module PCRU d'OSCAR permet d'automatiser la soumission des contrats de recherche depuis OSCAR vers les systèmes PCRU, afin d'éviter aux gestionnaires d'avoir à réaliser une double saisie.

Le fonctionnement nominal est le suivant :

 - l'établissement contacte PCRU pour demander un accès au serveur SFTP permettant le dépôt automatique de fichiers CSV par OSCAR,

 - l'établissement utilise son accès au site internet PCRU pour récupérer un accès au serveur SFTP permettant le dépôt automatique de fichiers CSV par OSCAR,

 - l'administrateur OSCAR renseigne les informations de connexion au serveur SFTP dans la configuration (login, mot de passe...),

 - l'administrateur OSCAR configure un CRON qui chaque jour va déclencher le dépôt automatique d'un fichier CSV contenant les nouvelles activités sur le serveur SFTP de PCRU,

 - les gestionnaires activent le transfert vers PCRU pour les activités concernées.

 - l'administrateur OSCAR télécharge les fichiers CSV et PDFs à envoyer à PCRU puis téléverse les fichiers sur le site web PCRU (https://pcru.dr14.cnrs.fr),

 - l'administrateur vérifie la bonne intégration des activités sur le site web PCRU puis met à jour par des requêtes SQL le statut des activités ainsi déposées.

## Récupération d'informations de connexion SFTP sur le site web PCRU

## Configuration du module PCRU

![PCRU accueil](./images/pcru_accueil.png)

Allez sur la page d'accueil du site PCRU puis dans le menu à droite cliquez sur le lien "Votre Tutelle".

![PCRU tutelle](./images/pcru_tutelle.png)

Une fois sur la page concernant votre tutelle, cliquez à droite sur le bouton "Modifier".

![PCRU tutelle modifier](./images/pcru_tutelle_modifier.png)

Une fois sur la page de modification de votre tutelle :

 - Notez la valeur du champ affiché "Login serveur de dépôt / APIs" car ce cera le login à renseigner dans OSCAR pour se connecter à PCRU

 - Cliquez sur "Serveur de Dépôt PCRU" pour déplier et faire apparaître les options de configuration

 - Dans le champ "Adresses IP à autoriser", renseignez l'adresse IP sortante de votre serveur OSCAR (celle qui sera visible par le serveur SFTP PCRU quand il recevra une demande de connexion SFTP émanant de votre instance OSCAR) afin que PCRU l'autorise.

 - Ensuite, si vous voulez une connexion par mot de passe, cliquez sur le bouton "Réinitialiser le mot de passe"

 - Pour une connexion par clé SSH, générez une clé puis renseignez la partie publique de votre clé dans le champ "Clé ssh pour sftp" puis cliquez sur "Actualiser la clé SSH"

Enfin, assurez vous que de votre côté aussi (infrastructure réseau de votre établissement), la connexion sortante est autorisée du serveur OSCAR vers l'hôte PCRU-Depot.dr14.cnrs.fr port 31000.

Pensez à tester à partir du serveur OSCAR que la connexion peut être établie, sans passer par OSCAR, directement en ligne de commande :

```bash

sftp -P31000 SitePMA_XXXXXXX@PCRU-Depot.dr14.cnrs.fr

```

## Configuration du module PCRU dans OSCAR

### Gestion des privilèges

![PCRU configuration du module](./images/pcru-config2.png)

Quand on soumet des informations à PCRU, certains champs attendent une valeur parmi une liste bien précise définie par PCRU. Toutefois il n'existe pas aujourd'hui d'API permettant de récupérer automatiquement ces valeurs. Si ces valeurs venaient à évoluer, l'administrateur OSCAR devra donc les intégrer à la main. Par exemple, si un gestionnaire indique ne pas pouvoir soumettre une activité à PCRU car le pôle de compétitivité concerné n'apparaît pas dans la liste affichée par OSCAR alors qu'il est bien disponible sur le site de PCRU, cela indique que l'administrateur devra mettre à jour ce référentiel.

Quand on soumet des informations à PCRU, certains champs attendent une valeur parmi une liste bien précise définie par PCRU. Toutefois il n'existe pas aujourd'hui d'API permettant de récupérer automatiquement ces valeurs.

### Configuration initiale des référentiels

L'administrateur doit d'abord commencer par s'assurer que les anciennes valeurs sont supprimées de sa base de données (tables pcrupolecompetitivite, pcrusourcefinancement, pcrutypecontract) puis relancer un import des valeurs à partir de fichiers json de configuration. Commencez par exécuter les requêtes SQL suivantes :

```sql

DELETE FROM pcrupolecompetitivite;

DELETE FROM pcrusourcefinancement;

DELETE FROM pcrutypecontract;

```

Vous devriez alors voir des listes vides quand vous allez sur les différents référentiels dans la partie administration du site. Vous pouvez alors lancer l'import des valeurs à jour (début mai 2025) à partir des fichiers json en cliquant sur le gros bouton vert "Mettre à jour les référentiels" ou bien en allant sur la page d'adminisration pour chacun des 4 référentiels puis en cliquant sur le bouton "Actualiser depuis le fichier JSON dans oscar/install". Maintenant les listes devraient être à jour avec les nouvelles valeurs. Par exemple dans "Correspondance des types de contrat" vous devriez voir "Convention-cadre" qui n'était pas présent auparavant.

### Mise à jour des référentiels

Si ces valeurs venaient à évoluer, l'administrateur OSCAR devra donc les intégrer à la main. Par exemple, si un gestionnaire indique ne pas pouvoir soumettre une activité à PCRU car le pôle de compétitivité concerné n'apparaît pas dans la liste affichée par OSCAR alors qu'il est bien disponible sur le site de PCRU, cela indique que l'administrateur devra mettre à jour ce référentiel.

Les quatres référentiels sont les suivants :

 - types de contrats,