Spécification du système d'annotations

Les annotations

Nous pouvons séparer les annotations en deux catégories :

Les commentaires simples
Les demandes de correction

Commentaire simple

Un commentaire simple se présente sous forme de simple texte non formaté. Il peut être décrit par les données suivantes :

Login name
Date
Texte

Demande de correction

Une demande de correction se présente sous forme de données formatées, dépendant du type de correction. Elle peut être décrite par les données d'un commentaire simple plus des données spécifiques au type de correction :

Login name
Date
Texte libre (pour complément d'information par exemple)
Données spécifiques au type de correction

Attachement à une donnée astronomique

Une annotation doit pouvoir être attachée à une donnée astronomique, de sorte que lorsque cette donnée est affichée via un des services du CDS, toutes les annotations correspondantes puissent être affichées aussi. Donc une donnée astronomique doit pouvoir être identifiée de façon unique, et une annotation contiendra ces données d'identification en tant que "clé étrangère".

Un objet dans VizieR

Un objet dans VizieR peut être décrit de façon unique avec les champs suivants :

Le nom de la table (par exemple "J/A+A/342/671/nii6583")
Le nom de l'objet (par exemple "NGC 2179")

Un objet dans Simbad

Un objet dans Simbad peut être décrit de façon unique avec les champs suivants :

Le nom de l'objet (par exemple "NGC 2179")

Administration des annotations

L'ensemble des annotations doivent pouvoir être gérées par des administrateurs. Un tel système d'administration devra avoir les fonctionnalitées suivantes :

Visualisation des annotations avec critères de filtrage (voir les n dernières annotations, ne voir que les annotation d'un certain type, ...)
Edition et suppression des annotations
Suivi des annotations de type correction (définir le responsable de la correction, changer le statut, ...)

Compte utilisateur

Chaque utilisateur désirant utiliser le système d'annotations devra posséder un compte.

Données

Voici la liste des données que pourrait contenir un compte utilisateur, avec en gras les données obligatoires :

Adresse mail
Login name
Mot de passe
Nom
Prénom
Lieu de travail
Fonction

Procédure d'inscription

Une inscription devra se dérouler en deux étapes :

L'utilisateur entre ses données de compte via un formulaire et un mail de confirmation lui est envoyé à l'adresse spécifiée
L'utilisateur doit cliquer sur le lien de confirmation contenu dans le mail afin de valider son inscription

Une telle procédure permet d'éviter les inscriptions en masse par des robots.

Authentification

Il faudrait que l'utilisateur ait besoin de s'authentifier une seule fois pour accéder au système d'annotations de tous les services du CDS.

Technologie

D'un point de vue technique, cela peut être réalisé en utilisant un système de session, s'appuyant par exemple sur les cookies pour la gérer.

Interface

A quel endroit l'utilisateur pourra-t-il s'authentifier ? Il y a deux approches :

Ajouter une section "Mon compte" à toutes les pages concernées, contenant un mini formulaire permettant de se connecter. Cette méthode est assez intrusive vu qu'elle pourra conduire à une grande modification des pages cibles.
Ajouter un simple lien "Se connecter" qui ouvrirait une page contenant le mini formulaire permettant de se connecter. Ce lien se changerait en "Se déconnecter" un fois connecté. Cette méthode est un peu moins intrusive que la précédante car elle ne nécessite de rajouter qu'un lien texte .

Gestion de compte

Un utilisateur enregistré devra à tout moment pouvoir gérer son compte. Une fois connecté, il devra y avoir un lien "Gérer mon compte" renvoyant sur une page permettant d'éditer ses informations personnelles et ses préférences éventuelles.