Evidence Bundle • ZIP • manifest CSV i JSON

Pakiet dowodów do oceny ryzyka maszyny
każdy plik połączony z konkretną decyzją

Zdjęcie zagrożenia, raport walidacyjny i protokół testu mają wartość dopiero wtedy, gdy wiadomo, czego dotyczą. Safety Software pozwala przypinać dowody bezpośrednio do oceny ryzyka, zagrożenia, scenariusza albo środka ochronnego. Indeks projektu zbiera te powiązania, a Evidence Bundle eksportuje materiał w jednym pliku ZIP razem z manifestami CSV i JSON.

Zbuduj pakiet dowodów Zobacz zawartość pakietu

Dowody w ocenie ryzyka to coś więcej niż folder z załącznikami.

Końcowy raport pokazuje wynik procesu, ale podczas przeglądu technicznego liczy się również materiał, na którym oparto decyzje: zdjęcia stref niebezpiecznych, dokumenty techniczne, raporty SISTEMA, raporty walidacyjne oraz protokoły testów. Bez powiązania z konkretną oceną, zagrożeniem, scenariuszem lub środkiem ochronnym nawet poprawny plik może być trudny do odnalezienia i zinterpretowania.

Evidence Bundle tworzy dokumentację dowodową z relacji zapisanych w procesie. Jeden indeks projektu porządkuje pliki i ich kontekst, a eksport ZIP przekazuje je razem z czytelnym manifestem. Pakiet nie certyfikuje maszyny, nie sprawdza poprawności decyzji technicznych i nie stanowi automatycznej gwarancji zgodności. Pomaga zebrać oraz przedstawić materiały, które zespół wcześniej zweryfikował.

Materiał dowodowy pozostaje przy elemencie procesu, którego rzeczywiście dotyczy

Pakiet przenosi pliki razem z ich kontekstem.

To konkretne elementy eksportu, a nie estymacje oszczędności: cztery poziomy powiązania dowodu, jedno archiwum oraz dwa formaty manifestu do przeglądania przez człowieka lub dalszego przetwarzania.

4 konteksty
ocena ryzyka, zagrożenie, scenariusz i środek ochronny
▲ UP
1 ZIP
obrazy, dokumenty i manifesty zebrane w paczce projektu
▲ UP
2 manifesty
manifest.csv oraz manifest.json opisujące zawartość eksportu
▲ UP 
evidence_link:
  entity_type: protective_measure
  source_stage: risk_reduction
  document_type: validation_report
  caption: test_blokady_oslony
Dowód przy decyzji

Dodawaj materiał tam, gdzie powstaje jego znaczenie.

Dowód można powiązać bezpośrednio z oceną ryzyka, zagrożeniem, scenariuszem ISO 12100 albo środkiem ochronnym. Razem z plikiem system przechowuje między innymi rodzaj dokumentu, etap procesu, opis oraz czas dodania.

Takie powiązanie ogranicza problem plików o podobnych nazwach i materiałów wyrwanych z kontekstu. Osoba przeglądająca projekt widzi nie tylko załącznik, ale również element oceny, do którego został przypisany.

  • zdjęcia i dokumenty przy ocenie ryzyka lub zagrożeniu
  • materiały przy scenariuszu sytuacji zagrożenia
  • raporty walidacyjne i protokoły przy środku ochronnym
Indeks dowodów projektu

Jeden widok zbiera dowody z całego procesu oceny ryzyka.

Indeks projektu łączy materiały dodane do ocen ryzyka, zagrożeń, scenariuszy i środków ochronnych. Obejmuje również starsze zdjęcia zagrożeń oraz pliki środków ochronnych, dzięki czemu dowody pozostają widoczne w jednym miejscu.

Indeks usuwa powtórzenia wynikające z tego samego pliku źródłowego i zachowuje informacje potrzebne do zbudowania paczki: ocenę, typ encji, identyfikator, podpis, typ dokumentu, nazwę oraz dane techniczne pliku.

  • wspólny indeks materiałów z projektu
  • kontekst konkretnej oceny i elementu procesu
  • oddzielenie obrazów od pozostałych dokumentów w eksporcie
project_evidence_index:
  assessment: RA-24
  entity: hazard-87
  document_type: photo
  caption: strefa_podajnika
  source_stage: risk_identification
bundle_scope:
  project_id: 42
  risk_assessment_id: 24
  output: project-42-evidence.zip
Zakres eksportu

Pobierz cały projekt albo dowody jednej oceny ryzyka.

Evidence Bundle może objąć pełny indeks dowodów projektu. Gdy potrzebny jest węższy materiał, eksport może zostać ograniczony do jednej wskazanej oceny ryzyka.

To przydatne, gdy projekt zawiera kilka wersji lub kilka ocen, a do przeglądu, przekazania klientowi albo pracy wewnętrznej potrzebny jest tylko konkretny zakres. Dostępność eksportu i wymagany zakres zależą od uprawnień oraz posiadanego planu.

  • pakiet dowodów dla całego projektu
  • pakiet ograniczony do jednej oceny ryzyka
  • kontrola dostępu i uprawnień przed pobraniem
Manifest powiązań

Odbiorca dostaje listę plików i informację, skąd każdy z nich pochodzi.

W archiwum znajdują się dwa równoległe manifesty: CSV do szybkiego otwarcia w narzędziu tabelarycznym oraz JSON do integracji i automatycznego przetwarzania. Oba opisują tę samą zawartość pakietu.

Wiersz manifestu może wskazywać status pliku, ścieżkę w ZIP, nazwę oryginalną, rodzaj dokumentu, typ oraz identyfikator elementu procesu, identyfikator oceny, podpis, typ MIME, rozmiar i datę utworzenia.

  • manifest.csv do przeglądu tabelarycznego
  • manifest.json do przetwarzania maszynowego
  • status oraz kontekst każdego rekordu w paczce
manifest_row:
  status: included
  zip_path: project-42-evidence/documents/RA-24_protective-measure-19_report.pdf
  entity_type: protective_measure
  entity_id: 19
  assessment_id: 24

Od pliku źródłowego do czytelnego kontekstu technicznego

Matryca pokazuje, co warto wiedzieć o materiale dowodowym oraz jak ta informacja zostaje zachowana w indeksie i eksporcie.

Pytanie podczas przeglądu
Informacja w Evidence Bundle
Czego dotyczy dowód?
Czy plik opisuje całą ocenę, zagrożenie, scenariusz czy konkretny środek ochronny?
Typ encji, jej identyfikator oraz identyfikator oceny wskazują kontekst rekordu.
Jaki to materiał?
Zdjęcie, dokument techniczny, raport SISTEMA, raport walidacyjny czy protokół testu?
Rodzaj dokumentu, nazwa oryginalna, typ MIME oraz opis zostają zapisane przy pozycji.
Na jakim etapie powstał?
Identyfikacja ryzyka, redukcja ryzyka czy przygotowanie dokumentacji?
Etap źródłowy pozostaje częścią relacji dowodu w indeksie projektu.
Czy plik znalazł się w paczce?
Odbiorca powinien wiedzieć, czy wskazany materiał został rzeczywiście dołączony.
Pole status w manifeście rozróżnia plik dołączony od brakującego pliku źródłowego.
Jak odnaleźć materiał?
Sama oryginalna nazwa może nie wystarczyć przy wielu podobnych plikach.
Manifest podaje ścieżkę w ZIP, a nazwa w paczce zawiera ocenę i kontekst elementu procesu.

Dokumentacja dowodowa powstaje razem z oceną ryzyka.

Najlepszy pakiet nie jest folderem skompletowanym po zakończeniu projektu. Powstaje wtedy, gdy zespół przypisuje zweryfikowany materiał do decyzji technicznych w toku pracy.

Dokumentacja dowodowa powstaje razem z oceną ryzyka. Os czasu z 5 wydarzeniami compliance. 1 — dodanie pliku przy ocenie, zagrożeniu, scenariuszu lub środku ochronnym 1 dodaj dowód 2 — opisanie rodzaju dokumentu, etapu procesu i kontekstu 2 opisz kontekst 3 — zebranie relacji w indeksie dowodów projektu 3 indeks projektu 4 — wybór całego projektu albo pojedynczej oceny ryzyka 4 wybierz zakres 5 — pobranie archiwum ZIP z manifestem CSV i JSON 5 pobierz pakiet

Folder z plikami a pakiet dowodów z kontekstem

Różnica nie polega wyłącznie na formacie ZIP. Evidence Bundle zachowuje relacje między materiałem a elementami oceny ryzyka.

Folder i ręczna lista Evidence Bundle
Powiązanie z oceną ryzyka wynika z nazwy katalogu lub pamięci autora identyfikator oceny jest zapisany przy rekordzie manifestu
Powiązanie z decyzją techniczną opisane w nazwie pliku albo osobnej tabeli typ i identyfikator zagrożenia, scenariusza lub środka ochronnego
Rodzaj dokumentu rozpoznawany ręcznie pole document_type w relacji i manifeście
Zakres przekazania ręczne kopiowanie wybranych katalogów cały projekt albo jedna wskazana ocena ryzyka
Lista zawartości tworzona i aktualizowana osobno manifest.csv oraz manifest.json generowane razem z ZIP
Brakujący plik źródłowy może zostać zauważony dopiero przy otwieraniu rekord manifestu otrzymuje status brakującego pliku

Najczęstsze pytania o pakiet dowodów do oceny ryzyka

Czym jest Evidence Bundle?
Evidence Bundle to eksport materiału dowodowego powiązanego z projektem maszyny. System zbiera pliki z indeksu dowodów, porządkuje obrazy i dokumenty w archiwum ZIP oraz dołącza manifest.csv i manifest.json z kontekstem poszczególnych pozycji.
Do jakich elementów oceny ryzyka można przypisać dowód?
Dowody mogą być powiązane z całą oceną ryzyka, konkretnym zagrożeniem, scenariuszem ISO 12100 albo środkiem ochronnym. Dzięki temu odbiorca widzi, której części procesu dotyczy zdjęcie, dokument techniczny, raport lub protokół.
Jakie rodzaje materiałów można opisać w pakiecie?
Moduł rozróżnia między innymi zdjęcia, dokumenty, dokumenty techniczne, raporty SISTEMA, raporty walidacyjne oraz protokoły testów. Przy pliku można zachować również etap procesu i opis wyjaśniający jego znaczenie.
Czy można pobrać dowody tylko dla jednej oceny ryzyka?
Tak. Eksport może objąć pełny indeks projektu albo zostać ograniczony do jednej wskazanej oceny ryzyka. Wymagany zakres i dostępność funkcji mogą zależeć od planu oraz uprawnień użytkownika.
Co zawierają manifest.csv i manifest.json?
Oba manifesty opisują zawartość tego samego pakietu. Rekord może zawierać status, ścieżkę w ZIP, nazwę oryginalną, rodzaj dokumentu, typ i identyfikator elementu procesu, identyfikator oceny, opis, typ MIME, rozmiar oraz datę utworzenia.
Czy Evidence Bundle gwarantuje zgodność maszyny?
Nie. Pakiet nie certyfikuje maszyny, nie ocenia poprawności dowodów i nie zastępuje odpowiedzialności producenta ani pracy osoby kompetentnej. Porządkuje materiały i ich powiązania, aby ułatwić weryfikację oraz przedstawienie podstaw podjętych decyzji.
Co się dzieje, gdy pliku źródłowego nie można odnaleźć podczas eksportu?
Brakujący plik nie jest dodawany do archiwum. Jego rekord pozostaje jednak w manifeście ze statusem wskazującym brak, dzięki czemu problem jest widoczny zamiast zostać pominięty bez informacji.

Zamień folder załączników w pakiet dowodów z kontekstem.

Zacznij od jednej oceny ryzyka. Powiąż zdjęcia, raporty i protokoły z zagrożeniami, scenariuszami oraz środkami ochronnymi, a następnie pobierz jeden ZIP z manifestem zawartości.

Uruchom Evidence Bundle

Pakiet porządkuje materiały dowodowe, ale nie zastępuje ich merytorycznej weryfikacji ani odpowiedzialności producenta.

Praktyczne artykuły o ocenie ryzyka, dyrektywach i compliance — uzupełnienie tego produktu.