Facet
EnglishInstallieren

FÜR MENSCHEN, DIE ÄNDERUNGEN FREIGEBEN

„Die Zeile kann weg.“ Sicher?

Im Review sieht eine gelöschte Zeile harmlos aus. Ob sie einen Kunden vor einer doppelten Abbuchung geschützt hat, steht nirgends. Mit FACET steht es direkt daneben — und der Review fragt nach, bevor es teuer wird.

DIFFsrc/checkout/payment.ts−1 Zeile — Eine Zeile wird aus der Datei entfernt
// @facet: checkout/payment/charge-onceexport async function charge(order: Order) {  if (await alreadyCharged(order.id)) return;  await gateway.charge(order.id, order.total);}

Illustratives Beispiel · eine Zeile im Diff, die harmlos aussieht

WAS FACET IM REVIEW MELDET

Der Code hat sich geändert. Seine Beschreibung nicht. Absicht?

Am Ende jeder Änderung nennt FACET jede Datei, deren Code sich bewegt hat, während die Beschreibung ihres Features gleich blieb. Daneben steht der Fall, den die gelöschte Zeile geschützt hat. Der Review bekommt eine konkrete Frage statt eines Bauchgefühls.

RECORDcheckout/payment/charge-once.yaml
contract:  scenarios:    - id: second-click-charges-once      given: an order of 100 € was charged      when: the customer submits payment again      then: no second charge is made
HOOKsession-drift.sh · Stop
decision: "block"FACET: source implementing these features changed,but their records did not:- checkout/payment/charge-once — changed: src/checkout/payment.ts

Illustratives Beispiel · Form wie der Stop-Hook von FACET

WAS DIE ZEILE GESCHÜTZT HAT

Im Diff fehlt eine Zeile. Beim Kunden kommt eine zweite Abbuchung an.

Ein Auftrag, zwei Klicks. Mit der Zeile zahlt der Kunde einmal. Ohne sie zahlt er zweimal: gleiche Oberfläche, andere Geschäftsregel.

die vereinbarte Regel

100 €

Ein Auftrag. Eine Zahlung. Auch wenn der Kunde zweimal klickt.

− Schutz vor doppelter Zahlung

200 €

Zweiter Klick. Zweite Abbuchung. Gleiche Oberfläche, andere Geschäftsregel.

Illustratives Beispiel · ein Auftrag über 100 €, keine gemessenen Werte

„Darf das weg?“ bekommt Kontext.

WAS FACET HIER NICHT TUT

Ein Hinweis ist noch kein Urteil.

FACET fordert zur Prüfung auf. Ob ein Fehler vorliegt, müssen Review und Tests klären.