
# Interaktivna Mermaid‑bazirana nadzorna ploča podrijetla dokaza za revizije upitnika u stvarnom vremenu

## Uvod  

Sigurnosni upitnici, revizije usklađenosti i procjene rizika dobavljača tradicionalno su usko grlo za brze SaaS tvrtke. Dok AI može u sekundi sastaviti odgovore, revizori i interniji pregledavači i dalje pitaju: *„Odakle je došao taj odgovor? Je li se promijenio od posljednje revizije?“* Rješenje leži u **podrijetlu dokaza** — sposobnosti praćenja svakog odgovora natrag do njegovog izvora, verzije i lanca odobrenja.

Procurize‑ova najnovija funkcionalnost uvodi **interaktivnu Mermaid nadzornu ploču** koja u stvarnom vremenu vizualizira podrijetlo dokaza. Ploča je napojena **Dinamičkim grafom znanja usklađenosti (DCKG)**, koji se kontinuirano sinkronizira s pohranama politika, dokumentnim spremištima i vanjskim izvorima usklađenosti. Renderiranjem grafa kao intuitivnog Mermaid dijagrama, sigurnosni timovi mogu:

* **Navigirati** linijom podrijetla svakog odgovora jednim klikom.  
* **Validirati** svježinu dokaza putem automatiziranih upozorenja o pomaku politika.  
* **Izvoziti** audit‑spremne snimke koji ugrađuju vizualno podrijetlo u izvještaje usklađenosti.  

Sljedeći odjeljci razlažu arhitekturu, Mermaid model, obrasce integracije i korake najbolje prakse.

---

## 1. Zašto je podrijetlo važno u automatiziranim upitnicima  

| Problem | Tradicionalno rješenje | Preostali rizik |
|------------|--------------------|---------------|
| **Zastarjelost odgovora** | Ručne bilješke „posljednje ažurirano“ | Propuštene promjene politika |
| **Nejasan izvor** | Tekstualne fusnote | Revizori ne mogu provjeriti |
| **Kaos u verzioniranju** | Odvojeni Git repozitoriji za dokumente | Nekonzistentni snimci |
| **Opterećenje suradnjom** | Lančane e‑mailove o odobrenjima | Izgubljena odobrenja, duplicirani rad |

Podrijetlo eliminira ove praznine **vezujući svaki AI‑generirani odgovor s jedinstvenim čvorom dokaza** u grafu koji bilježi:

* **Izvorni dokument** (politika, treća strana, kontrolni dokaz)  
* **Hash verzije** (kriptografski otisak koji osigurava nepromjenjivost)  
* **Vlasnik / odobritelj** (identitet čovjeka ili bota)  
* **Vremenski žig** (automatsko UTC vrijeme)  
* **Oznaka pomaka politike** (generira Real‑Time Drift Engine)

Kad revizor klikne na odgovor u nadzornoj ploči, sustav trenutno proširuje čvor i otkriva sve navedene meta‑podatke.

---

## 2. Osnovna arhitektura  

Ispod je visokorazinski Mermaid dijagram cjevovoda podrijetla. Dijagram koristi **dvostruke navodnike za oznake čvorova** prema specifikaciji.

```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
```

**Ključni tokovi**

1. **Prompt Manager** odabire kontekstno‑svjestan upit koji referencira relevantne KG čvorove.  
2. **LLM Answer Generator** proizvodi skicu odgovora.  
3. Odgovor se **registrira** u KG kao novi *Answer Node* s vezama prema podređenim *Evidence Nodes*.  
4. **Evidence Version Store** zapisuje kriptografski hash svakog izvornog dokumenta.  
5. **Drift Detection Service** kontinuirano uspoređuje pohranjene hash‑e s aktualnim snimkama politika; svaki nesklad automatski označava odgovor za reviziju.  
6 **Interactive Dashboard** čita KG putem GraphQL krajnje točke, generirajući Mermaid kod „u letu”.  
7. **Audit Export Service** spaja trenutni Mermaid SVG, JSON podrijetla i tekst odgovora u jedan PDF paket.

---

## 3. Izgradnja Mermaid nadzorne ploče  

### 3.1 Transformacija podataka u dijagram  

UI sloj upita KG za određeni ID upitnika. Odgovor uključuje ugniježđenu 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
    }
  ]
}
```

Klijentski render **pretvara** svaki unos dokaza u pod‑graf Mermaid:

```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 prekriva vizualne naznake:

* **Zeleni čvor** — evidencija je ažurirana.  
* **Crveni čvor** — detektiran je pomak.  
* **Ikona lokota** — kriptografski hash je verificiran.

> **Napomena:** Referenca na *policy‑iso27001* podudarna je s ISO 27001 standardom — pogledajte službenu specifikaciju: [ISO 27001](https://www.iso.org/standard/27001).

### 3.2 Interaktivne značajke  

| Značajka | Interakcija | Rezultat |
|----------|--------------|----------|
| **Klik na čvor** | Klik na bilo koji čvor dokaza | Otvara modal s punim pregledom dokumenta, difom verzija i komentarima odobrenja |
| **Preklop prikaza pomaka** | Preklop u alatnoj traci | Ističe samo čvorove s `drift = true` |
| **Izvoz snimke** | Klik na “Export” gumb | Generira SVG + JSON paket podrijetla za revizore |
| **Pretraga** | Unos ID‑a dokumenta ili e‑mail adrese vlasnika | Automatski fokusira odgovarajući pod‑graf |

Sve interakcije su **klijentske**, bez dodatnih round‑trip‑ova. Mermaid kod se pohranjuje u skrivenu `<textarea>` za lako kopiranje.

---

## 4. Integriranje podrijetla u postojeće radne tokove  

### 4.1 CI/CD Compliance Gate  

Dodajte korak u vašem CI/CD koji **neuspijeva gradnju** ako bilo koji odgovor u nadolazećem izdanju ima neriješenu oznaku pomaka. Primjer 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 Slack / Teams obavijesti  

Konfigurirajte **Drift Detection Service** da pošalje sažetu Mermaid isječak u odabrani Slack ili Teams kanal kad se detektira pomak. Podržani botovi automatski renderiraju isječak, dajući timovima trenutačnu vidljivost.

### 4.3 Automatizacija pravnog pregleda  

Pravni timovi mogu dodati **„Legal Sign‑Off“** rubicu (edge) čvorovima dokaza. Ploča tada prikazuje ikonu lokota pored čvora, signalizirajući da je dokaz prošao pravni popis.

---

## 5. Sigurnosni i privatnosni razlozi  

| Briga | Ublažavanje |
|-------|--------------|
| **Izlaganje osjetljivih dokumenata** | Sirovi dokumenti pohranjeni su u šifriranim S3 bucket‑ovima; ploča prikazuje samo meta‑podatke i hash, ne samu sadržinu. |
| **Falsifikacija podataka podrijetla** | Svaka transakcija grafa potpisana je **EIP‑712** stilom potpisa; bilo koja izmjena poništava hash. |
| **Rezidencija podataka** | Deployajte KG i pohranu dokaza u istu regiju kao primarne podatke usklađenosti (EU, US‑East, itd.). |
| **Kontrola pristupa** | Iskoristite Procurize‑ov RBAC model: samo korisnici s `provenance:read` mogu pregledavati ploču; `provenance:edit` je potreban za odobravanje. |

---

## 6. Stvarni učinak: Studija slučaja  

**Tvrtka:** SecureFinTech Ltd.  
**Scenarij:** Kvartalna SOC 2 revizija zahtijevala je dokaze za 182 kontrole šifriranja.  
**Prije ploče:** Ručno skupljanje je trajalo 12 dana; revizori su dovodili u pitanje svježinu dokaza.  
**Nakon ploče:**  

| Metrika | Osnovno | S nadzornom pločom |
|----------|----------|-------------------|
| Prosječno vrijeme odgovora | 4,2 sata | **1,1 sat** |
| Ponovno rad na pomaku | 28 % odgovora | **3 %** |
| Ocjena zadovoljstva revizora (1‑5) | 2,8 | **4,7** |
| Vrijeme za izvoz audit paketa | 6 sati | **45 minuta** |

Vizualizacija podrijetla skratila je pripremu revizije za **70 %**, a automatizirana upozorenja o pomaku uštedjela su procijenjenih **160 radnih sati godišnje**.

---

## 7. Vodič za implementaciju korak po korak  

1. **Omogućite sinkronizaciju grafa znanja** – povežite vaš Git repozitorij politika, spremište dokumenata i vanjske feedove u Procurize postavkama.  
2. **Aktivirajte uslugu podrijetla** – uključite „Evidence Versioning & Drift Detection“ u administratorskoj konzoli platforme.  
3. **Konfigurirajte Mermaid ploču** – dodajte `dashboard.provenance.enabled = true` u `procurize.yaml`.  
4. **Definirajte radne tokove odobrenja** – koristite „Workflow Builder“ za dodavanje koraka „Legal Sign‑Off“ i „Security Owner“ na svaki čvor dokaza.  
5. **Obučite timove** – organizirajte 30‑minutni live demo koji pokriva interakciju s čvorovima, rukovanje pomakom i postupke izvoza.  
6. **Ugradite u auditorijske portale** – upotrijebite sljedeći IFrame isječak za hostanje ploče unutar vanjskog audit portala.  

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

7. **Pratite metrike** – nadgledajte „Drift Events“, „Export Count“ i „Avg. Answer Time“ na Procurize analitičkom nadzornom panelu kako biste kvantificirali ROI.

---

## 8. Buduća poboljšanja  

| Stavka | Opis |
|--------|------|
| **AI‑potaknuta predikcija pomaka** | Korištenje LLM‑analize trendova promjena politika za predviđanje pomaka prije njihovog nastanka. |
| **Međusobno dijeljenje podrijetla** | Federativni KG način koji partnerima omogućuje pregled podijeljenih dokaza bez otkrivanja sirovih dokumenata. |
| **Glasovna navigacija** | Integracija s Procurize Voice Assistantom kako bi revizori mogli pitati „Pokaži mi izvor odgovora 34“. |
| **Suradnja u stvarnom vremenu** | Višekorisni uređivač podrijetla s indikatorima prisutnosti, prikazan izravno u Mermaid dijagramu. |

---

## 9. Zaključak  

Procurize‑ova **interaktivna Mermaid‑bazirana nadzorna ploča podrijetla dokaza** pretvara neprozirni svijet automatizacije sigurnosnih upitnika u transparentno, audit‑pripremljeno i suradničko iskustvo. Spoj AI‑generiranih odgovora i živog grafa usklađenosti pruža **trenutni uvid u liniju podrijetla**, **automatizirano otkrivanje pomaka** i **audit‑spremne artefakte** — sve to bez žrtvovanja brzine.

Uvođenjem ovog vizualnog sloja podrijetla organizacije ne samo da skraćuju cikluse revizije, već i grade povjerenje regulatora, partnera i kupaca da su njihove sigurnosne tvrdnje **podržane nepromjenjivim, u stvarnom vremenu ažuriranim dokazima**.