
# Interaktivní Mermaid‑řízený řídicí panel pro prokazování důkazů při auditu dotazníků v reálném čase

## Úvod  

Bezpečnostní dotazníky, souladové audity a hodnocení rizik dodavatelů byly tradičně úzkými místy pro rychle se rozvíjející SaaS společnosti. Zatímco AI může během několika vteřin vytvořit odpovědi, auditoři a interní recenzenti se stále ptají: *„Odkud tato odpověď pochází? Změnila se od posledního auditu?“* Odpověď spočívá v **prokazování důkazů** — schopnosti sledovat každou odpověď zpět k jejímu zdroji, verzi a schvalovacímu řetězci.

Procurize představuje generaci funkčností, která zavádí **interaktivní Mermaid‑dashboard**, jež v reálném čase vizualizuje prokazování důkazů. Dashboard je poháněn **Dynamickým znalostním grafem souladu (DCKG)**, neustále synchronizovaným s úložišti politik, repozitáři dokumentů a externími zdroji souladu. Zobrazením grafu jako intuitivního Mermaid‑diagramu mohou bezpečnostní týmy:

* **Navigovat** v genealogii každé odpovědi jedním kliknutím.
* **Validovat** čerstvost důkazů pomocí automatizovaných upozornění na odchylky politik.
* **Exportovat** audit‑připravené snímky, které vkládají vizuální prokazování do zpráv o souladu.

Níže jsou podrobně popsány architektura, Mermaid model, integrační vzory a osvědčené postupy nasazení.

---

## 1. Proč je prokazování důležitý u automatizovaných dotazníků  

| Bod bolesti | Tradiční řešení | Zbývající riziko |
|------------|--------------------|---------------|
| **Zastaralost odpovědí** | Manuální poznámky „poslední aktualizace“ | Přehlednuté změny politik |
| **Nejasný zdroj** | Textové poznámky pod čarou | Auditoři nemohou ověřit |
| **Chaos ve verzování** | Samostatné Git repozitáře pro dokumenty | Nekonzistentní snímky |
| **Zátěž spolupráce** | E‑mailová vlákna o schváleních | Ztracená schválení, duplicitní práce |

Prokazování eliminuje tyto mezery tím, že **sváže každou AI‑generovanou odpověď s unikátním uzlem důkazu** v grafu, který zaznamenává:

* **Zdrojový dokument** (politika, externí potvrzení, kontrolní důkaz)
* **Hash verze** (kryptografický otisk zajišťující nezměnitelnost)
* **Majitel / Schvalující** (identita člověka nebo bota)
* **Časové razítko** (automatický UTC čas)
* **Flag odchylky politiky** (vytvořený Real‑Time Drift Engine)

Když auditor klikne na odpověď v dashboardu, systém okamžitě rozbalí uzel a odhalí veškerá výše uvedená metadata.

---

## 2. Základní architektura  

Níže je vysoce‑úrovňový Mermaid diagram pipeline pro prokazování. Diagram používá **uzly s dvojitými uvozovkami** podle specifikace.

```mermaid
graph TD
    subgraph AI Engine
        A["LLM Answer Generator"]
        B["Prompt Manager"]
    end
    subgraph Knowledge Graph
        KG["Dynamic Compliance KG"]
        V["Evidence Version Store"]
        D["Drift Detection Service"]
    end
    subgraph UI Layer
        UI["Interactive Mermaid Dashboard"]
        C["Audit Export Service"]
    end
    subgraph Integrations
        R["Policy Repo (Git)"]
        S["Document Store (S3)"]
        M["External Compliance Feed"]
    end

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

**Klíčové toky**

1. **Prompt Manager** vybírá kontextově‑citlivý prompt, který odkazuje na relevantní uzly KG.
2. **LLM Answer Generator** vytvoří návrh odpovědi.
3. Odpověď je **zaregistrována** v KG jako nový *Answer Node* s hranami na podkladové *Evidence Nodes*.
4. **Evidence Version Store** zapíše kryptografický hash každého zdrojového dokumentu.
5. **Drift Detection Service** neustále porovnává uložené hashe s aktuálními snímky politik; jakákoliv neshoda automaticky označí odpověď ke kontrole.
6. **Interaktivní dashboard** čte KG přes GraphQL endpoint a renderuje Mermaid kód za běhu.
7. **Audit Export Service** balí aktuální Mermaid SVG, provenance JSON a text odpovědi do jednoho PDF balíčku.

---

## 3. Vytváření Mermaid dashboardu  

### 3.1 Transformace dat‑na‑diagram  

UI vrstva dotazuje KG pro konkrétní ID dotazníku. Odpověď zahrnuje vnořenou strukturu:

```json
{
  "questionId": "Q-101",
  "answer": "We encrypt data at rest using 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
    }
  ]
}
```

**Klientský renderer** převádí každou položku evidence na Mermaid podgraf:

```mermaid
graph LR
    A["Answer Q‑101"] --> E1["policy‑iso27001"]
    A --> E2["cloud‑kbs‑report"]
    E1 -->|hash: 0x9f2c| H1["Hash"]
    E2 -->|hash: 0x4c1a| H2["Hash"]
    E2 -->|drift| D["⚠️ Drift Detected"]
```

UI překrývá vizuální pomůcky:

* **Zelený uzel** — evidence aktuální.
* **Červený uzel** — odchylka detekována.
* **Ikona zámku** — kryptografický hash ověřen.

> **Poznámka:** Odkaz na *policy‑iso27001* se vztahuje ke standardu ISO 27001 — viz oficiální specifikace: [ISO 27001](https://www.iso.org/standard/27001).

### 3.2 Interaktivní funkce  

| Funkce | Interakce | Výsledek |
|--------|-----------|----------|
| **Kliknutí na uzel** | Kliknutí na jakýkoliv uzel evidence | Otevře modální okno s náhledem dokumentu, rozdílem verzí a komentáři ke schválení |
| **Přepínač zobrazení odchylek** | Přepínač v panelu nástrojů | Zvýrazní jen uzly s `drift = true` |
| **Export snímku** | Kliknutí na tlačítko “Export” | Vytvoří SVG + JSON balíček pro auditory |
| **Vyhledávání** | Zadání ID dokumentu nebo e‑mailu vlastníka | Automaticky zaměří odpovídající podgraf |

Všechny interakce jsou **pouze na klientovi**, čímž se eliminuje potřeba dalších round‑tripů. Podkladový Mermaid kód je uložen v skrytém `<textarea>` pro snadné kopírování.

---

## 4. Integrace prokazování do stávajících pracovních postupů  

### 4.1 CI/CD gate pro soulad  

Přidejte krok do pipeline, který **zastaví build**, pokud má některá odpověď v připravované verzi nezrušený drift flag. Pří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 Upozornění v Slacku / Teams  

Nakonfigurujte **Drift Detection Service**, aby při detekci odchylky poslal stručný Mermaid úryvek do kanálu. Podporovaní boty automaticky renderují diagram, čímž bezpečnostní vedoucí získají okamžitý přehled.

### 4.3 Automatizace právního schválení  

Právní týmy mohou přidat **hranu “Legal Sign‑Off”** k uzlům evidence. Dashboard poté zobrazuje ikonu zámku u uzlu, což signalizuje, že důkaz prošel právním kontrolním seznamem.

---

## 5. Bezpečnostní a soukromí‑související úvahy  

| Obava | Mitigace |
|-------|----------|
| **Zveřejnění citlivých dokumentů** | Ukládejte surové dokumenty v šifrovaných S3 bucket‑ech; dashboard zobrazuje jen metadata a hash, ne celé soubory. |
| **Zneužití provenance dat** | Používejte podpisy ve stylu **EIP‑712** pro každou transakci grafu; jakákoliv úprava neplatí hash. |
| **Umístění dat** | Nasazujte KG a úložiště důkazů ve stejné oblasti jako hlavní data souhlasu (EU, US‑East, atd.). |
| **Řízení přístupu** | Využijte RBAC model Procurize: jen uživatelé s `provenance:read` mohou vidět dashboard; `provenance:edit` je vyžadováno pro schvalování. |

---

## 6. Reálný dopad: případová studie  

**Společnost:** SecureFinTech Ltd.  
**Scénář:** Čtvrtletní **[SOC 2](https://secureframe.com/hub/soc-2/what-is-soc-2)** audit vyžadoval důkazy pro 182 šifrovací kontroly.  
**Před dashboardem:** Manuální sběr trval 12 dnů; auditoři pochybovali o čerstvosti důkazů.  
**Po nasazení dashboardu:**  

| Metrika | Základ | S dashboardem |
|---------|--------|----------------|
| Průměrná doba tvorby odpovědi | 4,2 hodiny | **1,1 hodiny** |
| Přepočet kvůli odchylkám | 28 % odpovědí | **3 %** |
| Skóre spokojenosti auditorů (1‑5) | 2,8 | **4,7** |
| Čas na export auditního balíčku | 6 hodin | **45 minut** |

Prokazování vizualizace snížilo dobu přípravy auditů o **70 %** a automatizovaná upozornění na drift ušetřila odhadovaných **160 osobních hodin ročně**.

---

## 7. Krok‑za‑krokem průvodce implementací  

1. **Povolte synchronizaci Knowledge Graph** – propojte svůj Git repozitář politik, úložiště dokumentů a externí feedy v nastavení Procurize.  
2. **Aktivujte Provenance Service** – zapněte „Evidence Versioning & Drift Detection“ v administrativní konzoli platformy.  
3. **Nastavte Mermaid dashboard** – přidejte `dashboard.provenance.enabled = true` do konfiguračního souboru `procurize.yaml`.  
4. **Definujte schvalovací workflow** – použijte “Workflow Builder” k přiřazení kroků “Legal Sign‑Off” a “Security Owner” ke každému uzlu evidence.  
5. **Školení týmů** – uspořádejte 30‑minutovou live demo se zaměřením na interakci s uzly, řešení driftů a exportní procesy.  
6. **Embed do auditorních portálů** – použijte následující IFrame kód k vložení dashboardu do externího auditorního portálu.

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

7. **Sledujte metriky** – na analytickém dashboardu Procurize monitorujte „Drift Events“, „Export Count“ a „Avg. Answer Time“, abyste kvantifikovali návratnost investice.

---

## 8. Budoucí vylepšení  

| Položka v plánu | Popis |
|-----------------|-------|
| **Predikce driftu pomocí AI** | Využití LLM‑analyz trendů změn politik pro předvídání odchylek dříve, než nastanou. |
| **Sdílení provenance napříč tenanty** | Federovaný režim KG, který umožní partnerským společnostem prohlížet sdílené důkazy bez odhalení surových dokumentů. |
| **Navigace hlasovým ovládáním** | Integrace s Procurize Voice Assistant, aby recenzenti mohli říct „Ukaž mi zdroj odpovědi 34“. |
| **Live kolaborace** | Real‑time multi‑uživatelské editování uzlů evidence s indikátory přítomnosti přímo v Mermaid diagramu. |

---

## 9. Závěr  

**Interaktivní Mermaid‑řízený řídicí panel pro prokazování důkazů** od Procurize proměňuje nejasný svět automatizace bezpečnostních dotazníků v transparentní, auditovatelný a spolupracovní zážitek. Spojením AI‑generovaných odpovědí s živým grafem souladu získávají organizace **okamžitý přehled o genealogii**, **automatizované zmírnění driftu** a **audit‑připravené artefakty** — a to vše bez kompromisu rychlosti.

Nasazení této vizuální vrstvy prokazování nejenže zkracuje cykly auditu, ale také buduje důvěru mezi regulátory, partnery a zákazníky, že vaše bezpečnostní tvrzení jsou **podložena neměnnými, real‑time důkazy**.