README.adoc

7 Wonders

Introduction

L’objectif de ce projet est de spécifier, concevoir et mettre en œuvre une version en ligne du jeu de plateau 7 Wonders.

Resources

7 Wonders est un jeu de stratégie qui se déroule à travers 3 âges successifs comportant chacun 6 tours de jeu. Chaque époque se joue de manière identique et repose sur un système de draft. Chaque joueur choisit une carte de sa main, la joue et passe les cartes restantes au joueur suivant.

Les règles du jeu sont disponibles en ligne, sur différents sites:

• Règles du jeu

• Jeux à volonté

• Tutoriel YouTube en français

Préparation

Équipes de développement

Pour réaliser ce projet, vous allez vous organiser en groupes de 4 étudiants.

Les participants du projet doivent impérativement utiliser leurs comptes étudiants de GitLab. Généralement, ces comptes commencent par la lettre E suivie par 6 chiffres et 1 lettre.

Si vous utilisez un autre compte que celui contenant votre code étudiant, vous n’aurez pas de note de projet.

Environnement

1. Avant toute chose, un membre du groupe doit créer un "Fork" du projet sur le serveur. Pour ce faire, cliquez sur l’icône "Fork" ("Créer une divergence" en français) de la page du projet, ou alors cliquez sur le lien suivant: Fork

2. Ajoutez ensuite les autres membres du groupe à votre fork.

3. Chaque membre du groupe doit cloner ce fork du projet (et non pas celui d’origine). Par la suite, toutes les modifications devront être poussées sur ce fork.

Il ne doit y avoir qu’un seul fork par groupe d’étudiants. Il sera utilisé comme espace de rendu des fichiers liés au projet.

Organisation du code source

Cette version initiale du projet s’appuie sur l’article Utilizing Maven Front-end Plugin for Angular & Spring Boot de Rion Halili.

L’utilisation de Maven pour compiler un projet TypeScript peut poser certains problèmes, notamment si vous utilisez Windows. Si c’est le cas, vous pouvez vous passer de Maven et utiliser directement npm (ou yarn, gulp, etc.).

Mise à jour du projet

Le projet originel sera mis à jour fréquemment pour corriger des erreurs et ajouter des exemples de code source. Cela impliquera la mise à jour de vos divergences pour récupérer les changements. Pour cela, vous devez faire:

git remote add upstream https://gitlab.univ-nantes.fr/naomod/ooad/projet-2021.git # pas besoin si déjà fait
git pull upstream master

• La première ligne ajoute le dépôt originel et le nomme "upstream"

• La deuxième ligne récupère les changements et les fusionne avec votre divergence

Les mises à jour peuvent créer des conflits sur vos divergences : vous devrez corriger ces conflits. Vous trouverez plus d’informations sur la résolution de conflits ici.

Tâches à réaliser

Le processus de développement suivra le modèle de développement agile : vous allez réaliser et délivrer plusieurs versions du projet.

Livrables attendus

1. Livrable 1, échéance le vendredi 15 octobre :

   • Analyse du domaine: Cas d’utilisation "Préparation", classes conceptuelles, actions/activités

   • Spécification des exigences : Spécification des cas d’utilisation de connexion, choix d’une partie, préparation.

   • Spécification des composants : Spécification initiale de l’interface du composant "Serveur", permettant la connexion au serveur.

2. Livrable final, échéance le vendredi 17 decembre 2021:

   • Analyse du domaine : mise à jour du livrable précédent

   • Spécification des exigences : Spécification de tous les cas d’utilisation du projet.

   • Spécification des composants : Spécification de tous les composants du projet.

   • Conception détaillée : Conception détaillée de tous les composants.

   • Code source, tests unitaires et d’intégration.

Critères d’évaluation

Les critères qui seront utilisés pour évaluer le travail rendu son les suivants:

• Le respect des exigences logicielles.

• La qualité du dossier de conception rendu.

• La précision, la correction et la clarté de la conception : diagrammes, descriptions textuelles, etc..

• La cohérence entre la conception et le code.

• La qualité du code source.

Les critères d’évaluation listés ci-dessus seront les seuls respectés. Ainsi, lisez bien les spécifications des exigences et assurez-vous de bien les respecter. Pour rendre un code source de qualité, rappelez-vous de ce que vous avez appris dans le module Construction et évolution de logiciels.