Gepi

= Cahier des charges du module absences 2 =

 == Avant propos ==

Devant la nécessité de recoder le module absences, nous allons profiter de ce lieu pour établir un cahier des charges le plus complet possible. A cet effet, en fonction des discussions sur les différentes liste de diffusion de gepi, la synthèse sera mise à jour ici même. Tous ceux qui veulent participer à ces échanges sont les bienvenus.

 ==== Quelques principes pour le développement ====

 * Pour éviter de disperser les bonnes volontés, il serait bien qu'une version aboutie soit prète avant la fin de l'année scolaire 2008-2009 pour pouvoir tester en grandeur nature le module dans les établissements.

 * Le choix technologique a été porté sur un outil d'ORM récent et puissant : Propel ([http://propel.phpdb.org/trac/wiki/Users/Documentation/1.3 Doc. officielle] et [wiki:propel traduction partielle]) est en test sinon un motif ActiveRecord adapté à la structure de Gepi fera l'affaire.

 * Le module portera le nom de mod_abs2 dont la structure est déjà présente sur le [browser:trunk/mod_abs2 trunk].

 * Il faudra que le code respecte quelques principes (conventions de nomage, DRY, POO).

 * Ce module devra être lié avec le nouveau module Disciplines de Stéphane Boireau ainsi qu'avec le module emploi du temps. Pour la saisie des absences, on utilisera les AID pour constituer des groupes d'élèves-professeurs-activité. Le module AID devra donc également être lié au module absences.

 * Tous les documents produits par Gepi devront être possibles sous plusieurs formats (html, [browser:trunk/class_php/odf.php open document], [browser:trunk/fpdf pdf], [browser:trunk/class_php/RSSFeed rss], csv).

 * 3 méthodes d'envoi devront être possibles (papier, courriel et sms).

 == Les fonctionnalités ==

 === La saisie ===

 * Chaque utilisateur devra pouvoir disposer de droits bien définis => un professeur ne peut saisir "absent" que des élèves qu'il a en cours par exemple.

  * => Les différents niveaux de saisie possible (indépendants du statut de l'utilisateur) :

   * l'utilisateur peut saisir seulement les élèves auxquels il est rattaché

   * l'utilisateur peut saisir tous les élèves de l'établissement

  * => Les "moments" possibles de la saisie

   * l'utilisateur peut saisir son niveau d'absence à n'importe quel moment de la journée

   * l'utilisateur peut saisir son niveau d'absence en respectant son emploi du temps seulement

  * => Que peut saisir l'utilisateur ?

   * l'utilisateur peut saisir les élèves absents seulement

   * l'utilisateur peut corriger une absence en retard

   * l'utilisateur peut saisir les élèves absents et ceux en retard

 * Il faudra prévoir d'utiliser les statuts personnalisés pour permettre à un administrateur de créer des utilisateurs avec des droits particuliers sur ses fonctionnalités.

 === Le traitement ===

  ==== Préambule ====

  * Seuls les personnels autorisés (CPE et statuts personnalisés qui auront ces droits) pourront accéder à cette partie du module

 === La structure de la base ===

'' ébauche ''

 -> table a_saisie[[BR]]

||`id`||int(11)||NOT NULL||auto_increment||-||

||`utilisateurs_id`||varchar(100)||NOT NULL||-||Utilisateurs::login||

||`eleves_id`||int(4)||NOT NULL||-||eleves::id_eleve||

||`date_saisie`||int(13)||NOT NULL||-||timestamp UNIX||

||`debut_abs`||int(12)||NOT NULL||-||timestamp UNIX||

||`fin_abs`||int(12)||NOT NULL||-||timestamp UNIX||

  ''PRIMARY KEY  (`id`)''

... @ suivre ...