Accéder au contenu principal

Bonne pratique du génie logiciel


Bonne pratique du génie logiciel

La complexité des projets informatiques s'est accrue aux fils des problèmes à résoudre. Cette discipline est assez récente, malgré tout, après d'innombrable projets informatiques réussie certaines pratique très importante ont sortie du lot.

Dans cet article, nous allons répertorier une liste de bonne pratique qui peut s'avérer cruciale dans la bonne réussite d'un projet informatique.

Système de gestion de versions

C'est un logiciel qui permet de gérer des fichiers, de connaître les différentes version d'un fichier, de connaître l'historique d'un fichier. Imaginez qu'un vous avez classe nommé Animal au début d'un projet, avec un tous outils vous pouvez sauvegarder chaque changement que vous faite sur cette classe. Vous pouvez revenir en arrière. Vous pouvez savoir qui a fait des modifications sur cette classe.

Les fichiers sont sauvegardé sur un serveur. Plusieurs personne peuvent travailler sur le même fichier.
Il en existe plusieurs sur le marché dont subversion et cvs.

Équipe

Limité le nombre de personne dans une équipe à 3 à 5 personnes. Créer plusieurs équipes au besoin. Affecté des tâches à chacune des équipes et redistribué à au membres des équipes.

Tableau, "White board"

Lors de rencontre, un tableau peut s'avérer très pratique afin de mieux faire comprendre une idée, d'énumérer ses données. De plus une photo peut être prise afin de pouvoir se remémorer une certaine idée.

Documentation

Il est très aisé après plusieurs moi d'oublier et de ne plus comprendre le fonctionnement d'une fonction, classe. Bien documenter son code contribue à diminuer de tel risque. Il ne faut pas oublier de modifier au besoin les commentaires lorsque des modifications sont apporté au code. Si le commentaire n'est plus valide, il peut mettre en erreur le développeur. Ce n'est pas nécessairement le même développeur qui a créer la classe, fonction qui va faire les mises à jour ou faire la maintenance du code.

Une documentation pour l'utilisateur final est aussi très importante, elle permet de diminuer les appels au support technique.

Échéancier

Un échéancier devrait être établie. Ce qu'il doit apporté en terme de fonctionnalité et de correction devrait aussi être déterminé. À chaque mois, 2 mois... une nouvelle révision du système pourrait sortir.

Spécification

Les spécifications devraient pas être écrite par un développeur qui travaillera sur le projet.

Logiciel de suivi de problème

Un logiciel de suivi de problème devrait être mis en place afin de pouvoir connaître les anomalies relié au système, affecter un problème à une ressource du projet.Bugzilla, Mantis, JIRA sont parmi les plus populaires de ce type d'outils.

Performance

Un temps devrait être alloué pour optimiser le système. Par exemple, à la fin de chaque béta, quelques jours, semaine peuvent être consacré à l'optimisation du système.

Revue de code

Une revue de code devrait être fait sur une base régulière. Voir l'article qui est consacré sur le sujet sur ce site.

Test

Des ressources du projets devrait être alloué pour tester le système, des tests unitaires devraient être créé. À chaque nuit, ses tests peuvent être roulé afin de voir si les changements apportés ont créé une régression.

Commentaires

Posts les plus consultés de ce blog

Toshiba AC100 et Android 4

Toshiba AC100 est un smartbook. Toshiba est la seule grosse entreprise qui a commercialisé un smartbook, malgré que plusieurs autres en aient présenté. Un smartbook est similaire à un netbook (taille) en plus d'avoir des caractéristiques souvent proche à un mobile (GPS, 3g, processeur ARM, autonomie). Le Toshiba AC100 utilisait le système d'exploitation Android en version 2.1. Toshiba a effectué une mise à jour Android 2.2. Il a arrêté la commercialisation et le support de cette machine. L'appareil ayant un bon rapport qualité/prix, la communauté le prit en charge. Il est possible d'installer une version beaucoup plus récente d'Android telle que la 4.1. La rom alternative Cyanogen a été utilisée pour ce portage. Les procédures citées ont été faites sous Linux.  Sous Windows, il faut télécharger une version de nvflash pour ce système. Préparation Télécharger les fichiers: cm_ac100-ota-eng.cm10-beta2.zombah.zip recovery.ac100-cm10_beta2.img via ce...

Spring data jpa et Hibernate’s Warning “firstResult/maxResults specified with collection fetch”

Nous verrons dans cet article comment corrigé le problème  Hibernate’s Warning “firstResult/maxResults specified with collection fetch” qui peut survenir lorsqu'il y a un fetch d'effectuer et qu'il y a du paging. Nous utiliserons spring data jpa. Détail structure Imaginons une relation 1 à plusieurs Lorsqu'on obtient un parent, on désire obtenir aussi sa liste d'enfants. En sql, il y aurait une jointure à effectuer. Il est question d'une recherche avancé où on pourrait recherche par plusieurs critères. Spécification Création d'une spécification pour construire une requête dynamique @Component public class ParentSpecification {     public Specification<Parent> recherche(RechercheParent recherche) {         return (root, cq, cb) -> {             Join<Parent, enfant> enfantJoin;              List<Predicate> rootPredicates = new ArrayList<>();       ...

Migration d’une application Spring Boot 2.2 vers Spring Boot 4.0 : retour d’expérience concret

 En 2019, nous avons développé une application métier basée sur : Java 8 Spring Boot 2.2.7 Gradle 6.6.1 Thymeleaf Bootstrap 4.3.1 Environ 40 000 lignes de code Java Fin 2025, voici un retour d’expérience concret sur la migration vers : Java 25 Spring Boot 4.0.1 Gradle 9.2.1 La partie thymeleaf, n'a pas été touché, il y a quelques warning concernant l'obsolescence de certain commande tel que th:include. Une migration plus rapide que prévu Un point important : en moins de 30 minutes, l’application démarrait sur la nouvelle stack. Évidemment, "ça démarre" ne veut pas dire "tout fonctionne", mais ce premier jalon est très révélateur : la base Spring Boot reste solide les outils de migration sont matures la dette technique était maîtrisée Les changements majeurs rencontrés De javax.* à jakarta.* C’est probablement le changement le plus visible. Tous les imports javax.* doivent être migrés ve...