
# AI‑tehostama reaaliaikainen sidosryhmien vaikutuksen visualisointi turvallisuuskyselyille

## Johdanto

Turvallisuuskyselyt ovat SaaS‑toimittajien ja niiden yritysasiakkaiden yhteinen kieli. Vaikka niiden tarkka vastaaminen on kriittistä, useimmat tiimit käsittelevät prosessia staattisena tietojen syöttötehtävänä. Piilokustannus on **välittömän näkemyksen puute** siitä, miten kukin vastaus vaikuttaa *eri sidosryhmiin* – tuote‑johtajiin, lakimiehiin, turvallisuusauditoinneissa toimiviin sekä myyntitiimeihin.

Tässä astuu kuvaan **AI‑tehostama reaaliaikainen sidosryhmien vaikutuksen visualisointi (RISIV)** –moottori. Yhdistämällä generatiivinen AI, kontekstuaalinen tietämysgraafi ja live‑Mermaid‑koontinäytöt RISIV muuntaa jokaisen kyselyn vastauksen interaktiiviseksi visuaaliseksi kertomukseksi, jossa korostuvat:

* **Sääntelyaltistus** compliance‑vastaaville.
* **Tuotteen ominaisuuksien riski** tekniikan vetäjille.
* **Sopimukselliset velvoitteet** lakitiimeille.
* **Kaupan nopeus** myynti‑ ja asiakaspäälliköille.

Tuloksena on yhtenäinen, reaaliaikainen näkymä, joka nopeuttaa päätöksentekoa, vähentää jatkuvia selvityskierroksia ja lyhentää lopulta toimittajien arviointisyklit.

---

## Keskeinen arkkitehtuuri

RISIV‑moottori koostuu neljästä tiiviisti kytketystä kerroksesta:

1. **Syötteen normitoija & Retrieval‑Augmented Generation (RAG) –kerros** – jäsentää vapaamuotoiset kyselyn vastaukset, rikastaa ne asiaankuuluvilla politiikkapätkillä ja tuottaa rakenteellisia intent‑objekteja.  
2. **Kontekstuaalinen tietämysgraafi (CKG)** – dynaaminen graafi, joka tallentaa sääntelykohtia, tuotteen kyvykkyyksiä ja sidosryhmäkartoitussuhteita.  
3. **Vaikutuspisteytysmoottori** – soveltaa graafisia neuroverkkoja (GNN) ja probabilistista inferenssiä laskeakseen sidosryhmakohtaiset vaikutuspisteet reaaliajassa.  
4. **Visualisointi‑ ja vuorovaikutuskerros** – renderöi Mermaid‑kaaviot, jotka päivittyvät välittömästi uusien vastausten saapuessa.

Alla on Mermaid‑kaavio, joka havainnollistaa tiedon kulkua näiden kerrosten välillä:

```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. Syötteen normitoija & RAG

* **Document AI** poimii taulukoita, luettelokohtia ja vapaata tekstiä.  
* **Hybrid Retrieval** hakee relevantit politiikkapätkät versionhallitusta repositoriosta (esim. [SOC 2](https://secureframe.com/hub/soc-2/what-is-soc-2), [ISO 27001](https://www.iso.org/standard/27001), [GDPR](https://gdpr.eu/)).  
* **Generatiivinen LLM** kirjoittaa raakavastaukset *intent‑objekteiksi* kuten `{ “dataEncryption”: true, “region”: “EU”, “thirdPartyAccess”: false }`.

### 2. Kontekstuaalinen tietämysgraafi

CKG ylläpitää solmuja:

* **Sääntelykohdat** – jokainen kohta linkitetään sidosryhmän rooliin.  
* **Tuotteen kyvykkyydet** – esim. “tukee levossa olevaa salausta”.  
* **Riskikategoriat** – luottamuksellisuus, eheys, käytettävyys.  

Suhteet painotetaan historiallisten auditointitulosten perusteella, mikä mahdollistaa graafin kehittymisen **jatkuvien oppimissilmukoiden** kautta.

### 3. Vaikutuspisteytysmoottori

Kahden vaiheen pisteytysputki:

1. **GNN‑levitys** – levittää vaikutuksen vastaus­solmuista CKG:n kautta sidosryhmäs­olmuihin, tuottaen raakavaikutusvektorit.  
2. **Bayes‑säätö** – sisällyttää prioriprobabiliteetit (esim. tunnettu toimittajariskipiste) lopullisten vaikutuspisteiden tuottamiseksi, jotka vaihtelevat 0 (ei vaikutusta) – 1 (kriittinen) välillä.

### 4. Visualisointikerros

Koontinäyttö käyttää **Mermaid**‑kirjastoa sen keveyden, puhtaasti tekstimuotoisen luonnon ja Hugo‑sivugeneraattorin kanssa tapahtuvan saumattoman integraation vuoksi. Kullekin sidosryhmälle luodaan oma alakaavionsa:

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

Koontinäyttö päivittyy välittömästi, kun vaikutusmoottori vastaanottaa uusia intent‑objekteja – varmistaa, että jokainen sidosryhmä näkee aina ajantasaisen riskikuvan.

---

## Toteutuksen läpikäynti

### Vaihe 1: Tietämysgraafin perustaminen

```bash
# Käynnistä Neo4j provenance‑datalla
docker run -d \
  -p 7474:7474 -p 7687:7687 \
  --env NEO4J_AUTH=neo4j/password \
  neo4j:5
```

```cypher
// Lataa sääntelykohdat
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);
```

### Vaihe 2: RAG‑palvelun käyttöönotto

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

### Vaihe 3: Pisteytysmoottorin käynnistäminen (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):
        # Yksinkertaistettu GCN‑pisteytys
        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()
```

### Vaihe 4: Mermaid‑koontinäytön yhdistäminen

Luo Hugo‑lyhytkoodi `mermaid.html`:

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

Lisää kaavio markdown‑sivulle:

```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 */>}}
```

Kun uusi vastaus on lähetetty, webhook käynnistää RAG → Scorer‑putken, päivittää pistetietovaraston ja kirjoittaa Mermaid‑lohkon uusilla arvoilla.

---

## Hyödyt sidosryhmille

| Sidosryhmä | Välitön näkemys | Päätöksenteon mahdollistaminen |
|------------|-----------------|-------------------------------|
| **Lakitiimi** | Näyttää, mitkä kohdat tulevat noudattamatta | Priorisoi sopimusmuutokset |
| **Tuote** | Korostaa ominaisuusaukkoja, jotka vaikuttavat sääntelyyn | Ohjaa tuote‑tiekarttaa |
| **Turvallisuus** | Kvantifioi altistumisen jokaiselle kontrollille | Aktivoi automaattiset korjauslippukkeet |
| **Myynti** | Visualisoi vaikutuksen kaupan nopeuteen | Antaa data‑perusteita neuvottelupisteisiin |

Mermaid‑kaavioiden visuaalinen luonne **parantaa monialaisen viestinnän tehokkuutta**: tuote‑päällikkö voi katsoa yhtä solmua ja ymmärtää oikeudellisen riskin ilman pitkältä polisista tekstiä.

---

## Todellinen käyttötapaus: Kyselyn läpimenoaika 14 päivästä kahteen tuntiin

**Yritys:** CloudSync (SaaS‑varmuuskopiointipalvelu)  
**Ongelma:** Turvallisuuskyselyiden kierto kesti keskimäärin 14 päivää johtuen jatkuvasta selventämisestä.  
**Ratkaisu:** Otettiin RISIV käyttöön compliance‑portaalissa.  

**Tulokset:**

* **Vastausaikojen** lyhentäminen 6 tunnista 12 minuuttiin per kysely.  
* **Sidosryhmien tarkastuskierrokset** kutistuivat 3 päivästä alle 1 tuntiin, koska jokainen tiimi näki oman vaikutuksensa heti.  
* **Kaupan sykkeen** nopeus kasvoi 27 % (keskimääräinen myyntisyklin kesto pudotti 45 päivästä 33 päivään).  

Jälkikäteen toteutettu sisäinen Net Promoter Score (NPS) nousi **+68**:iin, mikä kuvastaa visualisoinnin tuomaa selkeyttä ja nopeutta.

---

## Parhaat käytännöt käyttöönotolle

1. **Aloita minimaalisen tietämysgraafin kanssa** – tuo vain kriittisimmät sääntelykohdat ja linkitä ne pääasiallisiin sidosryhmiin. Laajenna järjestelmän kehittyessä.  
2. **Versionhallitut politiikkavarastot** – säilytä politiikkatiedostot Gitissä, merkitse jokainen muutos tagilla ja anna RAG‑kerroksen noutaa oikea versio kyselyn kontekstin perusteella.  
3. **Ihmisen mukana oleva tarkistus** – reititä korkean vaikutuksen pisteet (> 0.75) compliance‑tarkastajalle viimeistäksesi automaattinen lähetys.  
4. **Seuraa pisteytyksen häiriöitä** – aseta hälytykset, jos vaikutuspisteet muuttuvat dramaattisesti samanlaisten vastausten kohdalla, mikä voi viitata tietämysgraafin vanhentumiseen.  
5. **Hyödynnä CI/CD‑putkea** – käsittele Mermaid‑koontinäytöt koodina; suorita automaattisia testejä varmistaaksesi, että kaaviot renderöityvät oikein jokaisen julkaisun jälkeen.

---

## Tulevaisuuden kehityssuunnat

* **Monikielinen intent‑tunnistus** – laajenna RAG‑kerros kielikohtaisilla LLM:illä palvellaksesi globaalisti toimivia tiimejä.  
* **Adaptatiivinen GNN‑kalibrointi** – hyödynnä vahvistusoppimista tarkentaaksesi reunapainotuksia auditointitulosten perusteella.  
* **Federatiivinen tietämysgraafin synkronointi** – salli useiden tytäryhtiöiden kontribuutiot yhteiseen graafiin samalla suojaten datan suvereniteettia nollatiedon‑todisteilla.  
* **Ennustava vaikutusennuste** – yhdistä aikasarja‑mallit pisteytysmoottoriin, jotta voidaan arvioida tulevaa sidosryhmien vaikutusta sääntelyn muuttuessa.

---

## Yhteenveto

AI‑tehostama reaaliaikainen sidosryhmien vaikutuksen visualisointi mullistaa tavan, jolla turvallisuuskyselyitä käsitellään. Muuttamalla jokaisen vastauksen välittömäksi, toimivaksi visuaaliseksi tarinaksi organisaatiot voivat yhdistää tuote‑, lakitiimi‑, turvallisuus‑ ja myyntinäkökulmat ilman perinteistä manuaalisen tarkastelun viivettä. RISIV:n käyttöönotto ei ainoastaan nopeuta toimittajien arviointiprosessia, vaan myös rakentaa läpinäkyvyyttä ja tietoon perustuvaa sääntelyn noudattamista.