Spécification du logiciel de Gestion des Tournois de Mahjong - Auteur: Lionel Legaie Création: 23 avr. 2009
←
→
Transcription du contenu de la page
Si votre navigateur ne rend pas la page correctement, lisez s'il vous plaît le contenu de la page ci-dessous
Spécification du logiciel de Gestion
des Tournois de Mahjong
Auteur: Lionel Legaie Equipe: Clément Trung
Création: 23 avr. 2009 Nicolas Pochic
Olivier Boivin
Version: 1.4
Date: 19 juin 2009Spécification du logiciel de Gestion des Tournois de Mahjong 2/21
Table des matières
1. Organisation.............................................3 7.3. Le mode de saisie..........................10
1.1. Découpage.......................................3 7.3.1. Sélection de la partie...............10
1.2. Planning............................................3 7.3.2. Saisie rapide...........................10
2. But du logiciel...........................................4 7.3.3. Saisie de la valeur de la main. 10
3. Caractéristiques du logiciel......................4 7.3.4. Gagnant / Donneur..................10
3.1. Les différentes parties......................4 7.3.5. Pénalités..................................10
3.2. La sauvegarde..................................4 7.3.6. Les totaux................................10
3.3. La version multilingues.....................4 8. Les statistiques......................................11
4. L'architecture du logiciel..........................5 8.1. Les statistiques tournois.................11
4.1. Le Serveur........................................5 8.2. Les statistiques joueurs..................11
4.2. Le(s) Client(s)...................................5 9. L'affichage des résultats........................12
4.3. Environnement de développement. .5 9.1. Présentation avant tournoi.............12
4.3.1. Langage de programmation......5 9.2. Présentation entre les sessions.....12
4.3.2. Outils.........................................5 9.3. Présentation à la remise des prix...12
4.3.3. Base de données......................5 9.3.1. Export des résultats pour le site
4.3.4. Gestion de production de projet5 web....................................................12
4.3.5. Framework................................5 10. Les impressions...................................13
4.4. Exemple: architecture du Tournoi de 11. Maquettes............................................14
Paris.........................................................6 11.1. Maquette des Paramètres............14
5. Le paramétrage du tournoi......................7 11.2. Maquette de la Saisie...................15
5.1. Le paramétrage du tournoi...............7 11.3. Maquette des Statistiques............16
5.2. Les participants................................7 11.4. Maquette des Résultats................17
6. Le tirage au sort des tables.....................8 11.5. Maquette de l'Impression..............18
6.1. Le tirage au sort................................8 11.6. Maquette fichier des participants..19
6.2. Les documents à produire................8 11.7. Maquette des parcours.................20
7. La saisie des scores des joueurs............9 12. Divers...................................................21
7.1. La saisie...........................................9 12.1. Page d'accueil..............................21
7.2. Rappel de l'attribution des scores....9 12.2. Nom du logiciel.............................21
7.2.1. Comptage..................................9 12.3. Autres...........................................21
7.2.2. Points de table..........................9
Fédération Française de MahjongSpécification du logiciel de Gestion des Tournois de Mahjong 3/21
1. Organisation
1.1. Découpage
Lots Domaine Date
Lot 1 Saisie des scores Appli. serveur juillet/août
Appli. web juillet/août
Paramétrage Param. Tournoi juillet/août
Import joueurs juillet/août
Résultats juillet/août
Lot 1bis Tirage tables ??
Lot 2 Statistiques ??
Lot 3 Affichage ??
Lot 4 Saisie à plusieurs ??
Fin Au plus tôt
1.2. Planning
• Juin 2009: Mise en place de l'environnement de développement
• Juillet 2009: Développement
• Juillet 2009: Tests
• Sept. 2009: Test lors du 1er tournoi inter-club de rentrée
• Avril 2010: Tournoi de Paris
Fédération Française de MahjongSpécification du logiciel de Gestion des Tournois de Mahjong 4/21
2. But du logiciel
Le but de ce logiciel est de gérer le déroulement des tournois de mahjong.
Cela comprend le tirage au sort des tables, la saisie de tous les scores des
joueurs, l'affichage des résultats et la mise à disposition des statistiques du
tournoi.
3. Caractéristiques du logiciel
• Tous les langages de programmation et les différents éléments utilisés
pour le développement et l'utilisation de ce logiciel devront être libres de
droits.
• Le logiciel pourra être utilisé sur n'importe quel système d'exploitation.
• Une documentation complète du logiciel devra être fournie afin de
faciliter les évolutions à venir.
3.1. Les différentes parties
1. Le paramétrage du tournoi
2. Le tirage au sort des tables
3. La saisie des scores des joueurs
4. Les statistiques
5. L'affichage des résultats
6. Les impressions
3.2. La sauvegarde
Chaque tournoi est sauvegardé individuellement et restauré pour être
modifié à volonté.
3.3. La version multilingues
Le langue du logiciel est le français. Une version en anglais sera
implémentée par la suite (utilisation de fichier de langues pour une traduction
rapide ?).
Prévoir une gestion multilingues du logiciel.
Fédération Française de MahjongSpécification du logiciel de Gestion des Tournois de Mahjong 5/21
4. L'architecture du logiciel
Le logiciel est de type Client / Serveur.
L'ordinateur Serveur, sur lequel est installé l'application de Gestion de
Tournoi.
Un ou plusieurs ordinateurs Client, qui se connectent au serveur via un
réseau. Les Clients participent à la saisie des données grâce à une application
web.
4.1. Le Serveur
Le Serveur héberge l'application en elle-même développée en Java.
La base de données utilisée est MySQL.
4.2. Le(s) Client(s)
Le Client accède au Serveur par l'intermédiaire d'un réseau.
L'application web, compatible avec les navigateurs web courants (Internet
Explorer, FireFox,...), permet la saisie des données en simultané par plusieurs
Clients.
4.3. Environnement de développement
4.3.1. Langage de programmation
Java EE
Servlet JSP
4.3.2. Outils
Eclipse v3.4.2 (eclipse-jee-ganymede)
Apache TOMCAT v6
4.3.3. Base de données
Apache DERBY, système de gestion de base de données relationnelle qui
peut être embarqué dans des programmes écrits en Java.
4.3.4. Gestion de production de projet
Apache MAVEN
4.3.5. Framework
Hibernate
Fédération Française de MahjongSpécification du logiciel de Gestion des Tournois de Mahjong 6/21 4.4. Exemple: architecture du Tournoi de Paris Fédération Française de Mahjong
Spécification du logiciel de Gestion des Tournois de Mahjong 7/21 5. Le paramétrage du tournoi 5.1. Le paramétrage du tournoi La partie paramétrage du tournoi est faite sur le Serveur pour initialiser le tournoi avec les informations suivantes: Le nom du tournoi. Le nombre de participants. Le nombre de tables (calculé en fonction du nombre de participants). Le choix de faire des équipes (de 4 joueurs) ou non. Le nombre de session. Joueur MahjongTime ou non. Voir la maquette. 5.2. Les participants La liste des participants est importée dans le logiciel depuis un fichier de type tableur (Excel ou OpenOffice). Exemple du fichier d'inscription du Tournoi de Paris 2009. Le format définitif est à définir. Le fichier contient au moins les données suivantes: • Prénom • Nom • Nationalité • N° EMA (n° de licence) • Equipe • Pseudo MahjongTime Fédération Française de Mahjong
Spécification du logiciel de Gestion des Tournois de Mahjong 8/21
6. Le tirage au sort des tables
6.1. Le tirage au sort
Le tirage au sort détermine le parcours de chaque joueur, c'est-à-dire le
numéro des tables sur lesquelles il va jouer durant le tournoi.
Règles:
• Si des équipes sont constituées, les joueurs d'une même équipe ne
doivent pas se rencontrer.
• Si des équipes sont constituées, un joueur ne devra pas jouer contre
plusieurs joueurs d'une même équipe (en fonction du nombre de
participants).
• Un joueur ne doit pas jouer deux fois contre un même joueur (en
fonction du nombre de participants).
6.2. Les documents à produire
a) Un document comportant le parcours individuel de chaque joueur sera
produit au format " pdf " pour impression et distribution à chaque
participant.
b) Un tableau récapitulatif de tous les parcours sera produit au format
" pdf " pour l'organisation.
Voir exemples.
Fédération Française de MahjongSpécification du logiciel de Gestion des Tournois de Mahjong 9/21
7. La saisie des scores des joueurs
7.1. La saisie
Afin de diminuer le temps de saisie, la saisie peut être faite sur plusieurs
ordinateur simultanément par plusieurs binômes:
1 binôme = 1 personne qui dicte + 1 personne qui saisie.
La centralisation des données ainsi saisies se font sur la base de données
hébergée par le Serveur.
7.2. Rappel de l'attribution des scores
Une session comporte au maximum 16 parties.
Le total des scores d'une partie est égal à zéro. Sauf en cas de pénalité
d'arbitrage.
7.2.1. Comptage
a) Partie nulle
• tous les scores à 0
b) Victoire sur écart
• score du vainqueur = valeur de la main + 24
• score du donneur = - (valeur de la main + 8)
• score des perdants = -8
c) Victoire sur le mur
• score du vainqueur = 3 x (valeur de la main + 8)
• score des perdants = - (valeur de la main + 8)
b) Pénalités
• Pénalités à 10 points : -30 pour le joueur pénalisé et +10 pour les
autres
• Pénalités à 20 points : -60 pour le joueur pénalisé et +20 pour les
autres
• Pénalités d'arbitrage : -5, -10, -20, ... uniquement pour le joueur
pénalisé
7.2.2. Points de table
1er = 4 points
2ème = 2 points
3ème = 1 point
4ème = 0 point
En cas d'égalité, les points sont partagés entre les joueurs concernés.
Exemple:
Fédération Française de MahjongSpécification du logiciel de Gestion des Tournois de Mahjong 10/21
Egalité entre le 2ème et le 3ème , le score de chacun est 1,5 ((2 + 1)/2).
7.3. Le mode de saisie
7.3.1. Sélection de la partie
Choix de la session et de la table.
Le nom et le numéro des joueurs de cette table sont remplis
automatiquement en fonction des parcours.
7.3.2. Saisie rapide
Pour l'affichage rapide des résultats entre les sessions, il est nécessaire de
procéder à une saisie rapide.
Entrée des points de table et des scores des joueurs.
Si les valeurs de main ne sont pas remplies, permettre la saisie des points
de table et des scores.
7.3.3. Saisie de la valeur de la main
Saisie manuelle des valeurs des mains en fonction de la feuille de score des
joueurs.
7.3.4. Gagnant / Donneur
Cocher manuellement la case " Gagnant " ou " Donneur " en fonction de la
feuille de score :
Partie nulle : tout est décoché
Celui qui fait Hu : " Gagnant " coché
Hu donné : " Donneur " coché
Hu tiré : cocher tous les " Donneur "
7.3.5. Pénalités
Les pénalités sont à ajouter manuellement.
A définir : détail des pénalités (fautes de jeux, faux hu 10 et 20pts,...) ?
7.3.6. Les totaux
Les totaux des points de table et du score sont calculés automatiquement.
Vérification de la cohérence avec la feuille de score.
Voir les maquettes.
Fédération Française de MahjongSpécification du logiciel de Gestion des Tournois de Mahjong 11/21
8. Les statistiques
8.1. Les statistiques tournois
a) Nombre de parties jouées
b) Nombre de victoire sur écart
c) Nombre de victoire sur le mur
d) Nombre de parties nulles
e) Nombre de pénalités
8.2. Les statistiques joueurs
a) Nombre de parties jouées
b) Nombre de victoire sur écart
c) Nombre de victoire sur le mur
d) Nombre de défaite
e) Nombre de défaite sur écart
f) Nombre de défaite sur le mur
g) Nombre de parties nulles
h) Nombre de pénalités
i) % de victoire = nombre de victoire / nombre de parties jouées
j) % de victoire sur le mur = nombre de victoire sur le mur / nombre de
parties jouées
k) % de défaite sur écart = nombre de défaite sur écart / nombre de
parties jouées
Voir les maquettes.
Fédération Française de MahjongSpécification du logiciel de Gestion des Tournois de Mahjong 12/21
9. L'affichage des résultats
Format PowerPoint ou équivalent.
9.1. Présentation avant tournoi
Une page par équipe avec le nom de l'équipe, photos, prénom, nom, pseudo
MJT et nationalité des joueurs.
9.2. Présentation entre les sessions
• Classement individuel
• Classement par équipe
• Classement français
Voir la maquette.
9.3. Présentation à la remise des prix
À définir
9.3.1. Export des résultats pour le site web
Les résultats et les statistiques doivent être exportés vers le site du tournoi.
A voir avec le responsable du site.
Fédération Française de MahjongSpécification du logiciel de Gestion des Tournois de Mahjong 13/21 10. Les impressions Donner le choix des différents documents disponibles à l'impression. Proposer la visualisation du document choisi. Fédération Française de Mahjong
Spécification du logiciel de Gestion des Tournois de Mahjong 14/21 11. Maquettes Les maquettes proposées ici donnent une idée générale de l'application. L'interface sera adaptée en fonction des considération techniques choisies. En blanc: les saisies manuelles En gris: les calculs automatiques (sauf score et points pour saisie rapide) 11.1. Maquette des Paramètres Fédération Française de Mahjong
Spécification du logiciel de Gestion des Tournois de Mahjong 15/21 11.2. Maquette de la Saisie Fédération Française de Mahjong
Spécification du logiciel de Gestion des Tournois de Mahjong 16/21 11.3. Maquette des Statistiques Fédération Française de Mahjong
Spécification du logiciel de Gestion des Tournois de Mahjong 17/21 11.4. Maquette des Résultats Avec possibilité de tri et de filtre sur les différentes colonnes. Fédération Française de Mahjong
Spécification du logiciel de Gestion des Tournois de Mahjong 18/21 11.5. Maquette de l'Impression Fédération Française de Mahjong
Spécification du logiciel de Gestion des Tournois de Mahjong 19/21
11.6. Maquette fichier des participants
Cet exemple est le fichier des participants au Tournoi de Paris 2009.
Prénom Nom E-mail Pays EMA n° Équipe Pseudo Arrivée Départ Formulaire Payement Réf Payement Photo CJ CP Changements Clubs
Prénom1 Nom1 adresse1 France 04040001 Equipe1 pseudo1 17-avr. 20-avr. 27-janv. 28-févr. Virement X 1 1 MMSP
Prénom2 Nom2 adresse2 France 04040002 Equipe1 pseudo2 17-avr. 20-avr. 27-janv. 15-mars Virement X 1 1 FDO
Prénom3 Nom3 adresse3 France 04040003 Equipe1 pseudo3 17-avr. 20-avr. 27-janv. 23-mars Chèque X 1 1
Prénom4 Nom4 adresse4 France 04040004 Equipe1 pseudo4 17-avr. 20-avr. 27-janv. 28-févr. Virement X 1 1
…
Fédération Française de MahjongSpécification du logiciel de Gestion des Tournois de Mahjong 20/21 11.7. Maquette des parcours a) Parcours individuel b) Tableau récapitulatif Fédération Française de Mahjong
Spécification du logiciel de Gestion des Tournois de Mahjong 21/21
12. Divers
12.1. Page d'accueil
• La section « Paramètres » vous permet de régler tous les paramètres
inhérents au déroulement du tournoi: nombre de joueurs, nombre de
sessions, …
• La section « Saisie » permet de saisir les scores des joueurs par session
et par table.
• La section « Statistiques » permet de voir les statistiques tournoi et
joueurs.
• La section « Résultats » permet de visualiser les différents classements
du tournoi.
• La section « Impression » vous permet d'imprimer les éléments
nécessaires au déroulement du tournoi (parcours des joueurs, liste des
tables, ...) et les résultats.
12.2. Nom du logiciel
Trouver un nom pour le logiciel.
1. Proposition de Nathalie Mahé: ToMaS (Tournament Mahjong Software)
12.3. Autres
Voir s'il est possible d'intégrer TimeLeft dans le logiciel.
Fédération Française de MahjongVous pouvez aussi lire