Comment ça fonctionne

Décrivez le changement. RefineBrief analyse le code et prépare les tickets Jira.

Vous indiquez le problème et choisissez où mener l’analyse. RefineBrief parcourt les dépôts Java connectés, identifie les classes, méthodes, flux et dépendances probablement concernés, sépare les preuves des inférences et prépare un brief technique avec un ou plusieurs tickets. Votre équipe révise tout avant la création dans Jira.

Voir un exemple complet

Git en lecture seule · Aucun changement de code · Création dans Jira uniquement après approbation

ENTRÉEDescription du changement ou du problème
INVESTIGATIONImpact probable et décisions manquantes
RÉSULTATBrief technique et tickets Jira suggérés

Configuration initiale

Connectez une fois. Analysez toujours avec le contexte à jour.

Lors de la configuration, votre équipe connecte les dépôts Git en lecture seule et définit le projet et le modèle de ticket Jira. RefineBrief crée une représentation technique dérivée et la maintient à jour lorsque les dépôts évoluent.

CONFIGURATION INITIALE
  • Connecter les dépôts Git
  • Connecter Jira
  • Choisir le projet
  • Configurer le modèle de ticket
POUR CHAQUE DEMANDE
  • Décrire le problème
  • Choisir certains ou tous les dépôts
  • Analyser l’impact probable
  • Réviser le brief technique
  • Créer les tickets approuvés
Carte technique à jourILLUSTRATIF
customer-apidépôtNotificationServiceservicePOST /notifycontrat HTTPcustomer.eventsKafka topicsendEmail()méthodeshared-domaindépendance
CHEMIN DE PREUVE VISIBLENotificationController.java:84
CONSOMMÉ PAREmailConsumer.java:112

Flux principal

De la demande à Jira.

  1. 01

    Décrire le changement

    Saisissez un bug, une fonctionnalité, une tâche ou une question technique, même si la description est encore incomplète.

  2. 02

    Choisir où analyser

    Sélectionnez les dépôts probablement concernés ou laissez RefineBrief analyser tous les dépôts connectés.

  3. 03

    Réviser l’impact probable

    Consultez le comportement actuel, les classes, méthodes, services, flux, dépendances, risques et décisions manquantes.

  4. 04

    Ajuster le résultat

    Modifiez le brief, répondez aux questions et fusionnez, divisez ou supprimez les tickets suggérés.

  5. 05

    Créer dans Jira

    Les tickets approuvés utilisent le projet et le modèle de ticket Jira configurés par votre équipe.

Le résultat

Ce que votre équipe reçoit avant le refinement.

RefineBrief transforme la demande initiale en un brief technique révisable.

Le brief comprend la demande initiale, le comportement actuel trouvé dans le code, les classes et services probablement concernés, les flux HTTP et Kafka, les preuves liées, l’impact probable entre dépôts, le périmètre, les dépendances, les risques, les questions ouvertes et un ou plusieurs tickets suggérés.

RefineBriefPRÊT À ÊTRE RÉVISÉ
DEMANDE INITIALE

« Ajouter la gestion des nouvelles tentatives au traitement des notifications client. »

COMPORTEMENT ACTUEL IDENTIFIÉ

Le producteur envoie les événements vers customer.events. Le consommateur traite les erreurs temporaires et permanentes du fournisseur dans le même flux.

IMPACT PROBABLE
  • notification-service
  • email-consumer
  • Observability
  • Tests d’intégration
PREUVE
  • NotificationController.java:84
  • NotificationService.java:136
  • EmailConsumer.java:112
DÉCISIONS EN ATTENTE
  • Combien de tentatives doivent être effectuées ?
  • Les échecs permanents doivent-ils aller vers un dead-letter topic ?
  • Le consommateur doit-il garantir l’idempotence ?
  • Qui est alerté lorsque toutes les tentatives échouent ?
TICKETS SUGGÉRÉS
  • Mettre à jour la politique de nouvelle tentative
  • Ajouter l’idempotence au consommateur
  • Surveiller les échecs permanents
  • Couvrir les livraisons en double dans les tests d’intégration
Les preuves restent liéesRien n’arrive dans Jira avant approbation

Impact probable entre dépôts

Suivez le changement au-delà du premier dépôt.

RefineBrief suit les appels HTTP, les événements Kafka et les dépendances partagées pour montrer où un changement peut se propager. Chaque relation reste liée aux preuves trouvées et peut être révisée par l’équipe.

APIcustomer-apiHTTP POST
SVCnotification-serviceProducer
KFKcustomer.eventsKafka topic
JOBemail-consumerConsumer
OBSobservability + testsDownstream

Preuve, inférence et décision

Ce qui a été trouvé ne se mélange pas avec ce que l’équipe doit encore décider.

Preuve · Trouvée dans le code

EmailConsumer.java traite les erreurs temporaires et permanentes du fournisseur dans la même branche.

Inférence · Conclusion probable

La politique de nouvelle tentative peut nécessiter des changements dans plusieurs services.

Question ouverte · Décision de l’équipe

Les événements en échec permanent doivent-ils aller dans un topic dead-letter ?

Une demande, un ou plusieurs tickets

Révisez la répartition suggérée avant tout envoi vers Jira.

Lorsque l’investigation identifie des travaux indépendants dans les services, consommateurs, l’observabilité ou les tests, RefineBrief suggère une division. Votre équipe peut fusionner, séparer, modifier ou supprimer tout ticket.

RB-249

Mettre à jour la politique de nouvelle tentative du producteur de notifications

notification-service

Feature
RB-250

Ajouter l’idempotence au consommateur Kafka

email-consumer

Task
RB-251

Ajouter la surveillance des événements en échec

observability

Task
RB-252

Étendre la couverture d’intégration des livraisons en double

integration-tests

Test

Division suggérée · Fusionner, séparer, modifier ou supprimer avant la création dans Jira

01

RefineBrief suggère la division

02

L’équipe révise et modifie

03

Le modèle de ticket Jira est appliqué

04

Seuls les tickets approuvés sont créés

Périmètre actuel

Centré sur les systèmes Java modernes.

RefineBrief prend actuellement en charge Java 17 à Java 25, les monolithes et microservices, plusieurs dépôts Git, les classes, méthodes et dépendances, les contrats HTTP, les producteurs et consommateurs Kafka, ainsi que la sélection de certains ou de tous les dépôts connectés.

PRIS EN CHARGE
  • Java 17 à Java 25
  • Monolithes et microservices
  • Plusieurs dépôts Git
  • Classes, méthodes et dépendances
  • Appels et contrats HTTP
  • Producteurs et consommateurs Kafka
  • Certains ou tous les dépôts connectés
EN DÉVELOPPEMENT

Analyse du code frontend

Détails techniques de l’investigation

Cartographie des symboles basée sur SCIP

Relations de graphe

Recherche lexicale et sémantique

Utilisez une demande réelle

Utilisez une demande réelle de votre équipe pendant la démo.

Découvrez comment RefineBrief analyse le contexte technique, expose les décisions manquantes et prépare les tickets Jira avant le refinement.