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?
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
// @facet: checkout/pricing/tax-rate-by-country// @facet-role: primaryfunc RateFor(country string) Rate { … }
// @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.
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.