Author: fdesbois Date: 2010-04-05 18:14:16 +0000 (Mon, 05 Apr 2010) New Revision: 415 Added: trunk/src/announcement/release-email-1.1.txt Modified: trunk/changelog.txt trunk/src/site/resources/schemas/CU_WAO.png trunk/src/site/resources/schemas/Modele_WAO.png trunk/src/site/rst/admin/firstlaunch.rst trunk/src/site/rst/business-rules.rst trunk/src/site/rst/installation.rst trunk/src/site/rst/model.rst trunk/src/site/rst/usecases.rst trunk/src/site/rst/user/contacts.rst trunk/wao-business/src/main/xmi/wao.zargo Log: Update documentation site, announcement email and changelog for 1.1 Modified: trunk/changelog.txt =================================================================== --- trunk/changelog.txt 2010-04-03 10:33:53 UTC (rev 414) +++ trunk/changelog.txt 2010-04-05 18:14:16 UTC (rev 415) @@ -10,7 +10,7 @@ ++++++++++ - [fdesbois] Utilisation ServiceTransformer de ToPIA pour générer le squelette - des services. + des services + i18n v1.2.1 - [fdesbois] Evo #1980 : Droits "lecture seule" pour les utilisateurs - [fdesbois] Evo #2233 : Gérer les formats de dates par défaut d'OpenOffice pour l'import CSV (JJ/MM/AA) Added: trunk/src/announcement/release-email-1.1.txt =================================================================== --- trunk/src/announcement/release-email-1.1.txt (rev 0) +++ trunk/src/announcement/release-email-1.1.txt 2010-04-05 18:14:16 UTC (rev 415) @@ -0,0 +1,40 @@ + +La nouvelle version 1.1 de l'applicatif Wao est disponible ! + +Nouveautés : + +- Utilisation ServiceTransformer de ToPIA pour générer le squelette des services + i18n v1.2.1 [fdesbois] +- Droits "lecture seule" pour les utilisateurs [fdesbois-Evo#1980] +- Gérer les formats de dates par défaut d'OpenOffice pour l'import CSV (JJ/MM/AA) [fdesbois-Evo#2233] +- Gestion du chemin vers les logs de l'application [fdesbois-Evo#2229] +- Amélioration gestion interne des enumérations (ContactState) [fdesbois-Evo#2226] +- Créer un profil "coordinateur" pour les sociétés [fdesbois-Evo#2063] +- Tri des utilisateurs d'une société par ordre alphabétique (prénom, nom) [fdesbois-Evo#2225] +- Mise à jour librairies [fdesbois] : + * commons-lang 2.4 -> 2.5 + * commons-beanutils 1.8.0 -> 1.8.2 + * junit 4.7 -> 4.8.1 + * topia 2.3.0-beta-8 -> 2.3.2 + * eugene 2.0.0-beta-4 -> 2.0 + * nuiton-utils 1.1.5 -> 1.2.1 + * h2 1.2.128 -> 1.2.132 + * postgresql 8.3-603.jdbc4 -> 8.4-701.jdbc4 + +Résolutions d'anomalies : + +- Impossible de changer les zones de pêche [fdesbois-Ano#2237] +- Temps d'affichage lent pour les pages contacts et plan d'échantillonnage [fdesbois-Ano#2235] +- Erreur d'affichage de la synthèse : réactivité de la saisie dans Allegro [fdesbois-Ano#2228] + +Documentation : + +http://suiviobsmer.labs.libre-entreprise.org/wao/ + +Téléchargement : + +https://labs.libre-entreprise.org/frs/?group_id=154 + +Cordialement, + +L'équipe Wao + Modified: trunk/src/site/resources/schemas/CU_WAO.png =================================================================== (Binary files differ) Modified: trunk/src/site/resources/schemas/Modele_WAO.png =================================================================== (Binary files differ) Modified: trunk/src/site/rst/admin/firstlaunch.rst =================================================================== --- trunk/src/site/rst/admin/firstlaunch.rst 2010-04-03 10:33:53 UTC (rev 414) +++ trunk/src/site/rst/admin/firstlaunch.rst 2010-04-05 18:14:16 UTC (rev 415) @@ -4,8 +4,8 @@ Connection ---------- -Au premier lancement à l'adresse http://server/suiviobsmer-ui (ou l'adresse -configurée), vous arrivez sur la page de connection. +Au premier lancement à l'adresse http://server/wao-ui (ou l'adresse +configurée), vous arrivez sur la page de connexion. .. image:: login.png Modified: trunk/src/site/rst/business-rules.rst =================================================================== --- trunk/src/site/rst/business-rules.rst 2010-04-03 10:33:53 UTC (rev 414) +++ trunk/src/site/rst/business-rules.rst 2010-04-05 18:14:16 UTC (rev 415) @@ -85,7 +85,7 @@ * Refusé = non * Validé = accepté ou refusé (oui ou non) -- Validation par la société : +- Validation par la société (COORDINATEUR) : * Aucune validation faites par le programme (ADMIN) * Etat terminé ("Non abouti", "Refus", "Refus définitif") Modified: trunk/src/site/rst/installation.rst =================================================================== --- trunk/src/site/rst/installation.rst 2010-04-03 10:33:53 UTC (rev 414) +++ trunk/src/site/rst/installation.rst 2010-04-05 18:14:16 UTC (rev 415) @@ -26,13 +26,13 @@ Ce fichier se nomme Wao.properties et peut être placé dans : - /etc/Wao.properties -- $HOME/.Wao.properties +- $HOME/.config/Wao.properties Un fichier par défaut existe depuis le war de l'application avec les paramètres suivant :: ## Default properties for H2 database - hibernate.hbm2ddl.auto=create + hibernate.hbm2ddl.auto=none hibernate.show_sql=false hibernate.dialect=org.hibernate.dialect.H2Dialect hibernate.connection.username=sa @@ -42,8 +42,8 @@ hibernate.connection.url=jdbc:h2:file:~/.local/wao/h2data ## Logs for activityCalendar in user home - wao.log.activityCalendar.access=${user.home}/.local/wao/log/activity-access.log - wao.log.activityCalendar.import=${user.home}/.local/wao/log/activity.log + wao.log.activityCalendar.access=${wao.log.home}/activity-access.log + wao.log.activityCalendar.import=${wao.log.home}/activity.log ## Config for sending Email wao.email.host=smtp @@ -54,7 +54,7 @@ wao.server.path=localhost:8080/wao ## Version (not necessary to override it) - wao.version=1.0 + wao.version=1.1 Par défaut la base de données utilise le SGBD H2 qui créera un fichier dans le dossier $HOME/.local/wao nommé **h2data.h2.db**. Il est possible d'utiliser @@ -76,11 +76,12 @@ --------------------- Un fichier de log nommé wao.log permettant de voir le comportement de -l'application sera automatiquement créé dans le dossier /var/log/wao. +l'application sera automatiquement créé dans le dossier défini par la variable +d'environnement *wao.log.home*. Voici la configuration pour les logs de l'application :: log4j.appender.globalfile=org.apache.log4j.RollingFileAppender - log4j.appender.globalfile.File=/var/log/wao/wao.log + log4j.appender.globalfile.File=${wao.log.home}/wao.log log4j.appender.globalfile.MaxFileSize=500KB log4j.appender.globalfile.Append=true log4j.appender.globalfile.MaxBackupIndex=10 @@ -95,7 +96,20 @@ Le niveau de log par défaut est placé à DEBUG pour l'ensemble de l'application (package : **log4j.logger.fr.ifremer.wao=DEBUG**) +Options de lancement +-------------------- +depuis v1.1 + +L'option **-Dwao.log.home** doit être défini au lancement de l'application. +Il est également possible de redéfinir l'emplacement du fichier de config +en dehors du champs d'ApplicationConfig (/etc, ${user.home}/.config) en +utilisant l'option **-Dwao.config.path**. +Le plus simple pour tomcat est de définir dans /etc/default un +fichier *tomcat* contenant :: + +JAVA_OPTS="$JAVA_OPTS -Dwao.log.home=/var/log/wao -Dwao.config.path=/var/local/wao" + Références ---------- Modified: trunk/src/site/rst/model.rst =================================================================== --- trunk/src/site/rst/model.rst 2010-04-03 10:33:53 UTC (rev 414) +++ trunk/src/site/rst/model.rst 2010-04-05 18:14:16 UTC (rev 415) @@ -70,7 +70,7 @@ + logText : texte descriptif du changement effectué sur la ligne + comment : commentaire sur le changement + [caché] topiaCreateDate : date du changement effectué - + [lien] admin : administrateur qui a modifié la ligne + + [lien] author : auteur du log Navires ------- @@ -160,7 +160,7 @@ + dataInputDate : date de saisies des données observées dans l'application Allegro + comment : commentaire sur le contact - + state : état du contact + + state : état du contact (entier correspondant à une énumération Java) + tideNbDays : nombre de jours de marées effectuées + [lien] observer : observateur qui s'occupe du contact faisant parti de la société concerné par le métier (ligne du plan d'échantillonnage) @@ -195,8 +195,9 @@ + phoneNumber : numéro de téléphone + login : identifiant de connexion (correspond à l'e-mail) + password : mot de passe de connexion à l'application (encodé) - + admin : indicateur permettant d'identifier l'utilisateur comme étant un - administrateur. + + userRole : rôle de l'utilisateur (coordinateur, administrateur, observateur) + (entier correspondant à une énumération Java) + + readOnly : droits lecture seule (aucune sauvegarde/modification permise) - **BoatInfos** : Informations d'un navire spécifique à une société @@ -213,3 +214,16 @@ + title : titre + content : contenu de l'article + +Migration des données +--------------------- + +Version 1.1 +~~~~~~~~~~~ + +- [WaoUser] Création du champs userRole (smallint) +- [WaoUser] Suppression du champs admin (équivalent à userRole = 0) +- [WaoUser] Création du champs readOnly (boolean) +- [Contact] Modification du type pour le champs state (varchar -> smallint) +- [SampleRowLog] Modification du rôle de l'association vers WaoUser (admin -> + author) \ No newline at end of file Modified: trunk/src/site/rst/usecases.rst =================================================================== --- trunk/src/site/rst/usecases.rst 2010-04-03 10:33:53 UTC (rev 414) +++ trunk/src/site/rst/usecases.rst 2010-04-05 18:14:16 UTC (rev 415) @@ -5,94 +5,167 @@ :Revision: $Revision$ :Date: $Date$ -Il existe deux types d' `Utilisateur`_ dans l'application WAO : +Il existe plusieurs types d'utilisateur dans l'application WAO : -- `Administrateur`_ : Personne s'occupant de la gestion des référentiels, de la - création des comptes utilisateurs et du la gestion du planifié -- `Observateur`_ : Personne s'occupant du suivi du réalisé +- `Utilisateur lecture seule`_ : Personne n'ayant qu'un droit de lecture + sur l'application (il peut être administrateur ou observateur). +- `Administrateur`_ : Personne s'occupant de la gestion des référentiels, + de la création des comptes utilisateurs et de la gestion du planifié. +- `Observateur`_ : Personne s'occupant du suivi du réalisé. +- `Coordinateur`_ : Type particulier d'observateur ayant en plus les droits de + validation, d'import/exports des contacts et d'ajout de commentaire sur le + plan d'échantillonnage. -Ces deux utilisateurs ont quelques fonctionnalités en commun, comme certains -import/export ou la consultation des synthèses et indicateurs. +L'administrateur a une visibilité sur l'ensemble des sociétés tandis que +l'observateur et le coordinateur n'ont la visibilité que de leur propre +société. .. image:: schemas/CU_WAO.png -Les couleurs reprennent le `modele de donnees`_ : +Les couleurs des diagrammes reprennent le `modele de donnees`_ ainsi que les +grandes parties de l'application : -- jaune : navires -- vert : plan d'échantillonnage -- mauve : contacts -- bleu ciel : utilisateurs -- rose : synthèses -- blanc : news +- 0. blanc : news +- 1. vert : plan d'échantillonnage +- 2. jaune : navires +- 3. mauve : contacts +- 4. rose : synthèses +- 5. bleu ciel : utilisateurs / administration .. _modele de donnees: model.html -Utilisateur ------------ +Utilisateur lecture seule +------------------------- -Fonctionnalités communes aux deux types d'utilisateur : +Ce type d'utilisateur est celui ayant le minimum de droits, de ce fait, les +administrateurs et les observateurs ont également ces fonctionnalités. -- **Impression plan d'échantillonnage** : Permet l'impression du visuel du plan +- 1.1- **Consulter le plan d'échantillonnage** : Permet de consulter et + potentiellement filtrer le plan d'échantillonnage. L'observateur ne verra que + les lignes concernant sa société. + (Depuis 0.1) + +- 1.2- **Export plan d'échantillonnage** : Permet l'export CSV du visuel du plan d'échantillonnage (données visibles potentiellement filtrées). Dans le cas de - l'observateur, uniquement les lignes liées à la société seront visibles - et imprimables. (Non géré en version 0.2.0). + l'observateur, uniquement les lignes liées à la société seront visibles. + (Depuis 1.0) -- **Import/Exporter contacts** ( administrateur__ / utilisateur__ ) : Permet l'export et l'import du visuel des - contacts (données visibles potentiellement filtrées). Les validations ne - sont pas importables. +- 2.1- **Consulter les infos du navire** ( administrateur__ ) : + Consultation des informations privées d'un navire. Les observateurs ne + pourront consulter que les informations renseignées par leur société tandis + qu'un administrateur pourra consulter les informations société par société. + (Depuis 0.1) - __ admin/contacts.html - __ user/contacts.html + __ admin/boats.html#Consulter_les_informations_dun_navire -- **Valider contact** ( administrateur__ / utilisateur__ ) : L'observateur comme l'administrateur peuvent valider un - contact. Une différence est faites entre les deux niveaux de validations ( - l'administrateur doit attendre une validation de l'observateur afin de valider - à son tour le contact). +- 2.2- **Export de la liste des navires** : Permet l'export CSV du visuel des + navires (données visibles potentiellement filtrées). Pour les observateurs, + les informations privées de la société (contact téléphone, email, ...) sont + exportables avec les propriétés du navire. + (Depuis 1.0) - __ admin/contacts.html - __ user/contacts.html +- 3.1- **Consulter les contacts** : Permet de visualiser et potentiellement + filtrer les contacts. L'observateur ne verra que les contacts concernant sa + société. + (Depuis 1.0) -- **Voir syntheses et indicateurs** ( administrateur__ / utilisateur__ ) : Graphiques et indicateurs permettant d' - aggréger les données existantes dans l'application. +- 4- **Voir syntheses et indicateurs** ( administrateur__ / utilisateur__ ) : + Graphiques et indicateurs permettant d'aggréger les données existantes dans + l'application. + (Depuis 0.1) __ admin/syntheses.html __ user/syntheses.html -- **Rendre éligible un navire pour une ligne du plan** ( administrateur__ / utilisateur__ ) : Permet d'associer un - navire à une ligne du plan. L'administrateur le fera à partir du plan d' - échantillonnage tandis que l'observateur pourra le faire à partir des - informations privées (liées à la société) du navire. +Observateur/Administrateur +-------------------------- +- 2.3- **Rendre éligible un navire pour une ligne du plan** + ( administrateur__ / utilisateur__ ) : Permet d'associer un navire à une ligne + du plan. L'administrateur le fera à partir du plan d'échantillonnage tandis + que l'observateur pourra le faire à partir des informations privées (liées + à la société) du navire. + (Depuis 0.1) + __ admin/echantillonage.html __ user/boats.html +Observateur +----------- + +- 2.4- `Editer les informations du navire privees a la societe`_ : Modification + des informations d'un navire pour la société de l'observateur. + (Depuis 0.1) + +- 3.2- `Gerer contact`_ : Création, modification et suppression des contacts de + la société de l'observateur. Seuls les contacts non validés par un + administrateur peuvent être modifiés ou supprimés. + (Depuis 0.1) + +.. _Gerer contact: user/contacts.html + +.. _Editer les informations du navire privees a la societe: user/boats.html + +Coordinateur/Administrateur +--------------------------- + +- 3.3- **Import/Exporter contacts** ( administrateur__ / utilisateur__ ) : Permet + l'export et l'import du visuel des contacts (données visibles potentiellement + filtrées). Les validations ne sont pas importables. + (Depuis 0.1 -> modification droit d'accès 1.1) + + __ admin/contacts.html + __ user/contacts.html + +- 3.4- **Valider contact** ( administrateur__ / utilisateur__ ) : Le + coordinateur comme l'administrateur peuvent valider un contact. Une différence + est faites entre les deux niveaux de validations (l'administrateur doit + attendre une validation du coordinateur afin de valider à son tour le + contact). + (Depuis 0.1 -> modification droit d'accès 1.1) + + __ admin/contacts.html + __ user/contacts.html + +Coordinateur +------------ + +- 1.6- **Ajouter un commentaire sur une ligne du plan** : Le coordinateur + peut ajout un commentaire sur l'historique d'une ligne du plan. Ainsi il + peut identifier par ce biais un potentiel problème au niveau de la ligne. + (Depuis 1.1) + Administrateur -------------- -- `Importer referentiel zones de peche`_ : Permet l'import du fichier concernant - les zones de pêche référencées sur les lignes du plan. +- 0- `Gerer news`_ : Création, modification et suppression des articles + d'annonces sur la page d'accueil de l'application. + (Depuis 0.1) -- `Importer plan d echantillonnage`_ : Permet l'import de plans +- 1.3- `Importer plan d echantillonnage`_ : Permet l'import de plans d'échantillonnage à l'instant T. Aucune modification d'une ligne existante dans l'application n'est permise à partir de cet import. + (Depuis 0.1) -- `Gerer utilisateurs`_ : Création, modification et suppression des sociétés et - utilisateurs (observateur ou administrateur). +- 1.4- `Importer referentiel zones de peche`_ : Permet l'import du fichier + concernant les zones de pêche référencées sur les lignes du plan. + (Depuis 0.1) -- `Importer navires`_ : Import du référentiel navire. +- 1.5- `Gerer ligne du plan d echantillonnage`_ : Création, modification et + suppression des lignes du plan d'échantillonnage (y compris les métiers liés). + (Depuis 0.1) -- `Importer calendriers d activite des navires`_ : Import des calendriers d' +- 2.5- `Importer navires`_ : Import du référentiel navire. + (Depuis 0.1) + +- 2.6- `Importer calendriers d activite des navires`_ : Import des calendriers d' activité des navires. + (Depuis 0.1) -- `Gerer ligne du plan d echantillonnage`_ : Création, modification et - suppression des lignes du plan d'échantillonnage (y compris les métiers liés). +- 5- `Gerer utilisateurs`_ : Création, modification et suppression des sociétés + et utilisateurs (observateur, coordinateur ou administrateur). + (Depuis 0.1) -- `Gerer news`_ : Création, modification et suppression des articles d'annonces - sur la page d'accueil de l'application. - -- `Consulter les infos du navire pour une societe`_ : Consultation des - informations privées d'un navire pour une société. - .. _Importer referentiel zones de peche: admin/firstlaunch.html#Importer_les_zones_de_pche .. _Importer plan d echantillonnage: admin/echantillonage.html @@ -105,25 +178,4 @@ .. _Gerer ligne du plan d echantillonnage: admin/echantillonage.html#Grer_le_plan_dchantillonage -.. _Gerer news: admin/news.html - -.. _Consulter les infos du navire pour une societe: admin/boats.html#Consulter_les_informations_dun_navire - -Observateur ------------ - -- `Gerer contact`_ : Création, modification et suppression des contacts de la - société de l'observateur. Seuls les contacts non validés par un administrateur - peuvent être modifiés ou supprimés. - -- `Editer les informations du navire privees a la societe`_ : Modification des - informations d'un navire pour la société de l'observateur. - -- **Impression de la liste des navires** : Permet l'impression du visuel des - navires (données visibles potentiellement filtrées). Les informations - privées de la société (contact téléphone, email, ...) sont imprimables - avec les propriétés du navire. (Non géré en version 0.2.0). - -.. _Gerer contact: user/contacts.html - -.. _Editer les informations du navire privees a la societe: user/boats.html \ No newline at end of file +.. _Gerer news: admin/news.html \ No newline at end of file Modified: trunk/src/site/rst/user/contacts.rst =================================================================== --- trunk/src/site/rst/user/contacts.rst 2010-04-03 10:33:53 UTC (rev 414) +++ trunk/src/site/rst/user/contacts.rst 2010-04-05 18:14:16 UTC (rev 415) @@ -27,8 +27,8 @@ Il est possible de supprimer un contact non validé en cliquant sur l'icone 'poubelle' correspondant. -Valider un embarquement ------------------------ +Valider un embarquement (coordinateur) +-------------------------------------- Quand un contact est passé au statut 'Embarquement réalisé', il est possible de le valider afin que l'embarquement soit comptabilisé comme réalisé. Pour ce Modified: trunk/wao-business/src/main/xmi/wao.zargo =================================================================== (Binary files differ)