
# Interaktívny mermaid‑založený dashboard pôvodu dôkazov pre auditovanie dotazníkov v reálnom čase

## Úvod  

Bezpečnostné dotazníky, audity súladu a hodnotenia rizík dodávateľov boli tradične úzkymi hrdlami pre rýchlo sa rozvíjajúce SaaS spoločnosti. Zatiaľ čo AI dokáže v priebehu sekúnd vypracovať odpovede, audítori a interní kontrolóri sa stále pýtajú: *„Odkiaľ tá odpoveď pochádza? Zmenila sa od posledného auditu?“* Odpoveď sa skrýva v **poche pôvodu dôkazov** — v schopnosti vystopovať každú reakciu späť k jej zdroju, verzii a schvaľovaciemu reťazcu.

Procurize predstavuje najnovšiu sadu funkcií s **interaktívnym Mermaid dashboardom**, ktorý vizualizuje pôvod dôkazov v reálnom čase. Dashboard je poháňaný **Dynamickým grafom znalostí súladu (DCKG)**, ktorý je neustále synchronizovaný s úložiskami politík, dokumentovými repozitármi a externými zdrojmi súladu. Renderovaním grafu ako intuitívneho Mermaid diagramu môžu bezpečnostné tímy:

* **Navigovať** lineárny pôvod každej odpovede jediným kliknutím.
* **Overiť** aktuálnosť dôkazov pomocou automatických upozornení na odchýlky politík.
* **Exportovať** audit‑pripravené snímky, ktoré zakomponujú vizuálny pôvod do správ o súlade.

Nasledujúce sekcie rozoberajú architektúru, Mermaid model, integračné vzory a najlepšie postupy pri nasadzovaní.

---

## 1. Prečo je pôvod dôkazov dôležitý pri automatizovaných dotazníkoch  

| Problém | Tradičné riešenie | Zvyšné riziko |
|------------|--------------------|---------------|
| **Zastaralá odpoveď** | Manuálna poznámka „posledná aktualizácia“ | Prehliadnuté zmeny v politike |
| **Nepriehľadný zdroj** | Textové poznámky pod čiarou | Audítori nemôžu overiť |
| **Chaos verzovania** | Samostatné Git repozitáre pre dokumenty | Nekonzistentné snímky |
| **Náročná spolupráca** | E‑mailové vlákna o schválení | Stratené schválenia, duplikovaná práca |

Pôvod dôkazov eliminuje tieto medzery tým, že **spája každú AI‑generovanú odpoveď s jedinečným uzlom dôkazu** v grafe, ktorý zaznamenáva:

* **Zdrojový dokument** (politika, externá atestácia, kontrolný dôkaz)
* **Verzia – hash** (kryptografický odtlačok zabezpečujúci nemennosť)
* **Majiteľ / Schvaľovateľ** (identita človeka alebo bota)
* **Časové razítko** (automatický UTC čas)
* **Značka odchýlky politiky** (generovaná Real‑Time Drift Engine)

Keď audítor klikne na odpoveď v dashboarde, systém okamžite rozbalí uzol a zobrazí všetky vyššie uvedené metadáta.

---

## 2. Hlavná architektúra  

Nižšie je vysoká úroveň Mermaid diagramu pôvodného pipeline. Diagram používa **dvojité úvodzovky okolo popisov uzlov** podľa špecifikácie.

```mermaid
graph TD
    subgraph "AI engine"
        A["Generátor odpovedí LLM"]
        B["Správca výziev"]
    end
    subgraph "Graf znalostí"
        KG["Dynamický súlad KG"]
        V["Úložisko verzií dôkazov"]
        D["Služba detekcie odchýlok"]
    end
    subgraph "Vrstva UI"
        UI["Interaktívny Mermaid dashboard"]
        C["Služba exportu auditu"]
    end
    subgraph "Integrácie"
        R["Repozitár politík (Git)"]
        S["Úložisko dokumentov (S3)"]
        M["Externý prúd súladu"]
    end

    B --> A
    A --> KG
    KG --> V
    V --> D
    D --> KG
    KG --> UI
    UI --> C
    R --> V
    S --> V
    M --> KG
```

**Kľúčové toky**

1. **Správca výziev** vyberá kontextovo relevantnú výzvu, ktorá odkazuje na príslušné uzly KG.
2. **Generátor odpovedí LLM** vytvorí návrh odpovede.
3. Odpoveď sa **zaregistruje** v KG ako nový *Uzol odpovede* s hranami na podkladové *Uzly dôkazov*.
4. **Úložisko verzií dôkazov** zapíše kryptografický hash každého zdrojového dokumentu.
5. **Služba detekcie odchýlok** neustále porovnáva uložené hashe s aktuálnymi snímkami politík; akákoľvek nezhoda automaticky označí odpoveď na revíziu.
6. **Interaktívny dashboard** číta KG prostredníctvom GraphQL endpointu a renderuje Mermaid kód „na‑let“.
7. **Služba exportu auditu** zabalí aktuálny Mermaid SVG, provenance JSON a text odpovede do jedného PDF balíka.

---

## 3. Vytváranie Mermaid dashboardu  

### 3.1 Transformácia dát → diagram  

UI vrstva dotazuje KG pre konkrétne ID dotazníka. Odpoveď obsahuje vnorenú štruktúru:

```json
{
  "questionId": "Q-101",
  "answer": "Šifrujeme dáta v pokoji pomocou AES‑256.",
  "evidence": [
    {
      "docId": "policy-iso27001",
      "versionHash": "0x9f2c...",
      "approvedBy": "alice@example.com",
      "timestamp": "2025-11-20T14:32:00Z",
      "drift": false
    },
    {
      "docId": "cloud‑kbs‑report",
      "versionHash": "0x4c1a...",
      "approvedBy": "bob@example.com",
      "timestamp": "2025-09-05T09:10:00Z",
      "drift": true
    }
  ]
}
```

**Klientska renderovacia funkcia** konvertuje každú položku dôkazu na pod‑graf Mermaid:

```mermaid
graph LR
    A["Odpoveď Q‑101"] --> E1["policy‑iso27001"]
    A --> E2["cloud‑kbs‑report"]
    E1 -->|hash: 0x9f2c| H1["Hash"]
    E2 -->|hash: 0x4c1a| H2["Hash"]
    E2 -->|odchýlka| D["⚠️ Detekovaná odchýlka"]
```

UI pridáva vizuálne indície:

* **Zelený uzol** — dôkaz je aktuálny.
* **Červený uzol** — detekovaná odchýlka.
* **Ikona zámku** — kryptografický hash overený.

> **Poznámka:** Odkaz na *policy‑iso27001* sa vzťahuje na štandard ISO 27001 — pre podrobnosti pozrite oficiálnu špecifikáciu: [ISO 27001](https://www.iso.org/standard/27001).

### 3.2 Interaktívne funkcie  

| Funkcia | Interakcia | Výsledok |
|---------|------------|----------|
| **Kliknutie na uzol** | Kliknutie na akýkoľvek uzol dôkazu | Otvorí modálne okno s úplným náhľadom dokumentu, rozdielom verzií a komentármi schvaľovania |
| **Prepínač zobrazenia odchýlok** | Prepínač v paneli nástrojov | Zvýrazní len uzly, kde `drift = true` |
| **Export snímky** | Kliknutie na tlačidlo „Export“ | Vygeneruje SVG + JSON balík pôvodu pre audítorov |
| **Vyhľadávanie** | Zadajte ID dokumentu alebo e‑mail schvaľovateľa | Automaticky zameria príslušný pod‑graf |

Všetky interakcie prebiehajú **na strane klienta**, čím sa eliminuje potreba ďalších round‑tripov. Mermaid kód je uložený v skrytom `<textarea>` pre jednoduché kopírovanie.

---

## 4. Integrácia pôvodu do existujúcich pracovných postupov  

### 4.1 CI/CD brána súladu  

Pridajte krok do CI pipeline, ktorý **zlyhá build**, ak akákoľvek odpoveď v plánovanom vydaní má neodstránenú značku odchýlky. Príklad GitHub Action:

```yaml
name: Evidence Provenance Gate
on: [pull_request]
jobs:
  provenance-check:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Run Drift Scanner
        run: |
          curl -s https://api.procurize.io/drift?pr=${{ github.event.pull_request.number }} \
          | jq '.drifted | length > 0' && exit 1 || exit 0
```

### 4.2 Upozornenia v Slack / Teams  

Konfigurujte **Službu detekcie odchýlok**, aby pri každej odchýlke poslala stručný Mermaid úryvok do kanála. Bot automaticky rendruje diagram, čím poskytne vedeniu bezpečnosti okamžitý prehľad.

### 4.3 Automatizácia právneho schvaľovania  

Právne tímy môžu pridať **hranu „Právne schválenie“** k uzlom dôkazov. Dashboard potom zobrazí ikonu zámku na uzle, signalizujúc, že dôkaz prešiel právnou kontrolou.

---

## 5. Bezpečnosť a ochrana súkromia  

| Obava | Riešenie |
|-------|----------|
| **Zverejnenie citlivých dokumentov** | Skladujte surové dokumenty v šifrovaných S3 bucketoch; dashboard zobrazí iba metadáta a hash, nie samotný obsah |
| **Manipulácia s provenance dátami** | Používajte podpisy typu **EIP‑712** pre každú transakciu v grafe; akákoľvek úprava neplatí hash |
| **Rezidencia dát** | Nasadzujte KG a úložisko dôkazov v rovnakej oblasti ako primárne dáta súladu (EU, US‑East, atď.) |
| **Riadenie prístupu** | Využívajte RBAC model Procurize: `provenance:read` pre prezeranie dashboardu, `provenance:edit` pre schvaľovanie |
 
---

## 6. Skutočný dopad: prípadová štúdia  

**Spoločnosť:** SecureFinTech Ltd.  
**Scenár:** Štvrťročný **[SOC 2](https://secureframe.com/hub/soc-2/what-is-soc-2)** audit požadoval dôkazy pre 182 šifrovacie kontroly.  
**Pred dashboardom:** Manuálne zhromažďovanie trvalo 12 dní; audítori spochybňovali aktuálnosť dôkazov.  
**Po nasadení dashboardu:**  

| Metrika | Základná hodnota | S dashboardom |
|---------|------------------|----------------|
| Priemerný čas na odpoveď | 4,2 h | **1,1 h** |
| Re‑work v dôsledku odchýlok | 28 % odpovedí | **3 %** |
| Skóre spokojnosti audítora (1‑5) | 2,8 | **4,7** |
| Čas na export auditu | 6 h | **45 min** |

Dashboard pôvodu dôkazov skrátil čas prípravy auditu o **70 %** a automatické upozornenia na odchýlky ušetrili odhadovaných **160 osobných hodín ročne**.

---

## 7. Krok‑za‑krokom sprievodca implementáciou  

1. **Povoľte synchronizáciu grafu znalostí** – prepojte váš Git repozitár politík, úložisko dokumentov a externé zdroje súladu v nastaveniach Procurize.  
2. **Aktivujte službu provenance** – zapnite „Evidence Versioning & Drift Detection“ v admin konzole platformy.  
3. **Nakonfigurujte Mermaid dashboard** – pridajte `dashboard.provenance.enabled = true` do konfiguračného súboru `procurize.yaml`.  
4. **Definujte pracovné postupy schvaľovania** – použite “Workflow Builder” na priradenie krokov „Právne schválenie“ a „Bezpečnostný owner“ ku každému uzlu dôkazu.  
5. **Školenie tímov** – usporiadajte 30‑minútovú live prezentáciu pokrývajúcu interakciu s uzlami, riešenie odchýlok a exportné postupy.  
6. **Vložte do audítorských portálov** – použite poskytnutý IFrame snippet na hostovanie dashboardu v externom audítorskom portáli.  

```html
<iframe src="https://dashboard.procurize.io/q/2025-Q101"
        width="100%" height="800"
        style="border:none;"></iframe>
```

7. **Sledujte metriky** – monitorujte “Drift Events”, “Export Count” a “Avg. Answer Time” v analytickom dashboarde Procurize a kvantifikujte návratnosť investícií.

---

## 8. Budúce vylepšenia  

| Položka v roadmape | Popis |
|---------------------|-------|
| **Predikcia odchýlok poháňaná AI** | Využitie LLM na trendovú analýzu logov politík a predikciu odchýlok skôr, než nastanú |
| **Zdieľanie pôvodu medzi tenantmi** | Federovaný mód KG, ktorý umožní partnerom vidieť zdieľané dôkazy bez odhaľovania surových dokumentov |
| **Navigácia hlasovým príkazom** | Integrácia s Procurize Voice Assistant, ktorá umožní kontrolárom hovoriť: „Ukáž mi zdroj odpovede 34“. |
| **Live kolaborácia** | Real‑time viac‑užívateľské editovanie uzlov dôkazov s indikátormi prítomnosti, renderované priamo v Mermaid diagramoch |

---

## 9. Záver  

**Interaktívny Mermaid‑dashboard pôvodu dôkazov** od Procurize mení nepriehľadný svet automatizácie bezpečnostných dotazníkov na transparentný, auditovateľný a kolaboratívny zážitok. Spojením AI‑generovaných odpovedí s živým grafom súladu získavajú organizácie **okamžitú viditeľnosť lineárneho pôvodu**, **automatickú mitigáciu odchýlok** a **audit‑pripravené artefakty** — bez toho, aby sa znížila rýchlosť.

Nasadenie tejto vizuálnej vrstvy nie len skracuje cykly auditov, ale aj buduje dôveru medzi regulátormi, partnermi a zákazníkmi, že vaše bezpečnostné tvrdenia sú podložené **nemennými, reálnymi dôkazmi**.