Parcours 07Leçon 2 / 8

Importer une base de code existante dans Taiga

Examinez ce que Taiga déduit du dépôt. Distinguez comportement actuel et comportement souhaité, puis choisissez la réponse adaptée à un document inexact.

Pratique11 minRevu

Publié par Notre méthode de rédaction

Ce que vous apprendrez

  • Préparer un dépôt lié pour un produit importé.
  • Distinguer un défaut de code, une instruction permanente et une erreur d’analyse.
  • Examiner les initiatives proposées au regard des lacunes réelles et des capacités existantes.

Partir du système existant

Un service fictif de demandes d’équipement existe déjà. L’équipe souhaite le maintenir avec Taiga tout en conservant ses intégrations fonctionnelles.

Choisissez Import codebase à la création du produit. Liez le dépôt et lancez l’analyse. Ce parcours utilise l’analyse du dépôt à la place de la conversation d’un nouveau produit. Un produit créé de zéro n’ajoute pas ce parcours d’import plus tard.

Confirmez l’accès au dépôt et la branche sur laquelle Taiga doit travailler. Ajoutez les contraintes permanentes au niveau de contexte approprié. Dans cet exemple, précisez que l’intégration existante d’identité des salariés doit rester utilisée.

Examiner d’abord la spécification déduite

Taiga déduit les documents produit du code et inclut des références au dépôt. Elles aident à vérifier l’interprétation. Elles n’établissent pas l’intention métier derrière chaque pratique existante.

Examinez trois éléments de la spécification :

  • Objectif : l’objectif décrit correspond-il à la raison d’être du service ?
  • Contraintes : quelles pratiques sont des exigences délibérées ?
  • Défauts connus : quels comportements actuels doivent changer ?

Le service d’équipement contient un ancien module d’autorisation. Un document peut signaler correctement son utilisation. Cela ne signifie pas que l’équipe doit l’étendre.

Ouvrez un fichier cité et comparez le comportement pertinent à l’affirmation. Consignez les limites des preuves disponibles, comme une configuration ou un comportement d’exploitation situé hors du dépôt.

Choisir la bonne correction

SituationRéponse
Le document décrit correctement un code indésirablePlanifier et réaliser la modification du code
L’équipe dispose d’une règle permanente pour les travaux futursPlacer la règle dans les instructions produit
L’analyse a mal interprété le dépôtUtiliser Refresh this document et examiner le résultat

Les documents importés suivent le code. Ne les traitez pas comme des descriptions manuelles d’un futur système. L’actualisation d’un document recalcule aussi les documents dont il dépend. Actualiser un document situé plus loin dans la chaîne peut donc demander davantage de travail.

Pour l’ancien module, une instruction pourrait dire : « N’ajoutez pas de nouveaux appelants à l’ancien module d’autorisation. Utilisez l’interface de remplacement approuvée pour les nouveaux travaux. » Vérifiez que cette interface existe et indiquez son emplacement réel dans le dépôt.

Évaluer les premières initiatives

Le parcours d’import exécute aussi des analyses du dépôt, une évaluation par rapport aux politiques publiées et une première planification des initiatives. Une étape sans son prérequis peut être ignorée avec une explication. La planification utilise les résultats et l’évaluation des politiques disponibles.

Examinez les lacunes proposées au regard du dépôt. Les premières initiatives traitent les capacités manquantes, les fondations ou les problèmes pertinents de dépendances non résolus. Ce n’est pas une liste de nouvelles fonctionnalités que personne n’a demandées.

Conservez une capacité existante utile. Rejetez ou corrigez une proposition qui la reconstruirait inutilement. Ajoutez une initiative distincte pour une nouvelle exigence métier.

Préserver un point de départ fondé sur les preuves

Terminez Discovery et examinez les propositions d’initiatives. Confirmez l’environnement et les responsabilités de livraison avant la planification détaillée. Gardez les imports, les modifications du code et les instructions produit cohérents à mesure que le travail avance.

Le résultat est un point de départ compris et un backlog modifiable. Ce n’est pas une déclaration que tous les comportements existants sont corrects. Poursuivez avec la planification des initiatives.

Faire l’exercice

Un service fictif importé utilise un ancien module d’autorisation. Son remplacement est déjà prévu. Rédigez une instruction produit qui empêche de nouvelles dépendances à ce module. Identifiez ensuite une référence au dépôt à examiner dans la spécification importée.

Télécharger la fiche d’exercice (Markdown)

Vérifier votre compréhension

Un document importé décrit correctement un code que vous souhaitez remplacer. Quelle réponse convient ?

Sources et lectures complémentaires

Lectures Taiga sur le sujet