diff --git a/docs/Images/Screens/FigmaLogo.png b/docs/Images/Screens/FigmaLogo.png new file mode 100644 index 0000000..0eda24a Binary files /dev/null and b/docs/Images/Screens/FigmaLogo.png differ diff --git a/docs/Images/Screens/FigmaLogo.png:Zone.Identifier b/docs/Images/Screens/FigmaLogo.png:Zone.Identifier new file mode 100644 index 0000000..e69de29 diff --git a/docs/Images/Screens/MaterialsLogo.png b/docs/Images/Screens/MaterialsLogo.png new file mode 100644 index 0000000..29f1b10 Binary files /dev/null and b/docs/Images/Screens/MaterialsLogo.png differ diff --git a/docs/Images/Screens/Vs2022logo.png b/docs/Images/Screens/Vs2022logo.png new file mode 100644 index 0000000..8b83beb Binary files /dev/null and b/docs/Images/Screens/Vs2022logo.png differ diff --git a/docs/Images/Screens/Vs2022logo.png:Zone.Identifier b/docs/Images/Screens/Vs2022logo.png:Zone.Identifier new file mode 100644 index 0000000..e69de29 diff --git a/docs/Images/Screens/logo.png:Zone.Identifier b/docs/Images/Screens/logo.png:Zone.Identifier new file mode 100644 index 0000000..5c015ce --- /dev/null +++ b/docs/Images/Screens/logo.png:Zone.Identifier @@ -0,0 +1,4 @@ +[ZoneTransfer] +ZoneId=3 +ReferrerUrl=https://cloudconvert.com/ +HostUrl=https://storage.cloudconvert.com/tasks/86d47ecf-9b36-49d7-920d-afdc5a0d7d24/logo.png?AWSAccessKeyId=cloudconvert-production&Expires=1686128919&Signature=lCf1WuDkeA1HMNtNKrFgORZJtJ4%3D&response-content-disposition=attachment%3B%20filename%3D%22logo.png%22&response-content-type=image%2Fpng diff --git a/docs/Images/Screens/vsCodelogo.png b/docs/Images/Screens/vsCodelogo.png new file mode 100644 index 0000000..93dc8e0 Binary files /dev/null and b/docs/Images/Screens/vsCodelogo.png differ diff --git a/docs/Images/Screens/vsCodelogo.png:Zone.Identifier b/docs/Images/Screens/vsCodelogo.png:Zone.Identifier new file mode 100644 index 0000000..e69de29 diff --git a/docs/Planning/PlanningEffectif.pdf b/docs/Planning/PlanningEffectif.pdf new file mode 100644 index 0000000..ff59f18 Binary files /dev/null and b/docs/Planning/PlanningEffectif.pdf differ diff --git a/docs/Planning/PlanningEffectif.xlsx b/docs/Planning/PlanningEffectif.xlsx new file mode 100644 index 0000000..d90f7ed Binary files /dev/null and b/docs/Planning/PlanningEffectif.xlsx differ diff --git a/docs/Planning/PlanningEffectif.xlsx:Zone.Identifier b/docs/Planning/PlanningEffectif.xlsx:Zone.Identifier new file mode 100644 index 0000000..e69de29 diff --git a/docs/index.md b/docs/index.md index bfdcdca..a941a90 100644 --- a/docs/index.md +++ b/docs/index.md @@ -326,13 +326,35 @@ J'ai mis une durée arbitraire de deux jours, mais je ne sais pas vraiment combi ---- -[A remplir dans les dernières semaines du travail de diplôme] +Alors ! + +Ces lignes sont écrites dans les derniers jours du travail de diplôme et j'ai des choses à dire. + +Premièrement je suis plutôt content de mon estimation du travail. Je trouve que j'ai bien estimé la quantité de travail et combien de temps les différentes tâches allaient prendre. La plupart des dépassements sont des imprévus et/ou des allers et retours entre d'autres tâches. + +La raison pour laquelle je suis plutôt content de ma planification, c'est que malgré l'usine à Gaz que représente ce projet et le nombre de soucis que j'ai eu, j'ai quand même pu arriver à un projet qui fonctionne en suivant plutôt fidèlement le planning. Une chose dont je suis plutôt fier c'est la documentation. En ayant développé le squelette de l'app dès le début du projet ca m'a permis d'avancer au fur et à mesure du projet la conscience tranquille. + +Bon c'est bien joli les fleurs mais clairement c'est loin d'être parfait. Au moment de la planification je n'avais pas prévu de faire des allers et retours entre plusieurs tâches. Dans le planning effectif on peut voir que un jour je suis sur la PT3 (Stockage) et la PT5 (regroupement des mini projets en un seul gros). J'aurais peut-être du inverser l'ordre. + +Mais il y a deux gros soucis dans mon planning : + +- L'ordre des tâches n'était pas bon (mais il a été décidé comme ca pour que les plus grosse difficultées soient faites en premier) ce qui a créé pas mal de soucis. Ex : L'émulateur de la F1TV a été fait très tard et au final les images récupèrées n'étaient pas de la même qualité que ce que j'avais prévu en développant l'OCR en premier. +- Les Tests ont été négligés et utilisés comme des jours tampons. Ca c'est la plus grosse erreur de planning. Autant les autres sont pénibles etc... mais n'ont pas forcément compromis la bonne réalisation du projet alors que la les tests ont été mal placés et ont au final été balayés alors que si ils avaient été mieux planifiés ca ne serait pas arrivé. + +Solutions : + +L'ordre des tâches a été décidé exprès de cette facon pour éviter de prendre trop de risques. L'idée était qu'en faisant le plus dur au début, je pourrai facilement changer le cahier des charges. J'ai envie de dire que j'aurais dû être plus confiant mais pour être honnête je pense que c'était un mal pour un bien. Je ne pense pas avoir "bien" fait mais je pense que c'est une erreur qui était rentable pour mon niveau de stress dans le projet. + +Par contre les Tests c'est tout simplement une erreur. J'en parle plus en détail dans la partie test de la documentation mais je vais résumer un peu ici. +La documentation a été faite dès le début du projet. J'ai mis en place le squelette pour qu'ensuite il soit simple d'y ajouter au fur et à mesure. J'aurais dur faire exactement pareil avec les tests. Si j'avais fait au moins le squelette des tests au début du projet j'aurais pu beaucoup plus facilement en faire et cela m'aurait fait gagner un temps fou et j'aurais même pu faire du TDD (Test Driven Developpement). Je suis persuadé que cette bête erreur de planification m'a côuté très chère car ne pas avoir une bonne stratégie de tests a du me faire perdre un temps fou. + +Pour conclure je suis content car j'ai réussi à rendre un projet qui marche en suivant assez bien le planning mais il y a des choses que je vais devoir changer dans mes prochains projets. ## Analyse fonctionnelle ---- -[A remplir au fur et à mesure dans la seconde moitié du travail de diplôme] +Voir "Manuel Utilisateur" tout y est indiqué ## Analyse Organique @@ -340,7 +362,51 @@ J'ai mis une durée arbitraire de deux jours, mais je ne sais pas vraiment combi ### Outils utilisés -[A Remplir] +#### Visual Studio 2022 + + + +C'est l'application que j'ai le plus utilisé je pense. Visual Studio 2022 est l'IDE officiel de Microsoft pour coder en C#. + +C'est l'outil que j'utilise depuis maintenant 6 ans au CFPT et franchement il fait tout ce que je pourrais vouloir. C'est aussi un outil pratique pour utiliser Windows Forms et faire des applications natives Windows. + +Pas grand chose à dire à ce sujet à part que c'est un outil qui marche bien et qui est gratuit si on prend la community edition. + +#### Visual Studio Code + + + +Cet outil est déja un peu plus intéressant. C'est le second outil que j'ai le plus utilisé. J'en ai surtout eu besoin pour écrire de la doc, mais aussi pour coder en python et pour contrôler mkdocs. + +Visual Studio est un IDE absolument génial qui est très puissant avec les bonnes extensions. Je l'utilise au quotidien pour tout ce qui est développement WEB, Mobile ou pour éditer des fichiers de configs pour mes drones ou imprimantes 3D. Je peux même compiler le firmware pour ces dernières en utilisant une extension faite pour. + +Les possibilités de customisation sont presques infinies et c'est un plaisir d'utiliser ce logiciel gratuit fournis par Microsoft mais qui est amélioré constamment par des développeurs indépendants. + +Je conseille à nimporte quel développeur de l'essayer à moins qu'il soit uniquement sur C# ou il serait plus intéressant d'utiliser visual studio 2022 + +#### Material/Mkdocs/Markdown + + + +Pendant ce projet j'ai utilisé exclusivement du markdown avec l'aide de Mkdocs et Materials. + +Le choix de Markdown a été plutôt simple, c'est une facon facile et efficace de créer de la documentation et on n'avait pas le choix de l'utiliser. + +On avait également l'obligation (Ou au moins un très forte incitation) par nos professeurs d'utiliser mkdocs et materials pour que notre documentation ne soit pas simplement une liste de fichiers mais un joli site dans lequel il est agréable de chercher des informations. + +Mkdocs et Materials sont deux outils vraiment fantastiques mais je dois avouer que je n'ai pas assez mis de temps pour apprendre tout leur potentiel. Pour moi ce sont simplement des outils et je veux qu'ils marchent. Je ne suis pas forcément du genre à aller changer toutes les couleurs et polices pour avoir la doc parfaite, j'ai préféré passer du temps sur mon app. Mais même si ces outils offrent une customisation très avancée, il est très facile de créer un projet simple et j'aime beaucoup cette simplicité. + +J'ai eu pas mal d'aide de la part de M.Briard pour implémenter certaines features et je l'en remercie très chaudement car sans son aide ce document serait sûrement un peu moins facile à lire (Oui oui ca aurait pu être pire, je sais c'est dur à imaginer) + +#### Figma + + + +Figma est l'outil que j'ai utilisé pour créer mon poster et un certain nombre des diagrammes de cette documentation. + +J'utilise aussi cet outil dès que je vais faire des maquettes de sites ou d'applications. D'ailleurs les maquettes dans le cahier des charges ont été faites avec. + +C'est un outil en ligne parfaitement gratuit qui conserve tout dans le cloud. Franchement je n'ai rien à dire, je n'ai pas utilisé plus de 15% des features que cet outil propose et je suis déja conquis. ### Technologies utilisées @@ -2139,3 +2205,9 @@ Ecrire des tests c'est jamais marrant et c'est encore moins marrant quand ils no [A remplir la dernière semaine du travail de diplôme] ## Notes de code + +---- + +## Glossaire + +---- diff --git a/docs/jdb.md b/docs/jdb.md index 99c6d78..62eff8a 100644 --- a/docs/jdb.md +++ b/docs/jdb.md @@ -3102,4 +3102,12 @@ J'ai eu trois soucis pour l'utilisation du programme. Les voici dans l'ordre cro J'ai essayé de règler le problème en Live, le soucis c'est que j'ai un commentaire à fournir pendant la course et donc je n'ai pas eu le temps de plus me pencher sur le cas. Le weekend du prochain Grand Prix je vais essayer de tester sur les scéances d'essais libres.le click du bouton et j'amenerai mon cable chez moi. -Bon sinon aujourd'hui, comme d'hab, Doc... Je vais faire le manuel utilisateur. \ No newline at end of file +Bon sinon aujourd'hui, comme d'hab, Doc... Je vais faire le manuel utilisateur. + +J'ai fait un manuel qui décrit à peu près tout ce qui'il faut savoir pour bien utiliser l'app. Cela fait un document un peu long mais je pense que c'est nescessaire car c'est vraiment pas une app facile à comprendre quand on ne vient pas du milieu de la F1 (et même la...) + +## Mardi 6 Juin 2023 + +Aujourd'hui je vais continuer à documenter... Ma methode pour l'instant c'est juste de remplir les titres que j'ai prévu au départ. Ensuite à partir de jeudi (je pense que c'est à partir de cette date que j'aurai un peu tout rempli) j'aimerais bien relire la grille d'évaluation et ensuite faire une lecture de mon journal de bord pour vérifier que je n'ai rien oublié. Et le but c'est de finir la doc Vendredi soir pour faire une dernière release doc + projet. + +Un collègue M.Briard m'a pas mal aidé avec la configuration de mon mkdocs et il a développé une extension pour ajouter le code source au PDF final. La il est en train de regarder si il peut trouver un moyen de faire une table des figures qui nous est demandée. (j'ai plus de 200 images dans ma documentation alors si c'est possible de ne pas avoir à faire une table des figures à la main je prends) diff --git a/site/404.html b/site/404.html index e5fa957..be461a3 100644 --- a/site/404.html +++ b/site/404.html @@ -225,6 +225,21 @@ +
Je pense qu'ils sont un peu plus faciles à comprendre que le gros diagramme général. Ce que je me dis c'est que je vais faire une section fonctionnement général ou je vais expliquer les trois parties avec les petits diagramme et résumer avec le grand diagramme.
+Ce weekend j'ai voulu essayer le projet pour le Grand Prix de Barcelone qui s'est soldé en un échec cuisant...
+J'ai eu trois soucis pour l'utilisation du programme. Les voici dans l'ordre croissant d'importance et de difficulté à règler :
+
+
+J'ai essayé de règler le problème en Live, le soucis c'est que j'ai un commentaire à fournir pendant la course et donc je n'ai pas eu le temps de plus me pencher sur le cas. Le weekend du prochain Grand Prix je vais essayer de tester sur les scéances d'essais libres.le click du bouton et j'amenerai mon cable chez moi.
+Bon sinon aujourd'hui, comme d'hab, Doc... Je vais faire le manuel utilisateur.