Ta strona nie tworzy nowego słownika statusów. Publikuje i wyjaśnia kanon, który już istnieje w kodzie źródłowym portalu (jeden plik, jedna definicja), i mapuje na niego nazwy zaproponowane przez audyt zewnętrzny. Powód: brak jednego, publicznego słownika był zgłoszonym problemem P0 — nabywca aktywa i audytor muszą móc sprawdzić, co dokładnie znaczy każda etykieta statusu na portalu, bez zgadywania.
routes/ip3-status-vocab.js — ta strona go opisuje i tłumaczy, nie zmienia. Doktryna
claim ≤ proof: status nigdy nie może twierdzić więcej niż pokazuje dowód (kod + test + endpoint).
W trakcie prac na portalu pojawiła się realnie fraza „LIVE MVP" — status nieistniejący w kanonie, użyty 88 razy na różnych stronach. Efekt: zielony kolor sugerujący gotowość produkcyjną w miejscu, gdzie dowód sięgał najwyżej statusu MVP. Ten incydent został naprawiony (fraza wypleniona z portalu), ale pokazuje, dlaczego jeden, publiczny, egzekwowalny słownik jest potrzebny — nie jako formalność, tylko jako mechanizm, który uniemożliwia powtórkę tego błędu.
Poniższa tabela jest wiernym odwzorowaniem definicji z routes/ip3-status-vocab.js — kolumna
„definicja" cytuje pole opis z kodu źródłowego, kolumna „ranga" cytuje pole rank
(im wyżej, tym silniejszy claim).
| Status | Definicja (z kodu) | Dozwolone użycie | Ranga | Klasa/kolor |
|---|---|---|---|---|
| LIVE_PROD | Działa produkcyjnie: kod + test + endpoint + monitoring, dane realne. | Tylko dla komponentów z pełnym łańcuchem dowodowym na danych realnych. Najsilniejszy claim w kanonie. | 6 (najwyższa) | phosphor (zielony) |
| LIVE_CONTROLLED | Działa w kontrolowanym PoC / za flagą sterowaną (ACK-gate). | Komponent działa, ale za flagą wymagającą jawnego ACK operatora — nie jest domyślnie włączony ani otwarty. | 5 | cyan |
| LIVE_DEMO | Działa, ale na danych demonstracyjnych/syntetycznych. | Komponent techniczny działa (kod + endpoint), lecz wyłącznie na danych syntetycznych — nigdy nie mieszać z LIVE_PROD. | 4 | amber |
| MVP | Działa częściowo, ograniczony zakres. | Kod + test + endpoint istnieją, ale zakres jest celowo wąski — zawsze z listą znanych ograniczeń (patrz known-limitations). | 3 | amber |
| SCAFFOLD | Szkielet kodu, jeszcze nie funkcja. | Kod istnieje (struktura, interfejsy), ale nie realizuje jeszcze pełnej funkcji — nie sprzedawać jako działającej. | 2 | violet |
| ROADMAP | Specyfikacja, brak funkcji. | Wyłącznie opis planu/kierunku. Zero kodu wykonywalnego dla danej funkcji — nigdy nie prezentować jako dostępne dziś. | 1 | violet |
| GAP | Ryzyko/ograniczenie — nie wolno sprzedawać jako funkcji. | Oznacza świadomie znane ograniczenie lub ryzyko rezydualne. Twarda blokada: element GAP nigdy nie trafia do materiałów sprzedażowych jako zaleta. | 0 (najniższa) | red |
Uwaga techniczna: kod zawiera też LEGACY_MAP — mechanizm normalizacji starszych,
luźnych wartości (np. LIVE, DEMO, PILOT, CONTROLLED_PILOT) do jednego z siedmiu statusów
kanonu powyżej, oraz znacznik NOINDEX — ortogonalny do statusu funkcji, dotyczy wyłącznie indeksowania strony przez wyszukiwarki,
nie stanu komponentu.
Audyt zewnętrzny zaproponował własny zestaw nazw statusów. Poniżej mapujemy każdą z nich na istniejący kanon 7 — nie dodajemy żadnej z nich jako ósmego, obowiązującego statusu. Tam, gdzie nazwa audytu opisuje inny wymiar niż stan techniczny komponentu, oznaczamy to wprost jako osobną oś, a nie status.
| Nazwa z audytu | Mapowanie na kanon | Uzasadnienie |
|---|---|---|
PAGE_LIVE |
Nie jest statusem komponentu — to indeksowanie strony (przeciwieństwo NOINDEX z LEGACY_MAP). |
„Strona jest LIVE (opublikowana, indexable)" mówi tylko, że dokument istnieje i jest publiczny. To osobna oś od tego, czy opisywany na niej komponent ma status LIVE_PROD. Strona ze statusem publikacji „LIVE" może w treści opisywać komponent w statusie ROADMAP. |
DATA_LIVE |
LIVE_DEMO lub LIVE_PROD — zależnie od źródła danych. | „Dane na żywo" musi rozróżniać dane syntetyczne (LIVE_DEMO) od danych realnych (LIVE_PROD) — to dokładnie rozróżnienie, które kanon już wymusza w opisie LIVE_DEMO. |
CONTROLLED_PILOT |
LIVE_CONTROLLED | Bezpośredni odpowiednik — kod źródłowy (LEGACY_MAP) już normalizuje zarówno CONTROLLED, PILOT, jak i CONTROLLED_PILOT do LIVE_CONTROLLED. |
PRODUCTION_RESEARCH |
LIVE_CONTROLLED z notą „kontekst badawczy/PoC" | Nie jest to LIVE_PROD (brak pełnego łańcucha kod+test+endpoint+monitoring na danych realnych w skali produkcyjnej). Najbliższy dopasowany status to LIVE_CONTROLLED — z dopiskiem w treści strony, że kontekst jest badawczy, żeby nie sugerować gotowości produkcyjnej. |
CERTIFICATION_PLANNED |
To nie jest status komponentu — osobna oś: „stan certyfikacji". | Certyfikacja (np. przez jednostkę zewnętrzną) to proces prawny/formalny, niezależny od tego, czy kod działa. Komponent może być LIVE_PROD bez certyfikacji, i odwrotnie. Kanon statusów opisuje stan techniczny, nie stan formalny — mieszanie tych dwóch osi było źródłem overclaimu w przeszłości (patrz zakazane słowo „certyfikacja"). |
EXTERNAL_VALIDATION_PENDING |
Osobna oś: „stan walidacji zewnętrznej". Komponent pod spodem nadal ma swój status z kanonu (np. MVP). | „Czeka na walidację zewnętrzną" to metadana o procesie recenzji/audytu, nie o tym, czy kod działa. Traktowanie tego jako status funkcji zaciera różnicę między „działa i czeka na potwierdzenie z zewnątrz" a „nie działa". |
status: MVP +
certyfikacja: planowana), a nie ósmy status w tej samej kolumnie. To propozycja architektoniczna do
decyzji integratora/operatora — nie jest dziś wdrożona i nie jest używana na żadnej stronie portalu.
Audyt zewnętrzny wskazał konkretne frazy jako ryzykowne (mogące sugerować więcej niż pokazuje dowód). Poniższa tabela łączy każdą frazę z powodem ryzyka i bezpiecznym odpowiednikiem, który już jest używany na portalu.
| Fraza ryzykowna | Dlaczego ryzykowna | Bezpieczny odpowiednik |
|---|---|---|
FULL LIVE |
Sugeruje pełne pokrycie produkcyjne całego portalu/produktu jednym słowem — kanon nie ma pojęcia „pełne LIVE"; każdy komponent ma osobny, weryfikowalny status. | Wymienić konkretne komponenty i ich statusy z kanonu (np. „14 modułów: LIVE_PROD 0, MVP 14, ROADMAP reszta"). |
PRODUCTION READY |
Deklaruje gotowość produkcyjną bez odniesienia do konkretnego dowodu (kod+test+endpoint+monitoring na danych realnych) wymaganego przez definicję LIVE_PROD. | LIVE_PROD — tylko gdy spełnione są wszystkie cztery elementy dowodu z definicji kanonu. |
CERTIFIED |
Zakazane słowo (lint CI) — sugeruje formalną certyfikację przez jednostkę trzecią, której portal nie posiada. | Opisać stan faktyczny bez słowa „certyfikowany": np. „mapowanie na wymagania X jako decision-support, do weryfikacji przez uprawnionego audytora". |
AI Act compliant |
„Zgodny z AI Act" to twierdzenie prawne o pełnej zgodności regulacyjnej — portal nie wydaje takich ocen, bo to domena prawnika/organu nadzoru. | AI Act readiness / alignment support — wsparcie w przygotowaniu, nie deklaracja zgodności. |
Piaskownica LIVE |
Łączy słowo „piaskownica" (środowisko testowe/syntetyczne) ze statusem sugerującym produkcję — sprzeczność wewnętrzna, myląca dla czytelnika. | Research Sandbox (środowisko badawcze, dane syntetyczne) — oddzielone od statusu LIVE_PROD/LIVE_CONTROLLED, które opisują środowiska z realnym ruchem lub kontrolowanym PoC. |
Powyższe frazy są dodatkowo egzekwowane automatycznie przez
tests/ip3-overclaim-lint.js (lista OVERCLAIM w kodzie) — plik z frazą zakazaną bez
kontekstu zaprzeczenia kończy build z błędem.
„LIVE MVP" (88 wystąpień) nie istniał w kanonie, mieszał ranking LIVE_PROD (6) z MVP (3) i sugerował zielonym kolorem gotowość, jakiej dowód nie potwierdzał. Wypleniony — ale mechanizm, który do tego dopuścił (brak jednego egzekwowanego słownika), musiał zostać zaadresowany.
Osoba oceniająca ipIII do przejęcia lub audytu nie zawsze czyta routes/ip3-status-vocab.js.
Jeden publiczny słownik pozwala zweryfikować znaczenie etykiety bez dostępu do repozytorium.
Zielony badge (LIVE_PROD) budzi inne oczekiwania niż fioletowy (ROADMAP) — dlatego przypisanie koloru do statusu musi być stałe i publiczne, nie ustalane ad hoc na każdej stronie.
Ten sam kanon używany na wszystkich stronach portalu umożliwia audytorowi zewnętrznemu zweryfikowanie spójności — czy deklarowany status wszędzie odpowiada tej samej definicji, nie osobnej interpretacji autora danej podstrony.
PAGE_LIVE w terminologii audytu) nie oznacza, że każdy opisywany na niej komponent ma status
LIVE_PROD. Każdy komponent trzeba oceniać osobno, na podstawie własnego
dowodu (kod + test + endpoint), patrz status-matrix.
LEGACY_MAP)
w routes/ip3-status-vocab.js — wyłącznie go dokumentuje i mapuje na niego zewnętrzną terminologię.
Wszelkie propozycje nowych osi metadanych (certyfikacja, walidacja zewnętrzna) są jawnie oznaczone jako
propozycje wymagające decyzji integratora, nie jako wdrożony stan.
Powiązane: macierz statusów wszystkich komponentów → /status-matrix · pełny słownik pojęć portalu → /slownik · pełna lista znanych ograniczeń → /known-limitations · ekosystem narzędzi i komplementarność → /ecosystem.