Xilium

2023-2024

📋 Description

Xilium est une application de ticketing pour les étudiants et les professeurs de l'IUT de Vélizy.
Les utilisateurs peuvent créer des tickets pour signaler des problèmes dans l'IUT, et les techniciens de l'IUT peuvent les traiter grâce à une interface dédiée.

🔧 Utilisation

1. Télécharger la dernière release de l'application : Page releases
2. Extraire l'archive
3. Installer Docker
4. Lancer le fichier run.sh pour démarrer l'application :

./run.sh

Pour éteindre l'application, il suffit de lancer la commande suivante :

docker compose down

Pour lancer les tests sur l'application, il suffit de lancer la commande suivante (après avoir démarré l'application) :

docker exec -it xilium-app-1 bash -c "cd /var/www/html/tests && ./run_test.sh"

⚠️ xilium-app-1 est le nom du container de l'application. Il peut être différent en fonction de votre installation. Faite un docker ps pour obtenir le nom du container.
Tous les tests sont automatiquements exécutés lors des merges et push sur les branches main et develop.

⚠️ Il faut être administrateur pour lancer les commandes Docker. (sudo ou root). Sinon il faut ajouter l'utilisateur au groupe Docker.

🦺 Maintenance

Un manuel de maintenance est disponible dans le dossier doc/manuel_maintenance.md.

📚 Documentation

Pour générer la documentation, il suffit de lancer la commande suivante :

doxygen Doxyfile

La documentation sera disponible ici : doc/doxygen/html/index.html

💻 Compatabilités

L'application a été testées sur les systèmes suivants :

• Windows 10/11
• Rasbian (Debian Bullseye 64 bits)
• MacOS Sonoma
• Ubuntu 22.04.4 (LTS)

⚠️ L'application n'est pas compatible avec les systèmes ARM 32 bits. MariaDB et MySQL sous Docker ne supporte pas cette architecture.

💿 Logiciels et versions

• Docker : 26.0.0 [Raspberry]
• Debian : 11 (Bullseye) [Raspberry]
• php-apache : 8.2 [Docker]
• mariadb : 11.3 [Docker]
• Python : 3.xx [Docker]

🤝 Contributeurs

• Eliott BARKER
• Chakib OUALI
• Kylian GRAVIER
• Victor GUILLERAY
• Alexis LEMOUTON