Facet
EnglishInstallieren

STANDARDS

FACET baut auf Standards, die Ihr Team vielleicht schon kennt.

FACET erfindet keine Notation, wo es eine gute gibt. Szenarien lesen sich wie Gherkin, Ids folgen dem Domänenmodell, Regeln verweisen auf DMN, und jeder Record wird gegen JSON Schema geprüft.

  • Gherkin

    Ein Format in Alltagssprache, das Verhalten an konkreten Beispielen beschreibt: Given ein Ausgangszustand, When etwas geschieht, Then ein beobachtbares Ergebnis.

    IN FACET

    Jedes Szenario unter contract.scenarios ist eine Given-/When-/Then-Aussage, ein Szenario je Regel oder Grenzfall, jeder Schritt auf eigener Zeile (FACET §3.2Originalauszug aus der englischen Quelle.[…] The normative behavior of the feature — the rules that MUST hold. […]Auf GitHub öffnen). Fälle derselben Regel werden zu einer Scenario Outline mit Beispieltabellen (FACET §3.2.3Originalauszug aus der englischen Quelle.[…] MUST NOT flatten them into set notation or a list inside one Given/When/Then. […]Auf GitHub öffnen).

  • Domain-Driven Design

    Ein Ansatz, den Eric Evans in seinem gleichnamigen Buch benannt hat: Software wird an der Fachdomäne ausgerichtet und an der Sprache der Menschen, die sie kennen.

    IN FACET

    Jede Id lautet domain/capability/feature, und die Domäne ist eine Produktdomäne, nie ein Team oder ein Service (FACET §2.2Originalauszug aus der englischen Quelle.[…] Every feature has a canonical, stable identifier of the form: […]Auf GitHub öffnen). Eine Taxonomie kann Domänen und Fähigkeiten als core, supporting oder generic einordnen, Evans' Subdomänen in seinen Worten (FACET §4.4.2Originalauszug aus der englischen Quelle.[…] it is orthogonal to depth. […]Auf GitHub öffnen). Ein Glossar definiert jeden Fachbegriff genau einmal (FACET §4.5Originalauszug aus der englischen Quelle.[…] Records are written in a product's own vocabulary, and a term of art appears in many of them […]Auf GitHub öffnen).

  • DMN

    Decision Model and Notation, der OMG-Standard für Entscheidungstabellen und Geschäftsformeln.

    IN FACET

    contract.business_rules verweist auf eine Entscheidung oder Formel in einer .dmn-Datei. Der Record hält den Verweis, nie eine Kopie der Logik (FACET §3.2.4Originalauszug aus der englischen Quelle.[…] The business rules and formulas a feature applies […]Auf GitHub öffnen).

  • JSON Schema

    Ein Vokabular, mit dem sich die Form von JSON- und YAML-Dokumenten beschreiben und prüfen lässt.

    IN FACET

    Records, Taxonomie und Glossar werden gegen Schemas nach draft-07 geprüft. Ein Record, der sein Schema verletzt, ist ein Lint-Fehler (FACET §11.2Originalauszug aus der englischen Quelle.[…] YAML record fails schema […]Auf GitHub öffnen).

Die Abschnittsnummern beziehen sich auf die FACETOriginalauszug aus der englischen Quelle.[…] a named, coherent capability of the product that can be reasoned about, changed, and owned independently. […]Auf GitHub öffnen.