VARAM_classification_schema/VDVC_AI_Classification_Demo.md

# VDVC AI Classification Demo
## Konteksta meklēšana ar MCP — testa scenāriji

Šis dokuments demonstrē, kā AI aģents (Claude Desktop + MCP) klasificē dokumentus,
izmantojot V2 klasifikācijas shēmu ar AI konteksta aprakstiem.

---

## Darbības princips

```
┌─────────────┐    ┌──────────────┐    ┌────────────────┐    ┌──────────────┐
│  Lietvedis   │───>│  AI aģents   │───>│  MCP endpoint  │───>│  Best match  │
│  ielādē doc  │    │  analizē     │    │  search()      │    │  + score     │
│              │    │  saturu      │    │  get_entity()   │    │  + explain   │
└─────────────┘    └──────────────┘    └────────────────┘    └──────────────┘
```

**AI aģenta darba plūsma:**
1. Saņem dokumentu (PDF/DOCX/e-pasts)
2. Ekstrahē saturu — tekstu, metadatus, sūtītāju
3. Formulē MCP vaicājumu no satura atslēgvārdiem
4. MCP atgriež kandidātu sarakstu ar description laukiem
5. AI salīdzina dokumenta kontekstu ar IETVER/NEIETVER aprakstiem
6. Piedāvā lietvedim labāko atbilstību ar pamatojumu

---

## Testa dokuments Nr. 1: Vēstule no Kultūras ministrijas

### Dokumenta saturs
```
No: Kultūras ministrija
Kam: VARAM, Digitālās transformācijas departaments
Datums: 2026-01-15
Temats: Par sadarbību digitālā satura pieejamības nodrošināšanā

Godātā valsts sekretāre!

Kultūras ministrija informē, ka saskaņā ar Ministru kabineta 2025. gada 
12. septembra sēdes protokollēmumu Nr. 45, 12.§, ir nepieciešams izstrādāt 
kopīgu rīcības plānu digitālā kultūras mantojuma pieejamības nodrošināšanai. 
Lūdzam Jūs deleģēt atbildīgo personu līdz 2026. gada 31. janvārim.

Ar cieņu,
Kultūras ministrs J. Bērziņš
```

### AI aģenta analīze
```
Tēma: digitālais saturs, pieejamība, kultūras mantojums
Sūtītājs: Kultūras ministrija (ārēja valsts pārvaldes iestāde)
Saņēmējs: VARAM struktūrvienība
Tips: vēstule/pieprasījums
Process: starpministriju sadarbība
```

### MCP vaicājums
```json
{
  "tool": "search",
  "query": "sarakste valsts pārvaldes iestādes korespondence ministrija",
  "kind": "category"
}
```

### Gaidāmie kandidāti no MCP

| # | Kods | Nosaukums | Apraksta fragments |
|---|------|-----------|-------------------|
| 1 | **P-1-13** | Sarakste | "...saraksti ar ministrijām, valsts aģentūrām..." |
| 2 | I2-1 | Korespondence | "...investīciju projektu korespondence..." |
| 3 | I1-1-1 | Sarakste par programmas plānošanu | "...korespondence ar EK, FM..." |
| 4 | P-7-3 | Saņemtie informācijas pieprasījumi | "...sabiedrības pieprasījumi saskaņā ar IAL..." |

### AI lēmums

**Izvēle: P-1-13** (auditorijas tags: `state-admin-official`)

**Pamatojums:**
- P-1-13 apraksts saka: *"saraksti ar ministrijām, valsts aģentūrām"* → ✅ sakrīt
- I2-1 apraksts saka: *"NEIETVER: VARAM vispārīgo saraksti (P-1-13)"* → ✅ izslēgts
- I1-1-1 apraksts saka: *"korespondence par programmu izstrādi"* → ❌ nav par programmu
- P-7-3 apraksts saka: *"sabiedrības pieprasījumi saskaņā ar IAL"* → ❌ nav IAL pieprasījums

**Auditorijas tags**: `state-admin-official` (valsts pārvaldes iestādes dienesta vajadzībām)

---

## Testa dokuments Nr. 2: Iepirkuma specifikācija

### Dokumenta saturs
```
VARAM Publisko iepirkumu nodaļa
Iepirkuma identifikācijas Nr.: VARAM 2026/03-IT
Temats: Tehniskā specifikācija — IT infrastruktūras uzturēšanas pakalpojumi

1. Iepirkuma priekšmets
   IT infrastruktūras (serveri, tīkla iekārtas, UPS) uzturēšanas pakalpojumi 
   VARAM administratīvajā ēkā Peldu ielā 25, Rīgā.

2. Prasības pretendentiem
   - ISO 27001 sertifikāts
   - Vismaz 3 gadu pieredze valsts pārvaldes IT uzturēšanā

3. Līguma termiņš: 36 mēneši
4. Paredzamā līgumcena: līdz 150 000 EUR bez PVN
```

### AI aģenta analīze
```
Tēma: iepirkums, IT infrastruktūra, tehniskā specifikācija
Process: publiskais iepirkums (izsludināšanas fāze)
Budžets: pamatbudžets (nav ES fondu atsauces)
```

### MCP vaicājums
```json
{
  "tool": "search",
  "query": "iepirkums publiskais procedūra specifikācija nolikums",
  "kind": "category"
}
```

### Gaidāmie kandidāti

| # | Kods | Nosaukums | Atslēgas pazīme aprakstā |
|---|------|-----------|-------------------------|
| 1 | **P-5-2** | Publisko iepirkumu procedūru dokumentācija | "tehniskās specifikācijas, nolikumi..." |
| 2 | P-5-1 | Iepirkumu procesa pārvaldības dokumenti | "gada iepirkumu plāns, tirgus izpētes" |
| 3 | P-5-3 | Iepirkumu līgumu izpilde | "noslēgtie līgumi, pieņemšanas akti" |

### AI lēmums

**Izvēle: P-5-2**

**Pamatojums:**
- P-5-2: *"tehniskās specifikācijas, nolikumi, pretendentu piedāvājumi... No izsludināšanas līdz līguma slēgšanai"* → ✅ precīzi atbilst
- P-5-1: *"NEIETVER: konkrētu iepirkumu procedūru dokumentus (P-5-2)"* → ✅ pats saka, ka šis nav pareizais
- P-5-3: *"No līguma parakstīšanas līdz saistību izpildei"* → ❌ līgums vēl nav noslēgts
- Nav ES fondu atsauces → neiet uz I1/I2 domēniem (apraksts saka: *"NEIETVER: ES programmu iepirkumus (I1/I2)"*)

---

## Testa dokuments Nr. 3: CFLA vēstule par ANM projektu

### Dokumenta saturs
```
No: Centrālā finanšu un līgumu aģentūra (CFLA)
Kam: VARAM, Investīciju departaments
Ref: Nr. 2.2-1/2026/0142
Datums: 2026-02-03
Temats: Par projekta Nr. 2.3.1.1.i.0/1/24/I/VARAM/002 
        "Publiskās pārvaldes digitālā akadēmija" 
        2. starpposma mērķa izpildes apliecinājumiem

Informējam, ka pēc 2. starpposma mērķa izvērtēšanas konstatēts, ka 
3 no 5 iesniegtajiem apliecinājumiem neatbilst līguma nosacījumiem.
Lūdzam 15 darba dienu laikā iesniegt papildus dokumentāciju...
```

### AI aģenta analīze
```
Tēma: ANM projekts, starpposma mērķi, CFLA
Sūtītājs: CFLA (starpniekiestāde)
Projekts: "Publiskās pārvaldes digitālā akadēmija" (PRJ-029)
Process: projekta uzraudzība / apliecinājumu iesniegšana
```

### MCP vaicājums
```json
{
  "tool": "search",
  "query": "projekts korespondence CFLA ANM investīciju",
  "kind": "category"
}
```

### Gaidāmie kandidāti

| # | Kods | Nosaukums | Atslēgas pazīme |
|---|------|-----------|-----------------|
| 1 | **I2-1** | Korespondence | "projektu līmeņa sarakste — ar EK, CFLA, partneriem" |
| 2 | I1-10-1 | Projektu uzraudzības sarakste | "par projektu īstenošanas uzraudzību — CFLA komunikācija" |
| 3 | P-1-13 | Sarakste | "saraksti ar ministrijām, valsts aģentūrām" |

### AI lēmums

**Izvēle: I2-1** (projekta tags: `PRJ-029`)

**Pamatojums:**
- I2-1: *"visa projektu līmeņa sarakste — ar EK, CFLA, partneriem"* → ✅ CFLA vēstule par konkrētu projektu
- I1-10-1: *"par projektu īstenošanas uzraudzību"* → šis ir programmu līmenis, ne projekta līmenis
- P-1-13: *"NEIETVER: investīciju projektu korespondenci (I2-1)"* → ✅ pats izslēdz

**Tags**: `project=PRJ-029` (Publiskās pārvaldes digitālā akadēmija)

---

## Testa dokuments Nr. 4: Darbinieka disciplinārlieta

### Dokumenta saturs
```
VARAM Personāla nodaļa
Rīkojums Nr. P-4/2026
Datums: 2026-01-20
Par dienesta pārbaudes uzsākšanu

Pamatojoties uz 2026. gada 15. janvāra dienesta ziņojumu Nr. DZ-12/2026 
par iespējamiem Ētikas kodeksa pārkāpumiem, uzsākt dienesta pārbaudi 
attiecībā uz ierēdni [VĀRDS UZVĀRDS], departamenta [X] vecāko referentu.

Dienesta pārbaudes komisijā iekļaut:
1. [komisijas locekļi]
Pārbaudes termiņš: līdz 2026. gada 20. februārim.
```

### AI aģenta analīze
```
Tēma: disciplinārlieta, dienesta pārbaude, ētikas pārkāpums
Tips: rīkojums (bet par disciplinārlietu, ne personālsastāvu)
Process: dienesta pārbaude
```

### MCP vaicājums
```json
{
  "tool": "search",
  "query": "disciplinārlieta dienesta pārbaude rīkojums paskaidrojumi",
  "kind": "category"
}
```

### Gaidāmie kandidāti

| # | Kods | Nosaukums | Atslēgas pazīme |
|---|------|-----------|-----------------|
| 1 | **P-3-7** | Rīkojumi par disciplinārlietām | "dienesta pārbaužu materiāli — paskaidrojumi, atzinumi..." |
| 2 | P-1-2 | Rīkojumi pamatdarbības jautājumos | "rīkojumi par darba grupām, komisijām..." |
| 3 | P-3-1 | Rīkojumi par personālsastāvu | "rīkojumi par iecelšanu, atbrīvošanu..." |

### AI lēmums

**Izvēle: P-3-7**

**Pamatojums:**
- P-3-7: *"rīkojumi par disciplinārsoda piemērošanu, pārbaužu materiāli... Visa lietas gaita no pārbaudes uzsākšanas līdz lēmumam"* → ✅ precīzi
- P-1-2: *"NEIETVER: rīkojumus par disciplinārlietām (P-3-7)"* → ✅ pats izslēdz
- P-3-1: *"NEIETVER: rīkojumus par disciplinārlietām (P-3-7)"* → ✅ pats izslēdz
- P-1-6 (trauksmes cēlēji): *"NEIETVER: disciplinārlietām, kas uzsāktas neatkarīgi"* → nav trauksme

---

## Testa dokuments Nr. 5: Žurnālista informācijas pieprasījums

### Dokumenta saturs
```
No: janis.ozolins@tvnet.lv
Kam: pasts@varam.gov.lv
Datums: 2026-01-28
Temats: Informācijas pieprasījums par VARAM IT izdevumiem

Labdien!

Saskaņā ar Informācijas atklātības likuma 10. un 11. pantu lūdzu sniegt 
šādu informāciju:
1. VARAM kopējie IT pakalpojumu izdevumi 2024. un 2025. gadā
2. Līgumu saraksts ar IT pakalpojumu sniedzējiem (summas virs 10 000 EUR)
3. Vai ir plānots iepirkums par jaunu dokumentu vadības sistēmu

Paldies,
Jānis Ozoliņš, žurnālists, TVNet
```

### AI aģenta analīze
```
Tēma: informācijas pieprasījums, IT izdevumi, IAL
Sūtītājs: žurnālists (ārēja persona)
Process: Informācijas atklātības likums
Atslēgas pazīme: "saskaņā ar IAL 10. un 11. pantu"
```

### MCP vaicājums
```json
{
  "tool": "search",
  "query": "informācijas pieprasījums atklātības likums sabiedrība",
  "kind": "category"
}
```

### Gaidāmie kandidāti

| # | Kods | Nosaukums | Atslēgas pazīme |
|---|------|-----------|-----------------|
| 1 | **P-7-3** | Saņemtie informācijas pieprasījumi | "saskaņā ar IAL — pieprasījumi, atbildes, atteikumi" |
| 2 | P-1-13 | Sarakste | "saraksti ar dažādām organizācijām un personām" |
| 3 | P-7-2 | Publiskā informācija | "preses relīzes, raksti..." |

### AI lēmums

**Izvēle: P-7-3**

**Pamatojums:**
- P-7-3: *"sabiedrības pieprasījumi saskaņā ar Informācijas atklātības likumu (IAL)... Ietver žurnālistu pieprasījumus"* → ✅ precīzi sakrīt
- P-1-13: *"NEIETVER: informācijas pieprasījumus pēc IAL (P-7-3)"* → ✅ pats izslēdz
- P-7-2: attiecas uz VARAM radīto saturu, ne saņemtajiem pieprasījumiem

---

## Kopsavilkums: Aprakstu pievienotā vērtība

| Testa Nr. | Bez apraksta (kandidātu skaits) | Ar aprakstu (precizitāte) | Izšķirošais NEIETVER |
|-----------|--------------------------------|--------------------------|---------------------|
| 1 | 4 kandidāti, nav skaidrs | **P-1-13** (100%) | I2-1 saka "NEIETVER: vispārīgo saraksti" |
| 2 | 3 kandidāti P-5 grupā | **P-5-2** (100%) | P-5-1 saka "NEIETVER: procedūru dokumentus" |
| 3 | 3 kandidāti, sajaukšana ar P | **I2-1** (100%) | P-1-13 saka "NEIETVER: projektu korespondenci" |
| 4 | 3 rīkojumu kodi | **P-3-7** (100%) | P-1-2 un P-3-1 abi saka "NEIETVER: disciplinārlietas" |
| 5 | 3 komunikācijas kodi | **P-7-3** (100%) | P-1-13 saka "NEIETVER: pieprasījumus pēc IAL" |

**Galvenais secinājums:** NEIETVER norādes ar konkrētiem koda numuriem ir kritiski svarīgas — tās ļauj AI izslēgt nepareizos kandidātus pat tad, kad nosaukumi ir līdzīgi.

---

## ProcessGit MCP konfigurācija

Lai MCP serveris atgriež pilnus aprakstus, `processgit.mcp.yaml` jānodrošina, ka `search` atgriež `description` lauku. Pašreizējā konfigurācija:

```yaml
# processgit.mcp.yaml — triggers for VDVC classification
schema: processgit-mcp/v1
source:
  type: xml
  path: classification-v2-ai.xml
  xsd: vdvc-classification.xsd
  namespace: "urn:vdvc:classification:2026"

entities:
  - type: category
    xpath: "//vdvc:category"
    id: "@code"
    fields:
      name: "vdvc:name"
      description: "vdvc:description"    # ← AI context field
      retention: "vdvc:retention/@original"
      department: "vdvc:departmentRef"
    search_fields: [name, description]    # ← searchable by both name AND description

  - type: group
    xpath: "//vdvc:group"
    id: "@code"
    fields:
      name: "vdvc:name"

  - type: domain
    xpath: "//vdvc:domain"
    id: "@code"
    fields:
      name: "vdvc:name"

search:
  default_kind: category
  include_description: true               # ← return descriptions in search results
  max_results: 10
```

## Claude Desktop MCP pieslēguma konfigurācija

```json
{
  "mcpServers": {
    "vdvc-classification": {
      "url": "https://processgit.org/VARAM/Document_classification_schema/mcp",
      "name": "VDVC Classification",
      "description": "VARAM dokumentu klasifikācijas shēma ar AI konteksta aprakstiem"
    }
  }
}
```

## Sistēmas prompt AI aģentam

```
Tu esi VARAM lietvedības AI palīgs. Tev ir pieejams MCP serveris ar dokumentu 
klasifikācijas shēmu.

Kad saņem dokumentu klasifikācijai:
1. Analizē dokumenta saturu — tēmu, sūtītāju, procesu, kontekstu
2. Izsauc MCP search() ar atslēgvārdiem no satura
3. Saņemtajiem kandidātiem pārbaudi DESCRIPTION lauku:
   - Vai IETVER sadaļa atbilst dokumentam?
   - Vai kāds NEIETVER norāda uz citu, precīzāku kodu?
4. Piedāvā labāko kodu AR PAMATOJUMU — citē IETVER/NEIETVER

Ja vairāki kandidāti ir vienlīdz atbilstoši, norādi visus un jautā lietvedim.
Ja neviens neatbilst — norādi tuvāko un iesaki pārskatīt shēmu.
```