From e9cb067c980b39000466cbf7c950f6d012c0d1bf Mon Sep 17 00:00:00 2001 From: Greg Burri Date: Thu, 17 Apr 2008 15:36:45 +0000 Subject: [PATCH] ADD Planification des futures release (dans le todo) ADD Protocole version 3 --- README | 9 +- doc/TODO.txt | 92 +++++++++++--------- doc/protocole3.txt | 205 +++++++++++++++++++++++++++++++++++++++++++++ pages/about.html | 5 ++ pages/faq.html | 2 +- 5 files changed, 270 insertions(+), 43 deletions(-) create mode 100644 doc/protocole3.txt create mode 100644 pages/about.html diff --git a/README b/README index a8ff48b..860b1c5 100644 --- a/README +++ b/README @@ -28,20 +28,20 @@ est d Contient les feuilles de style de chaque skin contenu dans un dossier représentant le numéro du skin. /css/common.css - La feuille de style + La feuille de style commune à tous les skins. /doc Contient tous les documents de conception (fonctionnel, technique, etc.). /img Contient les images du site avec un séparation des images propres à chaque skin. - Certaines images sont issues de document de conception se trouvant dans /doc/graphiques + Certaines images sont issues de document de conception se trouvant dans /doc/graphiques. /js Contient tous les scripts JavaScript. Il existe un script général à Euphorik : euphorik.js ainsi qu'un script par page : page*.js /lightbox - Lib JavaScript permettant d'afficher des images sous la forme de pop-up div. + Lib JavaScript permettant d'afficher des images sous la forme de pop-up modaux. /modules Contient la partie serveur. @@ -53,7 +53,7 @@ est d Contient les modules compilées, initialement vide. /module/erl - Contient le code sources des différents modules. + Contient le code sources des différents modules Erlang. /modules/include Contient certaines définitions (headers). @@ -66,6 +66,7 @@ est d /tool Contient des outils diverses permettant l'aide au développement ou la mise en production. + /tool/jsmin.rb Permet la minification du javascript utilisé lors de la mise en production diff --git a/doc/TODO.txt b/doc/TODO.txt index 8ad0cff..b2b3059 100755 --- a/doc/TODO.txt +++ b/doc/TODO.txt @@ -1,31 +1,30 @@ == TODO == -[50%] Conversations : +=== v1.0 === +[70%] Conversations : [ok] implémenter coté serveur et client la sauvegarde et la restauration des conversations [ok] Supprimer l'envoie de la description des conversations lors du refresh ainsi que modifié la manière de créer les conversations (maj des diagrammes de séquence) - * Navigation vers les pages précédentes + [ok] Navigation vers les pages précédentes * Mettre à jour l'HTML/CSS de chaque skin - * Url vers conversation(s) + également un bouton sur chaque conversation pour obtenir l'url vers celle ci * Lien vers une conversation dans les messages sou s cette forme {5F}. Le clic dessus ouvre la conversation. Egalement un bouton sur chaque conversation pour insérer son lien dans le message en cours de rédaction +* Remplacer l'XML par du JSON. gain en simplicité et en temps d'execution. Légère modification du potocole : passage + * Tester sur un prototype : l'authentification + * Si concluant passage complet à JSON + * Les id ne sont plus passés en base 36 +* Passage du code en anglais (sauf commentaire) * Utiliser une listbox pour la liste des css +* Avoir un thème de discussion affiché en haut des messages genre appellé "troll de la semaine : linux sera-t-il desktop ready en 2008?" +* Faire une page faq et raconter n'importe quoi (entre autre la limitation avec firefox) "pourquoi ce site à des couleurs qui ne veulent rien dire ?" * Ralentir volontairement le connexion lors d'un mauvais login (ou après n mauvais login) * Pouvoir switcher entre un affichage "pseudo" ou "pseudo (login)" * réduire les pseudo trop long en mettant un ".." à la fin et permettre de le voir en entier lorsque le curseur le survol. -* Problème d'utf-8 avec opera, firefox et konqueror, le prologue ( XHTML - * A chaque Shift-enter la textbox s'agrandit d'une ligne * Rendre compatible IE 7 -* Faire une page faq et raconter n'importe quoi (entre autre la limitation avec firefox) "pourquoi ce site à des couleurs qui ne veulent rien dire ?" * Créer un favicon (joli) -* Système de commande / - * /nick : changer de pseudo - * /me : "* " - * /blam : permet d'envoyer un blame à qqun (uniquement depuis un modo vers un non-modo) - * /+ blabla Pourvoir ajouter du texte (correctif en général) à son dernier message par une commande. Le texte ajouté est mise en évidence. Ceci peut être fait plusieurs fois. -* Ajouter de nouveaux smiles : +* Ajouter dans la FAQ et/ou dans la page d'enregistrement les conditions d'utilisation, genre "chacun est responsable de ses dires" https://linuxfr.org/bouchot/ +* Inscrire le nom de l'image dans les les liens vers des images (à la place de simplement [jpg] ou [gif]) +* Ajouter de nouveaux smiles et changer la syntax pour eviter le conflit avec totoz : * "slurp" : http://forum-images.hardware.fr/images/perso/huit.gif * "agreed" : http://forum-images.hardware.fr/icones/smilies/jap.gif * "dodo" (tete avec un bonnet de nuit et des ZZZZ) @@ -34,28 +33,44 @@ * "interrogation" genre http://forum-images.hardware.fr/icones/confused.gif * http://forum-images.hardware.fr/images/perso/dao.gif ou http://forum-images.hardware.fr/icones/redface.gif * http://forum-images.hardware.fr/icones/ohwell.gif -* Ajouter un skin "simple" sans images ni fioritures (éventuellement le proposer par défaut) +* Un statut "EK" avec plein de privilège à la con. (avoir une petite étoile à coté de son nick ou le nick d'une certaine couleur) +* Finir le script de mise en production + * Compatage des js lors de la mise en production (afin d'optimiser la bande passante lors de l'accès au site), regarder comment fait jQuery. +* Traiter les tags TODO et FIXME dans le code * Cleaner le code (erl, js, xhtml, css) et eventuellement profiler un peu (le refresh est lent sous opera) -* Gestion de l'historique au niveau du navigateur (pouvoir revenir aux pages précédentes) +* Restructurer le code Erlang : déplacer certaines fonctions d'un module à l'autre (ev. créer des modules) +* Choisir une licence et la mettre un peu partout dans les sources +* Créer une page 'about' +=== v1.1 === +* Tests de monter en charge coté serveur, analyse de la complexité (regarder du coté des TODO dans le code). Utiliser eventuellement Tsung +* Profiling pour améliorer les performances (client et serveur) + * traitementComplet() de euphorik.js est très très lent à executer +* Pouvoir récupérer son mdp (ou en générer un autre) via son email +=== v1.2 === * Intégrer les totoz : http://www.totoz.eu/ (avec une limite de 3 par messages par exemple) * avoir une option pour les cacher ou les voir * Masquer systématiquement ceux qui dépassent d'une certaine taille (en pixel?) * modifier la syntaxe des smiles actuels (pour pas qu'ils entre en conflit avec totoz) -* Mettre un icone (genre sablier) lorsque le chat se charge (également lors d'un changement de page par exemple) -* gestion des timezone (fuseaux horaire) : - * L'utilisateur peut simplement définit une timezone dans son profil, les dates sont alors affichées en fonction de sa zone (en option) +=== V1.3 === +* Shift-enter pour ajouter une ligne dans la ligne de saisie (retour à la ligne) + * Crée un
XHTML (lf -> br coté client) + * A chaque Shift-enter la textbox s'agrandit d'une ligne +* Système de commande / + * /nick : changer de pseudo + * /me : "* " + * /blam : permet d'envoyer un blame à qqun (uniquement depuis un modo vers un non-modo) + * /+ blabla Pourvoir ajouter du texte (correctif en général) à son dernier message par une commande. Le texte ajouté est mise en évidence. Ceci peut être fait plusieurs fois. +=== V1.4 === +* Elaborer une stratégie de mise à jour de la structure de la BD quand celle ci est modifiée (voir euphorik_bd:vers_version()) +* Ajouter un skin "simple" sans images ni fioritures (éventuellement le proposer par défaut) * Créer un style "super old school" (couleur 8 bit, pas de smiles/images, font fixe) -* Un statut "EK" avec plein de privilège à la con. (avoir une petite étoile à coté de son nick ou le nick d'une certaine couleur) -* Tests de monter en charge coté serveur, analyse de la complexité (regarder du coté des TODO dans le code). Utiliser eventuellement Tsung -* Profiling pour améliorer les performances (client et serveur) - * traitementComplet() de euphorik.js est très très lent à executer -* Traiter les tags TODO dans le code -* Compatage des js lors de la mise en production (afin d'optimiser la bande passante lors de l'accès au site), regarder comment fait jQuery. -* Elaborer une stratégie de mise à jour de la structure de la BD quand celle ci est modifiée (voir euphorik_bd:vers_version()) -* Inscrire le nom de l'image dans les les liens vers des images (à la place de simplement [jpg] ou [gif]) -* Ajouter dans la FAQ et/ou dans la page d'enregistrement les conditions d'utilisation, genre "chacun est responsable de ses dires" https://linuxfr.org/bouchot/ -* Choisir une licence et la mettre un peu partout dans les sources -* Restructurer le code Erlang : déplacer certaines fonctions d'un module à l'autre (ev. créer des modules) +=== V1.5 === +* Gestion de l'historique au niveau du navigateur (pouvoir revenir aux pages précédentes). Utiliser un plugin jQuery si possible. +* gestion des timezone (fuseaux horaire) : + * L'utilisateur peut simplement définir une timezone dans son profil, les dates sont alors affichées en fonction de sa zone (en option) +* Transfert des messages XML (AJAX) en https et le noter dans la faq (même la mafia chinoise ne peut pas sniffer les messages). En fait il suffit (sauf erreur) de sécuriser euphorik : https://www.euphorik.ch +* Conversations : url vers conversation(s) + également un bouton sur chaque conversation pour obtenir l'url vers celle ci. (genre google map) + [ok] Réaliser la structure suivante : * Table minichat : {id, auteur_id, date, pseudo, contenu, reponses_minichat_id} reponses_minichat_id peut être null @@ -118,7 +133,8 @@ 1 : Critique 2 : Urgent 3 : Peu grave - + +[1] Problème d'utf-8 avec opera, firefox et konqueror, le prologue (, , , (quoted text) * La balise pour mettre des spoilers @@ -179,6 +194,7 @@ ok : Implémenté [4] Plusieurs canaux [A] smiles personnalisés, on peut en ajouter dans la préférence utilisateur. +[ok] Pouvoir insérer des tags qui sont des liens vers des conversations, par exemple : {R4S} =~ /\{\w+\}/ === Concurrents === diff --git a/doc/protocole3.txt b/doc/protocole3.txt new file mode 100644 index 0000000..4cf6255 --- /dev/null +++ b/doc/protocole3.txt @@ -0,0 +1,205 @@ +Euphorik - Protocole v3 +----------------------- + +A. Introduction +--------------- + +Ce document a pour but de décrire la communication client-serveur du site euphorik. +Les messages échangés sont basés sur le format JSON. +Ce document remplace 'protocole2.txt'. + + +B. Principe +----------- + +Enregistrement: + * Permet de créer un compte, un cookie est donné en retour. Ce cookie doit être stocké par le client pour pouvoir s'authentifier par la suite. + +Authentification: + * L'authentification (login) se fait soit par un couple soit à l'aide d'un cookie. + * Permet de récupérer les données d'un profile + +Rafraichissement: + * Le client envoie une demande au serveur avec l'id du dernier message (via XMLHttpRequest ou un function de JQuery) + * Le serveur maintient la connexion bloquée si le client est à jour. + * Dès qu'un nouveau message arrive, le serveur débloque la connexion est envoie le ou les messages manquants. + + +C. Protocole +------------ +c : client +s : server +Les messages client vers serveur sont envoyé par HTTP-POST + + +C.1. Login +---------- +Le mot de passe est hashé en md5. + +c -> s + { + "action" : "authentification", + "login" : "Paul", + "password" : "IJKJDHHSAD9081238" + } +ou + { + "action" : "authentification", + "cookie" : "LKJDLAKSJBFLKASN" + } +ou + { + "action" : "register", + "login" : "Paul", + "password" : "IJKJDHHSAD9081238" + } + +s -> c + { + "reply" : "login", + "status" : "registration_ok" | "authentification_ok" | "error", + "cookie" : "LKJDLAKSJBFLKASN", + "id" : 193, + "pseudo" : "Paul", + "login" : "paul49", + "email" : "paul@pierre.com", + "css" : "css/3/euphorik.css", + "main_page" : 1, + "conversations" : [ + { + "racine" : 123, + "page" : 1 + } + ], + "error_message" : "blabla" + } + + +C.2. Logout +----------- +c -> s + { + "action" : "logout", + "cookie" : "LKJDLAKSJBFLKASN" + } + + +C.3. Profile +------------ +Modification du profile, seul "cookie" est obligatoire. + +c -> s + { + "action" : "set_profile", + "cookie" : "LKJDLAKSJBFLKASN", + "login" : "paul49", + "password" : "IJKJDHHSAD9081238", + "pseudo" : "Paul", + "email" : "paul@pierre.com", + "css" : "css/3/euphorik.css", + "mainPage" : "1", + "conversations" : [ + { + "racine" : "4F", + "page" : 1 + } + ], + } + +s -> c + { + "reply" : "ok" | "error", + "error_message" : "blabla" + } + + +C.4. Wait event +--------------------- +Si "last_message_id" est absent alors le client ne possède pas de message. +Les conversations données sont définies dans le profile. + +c -> s + { + "action" : "wait_event", + "cookie" : "LKJDLAKSJBFLKASN", + "message_count" : 10, + "last_message_id" : 163 + } + +s -> c +La première conversation est la principale (main). +L'ordre des conversation est le même que celui des données de l'utilisateur. +Le format de la date n'est pas formel. + { + "reply" : "new_messages", + "conversations" : [ + "last_page" : true | false, + "messages" : [ + "id" : 54, + "date" : "Hier 17:26:54", + "system" : true | false, + "owner" : true | false, + "answered" : true | false, + "is_a_reply" : true | false, + "nick" : "Paul", + "login" : "paul_22", + "content" : "Salut", + "answer_to" : [ + { "id" : 123, "pseudo" : "Pierre", "login" : "pierre_45" } + ] + ] + ] + } +ou + { + "reply" : "message_updated", + "message_id" : 123, + "contenu" : "Salut +++ poulpe" + } +ou + { + "reply" : "error", + "error_message" : "blabla" + } + + +C.5. Envoie message +------------------- +Le client envoie un message, le message peut répondre à un certain nombre d'autres messages. +"answer_to" n'est pas obligatoire. + +c -> s + { + "action" : "put_message", + "cookie" : "LKJDLAKSJBFLKASN", + "nick" : "Paul", + "content" : "Bonjour", + "answer_to" : [ 345, 532, ... ] + } + +s -> c + { + "reply" : "ok" | "error", + "error_message" : "blabla" + } + + +C.6 Ajout d'une correction d'un messages +---------------------------------------- +Le client envoie un correctif sous la forme de texte supplémentaire à appondre au dernier messages. +Le message est appondu avec un " +++ " devant, par exemple : +> Gnome c'est mieux que KDE +++ Euh non ok, c'est faux + +c -> s + { + "action" : "correction", + "cookie" : "LKJDLAKSJBFLKASN", + "content" : "Euh non ok, c'est faux" + } + +s -> c + { + "reply" : "correction", + "status" : "ok" | "error", + "message_error" : "blabla" + } diff --git a/pages/about.html b/pages/about.html new file mode 100644 index 0000000..02d900f --- /dev/null +++ b/pages/about.html @@ -0,0 +1,5 @@ + + +Euphorik +Version : 1.0 +Auteur : Greg Burri (avec lien sur mail) \ No newline at end of file diff --git a/pages/faq.html b/pages/faq.html index a357d0f..29b9567 100755 --- a/pages/faq.html +++ b/pages/faq.html @@ -8,7 +8,7 @@

Le daltonisme du webmaster n'y est surement pas étranger. Il est possible de choisir parmis d'autres styles via le menu en haut à droite.

-

Quels-sont les navigateurs supporté ?

+

Quels-sont les navigateurs supportés ?

Le site a été testé avec succès sous "Firefox 2", "Safari 3", "Opera 9" et "Konqueror". Il est déconseillé d'utiliser Microsoft Internet Explorer pour des raisons d'incompatibilités.

-- 2.45.2