1. Intégration

1.1. Introduction

Cette section vise à décrire brièvement les éléments techniques permettant d’installer, paramétrer, intégrer et exploiter le logiciel. Pour plus de détails sur les caractéristiques techniques, il faut consulter la section développement.

1.2. Plateforme technique

Ce logiciel a été développé de façon généralement ouverte, mais est optimisé, utilisé et testé sur une plateforme donnée. L’utilisation d’une autre plateforme pourrait provoquer des dysfonctionnements.

1.2.1. Serveur

  • Linux CentOS 6 à 7
  • Apache 2.2 à 2.4
  • PHP 5.5 à 7
  • PostgreSQL 9.4 à 9.6

1.2.2. Client PC

  • Windows XP à 7
  • Firefox ESR
  • Lecteur NFC USB de type émulateur clavier sur 7 octets
  • Webcam USB 640x480

1.2.3. Client Mobile

  • smartphone 3G
  • écran: viewport 360x520 px
  • Android 5 à 6
  • lecture NFC
  • Firefox mobile

1.3. Installation

1.3.1. Installation d’une application openMairie

Consulter la documentation openMairie: Installation OM 4.6

Le module PostGIS n’est pas utilisé par openMarchéForain.

Une fois Apache/PHP et PostgreSQL en place, une base UTF-8 crée et paramétrée dans /dyn/database.inc.php, vous pouvez utiliser le script install.sh à la racine pour déployer la base de données initiale.

Le compte admin/admin permet une connexion administrateur sur l’appication web. Le compte demo/demo correspond à unutilisateur avec le profil CADRE.

1.3.2. Précision sur /var

Ce répertoire peut être monté hors de la racine documentaire, sa taille étant variable et ne contenant aucun code:

  • /var/filestorage/ : contient les fichiers générés ou stockés par l’application
  • /var/log/ : contient les fichiers journaux
  • /var/tmp/ : contient les fichiers temporaires téléchargeables ou téléversés
  • /var/tmp_sirene/ : contient les fichiers temporaires téléchargés depuis le site openData du SIRENE

1.3.3. Précision sur /web

Ce répertoire peut faire l’objet d’une politque de publication internet différente: il représente le module qui expose le service de consultation de la fiche commerçant.

1.4. Paramétrage

1.4.1. Synchronisation annuaire

Pour bénéficier de la synchronisation de l’annuaire applicatif (om_utilisateur) avec l’annuaire d’entreprise (LDAP), on peut activer l’interface LDAP. Le filtre d’accès à l’annuaire doit être adapté à votre annuaire: voir documentation openMairie

Un ordonnanceur tel que CRON peut permettre d’exécuter cette synchronisation périodiquement. Cela sécurise la déshabilitation d’un utilisateur, et peut également permettre une habilitation automatique. Pour ce faire, il faut exécuter le script shell qui se trouve dans le répertoire /bin/ . Lui-même fait appel à un web-service REST exposé par le répertoire /services/.

1.4.2. Récupération alertes SIRENE

Pour bénéficier de la récupération des alertes SIRENE, il faut configurer l’accès à la base de données de chargement temporaire: dyn/services.inc.php. Enfin, il faut activer l’interface SIRENE dans les paramètres en base (cf manuel utilisateur - paramétrage et www.sirene.fr). La table de chargement peut être établie sur une base tierce, non sauvegardée et supportant 10 Go de données, il faudra alors que le serveur puisse accéder en local au fichier csv téléchargé. A noter que la fonction COPY n’est exécutable que par le super-user du serveur de base.

Un ordonnanceur tel que CRON peut permettre d’exécuter cette récupération périodiquement. Cela sécurise la mise à jour progressive des laertes en base. Pour ce faire, il faut exécuter le script shell qui se trouve dans le répertoire /bin/ . Lui-même fait appel à un web-service REST exposé par le répertoire /services/.

1.4.3. ré-écriture URL

Pour que le scan (NFC/QRC) du badge du commerçant déclenche une action dans l’application, il est conseillé d’écrire sur les badges des URL pérennes, redirigées ensuite en interne sur les URL effectives. La ré-écriture peut être effectuée par le serveur Web (Apache module Rewrite). Par exemple

  • NFC :
    • de /monsite.fr/marche/nfc/badge/1234
    • vers /openmarcheforain/scr/form.php?obj=commercant_par_telephone&idx=]&action=9&id_badge=1234
  • QRC:
    • de /monsite.fr/marche/qrc/badge/1234
    • vers /openmarcheforain/web/cnsinfo.php?id_badge=1234