Skip to content

Latest commit

 

History

History

pro

README.md

pass-culture-pro

C'est la version (browser) de l’application PRO frontend du pass Culture. Ce repo contient également un storybook des éléments graphiques

Il faut aller voir le README dans https://github.com/pass-culture/pass-culture-main pour être informé des différentes lignes de commande associées à ce repo.

Note sur Yarn

Yarn est prometteur, on vous conseille de l’utiliser. Tâchez de l’installer globalement sur votre ordinateur (https://yarnpkg.com/en/docs/install), puis:

  yarn

Installation et Lancement de l’application Pro

  • yarn install
yarn start

Troubleshooting:

Sur linux + chrome / chromium l’application peut se charger indéfiniment un workaround est de changer de navigateur, une solution est proposée ici : https://vitejs.dev/guide/troubleshooting.html#dev-server

Lancement des tests

  • Lancement des tests unitaires

    yarn test:unit

  • Lancement des tests end to end

    • Prérequis aux lancement des tests E2E Cypress
    • Lancement du backend pc start-backend
    • Lancement des tests depuis la ligne de commande yarn test:e2e

Note, si vous lancez les tests e2e hors Docker et sous OSX, Cypress tentera de contacter le backoffice sur le localhost ipv6. Comme, par défaut, le backend écoute sur les ports en ipv4, il faudra lancer le backend avec:

$ FLASK_IP="::1" python src/pcapi/app.py

ADAGE

Nous intégrons une sous-route du portail Pro (/adage-iframe/) dans une iframe au sein d'ADAGE, la plateforme des établissements scolaires permettant de gérer leurs activités culturelles.

Accès à l’iframe ADAGE

Application web pour les rédacteurs de projets scolaires, leur permettant de réserver des offres sur le pass Culture pour leurs élèves.

  1. Ouvrir la console bash
$ pc bash
  1. Générer un token via la commande
flask generate_fake_adage_token
  1. Copier l’url générée dans le navigateur pour accéder à l’app

Affichage d'offres en local

Comme le local est branché sur algolia de testing, les ids qui sont remontés d'algolia sont ceux de testing, et il n’est pas certain qu'on ait les mêmes en local.

Pour récupérer les ids de certaines offres en local, on peut utiliser un index local. Pour cela, il faut :

  • Créer un nouvel index sur la sandbox algolia : <votre_nom>-collective-offers

  • Créer un fichier .env.development.local dans le dossier pro/src et renseigner le nom de l’index dans la variable VITE_ALGOLIA_COLLECTIVE_OFFERS_INDEX

  • Créer un fichier .env.local.secret dans le dossier api et renseigner les variables suivantes :

ALGOLIA_COLLECTIVE_OFFER_TEMPLATES_INDEX_NAME=<votre_nom>-collective-offers
ALGOLIA_TRIGGER_INDEXATION=1
ALGOLIA_API_KEY=<demander l’api key>
ALGOLIA_APPLICATION_ID=testingHXXTDUE7H0
SEARCH_BACKEND=pcapi.core.search.backends.algolia.AlgoliaBackend
  • Ouvrir la console bash
$ pc bash
  • Réindexer vos offres collectives
flask reindex_all_collective_offers

Standards de code et d'architecture

La documentation est intégrée au projet, aux travers de fichiers README à la racine des dossiers principaux.

Vous trouverez une documentation générale ainsi que des liens vers les différents README en suivant ce lien :

Standards de code et d'architecture

Dette technique

Nous utilisons SonarCloud pour monitorer la dette technique.

Lien vers le projet Portail Pro sur SonarCloud