Developpement

Version 214 (Etienne Pallier, 04/26/2017 04:25 pm)

1 150 Etienne Pallier
h1. Labinvent 2 (cakephp3) - Développement
2 1 Etienne Pallier
3 148 Etienne Pallier
Cette page décrit le processus de développement du logiciel, ainsi que les outils utilisés.
4 148 Etienne Pallier
5 148 Etienne Pallier
[ [[Labinvent_nouvelle_version|Retour au sommmaire]] ]
6 148 Etienne Pallier
7 1 Etienne Pallier
8 1 Etienne Pallier
{{toc}}
9 1 Etienne Pallier
10 1 Etienne Pallier
---
11 1 Etienne Pallier
12 4 Etienne Pallier
h2. LIENS UTILES
13 94 Etienne Pallier
14 97 Etienne Pallier
* HOWTO Format Redmine Wiki : http://www.redmine.org/projects/redmine/wiki/FrRedmineWikiFormatting
15 94 Etienne Pallier
16 96 Etienne Pallier
* [[Installation|Page wiki pour l'installation]]
17 1 Etienne Pallier
18 162 Etienne Pallier
* Migrations plugin: http://book.cakephp.org/3.0/fr/migrations.html
19 162 Etienne Pallier
20 93 Etienne Pallier
* Version majeure en cours (2.1): https://projects.irap.omp.eu/versions/101
21 93 Etienne Pallier
22 92 Etienne Pallier
* Liste complète des évolutions: https://gitlab.irap.omp.eu/epallier/labinvent/commits/master
23 1 Etienne Pallier
24 92 Etienne Pallier
* Browse files (gitlab): https://gitlab.irap.omp.eu/epallier/labinvent/tree/master
25 1 Etienne Pallier
26 92 Etienne Pallier
* Inventirap 1.3 (prod): https://inventirap.irap.omp.eu
27 1 Etienne Pallier
28 92 Etienne Pallier
* Inventirap 1.3 (test): https://inventirap-test.irap.omp.eu/
29 92 Etienne Pallier
30 93 Etienne Pallier
* CakePhp:
31 92 Etienne Pallier
32 147 Etienne Pallier
 * ROADMAP: https://github.com/cakephp/cakephp/wiki
33 93 Etienne Pallier
 * Forum cakephp: http://discourse.cakephp.org
34 93 Etienne Pallier
 * Quickstart tutorial: http://book.cakephp.org/3.0/en/quickstart.html
35 93 Etienne Pallier
 * Bookmarker tutorial: https://github.com/cakephp/bookmarker-tutorial
36 93 Etienne Pallier
 * Cakephp CRUD: https://github.com/FriendsOfCake/crud
37 1 Etienne Pallier
38 1 Etienne Pallier
---
39 1 Etienne Pallier
40 1 Etienne Pallier
h2. TODOLIST
41 1 Etienne Pallier
42 1 Etienne Pallier
43 205 Etienne Pallier
44 198 Etienne Pallier
*Bugfixes*
45 198 Etienne Pallier
46 198 Etienne Pallier
* cf fiche buguée avec numéro inventaire IRAP-2070-0001, et date achat 1/1/70, ce qui ne devrait normalement pas être possible !! : https://inventirap.irap.omp.eu/materiels/view/11790
47 198 Etienne Pallier
48 193 Etienne Pallier
*Besoins généraux*
49 193 Etienne Pallier
50 214 Etienne Pallier
* Ajouter un champ "Durée de garantie" sur la fiche matériel, et mettre le nom du pc en rouge quand il n'est plus sous garantie (sauf si la durée de garantie n'est pas précisée)
51 214 Etienne Pallier
52 205 Etienne Pallier
* Affiner la fonctionnalité d’envoi automatique des emails :
53 205 Etienne Pallier
 
54 205 Etienne Pallier
 * 1) (NEW) l'envoi d'emails doit être désactivé par défaut lors de l'installation
55 205 Etienne Pallier
 * 2) on doit pouvoir activer ou désactiver cette fonctionnalité (c'est déjà le cas)
56 205 Etienne Pallier
 * quand on active cette option:
57 205 Etienne Pallier
58 207 Etienne Pallier
  * on doit pouvoir entrer les paramètres nécessaires pour l'ENVOI (smtp) des mails (comme pour le LDAP)
59 207 Etienne Pallier
  * on doit pouvoir rentrer une liste d'emails qui RECEVRONT ces mails
60 205 Etienne Pallier
  * (NEW) on doit avoir une liste d'actions (qui déclenchent l'envoi d'un email) qui s'affiche et que l'on peut cocher ou pas (ex: "création d'un nouveau matériel", "modification d'un matériel", "création d'un suivi", ...)
61 213 Thibaud Ajas
* -Pouvoir changer le nombre de matériels affichés par page (par défaut, c'est 20 et c'est parfois insuffisant...-
62 195 Etienne Pallier
* Pour la partie administrative, la validation doit permettre l'édition de la fiche officielle d'inventaire transmise à la tutelle. Permettre l'édition de cette fiche (demande urgente).
63 193 Etienne Pallier
* Désactiver (ou simplement "limiter") l'envoi de mail aux responsables thématiques ou métiers :
64 196 Etienne Pallier
(Déjà 2 resp. thématiques ont manifesté leur mécontentement : Olivier Forni et Marie Calvet => solution temporaire : on leur a enlevé temporairement la responsabilité de "resp. thématique" ; il faudra la rétablir quand le problème sera réglé)
65 194 Etienne Pallier
* Elodie B. a des soucis avec le script d'install (notamment pour créer la BD mysql, et aussi pour le fonctionnement en local SANS LDAP) : voir de plus près quel est le problème
66 193 Etienne Pallier
67 190 Etienne Pallier
*Demandes des utilisateurs (transmises par D. Rambaud le 19/12/16) :*
68 190 Etienne Pallier
69 190 Etienne Pallier
* Ca serait bien que le proprio de la fiche reçoive un email quand l'étiquette est imprimée, ou encore quand la fiche est validée => dans le but qu'il vérifie et complète cette fiche
70 197 Etienne Pallier
* Ca serait bien aussi que le proprio puisse modifier sa fiche, une fois créée, mais aussi même après qu'elle ait été validée. Attention, la modification post-validation ne peut porter que sur les renseignements techniques complémentaires.
71 190 Etienne Pallier
72 190 Etienne Pallier
73 190 Etienne Pallier
*Suite à réunion du 27/10/16 avec le LATMOS, constat des modifs nécessaires:*
74 185 Etienne Pallier
75 189 Etienne Pallier
* L'étiqueteuse semble ne plus fonctionner alors qu'elle fonctionnait avant...
76 188 Etienne Pallier
* Ajouter un champ "Titre du mail" dans la liste des emails envoyés, pour qu'on puisse configurer le titre du mail envoyé (ex: [LABINVENT])
77 187 Etienne Pallier
* Check Date achat <= Date Livraison !!!
78 185 Etienne Pallier
* Ajouter un statut : ajouter un statut « désinventorié «  ou «amorti ? » (à réfléchir)
79 185 Etienne Pallier
* Ajouter colonne statut « hors service » dans la vue "liste des matériels"
80 185 Etienne Pallier
* N° série : à remettre dans la section informations (pour que tout le monde le voie)
81 185 Etienne Pallier
* Empêcher duplication d'une fiche matériel si même numéro de série
82 185 Etienne Pallier
* Importation depuis Excel
83 204 Etienne Pallier
* Le champ "Local de stockage" a-t-il disparu ??? => à remettre
84 204 Etienne Pallier
* Site : champ optionnel
85 204 Etienne Pallier
* Champs optionnels: de manière générale, il faudrait pouvoir configurer quelques champs comme optionnels (certains champs doivent bien sûr absolument rester obligatoires)
86 204 Etienne Pallier
* (temporairement, on peut se contenter de CACHER certains champs, comme par exemple le champ "Site")
87 204 Etienne Pallier
* Suivis par fournisseur: ajouter la colonne "fournisseur" dans Suivi pour pouvoir trier la vue par fournisseur
88 204 Etienne Pallier
* Suivis relance : trouver un moyen de relancer automatiquement les suivis périodiques (ou bien avec une date programmée)
89 204 Etienne Pallier
* Emprunt dates: afficher les dates d'emprunt et de retour (date emprunt doit être obligatoire)
90 185 Etienne Pallier
* Matériel gestionnaire: obliger la personne qui crée une fiche matériel à choisir un gestionnaire (via une liste) (et avertir automatiquement ce gestionnaire par mail)
91 185 Etienne Pallier
* supprimer profil AdminPlus, inutile
92 185 Etienne Pallier
93 185 Etienne Pallier
94 185 Etienne Pallier
95 192 Etienne Pallier
*Suite à l'installation à l'IRAP du 21/01/2016*:
96 1 Etienne Pallier
97 121 Alexandre Cases
- Si elle existe, supprimer table "fichiers"
98 120 Alexandre Cases
- Sauvegarder les utilisateurs
99 120 Alexandre Cases
- Transformer table "utilisateurs" en "users"
100 120 Alexandre Cases
- Ajout table "configuration"
101 120 Alexandre Cases
- Ajout clé étrangère emprunts (site_id)/suivis (type_suivi_id)
102 120 Alexandre Cases
- Transformation des données correspondantes
103 1 Etienne Pallier
- Suppression ancien champ emprunt (e_lieu_stockage), suivis (type_intervention)
104 120 Alexandre Cases
105 120 Alexandre Cases
106 192 Etienne Pallier
*Suite à l'installation à l'IAS du 09/03/2015*
107 120 Alexandre Cases
108 120 Alexandre Cases
- Ajout table "organismes", "type_suivis", "sites"
109 120 Alexandre Cases
- Ajout clé correspondante dans table "matériels"
110 120 Alexandre Cases
- Transformation des données correspondantes
111 120 Alexandre Cases
- Suppression anciens champs
112 120 Alexandre Cases
- Ajout table "documents"
113 120 Alexandre Cases
- Sauvegarder les utilisateurs
114 120 Alexandre Cases
- Transformer table "utilisateurs" en "users"
115 120 Alexandre Cases
- Ajout table "configuration"
116 120 Alexandre Cases
- Ajout clé étrangère emprunts (site_id)/suivis (type_suivi_id)
117 120 Alexandre Cases
- Transformation des données correspondantes
118 120 Alexandre Cases
- Suppression ancien champ emprunt (e_lieu_stockage), suivis (type_intervention)
119 1 Etienne Pallier
---
120 1 Etienne Pallier
121 101 Etienne Pallier
h2. Schéma de la base de données (v2.0.0)
122 9 Etienne Pallier
123 9 Etienne Pallier
124 180 Etienne Pallier
{{thumbnail(BDD_IRAP.png, size=2000, title=Pyros data model)}}
125 9 Etienne Pallier
126 174 Etienne Pallier
127 174 Etienne Pallier
128 174 Etienne Pallier
129 174 Etienne Pallier
130 174 Etienne Pallier
131 174 Etienne Pallier
---
132 209 Thibaud Ajas
133 210 Thibaud Ajas
h2. Utilisation du serveur web de dev de CakePHP (à la place de apache)
134 1 Etienne Pallier
135 210 Thibaud Ajas
/!\ Votre serveur MySQL doit être lancé !!!
136 210 Thibaud Ajas
137 208 Thibaud Ajas
* Se placer à la racine du projet.
138 208 Thibaud Ajas
139 208 Thibaud Ajas
* Lancer la commande suivante :
140 208 Thibaud Ajas
141 1 Etienne Pallier
 <pre> bin/cake server </pre>
142 208 Thibaud Ajas
143 210 Thibaud Ajas
* Rendez-vous sur http://localhost:8765/
144 208 Thibaud Ajas
145 208 Thibaud Ajas
---
146 174 Etienne Pallier
147 174 Etienne Pallier
h2. Cycle de vie du Matériel
148 174 Etienne Pallier
149 176 Etienne Pallier
150 182 Etienne Pallier
---
151 182 Etienne Pallier
152 176 Etienne Pallier
h3. Diagramme d'états-transitions
153 176 Etienne Pallier
154 179 Etienne Pallier
{{thumbnail(equipment_status_state_diagram.png, size=2000, title=Cycle de vie du matériel)}}
155 176 Etienne Pallier
156 182 Etienne Pallier
157 182 Etienne Pallier
---
158 176 Etienne Pallier
159 176 Etienne Pallier
h3. Diagramme de séquences
160 176 Etienne Pallier
161 178 Etienne Pallier
{{thumbnail(equipment_interactions_sequence_diagram.png, size=1500, title=Cycle de vie du matériel)}}
162 174 Etienne Pallier
163 174 Etienne Pallier
164 174 Etienne Pallier
165 9 Etienne Pallier
---
166 9 Etienne Pallier
167 181 Etienne Pallier
h2. ACL - Gestion des droits selon le profil
168 181 Etienne Pallier
169 184 Etienne Pallier
{{thumbnail(ACLs Droits selon les Roles.pdf, size=1500, title=Cycle de vie du matériel)}}
170 183 Etienne Pallier
171 183 Etienne Pallier
172 181 Etienne Pallier
173 181 Etienne Pallier
---
174 181 Etienne Pallier
175 12 Etienne Pallier
h2. ROADMAP - Plan de développement
176 12 Etienne Pallier
177 76 Etienne Pallier
Le stage se déroule de mi-avril à fin juin, soit sur 12 semaines (S1 à S12), ou 24 demi-semaines.
178 15 Etienne Pallier
_*(Ne pas oublier de rédiger le rapport de stage au fur et à mesure)*_
179 1 Etienne Pallier
180 12 Etienne Pallier
181 17 Etienne Pallier
Voir le détail de la roadmap: https://projects.irap.omp.eu/projects/inventirap/roadmap
182 17 Etienne Pallier
183 66 Etienne Pallier
|                    |   |_.Prévu |_.Réalisé |
184 155 Alexandre Cases
|/2=.S01 (11/4-15/4) |.1|/5=<."version 2.00 - Cakephp3 + Php5 (version de base from bake)":https://projects.irap.omp.eu/versions/105|/6=<.version 2.00|
185 84 Etienne Pallier
                     |.2|
186 86 Etienne Pallier
|/2=.S02 (18/4-22/4) |.1|
187 84 Etienne Pallier
                     |.2|
188 86 Etienne Pallier
|/2=.S03 (25/4-29/4) |.1|
189 154 Alexandre Cases
                     |.2|/4=<."version 2.01 - Implémentation complète du CRUD":https://projects.irap.omp.eu/versions/101|
190 154 Alexandre Cases
|/2=.S04 (02/5-06/5) |.1|/4=<.version 2.01|
191 107 Alexandre Cases
                     |.2|
192 105 Etienne Pallier
|/2=.S05 (09/5-13/5) |.1|
193 154 Alexandre Cases
                     |.2|/3=<."version 2.02 - Implémentation de toutes les autres actions":https://projects.irap.omp.eu/versions/106|
194 154 Alexandre Cases
|/2=.S06 (16/5-20/5) |.1|/2=<.version 2.02|
195 138 Etienne Pallier
                     |.2|
196 154 Alexandre Cases
|/2=.S07 (23/5-27/5) |.1|/2=<."version 2.03 - Implémentation du LDAP (vrai et fake)":https://projects.irap.omp.eu/versions/108|/2=<.version 2.03|
197 138 Etienne Pallier
                     |.2|
198 160 Alexandre Cases
|/2=.S08 (30/5-03/6) |.1|/2=<."version 2.04 - Implémentation des ACL (droits)":https://projects.irap.omp.eu/versions/107|_/10=<.version 2.04 (en cours)|
199 90 Etienne Pallier
                     |.2|
200 161 Etienne Pallier
|/2=.S09 (06/6-10/6) |.1|/2=<."version 2.05 - Documents attaches aux materiels (+ photos)":https://projects.irap.omp.eu/versions/99|
201 90 Etienne Pallier
                     |.2|
202 161 Etienne Pallier
|_/2=.S10 (13/6-17/6) |.1|/2=<."version 2.06 - Evolutions prévues dans 1.3 et 1.4":https://projects.irap.omp.eu/versions/110|
203 90 Etienne Pallier
                     |.2|
204 154 Alexandre Cases
|/2=.S11 (20/6-24/6) |.1|/1=<."version 2.07 - Corrections/Evolutions demandées par l'IAS":https://projects.irap.omp.eu/versions/124|
205 154 Alexandre Cases
                     |.2|/2=<."version 2.08 - Cakephp3 + Php7 (compatible Php5)":https://projects.irap.omp.eu/versions/98|
206 154 Alexandre Cases
|/2=.S12 (27/6-30/6) |.1|
207 154 Alexandre Cases
                     |.2|/1=<."version 2.10 - Autres ajouts (+ fin rédaction rapport de stage)":https://projects.irap.omp.eu/versions/100|
208 99 Etienne Pallier
209 1 Etienne Pallier
---
210 1 Etienne Pallier
211 151 Etienne Pallier
h2. PROCEDURE à suivre pour un COMMIT
212 102 Etienne Pallier
213 100 Etienne Pallier
Voici les différentes étapes à respecter au moment de chaque commit:
214 98 Etienne Pallier
215 100 Etienne Pallier
*1) S'assurer que tous les tests passent toujours...*
216 98 Etienne Pallier
217 100 Etienne Pallier
*2) Mettre à jour le fichier README (ceci est un exemple, un template)*
218 98 Etienne Pallier
219 98 Etienne Pallier
Date: 11/05/2016
220 98 Etienne Pallier
Version: 2.1.9
221 98 Etienne Pallier
Mise à jour doc install
222 98 Etienne Pallier
(Attention, changement structure BDD)
223 98 Etienne Pallier
Demande (terminée): https://projects.irap.omp.eu/issues/3542
224 98 Etienne Pallier
Version majeure en cours (2.1): https://projects.irap.omp.eu/versions/101
225 98 Etienne Pallier
226 98 Etienne Pallier
Remarques:
227 98 Etienne Pallier
=> Version: 2.1.9 = 9ème commit sur la version 2.1
228 98 Etienne Pallier
=> préciser "(bugfix)" si c'est le cas
229 1 Etienne Pallier
=> ajouter "(Attention, changement structure BDD)" s'il y a eu une modif de la BDD
230 1 Etienne Pallier
=> "Demande (terminée)" ou "Demande (en cours)", ou pas de demande du tout (exceptionnellement)
231 1 Etienne Pallier
=> ces infos permettront de savoir quelle version (et date) exacte du projet on a actuellement sur son disque
232 1 Etienne Pallier
233 1 Etienne Pallier
234 151 Etienne Pallier
*[3) S'il y a eu un changement de structure de la BD]*
235 1 Etienne Pallier
236 151 Etienne Pallier
* Mettre à jour le schéma de la BD (avec Mysql Workbench) dans le projet et sur le wiki (page "Documentation technique")
237 151 Etienne Pallier
238 151 Etienne Pallier
239 151 Etienne Pallier
*[4) Si c'est la fin d'une version majeure (2.0, 2.1, 2.2, ...)]*
240 151 Etienne Pallier
241 100 Etienne Pallier
* On doit normalement avoir écrit quelques nouveaux tests pour cette version !!!
242 100 Etienne Pallier
* Ajouter cette version en tête de la section "MAIN CHANGES (MILESTONES)" dans le fichier README
243 100 Etienne Pallier
* Mettre à jour la doc install/INSTALLATION à partir du wiki (si nécessaire)
244 1 Etienne Pallier
* Tester une installation du logiciel from scratch 
245 100 Etienne Pallier
246 100 Etienne Pallier
247 151 Etienne Pallier
*5) pull*
248 1 Etienne Pallier
249 1 Etienne Pallier
(au cas où quelqu'un d'autre aurait fait un push)
250 98 Etienne Pallier
251 98 Etienne Pallier
252 151 Etienne Pallier
*6) commit*
253 1 Etienne Pallier
254 151 Etienne Pallier
Dans le message de commit, faire un simple copier/coller des infos du fichier README (sauf date):
255 1 Etienne Pallier
256 1 Etienne Pallier
Version: 2.1.9
257 98 Etienne Pallier
Mise à jour doc install (bugfix)
258 98 Etienne Pallier
Demande (terminée): https://projects.irap.omp.eu/issues/3542
259 98 Etienne Pallier
Version majeure en cours (2.1): https://projects.irap.omp.eu/versions/101
260 98 Etienne Pallier
261 98 Etienne Pallier
262 151 Etienne Pallier
*[7) push]*
263 100 Etienne Pallier
264 100 Etienne Pallier
(seulement si le commit est important/urgent, ou suite à un ensemble de commits sur un même thème)
265 98 Etienne Pallier
266 104 Etienne Pallier
267 104 Etienne Pallier
---
268 104 Etienne Pallier
269 7 Etienne Pallier
h2. Installation from scratch (Sous UBuntu)
270 1 Etienne Pallier
271 1 Etienne Pallier
h3. Création projet avec Composer
272 1 Etienne Pallier
273 1 Etienne Pallier
* Télécharger composer.phar : 
274 1 Etienne Pallier
"curl -s https://getcomposer.org/installer | php"
275 1 Etienne Pallier
276 1 Etienne Pallier
* Avec le Composer créer un nouveau projet : 
277 1 Etienne Pallier
"php composer.phar create-project --prefer-dist cakephp/app labinvent_2.0"
278 1 Etienne Pallier
279 1 Etienne Pallier
> Voir structure projet : http://book.cakephp.org/3.0/fr/intro/cakephp-folder-structure.html
280 1 Etienne Pallier
281 1 Etienne Pallier
* On rempli la base de données avec le fichier sql
282 1 Etienne Pallier
283 203 Thibaud Ajas
* On indique la BD utiliser à CakePHP dans le fichier config/app.php, propriété "Datasources".
284 1 Etienne Pallier
285 1 Etienne Pallier
* On se place à la racine du projet
286 1 Etienne Pallier
287 1 Etienne Pallier
* On génère le code Scaffold : 
288 1 Etienne Pallier
"bin/cake bake all nom_table" --> ça génére les modeles, les vues, et les controlleurs.
289 1 Etienne Pallier
290 1 Etienne Pallier
> Commande (en une fois) :
291 1 Etienne Pallier
> > bin/cake bake all categories && bin/cake bake all emprunts && bin/cake bake all groupes_metiers && bin/cake bake all groupes_thematiques && bin/cake bake all organismes && bin/cake bake all sites && bin/cake bake all sous_categories && bin/cake bake all suivis && bin/cake bake all sur_categories && bin/cake bake all type_suivis && bin/cake bake all documents && bin/cake bake all users && bin/cake bake all materiels
292 1 Etienne Pallier
293 1 Etienne Pallier
h3. Modification de la base de données 
294 1 Etienne Pallier
> Une version du sql corrigée au fur et à mesure est disponible dans le git :
295 22 Alexandre Cases
296 22 Alexandre Cases
> > Dans database/, le fichier labinvent_2.1_09-05-16 correspond à la création de la base.
297 1 Etienne Pallier
> > Dans database/, le fichier labinvent_2.0_insert-irap_19-04-16 correspond aux insertions propre à l'IRAP, fichier insertion uniquement pour les dévellopeurs.
298 1 Etienne Pallier
299 1 Etienne Pallier
* Création table "config"
300 22 Alexandre Cases
301 22 Alexandre Cases
> > Mise à jour dans le fichier de création de base
302 22 Alexandre Cases
> > Mise à jour à part : db-update-2016-05-09.sql
303 1 Etienne Pallier
304 153 Etienne Pallier
h3. Autres remarques lors du développement
305 1 Etienne Pallier
306 21 Alexandre Cases
* Suivre les conventions de CakePHP est le top pour ne pas avoir à refaire de la config (bidouiller), il faudrait vérifier réguliérement que c'est le cas (outil "cakephp-codesniffer")...
307 1 Etienne Pallier
> Voir : http://book.cakephp.org/3.0/fr/contributing/cakephp-coding-conventions.html
308 1 Etienne Pallier
309 1 Etienne Pallier
* La solution pour insérer un utilisateur directement dans la base et pouvoir se connecter avec dans l'application est de l'insérer avec un mot de passe haché de la méme façon.
310 1 Etienne Pallier
Le mot de passe "login" = "$2y$10$LZzpws3oDidBcqO/Fy1RTedLLk3ENTmplny5J7bZ6R1PqFoGOw3Ma".
311 131 Alexandre Cases
Le mot de passe vide "" = "$2y$10$nBQMNstgN.sgad1ZANznY.pbJI.ZG/.Q5qX4gC8SXCFQnDIZC8rcW".
312 1 Etienne Pallier
313 1 Etienne Pallier
* Vérifier que la migration vers la prochaine version de cakephp3 (3.3 ?) sera facile... (décrire la procédure à suivre)
314 1 Etienne Pallier
--> Une migration vers une version mineur 3.2 => 3.3, se réalise avec la mise à jour de CakePHP à l'aide de Composer
315 21 Alexandre Cases
--> Puis il faut regarder les changements dans la page migration correspondant à la version voulu et adapter les changements au code.
316 1 Etienne Pallier
> Voir : http://book.cakephp.org/3.0/fr/appendices/3-2-migration-guide.html
317 21 Alexandre Cases
318 21 Alexandre Cases
* Outil (plugin) "DebugKit" de CakePHP3 : 
319 21 Alexandre Cases
--> DebugKit est un plugin qui fournit une toolbar pour aider à debugger les applications CakePHP plus facilement.
320 21 Alexandre Cases
--> Par défaut il est installé avec le squelette de l'application, pour l'activer, il faut se placer à la racine.
321 21 Alexandre Cases
--> Puis il faut éxécuter la ligne suivante : bin/cake plugin load DebugKit .
322 21 Alexandre Cases
--> La commande va aller modifier le fichier config bootstrap.php.
323 21 Alexandre Cases
--> Le fichier bootstrap.php actuel de l'application sur le git, est configuré pour charger le plugin lorsque l'application est en mode debug de CakePHP, je ne pense pas que exécuter la commande précédente soit utile vu la configuration de ce fichier dans notre application.
324 21 Alexandre Cases
--> Le plugin nécessite l'extension php5-sqlite par défaut (il supporte l'équivalent avec de la config).
325 20 Alexandre Cases
> Voir : http://book.cakephp.org/3.0/fr/debug-kit.html
326 24 Alexandre Cases
327 25 Alexandre Cases
328 91 Alexandre Cases
* Mode debug personnaliser : 
329 130 Alexandre Cases
> Faire $this->myDebug($var) dans un controlleur pour afficher le contenu de la variable si mode debug personnalisé actif, à condition que le mode debug soit activé.
330 91 Alexandre Cases
331 91 Alexandre Cases
> Voir : http://book.cakephp.org/3.0/fr/development/testing.html
332 31 Alexandre Cases
333 106 Alexandre Cases
* Pour charger une librairie (ex : phpqrcode, ...)
334 106 Alexandre Cases
> Voir : http://book.cakephp.org/3.0/fr/core-libraries/app.html#charger-les-fichiers-de-vendor
335 106 Alexandre Cases
336 1 Etienne Pallier
* Pour créer les fichiers pdf d'entrée et de sortie, on utilise fpdf 1.8.1, on pourrait utiliser le plugin développer pour CakePHP3.
337 129 Alexandre Cases
> Voir : https://github.com/FriendsOfCake/CakePdf
338 122 Alexandre Cases
339 129 Alexandre Cases
* Pour le JavaScript, le JS Helper a été retiré 
340 128 Alexandre Cases
> Voir : http://book.cakephp.org/3.0/fr/appendices/3-0-migration-guide.html#jshelper
341 128 Alexandre Cases
342 157 Alexandre Cases
* Pour pouvoir éxécuter les tests depuis eclipse : 
343 157 Alexandre Cases
> Voir : http://blog.loftdigital.com/running-phpunit-tests-in-eclipse-pdt
344 157 Alexandre Cases
345 125 Alexandre Cases
* Avant de déployer l'application sur le serveur de production, optimiser les performances
346 125 Alexandre Cases
> Voir : http://book.cakephp.org/3.0/fr/deployment.html#ameliorer-les-performances-de-votre-application
347 156 Etienne Pallier
348 156 Etienne Pallier
h2. %{margin-left:0px; font-weight:bold; font-size:25px;  display:block; color:red;}Installation sur Mac (retour des pb)%
349 156 Etienne Pallier
350 156 Etienne Pallier
1) install.sh
351 156 Etienne Pallier
=> 
352 156 Etienne Pallier
chmod: Unable to change file mode on ./webroot/img//gqbee0pkerrl8h2rbekaa3t8j1.png: Operation not permitted
353 156 Etienne Pallier
chmod: Unable to change file mode on ./tmp//cache/models/myapp_cake_model_default_configurations: Operation not permitted
354 156 Etienne Pallier
chmod: Unable to change file mode on ./tmp//cache/models/myapp_cake_model_default_documents: Operation not permitted
355 156 Etienne Pallier
chmod: Unable to change file mode on ./tmp//cache/persistent/myapp_cake_core_translations_cake_fr__f_r: Operation not permitted
356 156 Etienne Pallier
chmod: Unable to change file mode on ./tmp//cache/persistent/myapp_cake_core_translations_debug_kit_fr__f_r: Operation not permitted
357 156 Etienne Pallier
chmod: Unable to change file mode on ./tmp//cache/persistent/myapp_cake_core_translations_default_fr__f_r: Operation not permitted
358 156 Etienne Pallier
359 156 Etienne Pallier
360 156 Etienne Pallier
=> sudo chmod -R 777 ../webroot/img
361 156 Etienne Pallier
=> sudo chmod -R 777 ../tmp/
362 156 Etienne Pallier
(=> sudo chmod -R 777 ../vendor)
363 156 Etienne Pallier
364 156 Etienne Pallier
365 156 Etienne Pallier
2) connexion au site
366 156 Etienne Pallier
=> mauvais affichage pourri
367 156 Etienne Pallier
=> il faut configurer la BD dans app.php
368 156 Etienne Pallier
            'username' => 'labinvent2user',
369 156 Etienne Pallier
            'password' => 'labinvent2user',
370 156 Etienne Pallier
            'database' => 'labinvent2',
371 156 Etienne Pallier
372 156 Etienne Pallier
3) login
373 156 Etienne Pallier
=> epallier/login
374 156 Etienne Pallier
375 156 Etienne Pallier
376 163 Alexandre Cases
---
377 156 Etienne Pallier
378 163 Alexandre Cases
h2. Pour mettre à jour CakePHP
379 156 Etienne Pallier
380 165 Etienne Pallier
* Utiliser le composer : "php composer.phar update" à la racine de l'application
381 1 Etienne Pallier
> Voir : http://book.cakephp.org/3.0/fr/installation.html#rester-a-jour-avec-les-derniers-changements-de-cakephp
382 164 Alexandre Cases
383 164 Alexandre Cases
* Puis il faut modifier le fichier : ./vendor/cakephp/cakephp/src/View/Helper/PaginatorHelper.php
384 164 Alexandre Cases
  Ce fichier contient le template de l'helper "paginator" et il faut modifier le tableau "$_defaultConfig" et remplacer les balise "li" par des balises "span".
385 164 Alexandre Cases
  Enfin dans le même tableau, il faut remplacer la ligne suivante : 
386 164 Alexandre Cases
> 'current' => '<span class="active"><a href="">{{text}}</a></span>',
387 164 Alexandre Cases
388 164 Alexandre Cases
           Par : 
389 164 Alexandre Cases
390 164 Alexandre Cases
> 'current' => '<span class="current">{{text}}</span>',
391 164 Alexandre Cases
392 172 Alexandre Cases
* Puis il faut vider le cache de l'application (et du navigateur) pour que debug_kit fonctionne.
393 172 Alexandre Cases
394 156 Etienne Pallier
395 156 Etienne Pallier
---
396 156 Etienne Pallier
397 167 Alexandre Cases
h2. Rappel d'intervention par mail
398 167 Alexandre Cases
399 170 Alexandre Cases
* Il faut définir un attribut *"rappel" de type "int"* dans la table suivis.
400 171 Alexandre Cases
Cet attribut peut avoir *4 valeurs* : 
401 169 Alexandre Cases
<pre>
402 169 Alexandre Cases
0 ==> Pas d'envoi de rappel programmé
403 169 Alexandre Cases
1 ==> Rappel programmé 1 mois avant
404 169 Alexandre Cases
2 ==> Rappel programmé 15 jours avant
405 169 Alexandre Cases
3 ==> Rappel programmé 2 jours avant
406 169 Alexandre Cases
</pre>
407 1 Etienne Pallier
408 173 Alexandre Cases
* Dans *l'AppController*, il faut définir une fonction "rappelIntervention()" qui :
409 173 Alexandre Cases
- Parcourt tous les suivis et garde ceux qui ont une date inferieur à 1 mois de la date du jour et qui ont un attribut "rappel" à "0".
410 173 Alexandre Cases
- Met cette attribut à 1
411 173 Alexandre Cases
- 
412 1 Etienne Pallier
413 170 Alexandre Cases
...........................
414 170 Alexandre Cases
415 170 Alexandre Cases
* Dans *l'UsersController*, il faut executer la fonction précédente une fois que l'utilisateur est connecté (dans fonction login()).
416 167 Alexandre Cases
417 167 Alexandre Cases
---
418 167 Alexandre Cases
419 201 Thibaud Ajas
h2. %{margin-left:0px; font-weight:bold; font-size:25px;  display:block; color:red;}A L'ATTENTION DES UTILISATEURS D'ECLIPSE%
420 1 Etienne Pallier
421 211 Thibaud Ajas
*+0) Installer Eclipse (Si nécessaire), voire Java+*
422 1 Etienne Pallier
423 211 Thibaud Ajas
En effet, même si la version que vous allez installer est une version pour PHP, Eclipse à besoin de Java pour pouvoir s'exécuter.
424 211 Thibaud Ajas
Vérifiez que Java soit bien installé sur votre système :
425 211 Thibaud Ajas
<pre>
426 211 Thibaud Ajas
java -version
427 211 Thibaud Ajas
</pre>
428 211 Thibaud Ajas
Si ce n'est pas le cas, exécutez les lignes suivantes :
429 211 Thibaud Ajas
<pre>
430 211 Thibaud Ajas
sudo apt-add-repository ppa:webupd8team/java
431 211 Thibaud Ajas
sudo apt-get update
432 211 Thibaud Ajas
sudo apt-get install oracle-java8-installer
433 211 Thibaud Ajas
</pre>
434 211 Thibaud Ajas
435 211 Thibaud Ajas
Pour installer Eclipse, allez sur : http://www.eclipse.org/downloads/packages/release/Neon/3
436 1 Etienne Pallier
Selectionnez la version que vous désirez (Neon, Oxygen, Mars ...) puis sélectionnez "Eclipse for PHP Developers".
437 1 Etienne Pallier
Téléchargez la version correspondant à votre système d'exploitation.
438 211 Thibaud Ajas
Placez-vous dans le dossier ou vou voulez installer Eclipse avec l'archive précédement téléchargée (renommez-la en eclipse.tar.gz), puis exécutez la commande suivante :
439 211 Thibaud Ajas
<pre>
440 211 Thibaud Ajas
tar -zxvf eclipse.tar.gz
441 211 Thibaud Ajas
</pre>
442 1 Etienne Pallier
443 211 Thibaud Ajas
Si vous voulez Eclipse dans le menu des applications sous Ubuntu, il vous faudra crééer le fichier eclipse.desktop :
444 211 Thibaud Ajas
<pre>
445 211 Thibaud Ajas
gksudo gedit /usr/share/applications/eclipse.desktop
446 211 Thibaud Ajas
</pre>
447 212 Etienne Pallier
puis collez-y ce qui suit, en modifiant le chemin des lignes Exec et Icon au besoin :
448 211 Thibaud Ajas
<pre>
449 211 Thibaud Ajas
[Desktop Entry]
450 211 Thibaud Ajas
Name=Eclipse 
451 211 Thibaud Ajas
Type=Application
452 211 Thibaud Ajas
Exec=/opt/eclipse/eclipse
453 211 Thibaud Ajas
Terminal=false
454 211 Thibaud Ajas
Icon=/opt/eclipse/icon.xpm
455 211 Thibaud Ajas
Comment=Integrated Development Environment
456 211 Thibaud Ajas
NoDisplay=false
457 211 Thibaud Ajas
Categories=Development;IDE
458 211 Thibaud Ajas
Name[en]=eclipse.desktop
459 211 Thibaud Ajas
</pre>
460 211 Thibaud Ajas
461 211 Thibaud Ajas
Puis donnez les droits à tous les utilisateurs sur ce fichier :
462 211 Thibaud Ajas
<pre>
463 211 Thibaud Ajas
sudo chmod a+r /usr/share/applications/eclipse.desktop
464 211 Thibaud Ajas
</pre>
465 1 Etienne Pallier
466 202 Thibaud Ajas
*+1) Désactiver la vérification du certificat+*
467 1 Etienne Pallier
468 1 Etienne Pallier
Window -> Preferences -> Team -> git -> configuration -> Add entry
469 1 Etienne Pallier
470 1 Etienne Pallier
Key = http.sslVerify
471 1 Etienne Pallier
Value = false
472 1 Etienne Pallier
473 202 Thibaud Ajas
*+2) Récupérer le projet+*
474 1 Etienne Pallier
475 200 Thibaud Ajas
*(Si le projet git n'existe pas déjà sur votre machine)*
476 200 Thibaud Ajas
477 1 Etienne Pallier
File/Import project from git
478 1 Etienne Pallier
479 1 Etienne Pallier
Select repository source: Clone URI: https://gitlab.irap.omp.eu/epallier/labinvent.git
480 1 Etienne Pallier
481 1 Etienne Pallier
Directory: 
482 1 Etienne Pallier
- par défaut, il propose : /Users/epallier/git/labinvent
483 1 Etienne Pallier
- mais on peut le mettre n'importe où ailleurs, 
484 1 Etienne Pallier
par exemple, on pourrait le mettre directement dans le repertoire web de Apache:
485 1 Etienne Pallier
/Applications/XAMPP/xamppfiles/htdocs 
486 1 Etienne Pallier
(si on veut que le projet s'execute directement dans le dossier web apache htdocs, mais ca n'est pas obligatoire...)
487 1 Etienne Pallier
488 1 Etienne Pallier
initial branch: master
489 1 Etienne Pallier
remote name: origin
490 1 Etienne Pallier
491 1 Etienne Pallier
Import as general project
492 1 Etienne Pallier
493 1 Etienne Pallier
Project name: LABINVENT
494 1 Etienne Pallier
495 200 Thibaud Ajas
*(si le projet git existe déjà sur votre machine)*
496 1 Etienne Pallier
497 200 Thibaud Ajas
File/Import project from git
498 200 Thibaud Ajas
    
499 200 Thibaud Ajas
Existing local repository
500 1 Etienne Pallier
501 200 Thibaud Ajas
Directory
502 1 Etienne Pallier
503 200 Thibaud Ajas
ADD => Selectionnez le dossier contenant le projet git => Finish => Next
504 200 Thibaud Ajas
505 1 Etienne Pallier
Import existing Eclipse project
506 200 Thibaud Ajas
507 200 Thibaud Ajas
Selectionner le projet => Search for nested project => finish
508 200 Thibaud Ajas
509 200 Thibaud Ajas
510 202 Thibaud Ajas
*+3) Configurer le projet+*
511 200 Thibaud Ajas
512 1 Etienne Pallier
a) S'assurer que le projet est bien reconnu comme un projet PHP (il doit y avoir un petit "P" sur le dossier racine du projet)
513 1 Etienne Pallier
Si ça n'est pas le cas, vérifier que le fichier .project (à la racine) contient bien
514 1 Etienne Pallier
	<natures>
515 1 Etienne Pallier
		<nature>org.eclipse.php.core.PHPNature</nature>
516 1 Etienne Pallier
	</natures>
517 1 Etienne Pallier
NB : Le fichier .project est normalement versionné et donc le projet labinvent devrait être reconnu automatiquement comme projet PHP
518 1 Etienne Pallier
519 1 Etienne Pallier
520 1 Etienne Pallier
b) S'assurer que les fichiers de vue de cakephp ("*.ctp") sont bien reconnus comme des fichiers PHP.
521 1 Etienne Pallier
Pour tester cela, ouvrir le fichier de vue cakephp/app/View/Categories/get_all.ctp
522 1 Etienne Pallier
Si ce fichier s'ouvre comme un simple fichier texte, c'est qu'il n'est pas reconnu par Eclipse comme un fichier Php. 
523 1 Etienne Pallier
Il faut donc associer l'editeur Php a l'extension de fichier "*.ctp" :
524 1 Etienne Pallier
- Preferences/General/Content types
525 1 Etienne Pallier
- Dans la liste "Content types", ouvrir la section "Text", selectionner PHP
526 1 Etienne Pallier
- Ajouter l'extension "*.ctp"
527 1 Etienne Pallier
528 1 Etienne Pallier
c) Vérifier la version de php utilisée (il serait préférable d'utiliser la meme version que celle officiellement utilisée par le logiciel, c'est à dire php 5.6, mais attention, le serveur IRAP utilise toujours une version 5.3 pour inventirap) :
529 1 Etienne Pallier
- Clic-droit sur le projet, Propriétés
530 1 Etienne Pallier
- PHP
531 1 Etienne Pallier
- Interpreter
532 1 Etienne Pallier
- Enable project specific settings, PHP Version : "PHP 5.6"
533 1 Etienne Pallier
534 1 Etienne Pallier
d) S'assurer que le texte est bien encodé en UTF-8 par défaut :
535 1 Etienne Pallier
clic-droit sur le dossier racine du projet (dans PHP Explorer), Properties, Resource : dans la zone "Text file encoding" cocher "Other" et sélectionner UTF-8
536 1 Etienne Pallier
(
537 1 Etienne Pallier
Il faudrait commiter ça mais je ne sais pas trop si c'est risqué ou pas.
538 1 Etienne Pallier
Les fichiers concernés sont :
539 1 Etienne Pallier
- .project (déjà versionné) : car il commence par la ligne "<?xml version="1.0" encoding="UTF-8"?>"
540 1 Etienne Pallier
- mais c'est surtout celui-ci qui compte (actuellement ignoré de git) : .settings/org.eclipse.core.resources.prefs : car sa 2eme ligne est "encoding/<project>=UTF-8"
541 1 Etienne Pallier
)
542 1 Etienne Pallier
543 1 Etienne Pallier
Les éléments suivants sont normalement DEJA ignorés par git, à vérifier :
544 1 Etienne Pallier
- .settings/
545 1 Etienne Pallier
- cakephp/app/tmp/ : tout sauf 
546 1 Etienne Pallier
	- documents/
547 1 Etienne Pallier
- cakephp/app/Config/ :
548 1 Etienne Pallier
	- database.php
549 1 Etienne Pallier
	- labinvent.php
550 1 Etienne Pallier
551 1 Etienne Pallier
552 1 Etienne Pallier
553 1 Etienne Pallier
554 1 Etienne Pallier
555 1 Etienne Pallier
<pre>
556 1 Etienne Pallier
*********************************************************
557 1 Etienne Pallier
REMARQUES INTERRESSANTES (MAIS VOUS POUVEZ LES IGNORER)
558 1 Etienne Pallier
559 1 Etienne Pallier
// DEBUT DES REMARQUES
560 1 Etienne Pallier
561 1 Etienne Pallier
A la racine du projet, j'ai plusieurs éléments cachés de configuration Eclipse :
562 1 Etienne Pallier
563 1 Etienne Pallier
1) fichier .buildpath 
564 1 Etienne Pallier
Il est versionné puisque "svn status .buildpath" (depuis la console) ne donne rien
565 1 Etienne Pallier
Il contient :
566 1 Etienne Pallier
567 1 Etienne Pallier
<?xml version="1.0" encoding="UTF-8"?>
568 1 Etienne Pallier
<buildpath>
569 1 Etienne Pallier
        <buildpathentry kind="con" path="org.eclipse.php.core.LANGUAGE"/>
570 1 Etienne Pallier
        <buildpathentry kind="lib" path="docs/mockup/mockup_html.zip"/>
571 1 Etienne Pallier
        <buildpathentry kind="src" path="cakephp"/>
572 1 Etienne Pallier
</buildpath>
573 1 Etienne Pallier
574 1 Etienne Pallier
2) fichier .project
575 1 Etienne Pallier
Il est déjà versionné
576 1 Etienne Pallier
Il contient :
577 1 Etienne Pallier
<?xml version="1.0" encoding="UTF-8"?>
578 1 Etienne Pallier
<projectDescription>
579 1 Etienne Pallier
        <name>invirap</name>
580 1 Etienne Pallier
        <comment></comment>
581 1 Etienne Pallier
        <projects>
582 1 Etienne Pallier
        </projects>
583 1 Etienne Pallier
        <buildSpec>
584 1 Etienne Pallier
                <buildCommand>
585 1 Etienne Pallier
                        <name>org.eclipse.wst.common.project.facet.core.builder</name>
586 1 Etienne Pallier
                        <arguments>
587 1 Etienne Pallier
                        </arguments>
588 1 Etienne Pallier
                </buildCommand>
589 1 Etienne Pallier
                <buildCommand>
590 1 Etienne Pallier
                        <name>org.eclipse.wst.validation.validationbuilder</name>
591 1 Etienne Pallier
                        <arguments>
592 1 Etienne Pallier
                        </arguments>
593 1 Etienne Pallier
                </buildCommand>
594 1 Etienne Pallier
                <buildCommand>
595 1 Etienne Pallier
                        <name>org.eclipse.dltk.core.scriptbuilder</name>
596 1 Etienne Pallier
                        <arguments>
597 1 Etienne Pallier
                        </arguments>
598 1 Etienne Pallier
                </buildCommand>
599 1 Etienne Pallier
        </buildSpec>
600 1 Etienne Pallier
        <natures>
601 1 Etienne Pallier
                <nature>org.eclipse.php.core.PHPNature</nature>
602 1 Etienne Pallier
                <nature>org.eclipse.wst.common.project.facet.core.nature</nature>
603 1 Etienne Pallier
        </natures>
604 1 Etienne Pallier
</projectDescription>
605 1 Etienne Pallier
606 1 Etienne Pallier
3) dossier .settings/ (exclus de svn)
607 1 Etienne Pallier
Il contient 3 fichiers :
608 1 Etienne Pallier
609 1 Etienne Pallier
- org.eclipse.core.resources.prefs : bizarrement, il ne contient que quelques références seulement :
610 1 Etienne Pallier
eclipse.preferences.version=1
611 1 Etienne Pallier
encoding//cakephp/app/Controller/MaterielsController.php=UTF-8
612 1 Etienne Pallier
encoding//cakephp/app/View/Elements/menu_view.ctp=UTF-8
613 1 Etienne Pallier
encoding//cakephp/app/View/Layouts/default.ctp=UTF-8
614 1 Etienne Pallier
encoding//cakephp/app/View/Materiels/index.ctp=UTF-8
615 1 Etienne Pallier
encoding//cakephp/app/View/Materiels/scaffold.view.ctp=UTF-8
616 1 Etienne Pallier
encoding//database/Upd_TableConstraints.sql=UTF-8
617 1 Etienne Pallier
encoding//database/update/README.txt=UTF-8
618 1 Etienne Pallier
encoding//docs/HOWTO.txt=UTF-8
619 1 Etienne Pallier
encoding//install/HOWTO.txt=UTF-8
620 1 Etienne Pallier
encoding/<project>=UTF-8
621 1 Etienne Pallier
622 1 Etienne Pallier
- org.eclipse.php.core.prefs
623 1 Etienne Pallier
eclipse.preferences.version=1
624 1 Etienne Pallier
include_path=0;/invirap\u00051;/invirap/docs/mockup/mockup_html.zip
625 1 Etienne Pallier
626 1 Etienne Pallier
- org.eclipse.wst.common.project.facet.core.xml : sans doute inutile ? (lié à "Faceted Project Validation Builder" dans Properties/Builders)
627 1 Etienne Pallier
<?xml version="1.0" encoding="UTF-8"?>
628 1 Etienne Pallier
<faceted-project>
629 1 Etienne Pallier
  <fixed facet="php.core.component"/>
630 1 Etienne Pallier
  <fixed facet="php.component"/>
631 1 Etienne Pallier
  <installed facet="php.core.component" version="1"/>
632 1 Etienne Pallier
  <installed facet="php.component" version="5.4"/>
633 1 Etienne Pallier
</faceted-project>
634 1 Etienne Pallier
635 1 Etienne Pallier
// FIN DES REMARQUES
636 1 Etienne Pallier
*********************************************************
637 1 Etienne Pallier
</pre>
638 1 Etienne Pallier
639 200 Thibaud Ajas
*+4) (TODO:) Set Code style+*
640 1 Etienne Pallier
641 1 Etienne Pallier
Window/Preferences : PHP / Editor
642 1 Etienne Pallier
...
643 1 Etienne Pallier
644 200 Thibaud Ajas
*+5) (TODO:) virtualenv+*
645 200 Thibaud Ajas
646 200 Thibaud Ajas
Now, once the PHP5 virtual environment is installed (see above),
647 1 Etienne Pallier
set it in Eclipse as the project interpreter:
648 1 Etienne Pallier
649 1 Etienne Pallier
(cf http://virtphp.org)
650 1 Etienne Pallier
651 1 Etienne Pallier
...
652 1 Etienne Pallier
653 200 Thibaud Ajas
*+6) (TODO:) Test+*
654 1 Etienne Pallier
655 1 Etienne Pallier
656 200 Thibaud Ajas
*+7) (TODO:) Run+*
657 1 Etienne Pallier
658 1 Etienne Pallier
check http://localhost:8080/