Vue d'ensemble
Les principaux composants de SAINet sont présentés dans l’image ci-dessous:
Prérequis et recommandations
Les différents composants peuvent être compilés et lancés sur le poste en local. Pour cela il sera nécessaire d’avoir au préalable:
- JDK
- Maven
- un accès a git
- Git Bash (Windows)
- NetBeans ou un autre IDE qui supporte Java et Maven
- (pour la documentation) Node.js (>=14)
Organisation de l’espace de travail
Le serveur ainsi que le jeu de donnée de test sont à récupérer dans son espace de travail local. Le serveur peut ensuite être compilé (en mode embedded) puis lancé en lui spécifiant un répertoire de travail temporaire ainsi qu’une base de données de référence à importer.
Il est préférable d’installer SAINet et ses différents composants dans un répertoire à la base de disque pour éviter les problèmes liés au nom de chemin trop long, surtout sous Windows (par exemple C:\Work
Serveur SAINet & Base de donnée (res_data)
Les répertoires de travail du serveur SAINet et les bases de données de référence res_data doivent être clonées en local à partir du repository git.
Base de donnée (res_data)
Les projets du groupe res_data sont des jeux de données de référence qui permettent de lancer un serveur avec des données déjà préchargées. Elles sont aussi utilisées lors de l’execution des tests d’intégration.
Il existe plusieurs bases de données de référence qui correspondent à chaque métier (régie, creche, …).
Afin d’éviter d’avoir à installer un serveur de base de données sur la machine, SAINet utilise H2, qui est une base de données embarquées assez proche de MySQL/MariaDB.
Serveur SAINet
Le serveur SAINet est une application Java EE qui peut être lancée en mode Embedded Server après compilation.
Pour le lancer, il est nécéssaire de spécifier le répertoire qui contient la base de donnée res_data à importer ainsi qu’un espace de travail temporaire (ici tmp-runtime).
Client riche
Installation / Lancement
La procédure d’installation du client riche permet de récupérer l’installeur via ce lien.
Une fois installé, le client riche se met à jour automatiquement au lancement.
Résumé du fonctionnement
- Récupération/préparation des sources:
- récupération res_data.
- récupération sainet.
- compilation sainet.
- Lancement du serveur en mode embedded.
- Lancement du client ou des outils.