
# Interaktiivne Mermaid‑põhine tõendite päritolu armatuurlaud reaalajas küsimustiku auditide jaoks

## Sissejuhatus  

Turvaküsimustikud, vastavusaudod ja tarnijate riskihinnangud on traditsiooniliselt kitsaskojad kiirelt liikuvate SaaS-ettevõtete jaoks. Kuigi AI suudab vastuseid sekunditega koostada, küsivad auditorid ja sisekontrollijad endiselt: *„Kust see vastus pärineb? Kas see on pärast viimast auditi muutunud?“* Vastus peitub **tõendite päritolus** — võimes jälgida iga vastuse alku, versiooni ja heakskiitmise teed.

Procurize järgmise põlvkonna funktsioonikogum tutvustab **interaktiivset Mermaid armatuurlauda**, mis visualiseerib tõendite päritolu reaalajas. Armatuurlaud töötab **Dünaamilise Vastavuse Teadmistegraafi (DCKG)** toel, mis sünkroniseeritakse pidevalt poliitikapoodide, dokumendirepositooriumide ja välistest vastavusvoogudega. Graafi kujutamine intuitiivse Mermaid-diagrammina võimaldab turvameeskondadel:

* **Navigeerida** iga vastuse päritolu klõpsuga.  
* **Kinnitada** tõendi värskust automaatsete poliitika‑kõikumise hoiatuste kaudu.  
* **Ekspordida** auditiks valmis hetkepilte, mis põimivad visuaalse päritolu vastavusaruannetes.  

Järgnevad sektsioonid selgitavad arhitektuuri, Mermaid mudelit, integratsioonimustreid ja parimate tavade juurutamissamme.

## 1. Miks päritolu on oluline automatiseeritud küsimustikes  

| Probleem | Traditsiooniline lahendus | Järelejäänud risk |
|----------|---------------------------|-------------------|
| **Vastuse vananemine** | Käsitsi “viimati uuendatud” märkused | Poliitikamuutuste möödumine |
| **Ebamäärane allikas** | Tekstilised jalusmärgendid | Auditorid ei saa kinnitada |
| **Versioonihaldus kaos** | Eraldiseisvad Git repositooriumid dokumentidele | Ebatäpsed hetkepildid |
| **Koostöö ülekulu** | Kinnituste e-posti ahelad | Kadunud kinnitused, dubleeritud töö |

Päritolu elimineerib need lüngad, sidudes iga AI‑genereeritud vastuse graafikus unikaalse tõendenoodiga, mis salvestab:

* **Lähtedokument** (poliitikafail, kolmanda osapoole tõend, kontrolltõend)  
* **Versioonihash** (krüptograafiline sõrmejälg, mis tagab muutumatuse)  
* **Omanik / Kinnitaja** (inimese või boti identiteet)  
* **Ajatempel** (automaatne UTC aeg)  
* **Poliitika kõikumise lipp** (reaalja generaatoriga automaatselt loodud)

Kui auditor klõpsab armatuurlaudal vastusel, laiendab süsteem kohe sõlme, paljastades kogu ülaltoodud metaandmed.

## 2. Põhiarhitektuur  

```mermaid
graph TD
    subgraph AI Mootor
        A["LLM Vastuse Generaator"]
        B["Päringu Halduja"]
    end
    subgraph Teadmiste Graafik
        KG["Dünaamiline Vastavuse KG"]
        V["Tõendi Versioonipoe"]
        D["Kõikumise Tuvastamise Teenus"]
    end
    subgraph Kasutajaliidese Kihis
        UI["Interaktiivne Mermaid Armatuurlaud"]
        C["Auditi Eksporditeenus"]
    end
    subgraph Integratsioonid
        R["Poliitika Repos (Git)"]
        S["Dokumendi Pood (S3)"]
        M["Väline Vastavusvoog"]
    end

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

**Peamised vood**

1. **Päringu Halduja** valib kontekstiteadliku päringu, mis viitab asjakohastele KG sõlmedele.  
2. **LLM Vastuse Generaator** koostab mustandi vastuse.  
3. Vastus **registreeritakse** KG-s uue *Vastuse Sõlmena* koos ühendustega aluseks olevate *Tõende Sõlmedega*.  
4. **Tõendi Versioonipoe** kirjutab krüptograafilise hash-i iga lähte dokumendi jaoks.  
5. **Kõikumise Tuvastamise Teenus** võrdleb pidevalt salvestatud hashe'e elavate poliitika hetkepiltidega; igasugune mittevastavus märgib automaatselt vastuse ülevaatamiseks.  
6. **Interaktiivne Armatuurlaud** loeb KG-d GraphQL lõpp-punkti kaudu, renderdades Mermaid koodi kohapeal.  
7. **Auditi Eksporditeenus** pakib praeguse Mermaid SVG, päritolu JSON ja vastuse teksti ühte PDF paketti.

## 3. Mermaid Armatuurlaua ehitamine  

### 3.1 Andmete‑diagrammi teisendus  

UI‑kiht küsib KG‑st konkreetse küsimustiku ID (näiteks `Q-101`). Vastus sisaldab sisseehitatud metaandmeid:

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

Kliendipoolne renderdaja teisendab iga tõendikirje Mermaid aladiagrammiks:

```mermaid
graph LR
    A["Vastus Q‑101"] --> E1["poliitika‑iso27001"]
    A --> E2["pilve‑kbs‑aruanne"]
    E1 -->|hash: 0x9f2c| H1["Räsi"]
    E2 -->|hash: 0x4c1a| H2["Räsi"]
    E2 -->|drift| D["⚠️ Kõikumine tuvastatud"]
```

UI lisab visuaalseid vihjeid:

* **Roheline sõlm** – tõend ajakohane.  
* **Punane sõlm** – kõikumine märgitud.  
* **Lukusümbol** – krüptograafiline räsi kinnitatud.  

> **Märkus:** Viide *poliitika‑iso27001* on kooskõlas ISO 27001 standardiga — vaadake üksikasju ametlikus spetsifikatsioonis: [ISO 27001](https://www.iso.org/standard/27001).

### 3.2 Interaktiivsed funktsioonid  

| Funktsioon | Interaktsioon | Tulemus |
|------------|---------------|----------|
| Sõlme klõps | Klõpsa mistahes tõende sõlmel | Avab modaalakna täis dokumendi eelvaatega, versiooni erinevuste ja kinnituste kommentaaridega |
| Lülita kõikumise vaade | Lüliti tööriistaribal | Tõstab esile ainult sõlmed, mille kõikumine = tõene |
| Ekspordi hetkepilt | Klõpsa “Ekspordi” nuppu | Genereerib SVG + JSON päritolu paketi auditoritele |
| Otsing | Sisesta dokumendi ID või omaniku e‑post | Automaatselt fookustab vastava aladiagrammi |

Kõik interaktsioonid toimuvad **kliendi poolel**, vältides lisaringi. Aluseks olev Mermaid kood on salvestatud varjatud `<textarea>`‑s, et oleks lihtne kopeerida ja kleepida.

## 4. Päritulu integreerimine olemasolevatesse töövoogudesse  

### 4.1 CI/CD Vastavuse Värav  

Lisage oma torujuhtmesse samm, mis **katka ehituse**, kui mis tahes vastus uues väljalaskes omab lahendamata kõikumise lippu. Näide GitHub Action’ist:

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

Seadistage **Kõikumise Tuustamise Teenus**, et lükata kompaktne Mermaid‑klipp kanalisse iga kord, kui kõikumine ilmneb. Toetatud botid renderdavad klipi automaatselt, andes turvameeskonnale kohese ülevaate.

### 4.3 Õigusliku ülevaatuse automatiseerimine  

Õigusmeeskonnad saavad lisada **“Õiguslik kinnitamine”** ääre tõendisõlmedele. Armatuurlaud kuvab seejärel lukusümboli, mis näitab, et tõend on läbinud õigusliku kontrolli.

## 5. Turvalisus‑ ja privaatsuskaalutlused  

| Mure | Leevendus |
|------|-----------|
| **Tundlike dokumentide kokkupuude** | Salvestage toored dokumendid krüptitud S3 ämbritesse; armatuurlaud renderdab ainult metaandmeid ja räsi, mitte failisisu. |
| **Pärituluandmete võltsimine** | Kasutage **EIP‑712** stiilis allikaid iga graafi tehingu jaoks; iga muutmine kehtetuks teeb räsi. |
| **Andmete paiknemine** | Paigaldage KG ja tõendite pood samasse piirkonda, kus on teie põhivastavuse andmed (EU, US‑East jne). |
| **Juurdepääsu kontroll** | Kasutage Procurize RBAC mudelit: ainult kasutajad, kellel on `provenance:read`, saavad armatuurlaua näha; `provenance:edit` on vajalik kinnituste tegemiseks. |

## 6. Reaalse maailma mõju: juhtumiuuring  

**Ettevõte:** SecureFinTech Ltd.  
**Stsenaarium:** Kord kvartali **[SOC 2](https://secureframe.com/hub/soc-2/what-is-soc-2/)** audit nõudis tõendeid 182 krüpteerimiskontrolli kohta.  

| Mõõdik | Algsõlt | Armatuurlauaga |
|-------|----------|----------------|
| Keskmine vastuse tähtaeg | 4.2 tundi | **1.1 tundi** |
| Kõikumisega seotud ümbertegemine | 28 % vastustest | **3 %** |
| Auditori rahulolu skoor (1‑5) | 2.8 | **4.7** |
| Aega auditi paketi eksportimiseks | 6 tundi | **45 minutit** |

Päritulu visualiseerimine lõikas auditi ettevalmistuse ajakava **70 %**, ning automaatsed kõikumise hoiatused säästsid hinnanguliselt **160 tunnis aastas**.

## 7. Samm‑sammuline rakendamise juhend  

1. **Luba teadmistegraafi sünkroniseerimine** – ühenda oma poliitika Git repo, dokumendipood ja välised vastavusvood Procurize'i seadetes.  
2. **Aktiveeri päritulu teenus** – lülita sisse “Tõendi versioonimine & kõikumise tuvastamine” platvormi adminkonsoolis.  
3. **Seadista Mermaid armatuurlaud** – lisa `dashboard.provenance.enabled = true` `procurize.yaml` konfiguratsioonifaili.  
4. **Määra kinnituse töövood** – kasuta “Workflow Builder’it”, et lisada “Õiguslik kinnitamine” ja “Turvaomaniku” etapid igale tõende sõlmele.  
5. **Koolita meeskondi** – korralda 30‑minutiline live-demo, mis hõlmab sõlmeinteraktsiooni, kõikumise käsitlemist ja eksportimisprotseduure.  
6. **Integreeri auditorite portaalidesse** – kasuta antud IFrame'i koodi, et hostida armatuurlauda oma välises auditportaalis.  

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

7. **Jälgi mõõdikuid** – jälgi “Kõikumise sündmused”, “Ekspordi arv” ja “Keskmine vastuse aeg” Procurize’i analüütikaarmatuuril, et kvantifitseerida ROI.

## 8. Tuleviku täiustused  

| AI‑põhine kõikumise prognoos | Federated KG võimaldab partnerettevõtetel vaadata jagatud tõendeid ilma tooreid dokumente nähtavaks tegemata |
|------------------------------|-------------------------------------------------------------------------------------------------------------------|
| **AI‑põhine kõikumise prognoos** | Kasutage LLM‑põhist trendianalüüsi poliitika muutuste logidel, et prognoosida kõikumist enne selle esinemist. |
| **Risttenantide päritolu jagamine** | Föderaalse KG režiim, mis võimaldab partnerettevõtetel vaadata jagatud tõendeid ilma tooreid dokumente nähtavaks tegemata. |
| **Hääljuhtimine navigatsioon** | Integreerige Procurize Voice Assistantiga, et võimaldada ülevaatajal küsida “Näita mulle vastuse 34 allikat”. |
| **Reaalajas koostöö** | Reaalajas mitme kasutaja redigeerimine tõende sõlmedel, koos kohaloleku indikaatoritega, mis renderdatakse otse Mermaid’is. |

## 9. Kokkuvõte  

Procurize **interaktiivne Mermaid‑põhine tõendite päritolu armatuurlaud** muudab turvaküsimustike automatiseerimise ebamäärase maailma läbipaistvaks, auditeeritavaks ja koostöövõimeliseks kogemuseks. Sidudes AI‑genereeritud vastused reaalajas vastavuse teadmistegraafikuga, saavad organisatsioonid **kohese päritulu nähtavuse**, **automaatse kõikumise leevendamise** ja **auditi‑valmis artefaktid**—kõik ilma kiirust ohverdamata.

Selle visuaalse päritulu kihi kasutuselevõtt lühendab mitte ainult audititsükleid, vaid loob ka usalduse regulaatorite, partnerite ja klientide seas, et teie turva väited on **muutmatu, reaalajas tõenditega** toetatud.