Spécification du logiciel de Gestion des Tournois de Mahjong - Auteur: Lionel Legaie Création: 23 avr. 2009

 
CONTINUER À LIRE
Spécification du logiciel de Gestion des Tournois de Mahjong - Auteur: Lionel Legaie Création: 23 avr. 2009
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 2009
Spé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 Mahjong
Spé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 Mahjong
Spé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 Mahjong
Spé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 Mahjong
Spé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 Mahjong
Spé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 Mahjong
Spé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 Mahjong
Spé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 Mahjong
Spé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 Mahjong
Spé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 Mahjong
Spé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 Mahjong
Vous pouvez aussi lire