Documentation produit

Cette traduction est générée automatiquement (bêta). Le guide en anglais fait foi.

Planifier la modification

Conception

Utilisez Conception pour transformer une conversation en brief, en orientations de maquette et en ticket d’implémentation examiné, qui passe ensuite dans un espace de travail puis dans CI & Review.

Administrateurs clientMembres clientOpérateurs de plateforme

Dernière mise à jour

Conception avec un flux de travail ouvert : liste de travail, conversation Conception et panneau Artefact affichant un concept WebCentral structuré, sur des données d’exemple sûres.
Données d’exemple sûres : Conception affiche côte à côte la liste de travail, la conversation et l’artefact.

Conception (/design) permet de planifier une modification avant que quiconque n’écrive du code. Vous décrivez la modification dans une conversation ; ArchiBot prépare un brief et des orientations de maquette, puis vous approuvez un ticket d’implémentation qu’un développeur réalisera ensuite dans un espace de travail. Chaque projet de conception a sa propre adresse, /design/<project>.

Qui peut y accéder

Toute personne ayant une équipe : membres et administrateurs d’équipe, opérateurs et administrateurs de plateforme. Conception se trouve sous Build dans la navigation et sous Conception dans la barre inférieure du téléphone. La publication dans Linear nécessite une connexion Linear pour votre compte.

Commencer une conception

  1. Ouvrez Conception et choisissez New design. Une conversation démarre immédiatement.
  2. Décrivez la modification : écran ou workflow, personnes concernées, changements attendus, éléments à préserver et critères de réussite. Le First-message guide vous y aide. Joignez une capture d’écran ou nommez la vue WebCentral lorsque c’est possible. Les suggestions Redesign this experience, Explore the missing states et Draft the implementation issue sont des raccourcis.
  3. ArchiBot pose des questions ciblées et construit le brief au fil de la conversation : Describe the outcome → Ground it in context → Review the brief. « Rien n’avance tant que vous ne l’avez pas approuvé. »
  4. Pour ajouter des fichiers ou du contexte gouverné, ouvrez Outils et sources. Le contexte du projet Conception est toujours inclus.

Travailler avec l’artefact

L’espace de travail de l’artefact affiche la maquette actuelle. Lors de la première visite, choisissez Generate first direction.

  • Compare une révision à la précédente, l’Annotate ou Refine l’orientation sélectionnée.
  • Add comment consigne un commentaire uniquement sur cette révision.
  • Revisions répertorie toutes les versions (v1, v2, …). New variant lance une nouvelle orientation.
  • Chaque révision indique si elle a été vérifiée dans un environnement d’exécution réel : « Validated in the authenticated target runtime. » ou « No runtime verification has been recorded for this revision. » Une maquette sans validation à l’exécution est un concept, et non une preuve que la modification fonctionne.
  • Pour les vues WebCentral, Conception peut préparer le code source AXVW et, lorsqu’un espace de travail WebCentral inscriptible est associé, afficher la vue native pour examen.

Focus canvas, Restore work panes et Reset panes modifient la disposition.

Détails du travail

L’en-tête d’un travail affiche sa révision, l’étape Suivant, un badge de statut et Context ready ou Context needs attention. Le bouton (i) Détails du travail (« Objectif, contraintes, vérifications d’achèvement et contexte de produit résolu ») affiche :

ChampSignification
Contexte du produitProduit, hôte et version visés par la conception.
ViewVue ou module WebCentral.
Espace de travailEspace de travail utilisé pour les vérifications à l’exécution.
Repository stackDépôts concernés par la modification.
Base de donnéesBase de données utilisée pour les vérifications.
ContraintesÉléments à ne pas modifier.
Définition du travail terminéVérifications qui doivent réussir.

Choisissez Refresh context après la modification de l’espace de travail ou du produit, puis vérifiez de nouveau les valeurs. Ouvrir le guide de workflow ouvre Créer un espace de travail. Cela ne lance aucune opération.

Modifier change l’objectif. Mettre en pause et Reprendre arrêtent et relancent le travail d’ArchiBot sur la conception.

Boîte de dialogue Détails du travail avec le contexte du produit, la vue, l’espace de travail, la pile de dépôts, la base de données, les contraintes et la définition du travail terminé, ainsi que Actualiser le contexte, Ouvrir le guide de workflow et Ouvrir la documentation, sur des données d’exemple sûres.

Examiner et transmettre le ticket d’implémentation

Lorsque le dossier est prêt, l’en-tête affiche Examiner le dossier (ou vous pouvez choisir Review issue). Examiner le ticket d’implémentation ouvre :

  1. Modifiez le Titre du ticket et la Description du ticket et critères d’acceptation. Vérifiez le résultat dans l’onglet Aperçu.
  2. Choisissez Enregistrer le brouillon. L’approbation attend que les modifications non enregistrées soient enregistrées.
  3. Ouvrez la liste de contrôle (« N sur M prêts ») et terminez les éléments incomplets.
  4. Choisissez Approuver l’instantané. Cette opération approuve l’instantané de conception, pas le code.
  5. Choisissez une destination : Exporter en Markdown, Exporter en JSON, Enregistrer dans Shared Drive ou Publier dans Linear. Après la publication, Ouvrir le ticket fournit un lien vers celui-ci.

Aucune de ces actions ne crée d’espace de travail ni ne modifie le code. Un développeur réalise le ticket dans un espace de travail, puis la modification suit le processus de revue. Fonctionnement de l’examen d’implémentation dans la liste de contrôle ouvre Revue d’implémentation.

Boîte de dialogue Examiner le ticket d’implémentation avec le titre, les onglets Description et Aperçu, l’état de préparation (2 éléments prêts sur 3) et les boutons Enregistrer le brouillon, Approuver l’instantané, exporter et Publier dans Linear, sur des données d’exemple sûres.

Sur un téléphone

  • Un sélecteur Projects / Chat / Artifact en haut affiche un seul panneau à la fois. Tant que le brief est en cours d’élaboration, seuls Projects et Chat apparaissent.
  • Outils et sources s’ouvre sous forme de panneau pleine largeur depuis le bas de l’écran, avec un bouton Fermer.
  • Les onglets et les boutons ont des zones tactiles de taille standard, et Ouvrir le guide de workflow dans Détails du travail est un lien pleine largeur.
  • Examiner le ticket d’implémentation s’ouvre aussi sous forme de panneau pleine largeur depuis le bas de l’écran. Faites défiler le panneau pour accéder à Approuver l’instantané et aux boutons d’exportation.

Conception sur un téléphone avec le sélecteur Projets / Chat / Artefact et le panneau Chat affiché, sur des données d’exemple sûres.

Outils et sources ouvert dans un panneau pleine largeur sur un téléphone, avec les onglets Sources et Fichiers, les sources actives et le contexte Shared Drive, sur des données d’exemple sûres.

Examiner le ticket d’implémentation ouvert dans un panneau pleine largeur sur un téléphone, avec le titre du ticket, les onglets Description et Aperçu et la description du ticket, sur des données d’exemple sûres.

Détails du travail sous forme de panneau au bas de l’écran d’un téléphone, avec Fermer et Ouvrir la documentation, sur des données d’exemple sûres.

Dépannage

  • « La saisie d’une demande de conception en commençant par la conversation n’est pas encore disponible. » Actualisez la page et réessayez.
  • Le contexte nécessite une intervention : ouvrez Détails du travail, choisissez Refresh context, puis vérifiez l’espace de travail et le dépôt.
  • Approuver est désactivé : enregistrez d’abord le brouillon (« Modifications non enregistrées · enregistrez le brouillon avant l’approbation. »).
  • L’exportation ou la publication est désactivée : la liste de contrôle n’est pas terminée ou l’instantané n’a pas été approuvé.
  • L’aperçu ne peut pas afficher une vue WebCentral : associez un espace de travail WebCentral inscriptible ou connectez-vous à WebCentral dans un nouvel onglet lorsque Conception le demande.

Guides associés

Terminé quand

  • Détails du travail affiche le produit, la vue, l’espace de travail et le dépôt prévus.
  • Une maquette est considérée comme un concept tant que sa validation à l’exécution n’est pas consignée.
  • Le ticket d’implémentation est enregistré, approuvé et prêt avant son exportation ou sa publication.