Projet XML miage1 : Annuaire Etablissement

Introduction

Projet destiné à la géolocalisation des établissements français

Petite architecture

• Le client envoie une requête (souvent en AJAX) au serveur Node.js.
• Le serveur Node.js fait suivre la requête au serveur baseX
• Le serveur baseX répond au serveur Node.js
• Le serveur Node.js formate la réponse de baseX et la transmet au client
• Le client réalise un formatage léger et l'intègre dans son HTML dynamiquement

Démarrer l'application

Configurer et lancer BaseX

• Télécharger baseX qui est un logiciel stand alone (sans installation)
• Télécharger le fichier BDD XML contenant les établissements
• Lancer la GUI de baseX en lançant ./bin/basexgui (ajouter .bat pour Windows)
• Créer une base en important le fichier XML dans baseX et nommer la etablissement_superieur
• Installer le module functx-1.0-doc présent dans le projet git (options > packages > install dans la gui de baseX)
• Pour activer les requêtes préconfigurées vous devez ajouter le fichier adef.xq (présent dans le dossier bd du projet) dans le dossier webapp de baseX (Pensez aux liens symboliques pour ne pas avoir à dupliquer les fichiers)
• baseX est configuré, vous pouvez lancer le serveur en utilisant le script ./bin/basexhttp (ajouter .bat pour Windows)
• Le serveur fonctionne sur à l'URL http://localhost:8984/ + <id requête>

Installer et lancer le serveur Node.js

• Pour installer le serveur Node.js utiliser simplement npm install

• Pour lancer le serveur Node.js, deux méthodes :

  • Utiliser simplement npm start

  • Utiliser l'outil supervisor :

    • Lorsque vous changez un élément du serveur Node.js, il doit être redémarré, supervisor le redémarre automatiquement (gain de temps)
    • Installer supervisor : npm install supervisor -g
    • Lancer l'application avec supervisor: supervisor ./bin/www

• Lancer votre navigateur avec le http://localhost:30001/adef pour accéder à la page

To do

• L'application ne fonctionne qu'en local, le client localhost est hardcodé, il faudrait pouvoir le porter sur un serveur distant
• Reste à faire :
  • Affichage des établissements sur la carte (Salwa)
  • Réalisation des statistiques et des graphiques (Thais)
  • Réalisation des exports de statistiques (Dragos)