updated rncp_rules

docs/RNCP_RULES.md

@@ -6,6 +6,17 @@ données qu'ils nous fournissent, sur la base d'un import régulier.
 Toutefois, certaines données sont imprécises ou inexactes pour notre utilisation, aussi Avril
 ajoute un ensemble de règles de gestion lors de l'import qui sont documentées ici-même.
 
+## Note préalable
+
+Ces règles d'import sont soumises à modifications relativement fréquente, aussi il est possible que
+la présente documentation ne soit pas systématiquement à jour. Aussi, il peut être utile de se 
+référer au code source pour connaître les dernières règles en vigueur, particulièrement en ce qui concerne
+des listes de données brutes (ex: RNCP_IDs).
+
+Le code source de ces règles est implémenté essentiellement dans deux fichiers :
+- [authority_matcher.ex](https://github.com/StartupsPoleEmploi/avril/blob/master/lib/vae/authorities/rncp/authority_matcher.ex) : règles de rapprochement des certifiers
+- [custom_rules.ex](https://github.com/StartupsPoleEmploi/avril/blob/master/lib/vae/authorities/rncp/custom_rules.ex) : règles de la surcouche Avril d'import des certifications
+
 ## Le rapprochement des certifiers
 
 Du fait qu'il n'existe pas de référentiel pour les institutions fournissant des diplômes, leurs noms
@@ -14,7 +25,14 @@ pour règles :
 
 - transformer les chiffres romains en chiffres arabes (`paris-vii == paris-7`)
 - ignorer l'ordre des mots et certains mots de liaison (`université de Paris == Paris université`)
-- permettre des imprécisions d'orthographe sauf pour les noms propres (`Vincennes != Vincenne`)
+- permettre des imprécisions d'orthographe sauf pour les noms propres (`Vincennes != Vincenne`). La liste des noms propres est disponible [ici](https://github.com/StartupsPoleEmploi/avril/blob/master/lib/vae/authorities/rncp/authority_matcher.ex#L24)
+
+Comme cela ne suffit pas, il a fallu ajouter des aliases pour le nom de certains certifiers. Le rapprochement
+s'effectue sur le slug des noms, et la liste des aliases est disponible 
+[ici](https://github.com/StartupsPoleEmploi/avril/blob/master/lib/vae/authorities/rncp/authority_matcher.ex#L176)
+
+Enfin, nous avons pris le parti de ne pas inclure la liste des certifiers disponible 
+[là](https://github.com/StartupsPoleEmploi/avril/blob/master/lib/vae/authorities/rncp/authority_matcher.ex#L10)
 
 ## Certifications ignorées (non importées dans Avril) :
 
@@ -29,7 +47,7 @@ pour règles :
 
 - les fiches actives au RNCP associées au ministère de la solidarité
 - les BTS au RNCP associées au ministère de l'enseignement suppérieur
-- les ID RNCP suivants :
+- les ID RNCP suivants ([source](https://github.com/StartupsPoleEmploi/avril/blob/master/lib/vae/authorities/rncp/custom_rules.ex#L38)) :
   + 4875
   + 34825
   + 34826
@@ -38,44 +56,44 @@ pour règles :
 
 ## Certifications dissociées de l'éducation nationale alors qu'elles le sont dans le RNCP :
 
-- les fiches avec l'un des acronymes suivants :
+- les fiches avec l'un des acronymes suivants ([source](https://github.com/StartupsPoleEmploi/avril/blob/master/lib/vae/authorities/rncp/custom_rules.ex#L17)) :
   + CQP
   + DEUST
   + BUT
   + MASTER
   + Licence Professionnelle
   + Titre ingénieur
 - les fiches déjà associées au ministère de la jeunesse, des sports et de la cohésion sociale
-- les ID RNCP suivants :
-  + 230
-  + 367
-  + 2028
-  + 2514
-  + 2829
-  + 4495
-  + 4496
-  + 4500
-  + 4503
-  + 4505
-  + 18363
-  + 25467
-  + 28557
-  + 34824
-  + 34827
-  + 34829
-  + 34862
-  + 36004
+- les ID RNCP suivants ([source](https://github.com/StartupsPoleEmploi/avril/blob/master/lib/vae/authorities/rncp/custom_rules.ex#L34)) :
+    + 230
+    + 367
+    + 2028
+    + 2514
+    + 2829
+    + 4495
+    + 4496
+    + 4500
+    + 4503
+    + 4505
+    + 18363
+    + 25467
+    + 28557
+    + 34824
+    + 34827
+    + 34829
+    + 34862
+    + 36004
 
 ## Certification dissociée du ministère de la jeunesse, des sports et de la cohésion sociale alors qu'elle l'est dans le RNCP
 
-- La fiche au RNCP ID 492
+- La fiche au RNCP ID 492 ([source](https://github.com/StartupsPoleEmploi/avril/blob/master/lib/vae/authorities/rncp/custom_rules.ex#L166))
 
 ## Certifications dissociées du ministère de l'agriculture alors qu'elles le sont dans le RNCP
 
 - Les fiches dont le niveau est > 5
 
 ## Certifications rendues actives alors qu'elles sont inactives au RNCP :
-- les ID RNCP suivants :
+- les ID RNCP suivants ([source](https://github.com/StartupsPoleEmploi/avril/blob/master/lib/vae/authorities/rncp/custom_rules.ex#L147)) :
   + 25520
   + 25522
   + 25471
@@ -84,12 +102,12 @@ pour règles :
 
 - les BEP
 - les fiches de l'éducation nationale dont la fin de validité est définie à la fin de l'année en cours, à partir du mois de juillet.
-- les ID RNCP suivants :
+- les ID RNCP suivants ([source](https://github.com/StartupsPoleEmploi/avril/blob/master/lib/vae/authorities/rncp/custom_rules.ex#L141)) :
   + 462
   + 4504
   + 5440
   + 31191
-- les fiches de CCI France dont l'ID RNCP **n'est pas** parmis les suivants :
+- les fiches de CCI France dont l'ID RNCP **n'est pas** parmis les suivants ([source](https://github.com/StartupsPoleEmploi/avril/blob/master/lib/vae/authorities/rncp/custom_rules.ex#L26)) :
   + 11200
   + 23827
   + 23869
@@ -116,4 +134,4 @@ pour règles :
 
 ## Certifications avec acronyme personnalisé BATC
 
-- La fiche à l'ID RNCP 23909
+- La fiche à l'ID RNCP 23909 ([source](https://github.com/StartupsPoleEmploi/avril/blob/master/lib/vae/authorities/rncp/custom_rules.ex#L117))