
# Interaktiivinen Mermaid‑pohjainen todistusaineiston alkuperän hallintapaneeli reaaliaikaisiin kyselyauditointeihin

## Johdanto  

Turvallisuuskyselyt, vaatimustenmukaisuusauditoinnit ja toimittajariskien arvioinnit ovat perinteisesti olleet pullonkauloja nopeasti liikkuville SaaS‑yrityksille. Vaikka AI voi laatia vastauksia sekunneissa, tarkastajat ja sisäiset tarkistajat kysyvät edelleen: *“Mistä tuo vastaus on peräisin? Onko se muuttunut viimeisen auditoinnin jälkeen?”* Vastaus piilee **todistusaineiston alkuperässä** — kyvyssä jäljittää jokainen vastaus sen lähteeseen, versioon ja hyväksyntäpolkuun.

Procurizen seuraavan sukupolven ominaisuuspaketti esittelee **interaktiivisen Mermaid‑hallintapaneelin**, joka visualisoi todistusaineiston alkuperän reaaliajassa. Hallintapaneeli toimii **Dynaamisen Vaatimustenmukaisuuden Tietämyskartan (DCKG)** avulla, joka synkronoi jatkuvasti politiikkavarastoja, asiakirjavarastoja ja ulkoisia vaatimustenmukaisuustietovirtoja. Esittämällä graafin intuitiivisena Mermaid‑kaaviona turvallisuustiimit voivat:

* **Navigoida** jokaisen vastauksen perimän klikkaamalla.
* **Vahvistaa** todisteen ajantasaisuuden automaattisten politiikka‑poikkeamalähetysten avulla.
* **Viedä** auditointivalmiita tilannekuvia, jotka upottavat visuaalisen alkuperän vaatimustenmukaisuusraportteihin.

Seuraavat osat avaavat arkkitehtuurin, Mermaid‑mallin, integrointimallit ja parhaita käytäntöjä käyttöönottoon.

---

## 1. Miksi alkuperä on tärkeä automatisoiduissa kyselyissä  

| Kivun kohta | Perinteinen ratkaisu | Jäljelle jäävä riski |
|------------|----------------------|---------------------|
| **Vastauksen vanhentuminen** | Manuaaliset “viimeksi päivitetty” -muistiinpanot | Politiikan muutokset jäävät huomaamatta |
| **Epämääräinen lähde** | Tekstialaviitteet | Auditointihenkilö ei pysty vahvistamaan |
| **Versionhallinnan kaaos** | Erilliset Git‑repositorit asiakirjoille | Epäjohdonmukaiset tilannekuvat |
| **Yhteistyön kuormitus** | Sähköpostiketjut hyväksynnöistä | Kadonneet hyväksynnät, kaksoistyö |

Alkuperä poistaa nämä aukot **sitomalla jokaisen AI‑luodun vastauksen ainutlaatuiseen todiste-solmuun** tietämyspuussa, joka kirjaa:

* **Lähdeasiakirja** (politiikkatiedosto, kolmannen osapuolen todistus, kontrollitodiste)
* **Versio‑hash** (kryptografinen sormenjälki, joka takaa muuttumattomuuden)
* **Omistaja / Hyväksyjä** (ihminen tai botti)
* **Aikaleima** (automaattinen UTC‑aika)
* **Politiikkapoikkeama‑lippu** (automaattisesti luotu Reaaliaikainen Poikkeama‑moottori)

Kun tarkastaja klikkaa vastausta hallintapaneelissa, järjestelmä laajentaa solmun välittömästi ja näyttää kaikki edellä mainitut metatiedot.

---

## 2. Keskeinen arkkitehtuuri  

Alla on korkeatasoinen Mermaid‑kaavio todistusaineiston lähdeputkesta. Kaaviossa on **kaksoislainausmerkeillä** varustetut solmunimet, kuten spesifikaatiossa vaaditaan.

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

**Tärkeimmät kuljet**  

1. **Prompt Manager** valitsee kontekstitietoisen kehotteen, joka viittaa relevantteihin KG‑solmuihin.  
2. **LLM Answer Generator** tuottaa luonnosvastauksen.  
3. Vastaus **rekisteröidään** KG:ssä uutena *Answer Node* –solmuna, jonka reunat yhdistävät taustalla oleviin *Evidence Nodes* –solmuihin.  
4. **Evidence Version Store** kirjoittaa jokaisen lähdeasiakirjan kryptografisen hash‑arvon.  
5. **Drift Detection Service** vertaa tallennettuja hasheja jatkuvasti elävien politiikkakuvien kanssa; jokainen poikkeama merkitsee automaattisesti vastauksen tarkistettavaksi.  
6. **Interaktiivinen hallintapaneeli** lukee KG:n GraphQL‑rajapinnan kautta, renderöiden Mermaid‑koodin lennosta.  
7. **Audit Export Service** pakkaa nykyisen Mermaid‑SVG:n, provenance‑JSON:n ja vastaustekstin yhdeksi PDF‑paketiksi.

---

## 3. Mermaid‑hallintapaneelin rakentaminen  

### 3.1 Data‑to‑Diagram -muunnos  

UI‑kerros tekee KG‑kyselyn tietyn kyselyn ID:n perusteella. Vastaus sisältää sisäkkäisen rakenteen:

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

**Asiakaspuolen renderöijä** muuntaa jokaisen todiste‑merkinnän Mermaid‑alikuvioon:

```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‑kerros lisää visuaaliset vihjeet:  

* **Vihreä solmu** – todiste ajantasalla.  
* **Punainen solmu** – poikkeama havaittu.  
* **Lukko‑ikoni** – kryptografinen hash vahvistettu.

> **Huomio:** Viite *policy‑iso27001* viittaa ISO 27001 ‑standardiin — katso virallinen spesifikaatio: [ISO 27001](https://www.iso.org/standard/27001).

### 3.2 Interaktiiviset ominaisuudet  

| Ominaisuus | Vuorovaikutus | Lopputulos |
|-----------|---------------|------------|
| **Solmun klikkaus** | Klikkaa mitä tahansa todiste‑solmua | Avautuu modaali, jossa on täysi asiakirjakatsaus, versio‑vertailu ja hyväksyntäkommentit |
| **Poikkeamannäkymän kytkin** | Työkalupalkin kytkin | Korostaa vain poikkeama‑=true‑solmut |
| **Viedä hetkelliskuva** | Klikkaa “Export”‑painiketta | Luo SVG‑ + JSON‑provenance‑paketin auditointia varten |
| **Haku** | Kirjoita asiakirja‑ID tai omistajan sähköposti | Automaattisesti fokusoituu vastaavaan alikuvioon |

Kaikki vuorovaikutukset tapahtuvat **asiakaspuolella**, jolloin ylimääräisiä pyynnöitä vältetään. Mermaid‑koodi säilytetään piilotetussa `<textarea>`‑elementissä, jotta sen kopioiminen on helppoa.

---

## 4. Provenanssin integrointi nykyisiin työnkulkuihin  

### 4.1 CI/CD‑vaatimustenmukaisuuden portti  

Lisää pipeline‑askel, joka **katkaisee buildin**, jos tulevan julkaisun vastaus sisältää ratkaisemattoman poikkeaman. Esimerkki GitHub‑toiminnosta:

```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 –hälytykset  

Määritä **Drift Detection Service** lähettämään tiiviin Mermaid‑pätkän kanavaan, kun poikkeama havaitaan. Monet botti‑integraatiot renderöivät kaavion automaattisesti, jolloin turvallisuusjohtajilla on välitön näkyvyys.

### 4.3 Lainsäädännöllinen tarkastusautomaatio  

Oikeus‑tiimit voivat lisätä **“Legal Sign‑Off”**‑reunan todiste‑solmuihin. Hallintapaneeli näyttää tällöin solmussa lukko‑ikonin, joka kertoo, että todiste on läpäissyt oikeudellisen tarkistuksen.

---

## 5. Turvallisuus‑ ja yksityisyyskysymykset  

| Huoli | Mitigaatio |
|-------|------------|
| **Arkaluontoisten asiakirjojen paljastuminen** | Säilytä raakadokumentit salattuna S3‑bucketissa; hallintapaneeli näyttää vain metadataa ja hash‑arvoja. |
| **Provenanssitietojen manipulointi** | Käytä **EIP‑712**‑tyyppisiä alle signaattuja tapahtumia; jokainen muutospyyntö tarkistetaan allekirjoituksella. |
| **Tietojen sijainti** | Aja KG ja todiste‑varasto samassa alueessa kuin ensisijainen vaatimustenmukaisuustietosi (EU, US‑East, jne.). |
| **Pääsynvalvonta** | Hyödynnä Procurizen RBAC‑mallia: vain käyttäjät, joilla `provenance:read`‑oikeus, näkevät hallintapaneelin; `provenance:edit`‑oikeus vaaditaan hyväksyntöihin. |

---

## 6. Reaaliaikainen vaikutus: tapaustutkimus  

**Yritys:** SecureFinTech Ltd.  
**Tilanne:** Kvartaali‑**[SOC 2](https://secureframe.com/hub/soc-2/what-is-soc-2)**‑auditointi vaati todisteet 182 salaus‑kontrolleille.  
**Ennen hallintapaneelia:** Manuaalinen kokoaminen kesti 12 päivää; auditoinnin tarkastajat kyseenalaistivat todisteiden ajantasaisuuden.  
**Hallintapaneelin jälkeen:**  

| Mittari | Perustaso | Hallintapaneeli |
|----------|-----------|-----------------|
| Vastausten keskimääräinen läpimenoaika | 4,2 h | **1,1 h** |
| Poikkeamiin johtuva uudelleentyö | 28 % vastauksista | **3 %** |
| Auditointihenkilöiden tyytyväisyys (1‑5) | 2,8 | **4,7** |
| Pakettien vientiaika | 6 h | **45 min** |

Provenanssin visualisointi lyhentää auditoinnin valmistelua **70 %**, ja automaattiset poikkeamalähetykset säästävät arviolta **160 työ­tuntia vuodessa**.

---

## 7. Vaihe‑askeleinen toteutusopas  

1. **Ota tietämyskartan synkronointi käyttöön** – yhdistä politiikkarepositoriosi, asiakirjavarasto ja ulkoiset compliance‑syötteet Procurize‑asetuksissa.  
2. **Aktivoi Provenanssi‑palvelu** – kytke “Evidence Versioning & Drift Detection” -asetus hallintapaneelin admin‑konsolissa.  
3. **Määritä Mermaid‑hallintapaneeli** – lisää `dashboard.provenance.enabled = true` `procurize.yaml`‑konfiguraatioon.  
4. **Rakenna hyväksymistyövirrat** – käytä “Workflow Builderia” lisätäksesi “Legal Sign‑Off” ja “Security Owner” -vaiheet jokaiselle todiste‑solmulle.  
5. **Kouluta tiimi** – pidä 30 minuutin live‑demo, jossa käydään läpi solmujen klikkaus, poikkeamien käsittely ja vientitoiminnot.  
6. **Upota auditointisivustoihin** – hyödynnä IFrame‑koodinpätkää sisällyttääksesi hallintapaneelin ulkoiseen auditointialustaan.  

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

7. **Seuraa mittareita** – valvo “Drift Events”, “Export Count” ja “Avg. Answer Time” Procurize‑analytiikkapaneelissa mitataksesi ROI:ta.

---

## 8. Tulevaisuuden parannukset  

| Tuleva ominaisuus | Kuvaus |
|-------------------|--------|
| **AI‑pohjainen poikkeamien ennustaminen** | Käytä LLM‑pohjaista trendianalyysiä politiikkamuutoksista ennakoimaan poikkeamia ennen niiden ilmestymistä. |
| **Risti‑toimittajien provenance‑jakaminen** | Federatiivinen KG‑tila, joka mahdollistaa kumppaniyritysten jakaman provenance‑tiedon ilman raakadokumenttien paljastamista. |
| **Ääni‑ohjattu navigointi** | Integroi Procurize Voice Assistant, jonka avulla tarkistajat voivat kysyä “Näytä Q‑34:n lähde”. |
| **Live‑yhteistyö** | Reaaliaikainen monen käyttäjän editointi todiste‑solmuissa, jossa läsnäolotiedot renderöidään suoraan Mermaid‑kaavioon. |

---

## 9. Yhteenveto  

Procurize‑interaktiivinen Mermaid‑pohjainen todistusaineiston alkuperän hallintapaneeli mullistaa turvallisuuskyselyjen automaation läpinäkyväksi, tarkistettavaksi ja yhteistyöhön perustuvaksi kokemukseksi. Yhdistämällä AI‑luodut vastaukset elävään vaatimustenmukaisuuden tietämyskarttaan organisaatiot saavat **välittömän perimyksen näkyvyyden**, **automaattisen poikkeamien hallinnan** ja **auditointivalmiit artefaktit** — kaikki ilman nopeutta uhraavaa monimutkaisuutta.

Tämän visuaalisen provenance‑kerroksen omaksuminen ei ainoastaan nopeuta auditointisyklejä, vaan myös vahvistaa luottamusta regulaattoreihin, kumppaneihin ja asiakkaisiin, sillä turvallisuusväitteet on **tukena muuttumattomalla, reaaliaikaisella todistusaineistolla**.