Facet
EnglishInstallieren

FÜR TEAMS MIT GEWACHSENEN SYSTEMEN

Keiner will an die Preislogik ran. Und jeder muss irgendwann.

Zwölf Jahre alt, drei Autoren, null Kommentare. FACET hilft euch, Stück für Stück aufzuschreiben, was ein Bereich wirklich tut — dort, wo die nächste Änderung ohnehin ansteht, nicht als Doku-Projekt für den ganzen Monolithen.

DOMÄNE

  • checkout
  • inventorynoch nicht beschrieben
  • shippingnoch nicht beschrieben
  • accountsnoch nicht beschrieben

FÄHIGKEIT

  • pricing
  • cartnoch nicht beschrieben
  • paymentnoch nicht beschrieben

FEATURE

  • tax-rate-by-country2 Szenarien
  • roundingnoch nicht beschrieben

Die Id, die daraus entsteht: checkout/pricing/tax-rate-by-country

Illustratives Beispiel · ein Bereich, nicht der ganze Monolith

DER EINSTIEG

Nicht der ganze Monolith. Nur die Stelle, die ihr nächste Woche anfasst.

Niemand muss erst alles beschreiben. Ihr fangt dort an, wo die nächste Änderung ohnehin Kopfzerbrechen macht: eine Frage, die Antwort darauf, die Code-Stelle und der Test dazu.

Welcher Steuersatz gilt bei einem Länderwechsel?

RECORDcheckout/pricing/tax-rate-by-country.yaml
id: checkout/pricing/tax-rate-by-countrycontract:  scenarios:    - id: country-change-uses-destination-rate      given: a cart priced for DE      when: the shipping country changes to AT      then: the AT rate applies to every line
CODEsrc/pricing/tax.go
// @facet: checkout/pricing/tax-rate-by-country// @facet-role: primaryfunc RateFor(country string) Rate { … }
TESTsrc/pricing/tax_test.go
// @facet: checkout/pricing/tax-rate-by-country// @facet-proves: country-change-uses-destination-ratefunc TestCountryChangeUsesDestinationRate(t *testing.T) { … }

Illustratives Beispiel · Regel, Code und Test tragen dieselbe Feature-Id

WAS BLEIBT

Heute tagelang graben. Beim nächsten Mal nachlesen.

Die nächste Person findet, warum die Preislogik so ist, direkt neben dem Code. Besonders wertvoll, wenn die Geschichte eines Systems nur noch in zwei, drei Köpfen steckt.

REPOSITORYdocs/facets/
docs/facets/  taxonomy.yaml  features/    checkout/      pricing/        tax-rate-by-country.yamlsrc/pricing/  tax.go        @facet: checkout/pricing/tax-rate-by-country  tax_test.go   @facet: checkout/pricing/tax-rate-by-country                @facet-proves: country-change-uses-destination-rate

Illustratives Beispiel · facet lint prüft Records gegen ihr Schema und gegen den Code, den sie verankern — auch nach der nächsten Änderung

WAS FACET HIER NICHT TUT

Ein Bereich. Ein begrenzter Versuch.

FACET rekonstruiert keine unbekannte Absicht. Offene Fachfragen brauchen Menschen.