Przejdź do treści

Słownik

Konwencja językowa (BCP 14)

Normy w tym repozytorium stosują słowa kluczowe zgodnie z BCP 14 (RFC 2119, RFC 8174):

Słowo kluczowe Znaczenie
MUSI / MUST Bezwzględny wymóg specyfikacji
NIE MUSI / MUST NOT Bezwzględny zakaz
POWINIEN / SHOULD Silne zalecenie; odstępstwo dopuszczalne z uzasadnieniem
NIE POWINIEN / SHOULD NOT Silne odradzenie
MOŻE / MAY Opcja, element fakultatywny

Słownik domeny

Termin Definicja
Dyscyplina Całość zasad organizacji, wersjonowana semver; jeden spójny produkt
STD (norma) Żywy dokument normatywny — opisuje co obowiązuje; edytowany przez MR
ADR Lekki zapis decyzji architektonicznej; stosowany wyłącznie dla zmian major (łamiących)
Minimum of Done Lista weryfikowalnych kryteriów danej normy
check Pojedyncze kryterium normy (auto / manual) z przypisanym tierem
tier Środowisko, od którego dany check jest blokujący (test < preprod < prod)
waiver / odstępstwo Jawny, terminowy dług zarządzany — zarejestrowana niezgodność z właścicielem i terminem
discipline.yaml Deklaracja aplikacji: pinowana wersja dyscypliny, atestacje, waivery; commitowana do repo
conformance.json Zmierzony wynik zgodności aplikacji; artefakt CI (nie jest commitowany do repo)
bundle Maszynowe wydanie dyscypliny (discipline-X.Y.Z.json); konsumowane przez CI i dashboard
brama środowiskowa Boolean per środowisko: przepuszcza deployment jeśli wymagane checki mają pass \| n/a \| ważny waiver
scorecard Widok agregatowy zgodności aplikacji — dla leada
portfel Widok agregatowy dla całej organizacji — dla zarządu