
# AI-ga täiustatud reaalajas sidusrühmade mõju visualiseerimine turvaküsimustike jaoks

## Sissejuhatus

Turvaküsimustikud on SaaS‑teenuse pakkujate ja nende ettevõtte klientide vaheliseks ühiskeeliseks keeleks. Kuigi nende täpne täitmine on kriitiline, käsitleb enamik meeskondi protsessi kui staatilist andmesisestust. Peidetud kulu on **kohese ülevaate puudumine** sellest, kuidas iga vastus mõjutab *erinevaid sidusrühmi* — tootejuhtide, õigusnõustajate, turvaauditsientide ja isegi müügimeeskondade – perspektiivi.

Siseneb **AI-ga täiustatud reaalajas sidusrühmade mõju visualiseerimise (RISIV)** mootor. Kombineerides generatiivset AI-d, kontekstuaalset teadmistegraafi ja otse‑nähtavaid Mermaid‑tahvleid, teisendab RISIV iga küsimustiku vastuse interaktiivseks visuaalseks narratiiviks, mis esile toob:

* **Regulatiivse riskiga** kooskõlastamiseks vastutavatele ametnikele.
* **Toote funktsioonide riskiga** inseneridele.
* **Lepingu kohustustega** õigusmeeskondadele.
* **Lepingu kiirendamise mõjuga** müügimeeskondadele ja kontohalduritele.

Tulemuseks on ühtne, reaalajas vaade, mis kiirendab otsuste tegemist, vähendab selgituste läbikäimisi ja lühendab lõpuks müüja hindamise tsüklit.

---

## Põhitektuur

RISIV‑mootor põhineb neljal tihedalt seotud kihil:

1. **Sisendi normaliseerija ja Retrieval‑Augmented Generation (RAG) kiht** – struktureerib vabas vormis vastused, rikastab need asjakohaste poliitika fragmentidega ja genereerib struktureeritud intent‑objekte.  
2. **Kontekstuaalne teadmistegraafik (CKG)** – dünaamiline graaf, mis salvestab regulatiivsed klauslid, tootevõimalused ja sidusrühmade seosed.  
3. **Mõju skoorimise mootor** – rakendab graafineuraalvõrke (GNN) ja probabilistlikku inferentsi, et arvutada sidusrühmale spetsiifilised mõju­skoorid reaalajas.  
4. **Visualiseerimise ja interaktsiooni kiht** – renderdab Mermaid‑diagramme, mis värskenevad koheselt uute vastuste saabudes.

Allpool on Mermaid‑diagramm, mis illustreerib andmevoogu nende kihtide vahel:

```mermaid
graph LR
    A[Questionnaire Input] --> B[Norm‑RAG Processor]
    B --> C[Intent Objects]
    C --> D[Contextual Knowledge Graph]
    D --> E[Impact Scoring Engine]
    E --> F[Stakeholder Score Store]
    F --> G[Mermaid Dashboard]
    G --> H[User Interaction & Feedback]
    H --> B
    style A fill:#f9f,stroke:#333,stroke-width:2px
    style G fill:#bbf,stroke:#333,stroke-width:2px
```

### 1. Sisendi normaliseerija & RAG

* **Document AI** ekstraheerib tabeleid, täpikesi ja vabas vormis tekste.  
* **Hübriidne Retrieval** tõmbab kõige asjakohasemaid poliitika fragmente versioonikontrollitud repositooriumist (nt. [SOC 2](https://secureframe.com/hub/soc-2/what-is-soc-2), [ISO 27001](https://www.iso.org/standard/27001), [GDPR](https://gdpr.eu/)).  
* **Generatiivne LLM** vormindab toored vastused *intent‑objektideks*, näiteks `{ “dataEncryption”: true, “region”: “EU”, “thirdPartyAccess”: false }`.

### 2. Kontekstuaalne teadmistegraafik

CKG hoiab sõlme:

* **Regulatiivsed klauslid** – iga klausli link sidusrühma rolliga.  
* **Tootevõimalused** – nt. “toetab puhkeandmete krüpteerimist”.  
* **Riskikategooriad** – konfidentsiaalsus, terviklikkus, kättesaadavus.  

Seosed on kaalutud ajalooliste auditite tulemustel, võimaldades graafil kujuneda **pidevate õpirõngaste** kaudu.

### 3. Mõju skoorimise mootor

Kahe‑etapiline skoorimispõhine torustik:

1. **GNN levitamine** – levitab mõju vastuse‑sõlmedest läbi CKG‑sidusrühma‑sõlmedeni, andes toorskored.  
2. **Baysian kohandamine** – kasutab eeltäidetud tõenäosusi (nt. teadaolev müüja riskiskoor) lõplike sidusrühma mõju­skooride genereerimiseks vahemikus 0 (pole mõju) kuni 1 (kriitiline).

### 4. Visualiseerimise kiht

Juhtpaneel kasutab **Mermaid‑i**, sest see on kerge, tekstipõhine ja töötab sujuvalt Hugo‑staatiliste saitide generaatoritega. Iga sidusrühma jaoks eraldatud alagraafik:

```mermaid
flowchart TD
    subgraph Legal
        L1[Clause 5.1 – Data Retention] --> L2[Violation Risk: 0.78]
        L3[Clause 2.4 – Encryption] --> L4[Compliance Gap: 0.12]
    end
    subgraph Product
        P1[Feature: End‑to‑End Encryption] --> P2[Risk Exposure: 0.23]
        P3[Feature: Multi‑Region Deploy] --> P4[Impact Score: 0.45]
    end
    subgraph Sales
        S1[Deal Cycle Time] --> S2[Increase: 15%]
        S3[Customer Trust Score] --> S4[Boost: 0.31]
    end
```

Juhtpaneel värskenevad kohe, kui mõju‑mootor saab uued intent‑objektid, tagades, et iga sidusrühm näeb alati ajakohastatud riskipilti.

---

## Rakendamise samm‑sammult

### Samm 1: Teadmistegraafi seadistamine

```bash
# Initialiseeri Neo4j koos päritoludega
docker run -d \
  -p 7474:7474 -p 7687:7687 \
  --env NEO4J_AUTH=neo4j/password \
  neo4j:5
```

```cypher
// Laadi regulatiivsed klauslid
LOAD CSV WITH HEADERS FROM 'file:///regulations.csv' AS row
MERGE (c:Clause {id: row.id})
SET c.text = row.text,
    c.stakeholder = row.stakeholder,
    c.riskWeight = toFloat(row.riskWeight);
```

### Samm 2: RAG‑teenuse juurutamine

```yaml
services:
  rag:
    image: procurize/rag:latest
    environment:
      - VECTOR_DB_ENDPOINT=http://vector-db:8000
      - LLM_API_KEY=${LLM_API_KEY}
    ports:
      - "8080:8080"
```

### Samm 3: Skoorimise mootori käivitamine (Python)

```python
import torch
from torch_geometric.nn import GCNConv
from neo4j import GraphDatabase

class ImpactScorer:
    def __init__(self, uri, user, pwd):
        self.driver = GraphDatabase.driver(uri, auth=(user, pwd))

    def fetch_subgraph(self, answer_id):
        with self.driver.session() as session:
            result = session.run("""
                MATCH (a:Answer {id: $aid})-[:TRIGGERS]->(c:Clause)
                MATCH (c)-[:AFFECTS]->(s:Stakeholder)
                RETURN a, c, s
            """, aid=answer_id)
            return result.data()

    def score(self, subgraph):
        # Lihtsustatud GCN skoorimine
        x = torch.tensor([n['c']['riskWeight'] for n in subgraph])
        edge_index = torch.tensor([[0, 1], [1, 0]])  # dummy adjacency
        conv = GCNConv(in_channels=1, out_channels=1)
        out = conv(x.unsqueeze(1), edge_index)
        return torch.sigmoid(out).squeeze().tolist()
```

### Samm 4: Ühendamine Mermaid‑juhtpaneeliga

Loo Hugo‑lühikood `mermaid.html`:

```html
<div class="mermaid">
{{ .Inner }}
</div>
```

Lisa diagramm markdowni lehele:

```markdown
{{</* mermaid */>}}
flowchart LR
    Q1[Answer: “Data stored in EU only”] --> C5[Clause 4.3 – Data Residency]
    C5 --> L1[Legal Impact: 0.84]
    C5 --> P2[Product Impact: 0.41]
{{</* /mermaid */>}}
```

Kui uus vastus on sisestatud, käivitab webhook RAG → Skoorija toru, uuendab skoorihoidlat ja kirjutab Mermaid‑ploki automaatselt viimaste väärtustega.

---

## Kasu eri sidusrühmadele

| Sidusrühm | Kohene ülevaade | Otsuste võimaldamine |
|-----------|------------------|----------------------|
| **Õigus** | Näitab, millised klauslid muutuvad mittevastavaks | Prioriteediks lepingute muutmine |
| **Toode** | Tõstab esile funktsioonilõigud, mis mõjutavad kooskõlastust | Suunab tee‑kaardi kohandusi |
| **Turvalisus** | Kvantifitseerib igas kontrollis oleva kokkupuute taseme | Käivitab automaatsed kõrvaldamistiketid |
| **Müük** | Visualiseerib mõju tehingu kiirusele | Varustab esindajaid andmepõhiste läbirääkimistega |

Mermaid‑diagrammide visuaalne iseloom **parandab funktsioonidevahelist kommunikatsiooni**: tootejuht võib ühe sõlme pilguheitmisega mõista õiguslikku riski ilma tihedat poliitika teksti lugemata.

---

## Reaalse maailma kasutusjuht: Küsimustiku läbisõidu vähendamine 14 päevast 2 tunniks

**Ettevõte:** CloudSync (SaaS‑andmete varundusteenus)  
**Probleem:** Turvaküsimuste tsüklid võtsid keskmiselt 14 päeva kestuse, tänu pidevale selgitamisele.  
**Lahendus:** RISIV juurutati kogu kooskõlastusportaali.

**Tulemused:**

* **Vastuse genereerimise aeg** vähenes 6 st tunnist 12 minutiliseks ühe küsimustiku kohta.  
* **Sidusrühmade ülevaate tsüklid** kukkusid 3 päevast alla 1 tunnini, kuna iga meeskond nägi oma mõju kohe.  
* **Lepingu sulgemise kiirendus** tõusis 27 % (keskmine müügitsükkel 45 päevast 33 päevani).  

Rakenduse järelkasutajate Net Promoter Score (NPS) tõusis **+68**‑ni, mis näitab selguse ja kiiruse hinnatud väärtust.

---

## Parimad praktikad kasutuselevõtuks

1. **Alusta minimaalse teadmistegraafikuga** – importi ainult kõige kriitilisemad regulatiivsed klauslid ja seosta need põhisessidusrühmadega. Laienda süsteemi kasvades.  
2. **Versioonikontrollitud poliitika repositoorium** – hoia poliitika failid Gitis, märgi iga muudatus ning lase RAG‑kihil tõmmata õige versioon küsimustiku kontekstist.  
3. **Inimene‑tsüklis ülevaade** – suuna kõrge mõju‑skoorid (> 0,75) kooskõlastusülevaatajale lõpliku kinnituse saamiseks enne automaatset saatmist.  
4. **Skooride nihke jälgimine** – seadista teavitused, kui sarnaste vastuste mõju‑skoorid muutuvad dramaatiliselt, viidates võimalikule teadmistegraafi lagunemisele.  
5. **CI/CD toru kasutamine** – käsitle Mermaid‑juhtpaneele koodina; jooksuta automaatseid teste, et tagada diagrammide korrektsus iga juurutuse järel.

---

## Tuleviku täiustused

* **Mitmekeelne intent‑ekstraktsioon** – laienda RAG‑kihti keelespetsiifiliste LLM‑idega, et teenida globaalseid tiime.  
* **Kohandav GNN kalibreerimine** – kasuta tugevdusõpet, et finaalselt häälestada servade kaalu audititulemustel põhinevalt.  
* **Föderatiivne teadmistegraafi sünkroniseerimine** – lase mitmetel tütarettevõtetel oma andmete osaluse säilitada, kasutades null‑teadmiste tõendeid (zero‑knowledge proofs).  
* **Prognoosiv mõju ennustamine** – kombineeri ajaseriaalimudeleid skoorimismootoriga, et hinnata tulevast sidusrühma mõju, kui regulatiivne maastik muutub.

---

## Kokkuvõte

AI-ga täiustatud reaalajas sidusrühmade mõju visualiseerimise mootor muudab turvaküsimuste täitmise paradigmi. Iga vastus muutub koheseks, kasutatavaks visuaalseks loost, võimaldades toote‑, õigus‑, turvalisus‑ ja müügivaate “sünkroniseeritud” koordineerimist ilma traditsioonilise käsitsi ülevaate viivitusteta. RISIV‑lahenduse juurutamine kiirendab mitte ainult müüja hindamise protsessi, vaid loob ka läbipaistvuse ja andmepõhise kooskõlastuse kultuuri.

---