Contacts

Contacts est un prototype sous forme de webapp qui permets à un utilisateur de générer un avatar par rapport à des critères non conventionnels. Pour le front-end, la majorité est écrite en javascript native et utilise socket.io ainsi que jQuery pour la communication avec l’API de génération d’avatar. Le back-end utilise node.js, express js et socket.io

Installation

Pré-requis

Pour utiliser l’application, il vous faudra :

• Node.js testé sur la version v18.13.0+
• Npm
• Git optionnel mais recommandé

Démarche d’installation

1. Clonez l’application en utilisant la commande git clone [<https://github.com/KomplexKapharnaum/contacts-app>](<https://github.com/KomplexKapharnaum/contacts-app>) ou installez manuellement le code source en allant sur https://github.com/KomplexKapharnaum/contacts-app
2. Ouvrez un terminal à l’intérieur de l’application clonée
3. Exécutez la commande npm i pour installer les dépendances
4. Pour lancer l’application, utilisez node server
5. Ouvrez une page web sur l’ordinateur hébergé, l’interface client de l’application est disponible sur http://localhost:4000

Note importante

<aside> ⚠️ L’application est faite pour fonctionner sur un environnement smartphone, ce qui veut dire que la quasi-totalité des éléments DOM de la webapp ne détecteront pas la souris étant donné qu’ils utilisent les touch events. Il est donc impératif d’activer la fonctionnalité de simulation de toucher à l’aide des outils développeur de votre moteur web.

</aside>

Structure de l’application

Application server

Le programme serveur (utilisé pour communiquer avec les clients et la génération d’image) est écrite dans le fichier server.js. Ce fichier tourne sous node.js et utilise notamment les librairies socket.io ainsi que express js.