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 |