<<TableOfContents>>

== Roundup : roundup.auf.org ==

Support : 
 * http://wiki.debian.org/roundup
 * http://www.roundup-tracker.org/docs/user_guide.html
 * http://roundup.sourceforge.net/doc-1.0/customizing.html

=== Contexte ===
 * serveur hôte : vz-tech.ca.auf
 * N° de CT : 513
 * adresse IP : 199.84.140.29

=== Installation ===

 * apache
 * roundup
 * dovecot 
 * exim4-light

=== Configuration ===
 
 * roundup-admin install
  * type de db : sqlite (pour le moment, mais à voir avec l'évolution)

 * Adresses utilisées (alias créés sur le serveur smtp): 
  * pour les tickets : support-auf-test@auf.org, redirigé vers support-auf-test@roundup.auf.org
   . le principe étant que la boîte à mail est géré localement sur le serveur roundup (d'où le dovecot)
  * admin : roundup-admin@auf.org (MoussaNombre, DarkoStanar, AlexandreDomont)

 * création d'une instance de tracker : 
  * `roundup-admin install`
  * nom : auf-test
  * type de bd : sqlite
  * configuration : `/var/lib/roundup/trackers/yourtracker/config.ini`
  * initialisation : `roundup-admin initialise` (c'est ici qu'on définit le mot de passe du compte admin)
  * ajout du nouveau tracker dans le système (/etc/roundup/roundup-server.ini)
    * port = 8088  (''' A REVOIR''')
    * 
     {{{
      [trackers]
      auf-test = /var/lib/roundup/trackers/auf-test
     }}}
  * fichier de log : /var/log/roundup/auf-test.log
  * rendre la bd accessible : chmod 777 /var/lib/roundup/trackers/auf-test/db  (''' A REVOIR''')

 * exim4 + dovecot :
  * création du compte unix : support-auf-test avec homedir = /var/lib/roundup/trackers/auf-test/support-auf-test
  * BAL : ~Maildir
  * dovecot.conf
   * accessible seulement via localhost
   * groupe = support-auf-test
   * authentification PAM activée

 * relancer roundup : /etc/init.d/roundup restart

 * automatisation du roundup-mailgw : `/etc/cron.d/roundup-check-mail` à toutes les 2 minutes

 * activation de l'inscription par email (on n'a pas besoin d'être inscrit via le web pour envoyer un ticket) :
  * {{{
     # /var/lib/roundup/trackers/auf-test/schema.py
     db.security.addPermissionToRole('Anonymous', 'Email Access')
    }}}
  * quand quelqu'un (non inscrit via le web) envoie un mail à support-auf-test :
   1. le mail est accepté et un ticket est ouvert (avant, le mail était rejeté avec un message qui disait qu'il fallait d'abord être inscrit avant de pouvoir envoyer de mail)
   1. un nouveau compte est crée (préfixe du courriel) sans mot de passe (empêchant toute ouverture de session sur l'interface web)
   1. soit l'admin met un mot de passe et en informe l'utilisateur ; soit celui-ci clique sur l'option "Perdu votre login ?" pour se faire envoyer un mot de passe
  * il y a un '''MAIS''' :
  {{{
   # Let anonymous users access the email interface (note that this implies
   # that they will be registered automatically, hence they will need the
   # "Create" user Permission below)
   # This is disabled by default to stop spam from auto-registering users on
   # public trackers.
  }}}
  En français : '''c'est la porte grande ouverte aux spams'''.
  * Solution : '''n'accepter les nouveaux courriels que s'il viennent d'un xxxx@auf.org'''.
   De prime abord, il faudra jouer dans le code pour ça.

 * les utilisateurs ne doivent pas voir les comptes des autres (par défaut, c'est ouvert) :
  {{{
   # /var/lib/roundup/trackers/auf-test/schema.py

   # May users view other user information? Comment these lines out
   # if you don't want them to
   #db.security.addPermissionToRole('User', 'View', 'user')
  }}}
 
 * où sont envoyés les messages d'erreurs / taille des PJ :
  {{{
   # /var/lib/roundup/trackers/auf-test/config.py

   # Send error message emails to the dispatcher, user, or both?
   # Default: user
   error_messages_to = both

   #max_attachment_size = 2147483647
   max_attachment_size = 10000000
  }}}

 * liaison avec le système d'[[https://redmine.auf.org/projects/roa-authentification|authentification centralisée auf_roa_authentification]]
  * CyrilRobert a écrit un script ([[http://git.auf.org/?p=cyril.git;a=blob;f=Apps/roundup/auf_roa.py;h=6e6217efb6393667a2f907dc1cdf076b2b147e82;hb=aebdb7f4d0420543432149d1b82b0ef21d3ec2f5|auf_roa.py]])pour cette liaison
  * le script est installé dans `/var/lib/roundup/trackers/auf-test/extensions/auf_roa.py`
  * pour son fonctionnement installer json : `aptitude install python-simplejson`
  * résultat : tous les comptes en @auf.org ont accès à roundup.auf.org avec leur 'mot de passe TSE'

 * la partie auf-test de roundup est suivi sur git.auf.org : http://git.auf.org/?p=roundup-auf.git

=== Interface web ===

 http://roundup.auf.org


=== Échéancier projet ===

 https://redmine.auf.org/projects/roundup


=== Notes ===

Techniques :

 * Voir pour la DB à utiliser
 * Voir cette histoire de chmod 777 /var/lib/roundup/trackers/auf-test/db

Fonctionnelles :

 * Compléter et franciser : "état" et "priorité"
 * Synchronisation avec annuaire AUF
 * Message de réponse après avoir envoyer une demande de support (accuse la création d'un ticket)
 * Envoie des tickets à un support "niveau 1" en fonction de la région, pour assignation technique.
 * Par la suite : Syndication 
 * démarche :
  * Utilisateur envoie un message à support-auf-test@auf.org
  * Un nouveau ticket est créé dans un délai de 2' sur roundup.auf.org
   * Un message est envoyé à l'utilisateur pour l'informer de la création du ticket. A ce moment là, il peut au besoin compléter sa demande en répondant au message.
   * Un message est envoyé au support niveau 1 (1 ou 2 tech en fonction de la région de provenance du message), assignation du ticket et des mots-clés
   * Un message est envoyé au tech assigné, il gère le ticket soit par mail, soit sur la plateforme, il peut entreprendre des recherches sur un ticket similaire.
    * Lorsqu'un commentaire est ajouté via l'interface web, est-ce que les personnes dans la "liste des curieux" le reçoit par courriel ?
     *  A tester... --AlexandreDomont
     *  Oui, lorsqu'un commentaire est fait par courriel ou via l'interface web, il est adressé par courriel à la liste des curieux. --ChristineLegris
    * L'utilisateur reçoit-il tous les échanges concernant son ticket ou peut-il recevoir uniquement la réponse finale; la solution ?
     * L'utilisateur recevra tous les échanges concernant son ticket et pourra y répondre, le tech et les "curieux" recevront le message. --AlexandreDomont
       * L'utilisateur est ajouté par défaut dans la liste des curieux et reçoit donc tous les messages. Les autres doivent s'ajouter dans la liste des curieux; le fait de faire un commentaire ne provoque pas l'ajout à la liste des curieux.  --ChristineLegris
     * Une "liste parallèle" permettra de discuter purement technique.--AlexandreDomont


 * Comment envoyer un message au tech selon la région de provenance du message ? 
 * voir si on peut utiliser les mots-clés pour envoyer un message (ou comme catégorie d'abonnement de flux rss) aux personnes concernées/intéressées par CODA, OOo, Reflets-web, etc.
 * Ajouter des filtres/tris sur les en-tête de colonne de la liste des demandes sur l'interface web - en fait, rendre plus aisée et agréable la recherche dans les issus afin d'encourager la consultation des tickets en cours mais également de ceux résolus.

Remarque: Lorsque l'incident est résolu et que le demandeur en est avisé, s'il répond au courriel ne serait-ce que pour dire merci, le statut du ticket change pour chatting.