IHM Front ######### Cette documentation décrit la partie front/Angular de l'ihm et en particulier sa configuration et ses modules. -------------------------------------------------------------------------------------------------------------- Utils et général / Composition du projet Angular ************************************************ TODO Composition du projet ===================== NPM + Bower : npm est utilisé pour gérer les dépendances liées au build de l'application (par exemple la minification), tandis que bower est utilisé pour gérer les dépendances de l'appication (par exemple angular, moment.js, ...) Pour construire le projet, l'outil gulp a été mis en place. Celui permet d'automatiser les tâches permettant d'arriver à la construction d'un livrable contenant les fichiers html, javascript et css minifiés. La commande 'gulp package' permet de construire le projet. Tests unitaires: Voir ihm-tests.rst Gulp et déploiement à chaud =========================== Le déploiement à chaud est possible via la commande 'gulp serve'. Si un fichier est modifié pendant que le serve est lancé, les modifications seront automatiquement mises à jour. Le backend ciblé peut être spécifié en ajoutant un fichier local.json (Voir local.json.sample) et en modifiant la propriété target. Karma et Tests unitaires ======================== Les tests unitaires se lances via les commandes: - 'gulp tests' : Lance un serveur (basé sur le module karma serveur) + les tests karma (Unitaires) et Protractor (e2e) - 'gulp testKarma' : Lance les tests unitaires seules (Nécéssite un serveur lancé) - 'gulp testProtractor' : Lance les tests end to end seuls (Nécéssite un serveur lancé) Qualité du code Javascript ========================== La qualité du code javascript est validée grâce au module lint. Pour celà, il suffit de lancer la commande 'gulp lint'. Modèle MVC ========== Le front va petit à petit être migré vers une architecture reprenant le modèle MVC: - Une couche Modèle, récupérant les données depuis l'API vitam (Server d'app + dossier resources Angular) - Une couche Service, traitant les promesses des resources ou proposant des méthodes utilitaires - Une couche Vues, proposant l'affichage d'une page avec son controller associé Au final l'arbo type des fichiers devrait être la suivante: /app => Fichiers de conf globaux du projet (bower/npm/jshint/index.html/...) /core => Fichiers de configuration globaux (core.module.js, main.controller.js, app.config.js, app.module.js, ...) /static => Fichiers de traductions front (Key=value pour les champs statiques de l'IHM) /services => Services utilitaires partagés de l'application (Faire des modules pour chaque services si externalisables) /directives => Directives utilitaires partagés de l'application (Faire des modules pour chaque directives si externalisables) /filters => Filtres utilitaires partagés de l'application ? /resources accession-register.resource.js => Une méthode par endpoint du server d'app (Search / GetAll / GetDetails / ...) archive-unit.resource.js => Une méthode par endpoint du server d'app (Search / GetArchive / GetDetails / ...) ... /services accession-register.service.js => Une ou plusieurs méthodes par méthode de la resource fund-register archive-unit.service.js => Une ou plusieurs méthodes par méthode de la resource archive-unit ... /pages (Nom à valider) /accession-register-detail => Controller + Template de la page Détails de Registre de Fonds /archive-unit => Controller + Template de la page archive-unit ... /styles /css /img /fonts => A migrer dans le /css ? Internationalisation ==================== Cette partie est gérée par le module angular-translate Pour ajouter une traduction, ajouter une clé valeur dans le fichier static/languages_.json L'entrée être formatée de la manière suivante "..."="" où : - est le groupe de page ou du module dans l'application (Exemple archiveSearch ou administration) - est le nom de page dans le groupe (Exemple managementRules ou archiveUnitDetails) - est le nom du bloc dans la page (Exemple searchForm ou technicalMetadata) - est le nom de la clé (Exemple 'id' ou 'evDetData') Si possible essayez de regrouper les clés définies par groupe/detail/bloc/ordre alphabetique pour s'y retrouver. Pour utiliser une traduction, utilisez dans une instruction angular de votre HTML le filtre translate: .. code-block:: html
{{'archiveSearch.searchForm.id' | translate}}
Si votre key est dynamique et présente dans une variable, il est possible d'inserer du js en plus de la chaine: .. code-block:: html
{{'archive.archiveUnitDetails.technicalMetadata.' + metadata[$index] | translate}}
Enfin il est également possible de faire le traitement de traduction en js en appliquant le filtre: .. note:: $filter doit avoir été injecté .. code-block:: javascript var translatedLabel = $filter('translate')('archiveSearch.searchForm.id'); .. todo:: Rendre dynamique la langue choisi pour les traductions (actuellement static FR) .. todo:: Utiliser la langue de fallback fr (ou autre ?) .. todo:: Une grosse partie des constantes (js) et des String statiques (html) devraient être mises dans ces fichiers .. todo:: Récupérer la liste des valeurs du référentiel VITAM (Build / Appel API)