Zo werkt het

Beschrijf de wijziging. RefineBrief onderzoekt de code en bereidt de Jira-tickets voor.

U beschrijft het probleem en kiest waar het onderzoek plaatsvindt. RefineBrief volgt de verbonden Java-repositories, vindt waarschijnlijk betrokken klassen, methoden, flows en afhankelijkheden, scheidt bewijs van gevolgtrekkingen en bereidt een technisch brief met één of meer tickets voor. Uw team beoordeelt alles vóór aanmaak in Jira.

Git alleen-lezen · Geen codewijzigingen · Jira-aanmaak alleen na goedkeuring

INVOERBeschrijving van wijziging of probleem
ONDERZOEKWaarschijnlijke impact en ontbrekende beslissingen
RESULTAATTechnisch brief en voorgestelde Jira-tickets

Eerste configuratie

Eén keer verbinden. Elke keer onderzoeken met actuele context.

Tijdens de configuratie verbindt uw team Git-repositories met alleen-lezen toegang en definieert het Jira-project en de ticketsjabloon. RefineBrief maakt een afgeleide technische representatie en houdt die actueel wanneer repositories veranderen.

EERSTE CONFIGURATIE
  • Git-repositories verbinden
  • Jira verbinden
  • Project kiezen
  • Ticketsjabloon configureren
VOOR ELK VERZOEK
  • Beschrijf het probleem
  • Enkele of alle repositories kiezen
  • Waarschijnlijke impact onderzoeken
  • Technisch brief beoordelen
  • Goedgekeurde tickets aanmaken
Technische kaart actueelILLUSTRATIEF
customer-apirepositoryNotificationServiceservicePOST /notifyHTTP-contractcustomer.eventsKafka topicsendEmail()methodeshared-domainafhankelijkheid
ZICHTBAAR BEWIJSPADNotificationController.java:84
GEBRUIKT DOOREmailConsumer.java:112

Hoofdproces

Van het verzoek naar Jira.

  1. 01

    Beschrijf de wijziging

    Voer een bug, feature, taak of technische vraag in, ook als de beschrijving nog onvolledig is.

  2. 02

    Kies waar u wilt onderzoeken

    Selecteer de waarschijnlijke repositories of laat RefineBrief alle verbonden repositories onderzoeken.

  3. 03

    Waarschijnlijke impact beoordelen

    Bekijk huidig gedrag, klassen, methoden, services, flows, afhankelijkheden, risico’s en ontbrekende beslissingen.

  4. 04

    Resultaat aanpassen

    Bewerk het brief, beantwoord vragen en voeg voorgestelde tickets samen, splits of verwijder ze.

  5. 05

    Aanmaken in Jira

    Goedgekeurde tickets gebruiken het Jira-project en de ticketsjabloon van uw team.

Het resultaat

Wat uw team vóór refinement ontvangt.

RefineBrief zet de eerste aanvraag om in een controleerbaar technisch brief.

Het brief bevat het oorspronkelijke verzoek, huidig gedrag uit de code, waarschijnlijk betrokken klassen en services, HTTP- en Kafka-flows, gekoppeld bewijs, waarschijnlijke impact tussen repositories, scope, afhankelijkheden, risico’s, open vragen en één of meer voorgestelde tickets.

RefineBriefKLAAR VOOR BEOORDELING
OORSPRONKELIJK VERZOEK

‘Voeg herhaalpogingen toe aan de verwerking van klantmeldingen.’

HUIDIG GEDRAG GEVONDEN

De producer stuurt events naar customer.events. De consumer behandelt tijdelijke en permanente providerfouten in dezelfde flow.

WAARSCHIJNLIJKE IMPACT
  • notification-service
  • email-consumer
  • Observability
  • Integratietests
BEWIJS
  • NotificationController.java:84
  • NotificationService.java:136
  • EmailConsumer.java:112
OPENSTAANDE BESLISSINGEN
  • Hoeveel pogingen moeten worden gedaan?
  • Moeten permanente fouten naar een dead-letter-topic?
  • Moet de consumer idempotentie garanderen?
  • Wie wordt gewaarschuwd als alle pogingen mislukken?
VOORGESTELDE TICKETS
  • Beleid voor herhaalpogingen bijwerken
  • Idempotentie aan de consumer toevoegen
  • Permanente fouten monitoren
  • Dubbele leveringen afdekken in integratietests
Bewijs blijft gekoppeldNiets bereikt Jira vóór goedkeuring

Waarschijnlijke impact tussen repositories

Volg de wijziging voorbij de eerste repository.

RefineBrief volgt HTTP-calls, Kafka-events en gedeelde afhankelijkheden om te tonen waar een wijziging kan doorwerken. Elke relatie blijft gekoppeld aan gevonden bewijs en kan door het team worden beoordeeld.

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

Bewijs, gevolgtrekking en beslissing

Wat is gevonden, wordt niet vermengd met wat het team nog moet beslissen.

Bewijs · Gevonden in de code

EmailConsumer.java verwerkt tijdelijke en permanente providerfouten via dezelfde branch.

Gevolgtrekking · Waarschijnlijke conclusie

Het beleid voor herhaalpogingen kan wijzigingen in meer dan één service vereisen.

Open vraag · Teambeslissing

Moeten permanent mislukte events naar een dead-letter-topic?

Eén verzoek, één of meer tickets

Beoordeel de voorgestelde opsplitsing voordat iets Jira bereikt.

Wanneer het onderzoek zelfstandig werk in services, consumers, observability of tests vindt, stelt RefineBrief een opsplitsing voor. Uw team kan elk ticket samenvoegen, scheiden, bewerken of verwijderen.

RB-249

Beleid voor herhaalpogingen van de notificatieproducer bijwerken

notification-service

Feature
RB-250

Idempotentie toevoegen aan de Kafka-consumer

email-consumer

Task
RB-251

Monitoring van mislukte events toevoegen

observability

Task
RB-252

Integratiedekking voor dubbele levering uitbreiden

integration-tests

Test

Voorgestelde splitsing · Samenvoegen, scheiden, bewerken of verwijderen vóór Jira-aanmaak

01

RefineBrief stelt de splitsing voor

02

Het team beoordeelt en bewerkt

03

De Jira-ticketsjabloon wordt toegepast

04

Alleen goedgekeurde tickets worden aangemaakt

Huidige scope

Gericht op moderne Java-systemen.

RefineBrief ondersteunt momenteel Java 17 tot en met Java 25, monolieten en microservices, meerdere Git-repositories, klassen, methoden en afhankelijkheden, HTTP-contracten, Kafka-producers en -consumers en de selectie van enkele of alle verbonden repositories.

ONDERSTEUND
  • Java 17 tot en met Java 25
  • Monolieten en microservices
  • Meerdere Git-repositories
  • Klassen, methoden en afhankelijkheden
  • HTTP-aanroepen en -contracten
  • Kafka-producers en -consumers
  • Enkele of alle verbonden repositories
IN ONTWIKKELING

Analyse van frontendcode

Technische onderzoeksdetails

SCIP-gebaseerde symboolmapping

Graafrelaties

Lexicale en semantische retrieval

Gebruik een echt verzoek

Gebruik een echt verzoek van uw team in de demo.

Zie hoe RefineBrief de technische context onderzoekt, ontbrekende beslissingen zichtbaar maakt en vóór refinement de Jira-tickets voorbereidt.