
# Dünaamiline lepinguliste klauselite kaardistamine tehisintellekti abil turvaküsimustike jaoks

## Miks lepinguliste klauselite kaardistamine on oluline

Turvaküsimustikud on B2B SaaS‑tehingute väravavõtmed. Tavaline küsimustik võib sisaldada selliseid küsimusi:

* *“Kas krüpteerite andmeid puhkeolekus? Palun andke viide klauslile oma teenusetingimusest.”*  
* *“Mis on teie intsidendireaktsiooni aeg? Viidake asjakohasele sättlusele oma andmetöötluse lisaettepanekus.”*  

Nendele küsimustele täpne vastamine nõuab õige klausli leidmist lepingute, lisaettepanekute ja poliitikadokumentide ookeanist. Traditsiooniline käsitsi lähenemine kannatab kolme kriitilise puudumise all:

1. **Ajakulu** – Turvatiimid veedavad tunduvalt tunde õigete lõikude otsimisele.  
2. **Inimlik viga** – Vale klausli viitamine võib viia compliance‑aukude või auditi ebaõnnestumiseni.  
3. **Vananenud viited** – Lepingud arenevad; vanad klauslinumbrid muutuvad aegunuks, kuid küsimustiku vastused jäävad muutumatuks.

**Dünaamiline lepinguliste klauselite kaardistamise (DCCM) mootor** lahendab kõik kolm probleemi, muutes lepingukogud otsitavaks, ise‑hooldavaks teadmistegraafikuks, mis võimaldab reaalajas AI‑genereeritud vastuseid.

---

## DCCM mootorite põhialus

Allpool on DCCM torujuhtme kõrgetaseme vaade. Diagramm kasutab **Mermaid** süntaksit, et illustreerida andmevoogu ja otsustuspunkte.

```mermaid
stateDiagram-v2
    [*] --> IngestContracts: "Document Ingestion"
    IngestContracts --> ExtractText: "OCR & Text Extraction"
    ExtractText --> Chunkify: "Semantic Chunking"
    Chunkify --> EmbedChunks: "Vector Embedding (RAG)"
    EmbedChunks --> BuildKG: "Knowledge Graph Construction"
    BuildKG --> UpdateLedger: "Attribution Ledger Entry"
    UpdateLedger --> [*]

    state AIResponder {
        ReceiveQuestion --> RetrieveRelevantChunks: "Vector Search"
        RetrieveRelevantChunks --> RAGGenerator: "Retrieval‑Augmented Generation"
        RAGGenerator --> ExplainabilityLayer: "Citation & Confidence Scores"
        ExplainabilityLayer --> ReturnAnswer: "Formatted Answer with Clause Links"
    }

    [*] --> AIResponder
```

**Olulised komponendid selgitatud**

| Komponent | Eesmärk | Tehnoloogiad |
|-----------|---------|--------------|
| **IngestContracts** | Tõmmab lepingud, lisaettepanekud, SaaS‑tingimused pilvesalvestusest, SharePointist või GitOps‑repoost. | Sündmuspõhine Lambda, S3‑käivitused |
| **ExtractText** | Muudab PDF‑id, skannid ja Word‑failid tooresse tekstiks. | OCR (Tesseract), Apache Tika |
| **Chunkify** | Lõikab dokumendid semantilisteks koherentsseteks sektsioonideks (tavaliselt 1‑2 lõiku). | Kohandatud NLP‑jaotur, mis põhineb pealkirjadel ja loeteluhierarhial |
| **EmbedChunks** |Kodeerib iga lõigu tihedaks vektoriks sarnasuse otsimiseks. | Sentence‑Transformers (all‑MiniLM‑L12‑v2) |
| **BuildKG** | Loob omadusgraafi, kus sõlmed = klauslid, servad = viited, kohustused või seotud standardid. | Neo4j + GraphQL API |
| **UpdateLedger** | Salvestab immutaablse päritolu iga lisatud või muudetud lõigu kohta. | Hyperledger Fabric (ainult‑lisatav register) |
| **RetrieveRelevantChunks** | Leiab antud küsimuse jaoks top‑k sarnased lõigud. | FAISS / Milvus vektor‑DB |
| **RAGGenerator** | Kombineerib leitud teksti LLM‑iga, et genereerida lühike vastus. | OpenAI GPT‑4o / Anthropic Claude‑3.5 |
| **ExplainabilityLayer** | Lisab viited, kindlustus‑skooride ja visuaalse tükiku klauslist. | LangChain Explainability Toolkit |
| **ReturnAnswer** | Tagastab vastuse Procurize UI‑s klikitavate klauslivõtmetega. | React front‑end + Markdown renderdus |

---

## Retrieval‑Augmented Generation (RAG) ja lepingulise täpsuse kooskõla

Standardsed LLM‑id võivad hallutsineerida, kui küsitakse lepinguvõtmeid. Kui generatsiooni juures on *reaalselt* lepingulised lõigud, tagab DCCM mootori faktikindluse:

1. **Küsimuse vektorisõnastus** – Kasutaja küsimus muudetakse vektoriks.  
2. **Top‑k otsing** – FAISS tagastab kõige sarnasemad lepingulised lõigud (k=5 vaikimisi).  
3. **Prompt‑ehitus** – Leitud tükid sisestatakse süsteemiprompti, mis sunnib LLM‑i viitama allikatele selgelt:

```
You are a compliance assistant. Use ONLY the provided contract excerpts to answer the question. 
For each answer, end with "Clause: <DocumentID>#<ClauseNumber>".
If the excerpt does not contain enough detail, respond with "Information not available".
```

4. **Järeltöötlus** – Mootor analüüsib LLM‑i väljundit, kontrollib, et iga viidatud klausl eksisteerib teadmistegraafikus, ning lisab kindlustus‑skoori (0–100). Kui skoor langeb alla konfigureeritud läve (nt 70), märgitakse vastus inimese ülevaatamiseks.

---

## Selgitav atribuudi register

Auditorid nõuavad tõendeid *kust* iga vastus pärineb. DCCM mootor kirjutab **krüptograafiliselt allkirjastatud registreerimise kirje** iga kaardistamise sündmuse kohta:

```json
{
  "question_id": "Q-2025-07-12-001",
  "answer_hash": "sha256:8f3e...",
  "referenced_clause": "SA-2024-08#12.3",
  "vector_similarity": 0.94,
  "llm_confidence": 88,
  "timestamp": "2025-12-01T08:31:45Z",
  "signature": "0xABCD..."
}
```

See register:

* Tagab muutumatuid auditi jälgi.  
* Võimaldab **null‑teadmiste tõendeid**, mille abil regulaator saab kontrollida viite eksistentsi, paljastamata kogu lepingut.  
* Toetab **policy‑as‑code** jõustamist – kui klausl muutub aegunuks, flagib register automaatselt kõik sõltuvad küsimustikuvastused uuesti hindamiseks.

---

## Reaalajas kohandamine klausli „drift“‑i korral

Lepingud on elavad dokumendid. Kui klausl muudetakse, arvutab **muutuse‑tuvastusteenus** uuesti mõjutatud lõigu vektorid, uuendab teadmistegraafi ning genereerib registreerimise kirje kõigi küsimustiku vastuste jaoks, mis viitasid muudetud klauslile. See tsükkel kestab tavaliselt **2–5 sekundi**, tagades, et Procurize UI peegeldab alati värskeimat lepinguteksti.

### Näidissstsenaarium

*Algne klausl* (versioon 1):  
> “Andmeid krüpteeritakse puhkeolekus kasutades AES‑256.”

*Uuendatud klausl* (versioon 2):  
> “Andmeid krüpteeritakse puhkeolekus kasutades AES‑256 või ChaCha20‑Poly1305, sõltuvalt asjakohasusest.”

Muudatuse käigus:

1. Klausli sisseehitatud vektor uuendatakse.  
2. Kõik vastused, mis varem viitasid “Klausl 2.1”, käivitatakse uuesti RAG‑generaatoris.  
3. Kui uuendatud klausl lisab valikuvõimaluse, võib kindlustus‑skoor langeda, sundides turvategevuse ülevaatajat vastust kinnitama.  
4. Register salvestab **drift‑sündmuse**, mis seob vana ja uue klausli ID‑d.

---

## Kvantifitseeritud eelised

| Mõõdik | Enne DCCM | Pärast DCCM (30‑päevane piloot) |
|--------|-----------|--------------------------------|
| Keskmine aeg klausliviitega vastuse andmiseks | 12 min (käsitsi otsing) | 18 sek (AI‑põhine) |
| Inimliku vea määr (valesti viidatud klauslid) | 4,2 % | 0,3 % |
| Protsent vastustest, mis vajavad lepingumuudatuste järel ülevaatamist | 22 % | 5 % |
| Auditori rahulolu skoor (1‑10) | 6 | 9 |
| Kogu küsimustiku läbiläbimise kiirendamine | 35 % | 78 % |

Need arvud näitavad, kuidas **üks AI‑mootor** suudab kitsaskoha tõhusalt muuta konkurentsieeliseks.

---

## Turvatiimide rakendamise kontrollnimekiri

1. **Dokumentide keskondamine** – Veenduge, et kõik lepingud on masinloetavas repositooriumis (PDF, DOCX või tavaline tekst).  
2. **Metaandmete rikastamine** – Sildistage iga leping `vendor`, `type` (SA, **[DPA](https://www.dpocentre.com/what-is-a-dpa-and-why-do-you-need-one/)**, SLA) ja `effective_date`.  
3. **Ligipääsukontroll** – Anna DCCM‑teenusele ainult lugemisõigused; kirjutamisõigused on piiratud attribuudiregistri juurde.  
4. **Poliitika valitsemine** – Määrake kindlustus‑läve poliitika (nt > 80 % automaataktsept).  
5. **Inimese‑kaasamine (HITL)** – Määra compliance‑ülevaataja haldama madala kindlustusega vastuseid.  
6. **Pidev monitooring** – Aktiveeri hoiatused klausli‑drift‑sündmustele, mis ületavad riskiskoori läve.  

Nende sammude järgimine tagab sujuva juurutuse ja maksimeerib ROI‑d.

---

## Tuleviku visioon

| Kvartal | Initsiatiiv |
|--------|------------|
| Q1 2026 | **Mitmekeelne klausli otsing** – Kasutada mitmekeelseid vektoreid, et toetada lepinguid prantsuse, saksa ja jaapani keeles. |
| Q2 2026 | **Null‑teadmiste tõendite auditid** – Luba regulaatoritel tõestada klausli päritolu ilma kogu lepinguteksti avaldamata. |
| Q3 2026 | **Edge‑AI juurutamine** – Käivitada sisseehitatud embeddingu toru kohapeal äärmiselt reguleeritud tööstustes (finants, tervishoid). |
| Q4 2026 | **Genereeriv klauslite koostamine** – Kui nõutud klauslit puudub, pakub mootor välja mustrikujulise keele, mis vastab tööstusstandarditele. |

---

## Kokkuvõte

Dünaamiline lepinguliste klauselite kaardistamine ühendab õigusalase proosa ja turvaküsimustike nõuded. Kombineerides Retrieval‑Augmented Generation'i semantilise teadmistegraafikuga, muutumatut atribuudi registrit ning reaalajas drifti tuvastamist, võimaldab Procurize turvatiimidel vastata kindlalt, vähendada läbiläbimise aega ja rahuldada auditeure — kõik samal ajal hoides lepingud automaatselt ajakohasena.

SaaS‑ettevõtetele, kes soovivad võita ettevõtte lepinguid kiiremini, on DCCM mootor **ei ole enam ainult “nice‑to‑have” – see on *vajalik* konkurentsieelistus**.