Créer un endpoint d'api pour importer des actions dans l'Historique de parcours d'un carnet

[amaurydubot]

🍣 Contexte / problème

Aujourd'hui, les éléments d'action de parcours (action) peuvent être uniquement ajoutés dans le carnet en "manuel", c'est-à-dire via saisie directe dans le carnet par un pro sur la base de notre référentiel. Or, nous devons offrir d'avantage de flexibilité dans l'ajout d'éléments relatifs à des actions d'insertion car deux cas de figure peuvent se présenter :

1. Certains acteurs appelés à travailler avec nous - notamment les CD - vont vouloir reprendre un historique d'actions issu de leur SI. Ne pouvant évidemment saisir à la main dans chaque carnet un stock historique d'actions, ils souhaiteraient donc avoir accès un module d'import rapide d'éléments d'actions.
2. Même s'agissant des nouveaux entrants et des nouvelles actions qui seront posées au fil des accompagnements, certains acteurs ne feront jamais de saisie dans Carnet de bord (ex : Pôle emploi, hypothèse probable dans le cadre de France Travail) et souhaitent donc continuer à travailler sur la base de leur propre référentiel d'actions (ex : JRE - journal de recherche de Pôle emploi).

🚀 Solution

Créer une nouvelle route pour importer des fichiers d'actions.
Le modèle de fichier à importer, qui sera accompagné de sa notice explicative (sur un pad) et d'un fichier à importer en exemple, respectera le format suivant :

NIR	Date de prescription	Date de réalisation	Label action	Thème	SIRET structure

Les éléments à respecter seraient donc :

• Le "NIR" qui devra impérativement matcher avec le NIR d'un carnet déjà existant sur Carnet de bord ;
• La "Date de prescription" qui devra respecter le format JJ/MM/AAAA
• La "Date de réalisation" devra respecter le format JJ/MM/AAAA et n'est pas obligatoire
• Le "Thème" qui devra impérativement reprendre le libellé d'un de nos 9 thèmes (c'est-à-dire nos focus) ;
• Le "SIRET structure" qui devra impérativement correspondre au SIRET d'une des structures existantes dans le déploiement du manager appelé à réaliser l'import.

--> Seul le "Label action" n'est pas normé = on accepte la valeur telle qu'elle existe dans leur SI.

--> Cette demande revient très régulièrement lors de nos échanges et nous souhaitons donc la prioriser. Nous assumons d'être confrontés à trois "risques" que nous jugeons minimes par rapport à la plus-value de réalisation de cette feature :

• Un risque d'erreur au niveau de la date : éventuelle confusion entre la date de prescription et la date de réalisation de l'action ;
• Un risque que certains labels soient "concurrents" d'éléments de notre propre référentiel (c'est-à-dire qu'ils renvoient à des accompagnements similaires sans toutefois porter le même nom que nos action) ;
• Un risque de compliquer un éventuel requêtage des action à l'avenir si nous allons vers le développement d'une telle fonctionnalité.

🛠 Dépendances

• Siretiser les structures #1187 : important pour éviter les erreurs dans le nom des structures.
• Casser le lien action - target au profit d'un lien action - focus #1185 : indispensable car, si les managers appelés à importer des actions pourront aller jusqu'à relier dans le fichier leurs actions à nos focus, ils ne seraient toutefois pas en mesure de le faire pour les target.