Quels mots pouvez-vous utilisez pour décrire un objet? COMMENT DÉCRIRE UN OBJET.
Décrire un projet PHP dans des rapports
Transcript of Décrire un projet PHP dans des rapports
![Page 1: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/1.jpg)
Décrire un projet PHP dans des rapportsConfoo 2011, Montréal, Québec, Canada
9 mars 2011
mercredi 9 mars 2011
![Page 2: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/2.jpg)
Agenda
Pourquoi il faut tout rapporter?
Sujets et contenus
Outils et méthodes
mercredi 9 mars 2011
![Page 3: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/3.jpg)
Qui parle?
Damien Seguy
Consultant chez Alter Way ConsultingAlter Way Group
Industrialisation des développements PHP
mercredi 9 mars 2011
![Page 4: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/4.jpg)
Yes, we take questionsmercredi 9 mars 2011
![Page 5: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/5.jpg)
mercredi 9 mars 2011
![Page 6: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/6.jpg)
Pourquoi ?J’ai juste à me lever pour poser la question
C’est pénible à écrire
Personne ne le lit
On est plus productif à coder
C’est obsolète dès que c’est écrit
On a pas le temps de le faire
Ca ralentit le rythme de travail
mercredi 9 mars 2011
![Page 7: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/7.jpg)
Exemples
Conventions de code
Référentiel de sécurité
Plan d’urbanisme
Planning de travail
La conception
mercredi 9 mars 2011
![Page 8: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/8.jpg)
Conventions de code
Objectif : coder de manière uniforme
Contenu : liste de règles à appliquer
mercredi 9 mars 2011
![Page 9: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/9.jpg)
Sommaire
Liste de toutes les règles
Détails de chaque règle
Conventions de références
PEAR, Symfony, ZF, ...
mercredi 9 mars 2011
![Page 10: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/10.jpg)
Section
Nom de la règle
Description littérale
Exemples et non-exemples
Obligatoire, recommandation, bonne pratique
mercredi 9 mars 2011
![Page 11: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/11.jpg)
Outils
PHP_CodeSniffer
+ développement spécifique
Séances de corrections du code
mercredi 9 mars 2011
![Page 12: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/12.jpg)
Récapitulatif
Procéder par liste
Procéder par exemple
Donnez des noms
Intégrez le document dans le quotidien
mercredi 9 mars 2011
![Page 13: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/13.jpg)
Référentiel de sécurité
Objectif : maîtriser la sécurité
Contenu : montrer qu’on sait préparer l’application à affronter les menaces de sécurité
mercredi 9 mars 2011
![Page 14: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/14.jpg)
Sommaire
Rappel métier et objectifs de sécurité
Le référentiel : OWASP, PCI, HIPAA, Basel II
Liste des menaces identifiées
Détails des protections pour chaque menace
Cahier de recette
mercredi 9 mars 2011
![Page 15: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/15.jpg)
Détails des protections
Nom de la règle
Description de la menace et conséquence
Explication du mécanisme de protection
Exemples et illustration des mauvaises pratiques
Méthode de validation
mercredi 9 mars 2011
![Page 16: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/16.jpg)
Récapitulatif
Exploitez les référentiels
Ou un gourou / expert
Capitalisez par l’exemple
mercredi 9 mars 2011
![Page 17: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/17.jpg)
Plan d’urbanisme
Dossier d’exploitation, architecture serveurs...
Objectif : décrire les machines de production
Contenu : décrire la plate-forme d’hébergement de l’application
mercredi 9 mars 2011
![Page 18: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/18.jpg)
SommaireSchéma du réseau
Liste des services de chaque serveur
Flux de données entre les serveurs, par service
Déploiement
Procédés d’administration
Installation, déploiement, redémarrage après crash
mercredi 9 mars 2011
![Page 19: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/19.jpg)
Outils
Schéma
Visio, Dia, Omnigraffle, Xmind
Tableaux
mercredi 9 mars 2011
![Page 20: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/20.jpg)
Récapitulatif
Document commun : doit être partagé, évolutif
Utiliser des schémas
mercredi 9 mars 2011
![Page 21: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/21.jpg)
Planning de travail
Objectif : organiser l’action dans le temps
Contenu : liste des points clés du projet
mercredi 9 mars 2011
![Page 22: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/22.jpg)
Structure
Planning du projet
Liste de tâches et réunions
Liste des cycles de travail
Découpage hebdomadaire
mercredi 9 mars 2011
![Page 23: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/23.jpg)
Réunions
Point projet
Réunion technique
Daily scrum
Revue de cycle
mercredi 9 mars 2011
![Page 24: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/24.jpg)
Taches
Audits croisés
Tests
Relecture de code
Validation avant commit du jour
Mise en Production
mercredi 9 mars 2011
![Page 25: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/25.jpg)
Détails des activitésNom de l’activité
Fréquence
Durée : % et durée effective
Acteurs
Sujets abordés
Résultats attendus
mercredi 9 mars 2011
![Page 26: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/26.jpg)
Occupation
50 %
20 %
10 %
10 %
10 %
Dev Tests Rapports Qualité MeP
mercredi 9 mars 2011
![Page 27: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/27.jpg)
Outils
Calendrier
Diagrammes de Gantt
mercredi 9 mars 2011
![Page 28: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/28.jpg)
Document de conception
Objectif : rassembler tout ce qui contribue à la progression du projet
Structure : dictionnaire des concepts
mercredi 9 mars 2011
![Page 29: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/29.jpg)
Sommaire
Objectifs de l’application
Glossaire
Procédés particuliers
Liste de noms
mercredi 9 mars 2011
![Page 30: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/30.jpg)
Objectifs de l’application
Rappel des objectifs métier
Donne une vision d’ensemble
Liste les cas d’utilisation
mercredi 9 mars 2011
![Page 31: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/31.jpg)
Glossaire
Dictionnaire des termes utilisés
Sigles
Termes métier
Synonymes
Donner des illustrations
mercredi 9 mars 2011
![Page 32: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/32.jpg)
Procédés particuliers
Explications des algorithmes
Schéma rapide du fonctionnement
Exemples d’application
mercredi 9 mars 2011
![Page 33: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/33.jpg)
Listes de noms
Tout ce qui est nommé doit être listé
Classes, méthodes, propriétés, constantes, fonctions, sessions
URL, vues, contrôleurs, cookies, modules
Nom des tables, bases de données, serveurs, configurations
Formats de noms, de fichiers
mercredi 9 mars 2011
![Page 34: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/34.jpg)
Listes de noms
Classes : diagrammes de classes, de paquets
Tables : MCD
Le reste : des tableaux en traitement de texte
mercredi 9 mars 2011
![Page 35: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/35.jpg)
OutilsDiagrammes de classes
ArgoUML, StarUML
MCD
Mysql Workbench, Power Architect
Traitement de texte
Format extractible, vérifiable
mercredi 9 mars 2011
![Page 36: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/36.jpg)
Récapitulatif
Savoir vérifier l’application de la conception
Savoir faire évoluer la conception au besoin
Beaucoup d’outils
Faites un choix
mercredi 9 mars 2011
![Page 37: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/37.jpg)
Parce que!Je suis autonome
Je participe à sa rédaction
Je l’utilise régulièrement
Je me pose moins de questions
Je peux le tester facilement
Je le fait depuis le début
mercredi 9 mars 2011
![Page 38: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/38.jpg)
L’impact est croissant
mercredi 9 mars 2011
![Page 40: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/40.jpg)
mercredi 9 mars 2011
![Page 41: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/41.jpg)
Outils
Détecteurs automatiques
Auditeurs statiques
Revue manuelle
Audits croisés
Ajouter une fiche de recette
mercredi 9 mars 2011
![Page 42: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/42.jpg)
Tout le monde aime ça
Graphiques, camemberts, courbes...
Tableaux
Prévisions, constatations
mercredi 9 mars 2011
![Page 43: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/43.jpg)
Pour qui?
Projet
Chef de projet
Développeurs
Administrateurs
Clients / utilisateurs
mercredi 9 mars 2011
![Page 44: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/44.jpg)
Personne n’aime les écrire
Documentations cul-de-sac
Temps perdu
Jamais lu
Tout le monde se plaint de ne jamais en avoir
mercredi 9 mars 2011
![Page 45: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/45.jpg)
Une activité complète
Prendre les informations
Les rédiger
Les relire
Les valider
Les faire comprendre
mercredi 9 mars 2011
![Page 46: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/46.jpg)
Pilotage à vue
Est-ce que c’est fait?
Est-ce que c’est en retard?
Qu’est-ce qu’il y a dedans
On vire une partie, on en garde une autre
On recommence
mercredi 9 mars 2011
![Page 47: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/47.jpg)
Les développeurs
Les clients et utilisateurs
Le chef de projet
Les administrateurs
mercredi 9 mars 2011
![Page 48: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/48.jpg)
Comment documenter?
Établir un document texte, tableur
Le partager entre les intervenants
En lecture seule pour les autres
Automatiser la vérification du document
mercredi 9 mars 2011
![Page 49: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/49.jpg)
Dans le doute?
Forcez sur les exemples
Arrangez-vous pour que le document soit éditable
Dégagez explicitement du temps pour lire des documents, les écrire, les relire, les appliquer.
mercredi 9 mars 2011
![Page 50: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/50.jpg)
Spécifications et tests
Si personne ne les écrits, vous êtes dans la merde
Principe de la loi de Murphy : on oublie tout ce qui va, et on ne fait le bilan que de ce qui ne va pas.
Le temps de l’écrire, vous le comprenez, et vous temporisez face au client. Apaisement du cycle de développement
mercredi 9 mars 2011
![Page 51: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/51.jpg)
Spécifications
Evitez le futur (utilisez le présent)
Fuyez les listes non terminées (privilégiez les listes finies, quitte à reporter en annexe des ajouts finaux, tbd)
Donnez des noms à tout, et mettez en glossaire
Explicitez ce qui ne l’est pas
Faites des tableaux dès que possible
mercredi 9 mars 2011
![Page 52: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/52.jpg)
Urbanisation des serveurs
Les machines qui supportent l’application
Les services et les flux de données
Les accès et/ou les responsables
Les procédures à appliquer
deploiement, installation, restauration, crash, sécurité, sauvegarde
mercredi 9 mars 2011
![Page 53: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/53.jpg)
mercredi 9 mars 2011
![Page 54: Décrire un projet PHP dans des rapports](https://reader033.fdocuments.net/reader033/viewer/2022042607/55700b66d8b42ac0178b491a/html5/thumbnails/54.jpg)
Evitez les réducteurs
Peut, pourrais
petit, léger, rapide, simple, light
beta, version x.xx.01
mercredi 9 mars 2011