Sith/docs/archives/TO_Skia_LoJ/Rapport.tex

491 lines
27 KiB
TeX
Raw Normal View History

2017-01-08 19:02:09 +00:00
%%
%
% Skia
% skia@libskia.so
%
%%
\documentclass[a4paper]{report}
%packages
\usepackage[utf8]{inputenc}
\usepackage[francais]{babel}
\usepackage{graphicx}\graphicspath{{pix/}}
\usepackage{float}
\usepackage{scrextend}
\usepackage[T1]{fontenc}
\usepackage{color}
\usepackage{fancyhdr}
%Options: Sonny, Lenny, Glenn, Conny, Rejne, Bjarne, Bjornstrup
\usepackage[Bjornstrup]{fncychap}
\usepackage{minted}
\usepackage[colorlinks=true,linkcolor=black]{hyperref}
\usepackage{pdfpages}
%\usepackage{titlesec, blindtext, color}
%pdf metadata
\hypersetup{
unicode=true,
colorlinks=true,
citecolor=black,
filecolor=black,
linkcolor=black,
urlcolor=black,
pdfauthor={Skia <skia@libskia.so>},
pdftitle={},
pdfcreator={pdftex},
pdfsubject={},
pdfkeywords={},
}
\definecolor{keywords}{RGB}{200,0,90}
\definecolor{comments}{RGB}{50,50,253}
\definecolor{red}{RGB}{160,0,0}
\definecolor{brown}{RGB}{160,100,100}
\definecolor{green}{RGB}{0,200,0}
\definecolor{darkgreen}{RGB}{0,130,0}
\definecolor{gray}{RGB}{100,100,100}
%inner meta
2017-01-15 19:33:18 +00:00
\title{Sith: Développement de nouvelles applications}
2017-01-16 13:56:30 +00:00
\author{Florent \textsc{Jacquet}\\
Guillaume \textsc{Renaud}}
2017-01-08 19:02:09 +00:00
\date{Dernière version: \today}
\begin{document}
2017-01-16 13:56:30 +00:00
% \maketitle
\includepdf[pages={1}]{Couvertures.pdf}
2017-01-08 19:02:09 +00:00
\tableofcontents
2017-01-12 12:22:35 +00:00
\chapter*{Remerciements}
2017-01-16 13:56:30 +00:00
\section*{Guillaume \textsc{Renaud}}
2017-01-15 19:33:18 +00:00
\par Je remercie tout d'abord Monsieur Frédéric \textsc{Lassabe} qui nous a permis d'effectuer cette TO52 lors de notre cursus à
l'UTBM, nous permettant ainsi de mêler nôtre travail scolaire à nôtre envie de participer à l'amélioration de la vie
associative de l'UTBM.
2017-01-11 14:26:54 +00:00
2017-01-15 19:33:18 +00:00
\par Je tiens aussi à remercier Florent \textsc{Jacquet} qui m'a aidé tout au long de ce travail et à qui j'ai pu poser mes
différentes questions pour apprendre et comprendre plus rapidement que si j'avais été seul.
2017-01-11 14:26:54 +00:00
2017-01-16 13:56:30 +00:00
\section*{Florent \textsc{Jacquet}}
2017-01-15 19:33:18 +00:00
\par Je remercie également Frédéric \textsc{Lassabe} , non seulement pour la TO, mais également pour la précédente TW. Sans ces
deux UV hors emploi du temps, jamais un projet comme ce site de l'AE n'aurait pu voir le jour. Cela a demandé beaucoup
d'investissement, et il est plus qu'appréciable de pouvoir obtenir quelques crédits en retour.
2017-01-11 14:26:54 +00:00
2017-01-15 19:33:18 +00:00
\par Je tiens également à remercier l'ensemble de l'équipe info de l'AE qui s'est motivée ce semestre à organiser des
réunions hebdomadaires afin de reprendre le projet du mieux possible. C'est maintenant à eux que va être confié le
projet, et il est agréable de constater qu'ils n'ont pas attendu le dernier moment pour se pencher sur la question.
\chapter*{Introduction}
\addcontentsline{toc}{chapter}{Introduction}
2017-01-13 18:21:28 +00:00
\par Après le développement de la base du nouveau site de l'AE, le projet \emph{Sith}, au Printemps 2016, la mise en
2017-01-12 12:22:35 +00:00
production a pu avoir lieu avec succès fin Août 2016.
\par Mais le site était encore très incomplet, et il était nécessaire d'y ajouter un grand nombre de fonctionnalités
moins critiques, celles-ci n'ayant pas de rapport avec l'argent, mais tout de même très utiles pour le fonctionnement
de l'AE.
2017-01-08 19:02:09 +00:00
2017-01-16 13:56:30 +00:00
\par Parmis elles, se trouvait notamment une application de gestion des stocks, qui a été confiée à Guillaume, puisqu'elle
2017-01-15 19:33:18 +00:00
concernait en premier lieu le \emph{Bureau des Festivités} et qu'il en était le président. Il était donc parmis les
mieux placé pour évaluer le besoin et développer l'outil, d'autant qu'il fallait le concevoir depuis le début, ces
fonctions n'étant pas du tout présentes dans l'ancien site.
2017-01-16 13:56:30 +00:00
\par Du reste, Florent a eu la responsabilité de développer les autres applications, ou bien de gérer leur développement
2017-01-15 19:33:18 +00:00
lors qu'il était fait par quelqu'un d'autre.
2017-01-08 19:02:09 +00:00
\chapter{Eboutic}
\label{sec:eboutic}
2017-01-16 13:56:30 +00:00
\par Développeur principal: Florent
2017-01-08 19:02:09 +00:00
\section{But}
\label{sub:but}
\par Fournir une boutique en ligne, avec paiement sécurisé, compatible avec l'API de paiement du Crédit Agricole.
\begin{itemize}
\item Gérer les cotisations
\item Gérer les rechargements de compte AE
\item Gérer différents groupes de vente
\end{itemize}
\section{Principaux problèmes}
\label{sec:principaux_problemes}
\subsection{Interaction avec l'API}
\label{sub:interaction_avec_l_api}
2017-01-12 12:22:35 +00:00
\par C'est la principale contrainte de cette application. On doit interagir avec les serveurs du Crédit Agricole, et
pour cela, ces derniers n'aident pas beaucoup.
\par Ils fournissent un PDF peu clair\footnote{disponible dans le dossier \url{doc/Etransaction/} des sources du site}
expliquant l'implémentation d'un site marchand, en plus des nombreux autres PDF de documentation disponibles à l'adresse
\url{https://e-transactions.avem-groupe.com/pages/global.php?page=telechargement}.
\par Une implémentation de référence uniquement en PHP, et contenant que peut de fonctionnalités par rapport à ce
que dit le PDF peut aussi être obtenue, mais n'est guère utile excepté pour la vérification cryptographique de la
signature de la réponse. Mais encore, il faut arriver à traduire les fonctions propres à PHP, et ce n'est pas toujours
une mince affaire, mais fort heureusement, les algorithmes sont encore assez standards et l'on trouve vite de l'aide
quant à ces fonctions.
\par De plus, certaines informations concernants les numéros d'identification de marchand son incohérents
d'une documentation à l'autre, et le plus simple à ce niveau est encore de contacter le support.
2017-01-08 19:02:09 +00:00
\subsection{Accès concurrentiels}
\label{sub:acces_concurrentiels}
2017-01-15 19:33:18 +00:00
\par En production, le projet Sith tourne à l'aide d'\textbf{uWSGI}, qui s'occupe lui de gérer les différents processus du
2017-01-12 12:22:35 +00:00
logiciel. Cela se traduit par des accès concurrentiels à la base de donnée lors de l'appel de deux pages simultanément
qui ont besoin d'accèder aux mêmes ressources.
\par Le problème n'en est la plupart du temps pas un, mais il devient très critique lorsque la page appelée permet par
exemple de recharger un compte AE. Il ne faut alors surtout faire l'opération en double.
\par Pour protéger ces accès en double, on peut alors utiliser des transactions, et \textbf{Django} fournit une
abstraction très pratique: \verb-with transaction.atomic():-.
2017-01-08 19:02:09 +00:00
2017-01-12 12:22:35 +00:00
\par L'Eboutic, avec sa réponse de la banque, est très sujette à ces accès concurrents, et cela a posé quelques
problèmes dans les débuts. La plupart ont été résolu, mais il arrive encore dans les comptoirs d'avoir une vente en
double, sans pour autant avoir le débit du compte qui soit doublé. Cela ne pose pas foncièrement de problèmes, puisque
le solde du compte est tout de même valide, et c'est un problème très compliqué à debugger, puisqu'il survient très
rarement, mais il faudrait tout de même arriver à le résoudre un jour.
2017-01-08 19:02:09 +00:00
\chapter{Le SAS}
\label{sec:le_sas}
2017-01-16 13:56:30 +00:00
\par Développeur principal: Florent
2017-01-08 19:02:09 +00:00
\section{But}
\label{sub:but}
\par Fournir un système de galerie de photo:
\begin{itemize}
\item Upload en ligne via un formulaire pour tous les cotisants.
\item Modération pour l'équipe du SAS.
\item Système d'identification des membres pour retrouver rapidement ses photos.
\item Affichage des photos dans les différents album et sur la page "photo" du profil d'un utilisateur.
\end{itemize}
\section{Principaux problèmes}
\label{sec:principaux_problemes}
\subsection{Gestion des fichiers}
\label{sub:gestion_des_fichiers}
2017-01-13 18:21:28 +00:00
\par L'envoie en grande quantité de photos nécéssite une gestion des fichiers solide, en même temps qu'un formulaire
d'envoie efficace, capable d'envoyer plusieurs dizaines de photos en une seule action de l'utilisateur.
\par L'envoie est donc fait à l'aide de requêtes AJAX pour envoyer les photos une par une et éviter alors le timeout.
\par Concernant les fichiers une fois envoyé, ils sont en réalité traités par la classe \verb#SithFile# qui gère tous
les fichiers du site. Cela ne fait qu'une seule classe à développer, de même qu'un seul système de fichier avec une
seule arborescence, ce qui est beaucoup plus robuste.
\par La difficulté a aussi été de permettre le déplacement des fichiers, par couper-coller, tout en faisant de même dans
le système de fichier réel, afin d'avoir une arborescence cohérente même en cas de perte de la base de données.
2017-01-08 19:02:09 +00:00
\subsection{Optimisation des pages}
\label{sub:optimisation_des_pages}
2017-01-12 12:22:35 +00:00
\par La génération d'un grand nombre de requêtes SQL est un des principaux problèmes de ralentissement d'un site. Le
SAS, avec ses très nombreuses photos, qui requierent une validation des droits, a posé un gros problème à ce niveau.
\par Certaines pages ont pu mettre jusqu'à plus de 10 secondes à générer, ce qui est inconcevable pour une galerie de
photos, mais ce temps à pu être réduit à moins de 3 secondes.
\par L'astuce à été d'utiliser des actions utilisateurs, comme l'upload de nouvelles photos, pour faire plus de
traitement que nécessaire, afin de mettre en "cache" une grande partie des actions, comme par exemple la génération des
miniatures des albums.
2017-01-13 18:21:28 +00:00
\par Une autre technique pour gagner du temps est de mettre en cache certaines requêtes en forcant les \emph{QuerySet}
à s'évaluer dans une \emph{list} \textbf{Python} que l'on stocke afin d'obtenir sa longueur, au lieu de lancer d'abord
un \emph{count}, puis une itération des résultats, qui en utilisant directement l'ORM, conduit à réaliser deux
2017-01-12 12:22:35 +00:00
requêtes SQL.
\par Enfin, le passage à \textbf{HTTP/2} permettrait d'améliorer encore les performances côté utilisateur puisqu'il n'y
2017-01-13 18:21:28 +00:00
aurait plus qu'un seul \emph{socket} d'ouvert pour transférer toutes les photos d'une page par exemple, sans avoir
2017-01-12 12:22:35 +00:00
pour autant à toucher au code.
2017-01-08 19:02:09 +00:00
\chapter{Les élections}
\label{sec:les_elections}
2017-01-16 13:56:30 +00:00
\par Développeur principal: Antoine
2017-01-08 19:02:09 +00:00
\section{But}
\label{sub:but}
\par Fournir un système d'élections:
\begin{itemize}
\item Gestion des différentes élections comprenants à chaque fois une liste de postes pour lesquels les gens
candidatent, ainsi qu'une gestion des listes, pour pouvoir classifier et répartir les candidatures.
\item Gestion d'une page de vote, permettant aux gens autorisés de pouvoir voter.
\item Affichage des résultats une fois le vote terminé.
\item Pas compatible avec la législation française: trop contraignant et pas utile, puisque validation officiel en
AG.
\end{itemize}
\section{Principaux problèmes}
\label{sec:principaux_problemes}
\subsection{Automatisation d'un widget particulier pour les formulaires}
\label{sub:automatisation_d_un_widget_particulier_pour_les_formulaires}
2017-01-13 18:21:28 +00:00
\par La demande est venue du \textbf{BdF} qui a voulu autoriser pour certains poste un nombre de vote supérieur à 1.
Cela signifie que l'on passe d'un choix simple, type \verb#radio# à un choix multiple, type \verb#checkbox#, tout cela
étant paramètrable dans l'élection.
\par Ce genre de choix n'étant pas disponible dans \textbf{Django} de base, il a fallut développer le \emph{widget} à
utiliser dans le formulaire qui permette cette configuration tout en validant bien les données reçues par rapport au
modèle, et éviter ainsi de pouvoir "tricher" en envoyant des requêtes erronées.
2017-01-08 19:02:09 +00:00
\subsection{Revue du code d'un autre développeur}
\label{sub:revue_du_code_d_un_autre_developpeur}
2017-01-16 13:56:30 +00:00
\par \emph{Antoine} étant le principal développeur de cette application, un gros travail de revue de code a dû être
2017-01-13 18:21:28 +00:00
effectuer afin de garantir une certaine cohérence avec le reste du projet.
2017-01-08 19:02:09 +00:00
2017-01-13 18:21:28 +00:00
\par C'est un travail très long et fastidieux, car il faut bien revérifier chaque ligne, sur chaque fichier, tout en
faisant des commentaire lorsque quelque chose ne va pas. \textbf{Gitlab} a, à ce niveau, grandement facilité la tâche, à
l'aide de ses outils de \emph{merge request} assez avancés.
\par En plus du code en lui-même, il a fallut porter une attention particulière aux migrations. Ces fichiers générés
automatiquement par \textbf{Django} sont responsables du maintient d'une base de donnée cohérente malgré les évolutions
des modèles. Même si le code parait donc valide, il est impératif de surveiller que la chaîne de dépendance des dites
migrations ne soit pas cassée, au risque de problèmes potentiels au moment de la mise en production, ce qui entraînent à
coup sûr un \emph{downtime}.
2017-01-08 19:02:09 +00:00
\chapter{Les stocks}
\label{sub:les_stocks}
2017-01-16 13:56:30 +00:00
\par Développeur principal: Guillaume
2017-01-13 18:21:28 +00:00
\vskip 2em
2017-01-15 19:33:18 +00:00
\par Cette application s'occupe de la gestion des stocks des comptoirs de type « BAR ». Elle permet de suivre les
quantités restantes afin de pouvoir déterminer de manière automatisée quels sont les produits qu'il faut acheter et en
2017-01-13 18:21:28 +00:00
quelle quantité.
2017-01-08 19:02:09 +00:00
2017-01-11 14:26:54 +00:00
\section{Liste des modèles}
\label{sec:liste_des_modeles}
2017-01-08 19:02:09 +00:00
2017-01-11 14:26:54 +00:00
\subsection{Stock}
\par Un Stock possède un nom et est lié à la classe Counter. Ainsi, chaque Comptoir peut avoir son propre Stock.
\subsection{StockItem}
2017-01-13 18:21:28 +00:00
\par Un StockItem possède un nom, une quantité unitaire, une quantité effective, une quantité minimale et est lié à la
2017-01-15 19:33:18 +00:00
classe Stock ainsi qu'à la classe ProductType. De cette manière, chaque élément appartient à un Stock et il est
2017-01-13 18:21:28 +00:00
catégorisé de la même manière que les Products (qui sont les objets utilisés pour la vente dans les comptoirs).
2017-01-11 14:26:54 +00:00
\subsection{ShoppingList}
2017-01-13 18:21:28 +00:00
\par Une ShoppingList possède un nom, une date, un booléen (fait ou à faire), un commentaire et est liée à un Stock.
2017-01-15 19:33:18 +00:00
Chaque ShoppingList est donc liée à un Stock ce qui permet d'avoir des listes de courses spécifique à chaque comptoir.
2017-01-11 14:26:54 +00:00
\subsection{ShoppingListItem}
2017-01-13 18:21:28 +00:00
\par Un ShoppingListItem possède un nom, une quantité demandée, une quantité achetée et est lié à la classe StockItem, à
la classe ShoppingList et à la classe ProductType. Cela permet de pouvoir faire plusieurs listes de courses différentes
2017-01-15 19:33:18 +00:00
en même temps et d'en garder un historique.
2017-01-11 14:26:54 +00:00
\section{Fonctionnement}
\label{sec:fonctionnement}
2017-01-15 19:33:18 +00:00
\par Au départ, si le comptoir de type « BAR » n'a pas de stock, la seule chose qu'il est possible de faire est d'en
créer un. Ensuite, il va falloir créer les objets StockItem en indiquant pour chacun les quantités qu'il y a dans le
2017-01-13 18:21:28 +00:00
stock.
2017-01-15 19:33:18 +00:00
\par De plus, la personne (généralement le Responsable du lieu de vie) qui aura la responsabilité d'informatiser les
2017-01-13 18:21:28 +00:00
stocks devra aussi définir la quantité unitaire, effective et minimale.
\par Par exemple, les Cheeseburger vendus aux différents comptoirs sont achetés par boite de 6, la quantité unitaire
2017-01-15 19:33:18 +00:00
sera donc 6, la quantité effective correspondra au nombre de boites restantes dans le stock (c'est à dire dans la
2017-01-13 18:21:28 +00:00
réserve du lieu de vie, une boite sortie du stock est considérée comme consommée) et enfin, la quantité minimale servira
de valeur seuil.
2017-01-15 19:33:18 +00:00
\par Une fois l'état de la réserve retranscrit dans le site, il reste encore gérer les stocks de manière quotidienne.
Pour ce faire, l'application se décompose en 3 parties :
2017-01-11 14:26:54 +00:00
\begin{itemize}
\item Création automatique des listes de courses
\item Approvisionnement du stock
2017-01-15 19:33:18 +00:00
\item Prise d'éléments dans le stock
2017-01-11 14:26:54 +00:00
\end{itemize}
2017-01-15 19:33:18 +00:00
\par Lorsque l'on accède à la partie qui s'occupe de la gestion des listes de courses, il y a un bouton permettant de
créer une liste de courses en fonction de l'état des stocks à cet instant, puis un premier tableau contenant les listes
de courses qu'il faut faire et enfin un second tableau servant d'historique des listes de courses déjà effectuées.
\par Pour chaque liste de course ainsi créée, qu'elle soit « faite » ou « à faire », il est possible de cliquer sur son
nom pour voir le détail de ce qu'elle comprend.
2017-01-11 14:26:54 +00:00
\subsection{Création automatique des listes de courses}
2017-01-13 18:21:28 +00:00
\par En cliquant sur le bouton permettant de créer une nouvelle liste de courses, il faut remplir un formulaire. Les
informations à donner dans ce formulaire sont le nom de la liste de course (par exemple, une liste spéciale pour
Leclerc), ensuite, apparaissent tous les StockItem ayant une quantité effective inférieure au seuil fixé par leur
quantité minimale. Il faut donc donner pour chacun de ces éléments une quantité à acheter. Enfin, un dernier champ de
2017-01-15 19:33:18 +00:00
commentaire peut être compléter, il sert à demander l'achat d'éléments qui n'apparaissent pas dans le Stock, par
2017-01-13 18:21:28 +00:00
exemple, des couteaux, fourchettes ou encore tasses...
\par Lors de la validation de ce formulaire, la liste de courses est créée et est ajoutée au tableau contenant les
listes de courses à faire.
2017-01-11 14:26:54 +00:00
\subsection{Approvisionnement du stock}
2017-01-13 18:21:28 +00:00
\par Au retour des courses, il faut ranger les produits achetés dans la réserve. À ce moment-là, il faut aussi mettre à
jour le stock. Une opération « Mettre à jour le stock » est disponible pour chaque liste de courses du tableau « À
faire ».
\par En effectuant cette action, il va falloir indiquer les quantités effectivement achetées. En effet, les quantités
2017-01-15 19:33:18 +00:00
demandées ne sont pas forcément celles achetées, c'est donc les quantités effectives qu'il faut ajouter au stock. Une
fois ce formulaire validé, la liste de couses passera de l'état « à faire » à l'état « faite ».
2017-01-11 14:26:54 +00:00
2017-01-15 19:33:18 +00:00
\subsection{Prise d'éléments dans le stock}
\par La réserve étant accessible aux barmen afin qu'ils puissent réapprovisionner les réfrigérateurs à tout moment,
l'interface permettant de prendre des éléments dans le stock a été ajoutée dans les onglets de l'interface des ventes
2017-01-13 18:21:28 +00:00
(là où le barman inscrit le code du compte du client qui souhaite commander quelque chose). Ainsi, en revenant de la
2017-01-15 19:33:18 +00:00
réserve, le barman doit indiquer le nombre de chaque produit qu'il a rapporté.
2017-01-13 18:21:28 +00:00
\par Dans un souci de simplicité pour le gérant du lieu de vie, ce formulaire de prise des éléments dans le stock est
aussi accessible depuis son interface de gestion.
2017-01-11 14:26:54 +00:00
\section{Améliorations à apporter}
\label{sec:amelioration_a_apporter}
\begin{itemize}
2017-01-15 19:33:18 +00:00
\item Il n'est pas encore possible de modifier les quantités demandées pour un ou plusieurs des produits d'une liste
2017-01-13 18:21:28 +00:00
de course. Il faudrait rendre cela possible car actuellement, il faut supprimer la liste de courses et la
refaire en changeant les quantités souhaitées.
\item Il faudrait améliorer la manière dont on ajoute les éléments non définis en tant que StockItem dans la liste
de course. Un objet ShoppingListItem avec une référence « Null » vers la classe StockItem pourrait être créé à
la place de compléter le champ de commentaires.
\item Dans les améliorations sur le long terme, il faudrait que la décrémentation des quantités de chaque élément
2017-01-15 19:33:18 +00:00
dans le stock soit automatique. En repensant une partie de l'architecture de l'application, on pourrait faire en
2017-01-13 18:21:28 +00:00
sorte que chaque vente faite au comptoir face diminuer les quantités restantes (cela remplacerait le formulaire
2017-01-15 19:33:18 +00:00
de « Prise d'éléments dans le stock », mais cela ne serait pas applicable à tous les produits mis en vente. Par
2017-01-13 18:21:28 +00:00
exemple, pour les cacahuètes que nous vendons au bol et non par paquet)
\item Avec le système de notifications qui a été mis en place sur le site, on pourrait faire en sorte que le ou les
responsables des lieux de vie reçoivent une notification lorsque la liste de courses contient plus de 5 éléments
2017-01-11 14:26:54 +00:00
\end{itemize}
2017-01-08 19:02:09 +00:00
\chapter{La laverie}
\label{sec:la_laverie}
2017-01-16 13:56:30 +00:00
\par Développeur principal: Florent
2017-01-08 19:02:09 +00:00
\section{But}
\label{sub:but}
\par Cette application doit fournir un système de gestion de laverie. Cela comprend:
\begin{itemize}
\item Un système de planning et de réservation de créneaux
\item Un système de vente de jetons de laverie, lié aux comptoirs et au compte AE, permettant aux permanenciers de
cliquer les jetons en même temps qu'ils vérifient l'état de la cotisation.
\item Un système d'inventaire, pour gérer les différentes machines dans les différents lieux, et gérer également le
retour des jetons après utilisation.
\end{itemize}
\section{Principaux problèmes}
\label{sec:principaux_problemes}
\subsection{Génération de plannings}
\label{sub:generation_de_plannings}
2017-01-13 18:21:28 +00:00
\par Il y a là beaucoup de cas à prendre en compte. Lorsque que quelqu'un veut réserver directement un "Lavage +
Séchage", un simple "Lavage", ou un simple "Séchage", il faut toujours vérifier la disponibilité des créneaux en
fonction du nombre de machine de chaque type présent dans la laverie en question \footnote{Belfort ou Sevenans, en
l'occurrence}, et cela représente vite un grand nombre de combinaisons à vérifier.
\par De plus, la réservation doit rester ergonomique, et s'afficher dans un format le plus lisible possible pour un
humain. Là dessus, un tableau est le plus approprié, avec chaque jour représenté par une colonne, et chaque créneau par
une ligne.\\
Mais cela ne représente malheureusement pas la temporalité, et la génération du tableau devient alors plutôt compliquée,
et d'autant plus si l'on veut qu'il soit sémantiquement correct en HTML.
2017-01-08 19:02:09 +00:00
\subsection{Gestion des timezones}
\label{sub:gestion_des_timezones}
2017-01-13 18:21:28 +00:00
\par La gestion et le stockage des crénaux implique l'utilisation de champs de type \verb#DateTime#. \textbf{Django} les
gère très bien, particulièrement au niveau des \emph{timezones}, où ce dernier n'hésite pas à lancer un warning lorsque
l'objet \emph{date} passé ne contient pas d'information de fuseau horaire.
\par Mais avec notre décalage d'une heure par rapport au temps UTC, tous les horaires se retrouvent décalés, et gérer
cela convenablement sans sortir d'avertissement a été plutôt compliqué. La solution a été de forcer un peu partout la
\emph{timezone} à UTC, afin de ne pas créer de décalage, mais en conservant tout de même l'information de fuseau
horaire, et sans tout casser lors du passage à l'heure d'hiver.
2017-01-08 19:02:09 +00:00
\chapter{La communication}
\label{sec:la_communication}
2017-01-16 13:56:30 +00:00
\par Développeur principal: Florent
2017-01-08 19:02:09 +00:00
\section{But}
\label{sub:but}
\par Cette application a plusieurs but:
\begin{itemize}
\item Donner la possibilité au responsable communication d'éditer les différents textes, messages, et pages
statiques du site.
\item Fournir un système de news.
\item Fournir un système de newsletter: le Weekmail.
\end{itemize}
\section{Principaux problèmes}
\label{sec:principaux_problemes}
\subsection{Envoie de mails}
\label{sub:envoie_de_mails}
2017-01-13 18:21:28 +00:00
\par Un outil de \emph{newsletter} nécessite l'envoie de mail. C'est là quelque chose de relativement compliqué à
tester, d'autant plus lorsqu'il s'agit de mailing-list contenant l'intégralité des étudiants de l'UTBM.
\par \textbf{Django} fournit toutefois un outil très pratique: il contient plusieurs \emph{backend} d'emails, dont entre
autre un \emph{SMTP}, et un \emph{console}. Le \emph{SMTP} est bien évidemment utilisé en production pour envoyer
effectivement les mails, mais il est compliqué à utiliser en développement, car il suppose que le développeur a à sa
disposition un serveur de ce type. On utilise alors le backend \emph{console}, qui affiche simplement dans le thread
d'execution de \textbf{Django} une version texte de l'email envoyé, avec d'une part les entêtes, d'autre part le corps
de message.
\par Mais autant pour tester l'envoie d'un mail unique à une adresse unique, cela fonctionne parfaitement bien, ce n'est
toutefois pas suffisant pour tester un envoie massif à plusieurs mailings, avec en plus encore d'autres adresses en
\emph{Bcc} pour les gens ne faisant pas partie des mailings "classiques", mais souhaitant quand même recevoir le
\textbf{Weekmail}.
2017-01-08 19:02:09 +00:00
\subsection{Amélioration de l'outil de recherche}
\label{sub:amelioration_de_l_outil_de_recherche}
2017-01-13 18:21:28 +00:00
\par Pour la gestion de l'AE, il est nécessaire de pouvoir rechercher et trouver efficacement n'importe quel membre, en
tapant au choix son nom, prénom, ou surnom, voire une combinaison de ces trois champs.
\par Mais une fonction de recherche aussi complexe est très difficile a mettre en place efficacement sans un traitement
préalable, d'où la nécessité d'indexer les entrées à chercher. Un indexeur étant très complexe, mais également très
courant, il n'a pas été difficile de trouver une application déjà existante fournissant ces fonctionnalités.
\par Le choix s'est porté sur \textbf{Haystack}, en l'utilisant avec l'indexeur \textbf{Whoosh}, plutôt efficace pour
2017-01-15 19:33:18 +00:00
des bases raisonnables, et surtout écrit en pure \textbf{Python}, donc ne nécessitant pas d'installation compliquée en
2017-01-13 18:21:28 +00:00
parallèle du site.
\par Le résultat est plutôt satisfaisant, mais il faudrait encore améliorer les résultats en utilisant les fonctions de
\emph{boost} pour certains champs. De plus, une certaine lenteur se fait encore sentir avec certaines recherches trop
communes ou générales.
2017-01-08 19:02:09 +00:00
\chapter{Conclusions personnelles}
2017-01-16 13:56:30 +00:00
\section{Florent}
2017-01-08 19:02:09 +00:00
\label{sec:skia}
\par Développer de nouvelles application m'a permis d'apréhender d'autres problématiques, comme la gestion des fichiers
dans le SAS, ou bien des contraintes de concurrence et d'atomicité sur l'Eboutic.
\par Mais la plus grosse partie de mon travail ce semestre a surtout été de superviser une équipe de développement
naissante, de relire les "Merge request", et de m'assurer de la cohérence du code des contributeurs avec le reste du
projet.
\par J'ai églament pu approfondir mon utilisation de Gitlab à travers ses outils de gestion de projet, de revue de code,
et de gestion des permissions sur les différentes branches.
2017-01-16 13:56:30 +00:00
\section{Guillaume}
2017-01-08 19:02:09 +00:00
\label{sec:lo_j}
2017-01-15 19:33:18 +00:00
\par Je suis très heureux d'avoir pu participer à ce projet de TO52 sur le développement de modules sur le site de
l'Association des Étudiants. J'ai pu apprendre à travailler avec un nouvel environnement informatique tout en
contribuant au développement d'outils pour l'association dont je suis Président, le Bureau des Festivités.
2017-01-11 14:26:54 +00:00
\subsection{Django}
2017-01-15 19:33:18 +00:00
\par Ayant déjà travaillé avec le framework Spring et Java durant mon stage ST40, j'ai pu m'appuyer sur des notions
générales afin d'apprendre et de comprendre le fonctionnement du Python et de Django que je ne connaissais pas du tout.
2017-01-11 14:26:54 +00:00
2017-01-15 19:33:18 +00:00
\par Mon apprentissage a été assez long au départ, car il y avait beaucoup d'informations à intégrer. Django est un
framework très pratique qui permet d'effectuer de nombreuses tâches assez rébarbatives de manière automatique certes,
mais encore faut-il comprendre ce qu'il se passe en arrière-plan. C'est cet apprentissage qui m'a pris le plus de temps.
2017-01-11 14:26:54 +00:00
2017-01-15 19:33:18 +00:00
\par Mon deuxième point de difficulté a été les formulaires. Là encore, Django est très pratique dès lors qu'il s'agit
de faire un formulaire avec tous les champs d'un même Model. Cependant, il m'a fallu de l'aide et du temps pour
comprendre comment faire pour ajouter d'autres champs en plus de ceux du Model au formulaire et pour comprendre comment
récupérer les valeurs associées à chacun d'eux.
2017-01-11 14:26:54 +00:00
\subsection{Git}
2017-01-15 19:33:18 +00:00
\par J'ai eu aussi à apprendre le fonctionnement de Git que j'avais déjà pu manipuler quelque peu mais il me manquait
quand même beaucoup d'éléments.
2017-01-08 19:02:09 +00:00
2017-01-15 19:33:18 +00:00
\par Aujourd'hui, je pense pouvoir dire que j'ai progressé dans ce domaine mais il me reste encore bien des choses à
apprendre pour être capable de l'utiliser de manière efficace.
2017-01-08 19:02:09 +00:00
2017-01-16 13:56:30 +00:00
\includepdf[pages={2}]{Couvertures.pdf}
2017-01-08 19:02:09 +00:00
\end{document}