Facet
EnglishInstallieren

FÜR ENGINEERING LEADS UND DOMAIN-TEAMS

Euer Release war grün. Unseres ist jetzt kaputt.

Team A ändert eine Regel, Team B hing still daran, und beide erfahren es aus dem Incident-Channel. FACET macht sichtbar, wer von welcher Regel abhängt — bevor die Änderung live geht, nicht danach.

Team Bestellungencheckout/

RECORDdocs/facets/features/checkout/orders/cancellation.yaml
id: checkout/orders/cancellationlineage:  owner:    team: orders  depended_on_by:    - billing/invoicing/cancelled-order-no-invoice

Team Abrechnungbilling/

RECORDdocs/facets/features/billing/invoicing/cancelled-order-no-invoice.yaml
id: billing/invoicing/cancelled-order-no-invoicelineage:  owner:    team: billing  depends_on:    - checkout/orders/cancellation

Illustratives Beispiel · zwei Registries, in .facetrc.yaml deklariert

DIE ÄNDERUNG AN DER TEAMGRENZE

Bestellungen ändert eine Regel. Abrechnung erfährt es vor dem Release.

„Für uns ist sie storniert.“ — „Für uns ist sie abrechenbar.“ Zwei Teams, zwei Repositories, ein Produkt. Wenn die Stornierungsfrist wächst, zeigt FACET, welches andere Team an dieser Regel hängt — und der Review weiß, wen er fragen muss.

RECORDcheckout/orders/cancellation.yaml
contract:  scenarios:    - id: cancel-before-shipping      when: the order is cancelled before shipping      when: the order is cancelled up to 24 h after shipping      then: the order is cancelled and leaves picking

lineage · wer hängt daran?

erfasstbilling/invoicing/cancelled-order-no-invoice

Team Abrechnung hat diese Beziehung in seinem Record festgehalten. Deshalb wird es genannt — nicht, weil FACET den Code beider Teams durchsucht hätte.

unbekanntWas niemand erfasst hat, bleibt unsichtbar.

Illustratives Beispiel · facet registries zeigt, welche Registry welche Feature-Ids dokumentiert; facet lint prüft jede depends_on-Referenz

EIN GEMEINSAMES VOKABULAR

„Storniert“ heißt bei uns dasselbe wie bei euch.

Was nur ein Team betrifft, bleibt bei diesem Team. Begriffe, die beide benutzen, werden einmal definiert — und beide Teams zeigen auf dieselbe Definition statt auf zwei Meinungen.

GLOSSARYdocs/facets/glossary.yaml
terms:  - term: cancelled    category: order-state    definition: the buyer or the shop ended the order; nothing is shipped and nothing is invoiced
Verwendet in
checkout/orders/cancellation

Eine stornierte Bestellung verlässt die Kommissionierung.

billing/invoicing/cancelled-order-no-invoice

Eine stornierte Bestellung erzeugt keine Rechnung.

Illustratives Beispiel · facet lint warnt, wenn ein Wort in intent.summary einem Glossar-Begriff nur beinahe entspricht

WAS FACET HIER NICHT TUT

Eigenständig liefern. Gemeinsam verstehen.

FACET kennt nur erfasste Beziehungen. Es liefert keine vollständige automatische Auswirkungsanalyse.