[FEATURE] Ajout d'un lien vers les explications de résultats sur le Certificat Pix (PIX-16247).

 #11250

Author: pix-service-auto-merge

mon-pix/app/components/user-certifications-detail-header.hbs

@@ -37,6 +37,16 @@
           {{t "pages.certificate.professionalizing-warning"}}</p>
       {{/if}}
 
+      {{#if this.displayCertificationResultsExplanation}}
+        <PixButtonLink
+          @href={{this.certificationResultsExplanationUrl}}
+          target="_blank"
+          rel="noopener noreferrer"
+          @variant="tertiary"
+          @iconAfter="openNew"
+        > {{t "pages.certificate.learn-about-certification-results"}}</PixButtonLink>
+      {{/if}}
+
     </div>
   </div>
   {{#if @certification.verificationCode}}

mon-pix/app/components/user-certifications-detail-header.js

@@ -10,6 +10,8 @@ export default class UserCertificationsDetailHeader extends Component {
   @service fileSaver;
   @service session;
   @service currentDomain;
+  @service currentUser;
+  @service url;
 
   @tracked tooltipText = this.intl.t('pages.certificate.verification-code.copy');
   @tracked attestationDownloadErrorMessage = null;
@@ -18,6 +20,18 @@ export default class UserCertificationsDetailHeader extends Component {
     return parseISODateOnly(this.args.certification.birthdate);
   }
 
+  get isUserFrenchReader() {
+    return this.currentUser.user && this.currentUser.user.lang === 'fr';
+  }
+
+  get displayCertificationResultsExplanation() {
+    return this.args.certification.isV3 && (this.currentDomain.isFranceDomain || this.isUserFrenchReader);
+  }
+
+  get certificationResultsExplanationUrl() {
+    return this.url.certificationResultsExplanationUrl;
+  }
+
   @action
   clipboardSuccess() {
     this.tooltipText = this.intl.t('pages.certificate.verification-code.copied');

mon-pix/app/models/certification.js

@@ -50,6 +50,10 @@ export default class Certification extends Model {
     );
   }
 
+  get isV3() {
+    return this.version === 3;
+  }
+
   get maxReachablePixCountOnCertificationDate() {
     return this.maxReachableLevelOnCertificationDate * 8 * 16;
   }

mon-pix/app/services/url.js

@@ -132,6 +132,14 @@ export default class Url extends Service {
     return `https://status.pix.org/?locale=${currentLanguage}`;
   }
 
+  get certificationResultsExplanationUrl() {
+    if (this.currentDomain.isFranceDomain) {
+      return 'https://pix.fr/certification-comprendre-score-niveau';
+    }
+
+    return 'https://pix.org/fr/certification-comprendre-score-niveau';
+  }
+
   get _showcaseWebsiteUrl() {
     const currentLanguage = this.intl.primaryLocale;
 

mon-pix/tests/helpers/service-stubs.js

@@ -67,6 +67,7 @@ export function stubSessionService(owner, sessionData = {}) {
  * @param {string} [userData.firstName='John'] - The first name of the user.
  * @param {string} [userData.lastName='Doe'] - The last name of the user.
  * @param {string} [userData.email] - The email of the user.
+ * @param {string} [userData.lang] - The language of the user.
  * @param {Object} [userData.profile] - The profile of the user.
  * @param {boolean} [userData.mustValidateTermsOfService=false] - Indicates if the user must validate terms of service.
  * @param {boolean} [userData.hasRecommendedTrainings=false] - Indicates if the user has recommended trainings.
@@ -85,6 +86,7 @@ export function stubCurrentUserService(owner, userData = {}, { withStoreStubbed
   const firstName = userData.firstName || 'John';
   const lastName = userData.lastName || 'Doe';
   const fullName = `${firstName} ${lastName}`;
+  const lang = userData.lang || 'fr';
   const email = userData.email || `${firstName.toLowerCase()}.${lastName.toLowerCase()}@example.net`;
   const codeForLastProfileToShare = userData.codeForLastProfileToShare || null;
   const mustValidateTermsOfService = userData.mustValidateTermsOfService || false;
@@ -123,6 +125,7 @@ export function stubCurrentUserService(owner, userData = {}, { withStoreStubbed
             firstName,
             lastName,
             fullName,
+            lang,
             profile,
             codeForLastProfileToShare,
             mustValidateTermsOfService,

mon-pix/tests/integration/components/user-certifications-detail-header-test.js

@@ -2,9 +2,11 @@ import { render as renderScreen } from '@1024pix/ember-testing-library';
 import Service from '@ember/service';
 import { click } from '@ember/test-helpers';
 import { hbs } from 'ember-cli-htmlbars';
+import { t } from 'ember-intl/test-support';
 import { module, test } from 'qunit';
 import sinon from 'sinon';
 
+import { stubCurrentUserService } from '../../helpers/service-stubs';
 import setupIntlRenderingTest from '../../helpers/setup-intl-rendering';
 
 module('Integration | Component | user certifications detail header', function (hooks) {
@@ -16,6 +18,7 @@ module('Integration | Component | user certifications detail header', function (
 
     hooks.beforeEach(async function () {
       // given
+      stubCurrentUserService(this.owner);
       store = this.owner.lookup('service:store');
       certification = store.createRecord('certification', {
         id: '1',
@@ -92,6 +95,7 @@ module('Integration | Component | user certifications detail header', function (
 
   module('when domain is french', function (hooks) {
     hooks.beforeEach(function () {
+      stubCurrentUserService(this.owner, { lang: 'fr' });
       class CurrentDomainServiceStub extends Service {
         get isFranceDomain() {
           return true;
@@ -136,7 +140,7 @@ module('Integration | Component | user certifications detail header', function (
       });
     });
 
-    module('when certification is delivered before 2022-01-01', function () {
+    module('when certification is v2 and delivered before 2022-01-01', function () {
       test('should not display the professionalizing warning', async function (assert) {
         // given
         const store = this.owner.lookup('service:store');
@@ -246,9 +250,35 @@ module('Integration | Component | user certifications detail header', function (
       });
       assert.ok(true);
     });
+
+    test('should display a link to the results explanation', async function (assert) {
+      // given
+      stubCurrentUserService(this.owner, { lang: 'en' });
+      const store = this.owner.lookup('service:store');
+      const certification = store.createRecord('certification', {
+        birthdate: '2000-01-22',
+        date: new Date('2018-02-15T15:15:52Z'),
+        isPublished: true,
+        status: 'validated',
+        version: 3,
+      });
+      this.set('certification', certification);
+
+      // when
+      const screen = await renderScreen(hbs`<UserCertificationsDetailHeader @certification={{this.certification}} />`);
+
+      // then
+      assert
+        .dom(screen.getByRole('link', { name: t('pages.certificate.learn-about-certification-results') }))
+        .hasAttribute('href', 'https://pix.fr/certification-comprendre-score-niveau');
+    });
   });
 
-  module('when domain is not french', function () {
+  module('when domain is not french', function (hooks) {
+    hooks.beforeEach(function () {
+      stubCurrentUserService(this.owner, { lang: 'en' });
+    });
+
     test('should not display the professionalizing warning', async function (assert) {
       // given
       class CurrentDomainServiceStub extends Service {
@@ -327,11 +357,64 @@ module('Integration | Component | user certifications detail header', function (
       });
       assert.ok(true);
     });
+
+    module('when user is a French reader', function () {
+      test('should display a link to the results explanation', async function (assert) {
+        // given
+        stubCurrentUserService(this.owner, { lang: 'fr' });
+
+        const store = this.owner.lookup('service:store');
+        const certification = store.createRecord('certification', {
+          birthdate: '2000-01-22',
+          date: new Date('2018-02-15T15:15:52Z'),
+          isPublished: true,
+          status: 'validated',
+          version: 3,
+        });
+        this.set('certification', certification);
+
+        // when
+        const screen = await renderScreen(
+          hbs`<UserCertificationsDetailHeader @certification={{this.certification}} />`,
+        );
+
+        // then
+        assert
+          .dom(screen.getByRole('link', { name: t('pages.certificate.learn-about-certification-results') }))
+          .hasAttribute('href', 'https://pix.org/fr/certification-comprendre-score-niveau');
+      });
+    });
+
+    module('when user is not a French reader', function () {
+      test('should not display a link to the results explanation', async function (assert) {
+        // given
+        stubCurrentUserService(this.owner, { lang: 'en' });
+        const store = this.owner.lookup('service:store');
+        const certification = store.createRecord('certification', {
+          birthdate: '2000-01-22',
+          date: new Date('2018-02-15T15:15:52Z'),
+          isPublished: true,
+          status: 'validated',
+        });
+        this.set('certification', certification);
+
+        // when
+        const screen = await renderScreen(
+          hbs`<UserCertificationsDetailHeader @certification={{this.certification}} />`,
+        );
+
+        // then
+        assert
+          .dom(screen.queryByRole('link', { name: t('pages.certificate.learn-about-certification-results') }))
+          .doesNotExist();
+      });
+    });
   });
 
   module('when there is an error during the download of the attestation', function () {
     test('should show the common error message', async function (assert) {
       // given
+      stubCurrentUserService(this.owner);
       const fileSaverSaveStub = sinon.stub();
 
       class FileSaverStub extends Service {

mon-pix/tests/unit/services/url-test.js

@@ -507,4 +507,36 @@ module('Unit | Service | url', function (hooks) {
       });
     });
   });
+
+  module('#certificationResultsExplanationUrl', function () {
+    module('when domain extension is .fr', function () {
+      test('returns the pix.fr website certification details page', function (assert) {
+        // given
+        const service = this.owner.lookup('service:url');
+        service.currentDomain = { isFranceDomain: true };
+        const expectedCertificationResultsExplanationUrl = 'https://pix.fr/certification-comprendre-score-niveau';
+
+        // when
+        const certificationResultsExplanationUrl = service.certificationResultsExplanationUrl;
+
+        // then
+        assert.strictEqual(certificationResultsExplanationUrl, expectedCertificationResultsExplanationUrl);
+      });
+    });
+
+    module('when domain extension is .org', function () {
+      test('returns the pix.org website certification details page', function (assert) {
+        // given
+        const service = this.owner.lookup('service:url');
+        service.currentDomain = { isFranceDomain: false };
+        const expectedCertificationResultsExplanationUrl = 'https://pix.org/fr/certification-comprendre-score-niveau';
+
+        // when
+        const certificationResultsExplanationUrl = service.certificationResultsExplanationUrl;
+
+        // then
+        assert.strictEqual(certificationResultsExplanationUrl, expectedCertificationResultsExplanationUrl);
+      });
+    });
+  });
 });

mon-pix/translations/en.json

@@ -599,6 +599,7 @@
       "issued-on": "Delivered on",
       "jury-info": "Notes from the examining body are not displayed on the verification page of your certificate.",
       "jury-title": "Notes from the examining body",
+      "learn-about-certification-results": "Learn more about my Pix Certification results",
       "professionalizing-warning": "The Pix certificate is recognised as professionalising by France Compétences upon reaching a minimum score of 120 pix.",
       "title": "Pix Certificate",
       "verification-code": {

mon-pix/translations/fr.json

@@ -599,6 +599,7 @@
       "issued-on": "Délivré le",
       "jury-info": "Les observations du jury ne sont pas partagées sur la page de vérification de votre certificat.",
       "jury-title": "Observations du jury",
+      "learn-about-certification-results": "Comprendre mes résultats de Certification Pix",
       "professionalizing-warning": "Le certificat Pix est reconnu comme professionnalisant par France compétences à compter d’un score minimal de 120 pix",
       "title": "Certificat Pix",
       "verification-code": {