Spécification des exigences

Ce document permet de spécifier les différentes exigences et requis du projet "Les colons de Catane". Ces exigences devront être respectées afin de permettre la mise en place d’un logiciel durable et faciliter la phase de développement.

Aucune jusqu’à présent.

Le public visé par cette spécification comprend les développeurs de l’application, les personnes responsibles du game design ainsi que les personnes chargées des tests.

Les colons de Catane est un jeu passionnant, véritable succès parmi les jeux de société contemporains. Sorti en 1995 sous le nom "Les Colons de Catane", ce jeu de société reste l’un des plus vendus dans le monde et insufflé un véritable renouveau dans le monde des jeux de stratégie et de plateau.

Le système logiciel à produire est une version simplifiée du jeu de plateau Les colons de Catane, qui sera désigné par le terme "Les colons de Catane" dans le présent document.

Le reste de ce document contient une description globale du système logiciel Les colons de Catane (section Description générale, les exigences fonctionnelles spécifiques (section Exigences fonctionnelles) et les exigences non-fonctionnelles du système (voir Exigences non-fonctionnelles.

Vous avez l’âme d’un colon et vous avez toujours eu envie de développer votre civilisation en récoltant des ressources et construisant des routes et des villes ? Il sera désormai possible de le faire en ligne via un appareil connecté.

Les colons de Catane est un jeu de plateau, de gestion et de stratégie « à l’allemande » où l’objectif est de développer ses colonies en construisant des routes, des villes et surtout en récoltant des ressources. Grâce à son plateau qui se construit à chaque début de partie, la rejouabilité est très bonne, car chaque partie sera différente avec des ressources placées à des endroits différents. Vous allez ensuite devoir récolter les bonnes ressources pour réussir à acquérir le plus de points possible pour être le premier à arriver à un nombre de points défini. Ce jeu est fait pour être joué entre 3 et 4 joueurs Ainsi, "Les colons de Catane" est une version électronique en ligne du jeu de plateau.

Bien que le système soit distribué et organisé en différents composants, les joueurs doivent le percevoir comme un seul logiciel. La figure Figure 1 présente l’architecture globale du logiciel. Un joueur crée un salon en interagissent avec un client Web, qui utilise le protocole HTTP pour communiquer avec (au maximum) le serveur de jeu. Une fois le salon composé de 3 à 4 joueurs il est alors possible de déclencer une partie. Les serveurs utilisent le protocole TCP/IP à l’aide d’une librairie Websocket pour communiquer avec le serveur de jeu et permettre des intéractions plus spontanées entre les joueurs.

Le logiciel Les colons de Catane doit assurer plusieurs fonctions principales :

Les fonctions secondaires du logiciel :

Les fonctions annexes du logiciel :

Le logiciel Les colons de Catane n’a qu’une seule classe d’utilisateurs : les joueurs. Les joueurs peuvent avoir différents niveaux : débutants, intermédiaires ou experts. Cependant, indépendamment de leur niveau, les joueurs doivent utiliser la même interface utilisateur pour jouer les uns contre les autres.

Par la suite dans une version future du projet certains joueurs, notamment les créateurs d’un lobby, auront plus de responsabilités au cours d’une partie en cours. Ils seront considérer comme administrateur de leur partie.

Le logiciel Les colons de Catane doit fonctionner sur tout système d’exploitation populaire et récent : Linux, Windows, ou MacOS.

Il doit également possible de déployer l’application serveur au sein d’un container comme Docker.

Le client Web devra fonctionner sur tout navigateur Web récent : Firefox, Chrome, Safari, ou Edge. L’application web devra être un minimum responsive pour être utilisable par des appareils ayant un écran de taille moyenne comme les tablettes numériques.

Aucune contrainte de conception.

Aucun jusqu’à présent.

L’interface devra permettre d’être utilisable sur la plupart des écrans en mode paysage. Il devra être simple à comprendre. Pour cela le plateau de jeu lors d’une partie devra impérativement au centre de l’écran.

Le plateau de jeu à besoin d’un interface.

Le logiciel n’interagit pas directement avec un quelconque dispositif matériel.

La partie client du logiciel doit fonctionner sur des navigateurs web commun (chromium, firefox).

Dans un premier temps afin de communiquer lors de la création d’un lobby le client et le serveur de jeu doivent utiliser le protocole HTTP. Une fois au sein d’une partie le client et le serveur de jeu doivent utiliser les WebSockets. En matière de sécurité les données ne devant pas identifier les utilisateurs aucune solution d’encryption ne sera nécessaire dans un premier temps.

Les règles du jeux doivent être contraintes par le serveur pour ne pas permettre de triche. Toute la logique doit être continuellement vérifier côté serveur. Il ne faut pas faire confiance au client.

Les joueurs n’ayant besoin d’aucun compte pour jouer, il faut prévenir des acteurs malveillants qui pourraient essayer de jouer à leur place en envoyant des reqûetes directement au serveur à l’aide de logiciels tiers pour nuire à l’expérience de jeu. Pour éviter cela il faudra que chaque joueur au sein d’une partie soit identifiable à l’aide d’un Token (JWT) unique propre à lui. De ce fait, si le serveur réalise une action, il devra s’assurer qu’elle provienne bien de ce joueur. Avec cette méthode, il sera impossible d’altérer directement via l’API les actions d’un autre joueur pendant une partie. Si un utilisateur lance plusieurs instances de client, chaque instance au sein d’une partie devra posséder un identifiant (token) unique. Nous pouvons ainsi sécuriser une partie en cours tout en permettant au joueur de n’avoir aucun compte.

On utilisera HTTPS dès que possible pour la communication client - serveur.

La transmission et le stockage d’informations sensibles doit être fait de manière sécurisé en utilisant la librairie Bcrypt.

Le stockage des données permettant d’identifier directement un utilisateur doit respecter les règlementations locales tel que le RGPD.

Voir le chapitre [domain] (analyse du domaine) pour plus de détails.