-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathManuel d'utilisation
153 lines (93 loc) · 10.6 KB
/
Manuel d'utilisation
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
Bienvenue sur le manuel d'utilisation des services de RPI
Cette documentation va se composer de plusieurs parties :
1. Les services
2. Les erreurs et les procédures pour les corriger ou les contourner
3. Comment rétablir les versions précédentes
4. L'utilisation des services
5. Les astuces
6. Les subtilités suivant les versions
7. Les logs
Introduction.
Ce système est basé sur du code Python 3 (Les services pour les serveurs necessitent des fichiers en CSS et HTML mais ils sont déja fournis avec le package).
Pour un fonctionnement optimal, les services necessitent les modules suivants : OS, Flask, platform, time et datetime.
Les chemins d'accès depuis le script principal seront mentionnés sous cette forme : [1.9.5] cette definition correspond au choix 1, puis 9 puis 5. Cette information ne vaut que pour le panneau administrateur.
Cette forme [1,2.7.6] signifie que l'on peut acceder au même endroit depuis deux endroits, dans ce cas, on peut acceder au choix ou l'on va répondre 7 par le choix 1 ou 2.
Pour la sécurité du système, veuillez ne pas laisser les fichiers des services accessibles à tous mais uniquement aux administrateurs du réseau et aux personnes qualifiées.
Toute erreur non référencée devra être signalée accompagnée du fichier de log présent dans le même fichier que les scripts (Les versions précedentes sont suceptibles de ne pas fonctionner de la même manière
et de faire différents fichiers de logs différents. Il faut donc dans ce cas :
A. Trouver le service concerné
B. Envoyer le fichier de log correspondant (certains services ne produisent pas de logs donc faire un descriptif de la version, du service, des options...))
/!\ Cette erreur à été résolue dans la version 1.13.0 du client
Notes aux administrateurs
Tout service portant la mention "(:/)" est désactivable. Pour le désactiver, lancez le script via la commande ci-dessous et accedez au service n°4 (disponible dès la version 1.20 du client) pour changer les choix.
La commande à executer pour lancer l'infrastructure est : "python3 BOOT.py" dans le fichier Services RPI
Si vous disposez des droits d'administrateur, veuillez ajouter le préfixe "sudo" pour un fonctionnement optimal.
Vous pourrez ensuite acceder aux services.
SECTION 1 : Les services
1.1 LoginService
Le LoginService est un service de connexion. Il fonctionne à partir d'un système de base de données et de séparation des ID.
Ce système est divisé en deux versions ("Alpha et Test (n°1.1.1 et 1.1.2))
Ce service est utilisé notamment dans l'interface de lancement des serveurs (1.2.2.2,3).
1.1.1 Version Alpha
La version Alpha est la version la plus avancée, sécurisée et mise à jour. Elle fontionne via le fichier de données PWD_DATA.bps.
Elle doit être utilisée pour une connexion à des services authentifiés.
1.1.2 Version Test
/!\ Cette version à été désactivée à partir de la version 1.19 du LoginService
Cette version est réservée aux administrateurs. Elle permet de faire des essais si un changement interne est utile car le code des services est actuellement OpenSource.
Cela signifie que vous pouvez modifier le code sans problème pour l'adapter a vos besoins. Un signalement est cependant necessaire à l'équipe gérant ce projet pour que
toute erreur soit corrigée par notre équipe et que le code soit vérifié afin qu'aucune faille de sécurité ne soit présente.
1.2 Hubs
Les Hubs sons des services intermédiaires servant à ne pas surcharger le script principal.
Il y a plusieurs hubs (un pour chaque type de service sauf rares exeptions) chacun appelant les différents services.
1.2.1 HubGames (:/)
Ce hub comporte actuellement 3 services de jeux : le Pendu, le Trouve Le Nombre (TLN) et le Morpion.
1.2.1.1 Pendu (:/)
Le mot à trouver dans le pendu est choisi aléatoirement dans une liste prédéfinie.
Il n'est pas possible d'ajouter des mots sans acceder au code.
1.2.1.2 TLN (:/)
Le jeu Trouve Le Nombre est un jeu ou un nombre entre 1 et 40 est généré automatiquement et aléatoirement. Dans ce jeu, il faut le trouver en un nombre de chances défini.
1.2.1.3 Morpion (:/)
Le jeu Morpion se joue à 2 en VS.
1.2.2 HubServer (:/)
Ce Hub comporte actuellement 2 services : Le serveur de version 2 (obsolète) et celui de version 3.
1.2.2.1 Cette mention est indisponible...
1.2.2.2 Version 2 du serveur
/!\ Cette version est obsolète. Toute utilisation serait dangereuse par rapport à la sécurité des services car cette version n'est plus mise à jour.
1.2.2.3 Version 3 du serveur
Ce service est un serveur réseau utilisant Flask et disposant de plusieurs pages codées en HTML.
Cette fonction vous étant proposée peut être modifiée pour apprendre à coder du HTML et du CSS en modifiant les fichiers dans les dossiers Templates et Static.
Ils sont ouvrables via un éditeur de texte brut quelconque.
1.3 Autres apps
Ce service comporte plusieurs solutions :
1.3.1 Les clients MC
Les clients MC ne sont disponibles que pour Linux (Raspi OS) car les scripts sont faits sur mesure pour cette version.
Dans la version 1.21, il y en a un. Un client de téléportation qui permet de se téléporter à des endroits en entrant les coordonnées, ou en choisissant parmi les favois.
1.3.2 Le Portail GUI
Cette fonction est indisponible car une corruption de données du service à effacé les services des GUI.
Un retour à la normale est prévu sur la prochaine version
1.3.3 Cette mention est indisponible...
1.3.4 Aide
L'aide est un prototype d'IA permettant de résoudre les problèmes rencontrés sur les services.
Fin de développement prévu à la version 1.24
SECTION 2 : Les erreurs et les procédures pour les corriger ou les contourner
╔═══════════╦════════════════════════╦════════════════════════════╦═════════════════════════════════════════════════════════════════════════╗
║N° d'erreur║Service ║Problème ║Solution ║
╠═══════════╬════════════════════════╬════════════════════════════╬═════════════════════════════════════════════════════════════════════════╣
║0001 ║LoginService ║Mauvais identifiant ║Entrez l'identifiant correct ║
╠═══════════╬════════════════════════╬════════════════════════════╬═════════════════════════════════════════════════════════════════════════╣
║0002 ║LoginService ║Mauvais mot de passe ║Entrez le mot de passe correct ║
╠═══════════╬════════════════════════╬════════════════════════════╬═════════════════════════════════════════════════════════════════════════╣
║0050 ║Tous ║ValueError ║Entrez un nombre dans la plage autorisée ║
╠═══════════╬════════════════════════╬════════════════════════════╬═════════════════════════════════════════════════════════════════════════╣
║0051 ║Tous ║NameError ║Une erreur de syntaxe est présente. Envoyez les logs. ║
╠═══════════╬════════════════════════╬════════════════════════════╬═════════════════════════════════════════════════════════════════════════╣
║0052 ║Tous ║Une mise à jour est en cours║Attendre que la mise à jour soit terminée puis réessayer ║
╠═══════════╬════════════════════════╬════════════════════════════╬═════════════════════════════════════════════════════════════════════════╣
║OFF ║Serveurs ║Le serveur s'éteint ║Relancez les services. Si le problème persiste, envoyez les logs. ║
╠═══════════╬════════════════════════╬════════════════════════════╬═════════════════════════════════════════════════════════════════════════╣
SECTION 3 : Comment rétablir les versions précédentes
Les services sont régulièrement mis à jour pour assurer une sécurité la plus perfectionniste. Parfois, une erreur sur la nouvelle version est passée et fait que tout dysfonctionne.
C'est pour cela que les versions précédentes sont parfois accessibles.
Il faut néanmoins pouvoir acceder au code pour pouvoir les réactiver.
Tous les services activés puis désactivés ne sont pas tous réactivables pour des raisons de sécurité ou de remplacement.
SECTION 4 :