====== WvdS Audit Dodatak ======

**Verzija:** 1.0\\
**Autor:** Wolfgang van der Stille <zeljko.petrusic@outlook.de>\\
**Licenca:** GPL 2

----

===== Opis =====

Dodatak **wvdsaudit** omogućuje ugrađivanje revizijskih oznaka na wiki stranice s automatskim izračunom statusa na temelju sintakse potvrdnih okvira.

**Značajke:**
  * Automatski izračun statusa (passed/issues/critical)
  * Kritične sekcije mogu se označiti
  * Moguće ručno nadjačavanje
  * Fluent Design shema boja (kompatibilno s Note dodatkom)
  * Višejezično (DE, EN, SL, HR)

----

===== Sintaksa =====

==== Varijanta 1: Eksplicitne sekcije ====

<code xml>
<wvds:audit stack="stack-name" title="Naslov-modula">
  <wvds:audit:result value="passed|issues|critical" />  <!-- Opcionalno: Nadjačavanje -->

  <wvds:section title="Naslov-sekcije" ref="wiki:poveznica" critical="true">
    [x] Prošlo
    [ ] Nije prošlo
    [-] Nije primjenjivo
  </wvds:section>
</wvds:audit>
</code>

==== Varijanta 2: Include (preporučeno) ====

Automatski učitava naslov sekcije s referencirane wiki stranice:

<code xml>
<wvds:audit stack="vsix" title="FPC Solution Explorer 2">
  <!-- S punim tekstom -->
  <wvds:include ref="code:qualitaet" critical="true">
    [ ] Bez TODO komentara (22 pronađeno)
    [x] Bez stub funkcija
  </wvds:include>

  <!-- Način predloška: horizontalno (kompaktno) -->
  <wvds:include ref="stacks:vscode-extension">[x][x][ ][x][x]</wvds:include>

  <!-- Način predloška: vertikalno -->
  <wvds:include ref="sicherheit:kritis">
[x]
[x]
[-]
  </wvds:include>
</wvds:audit>
</code>

**Prednosti Include:**
  * Naslov sekcije se automatski učitava sa stranice s popisom za provjeru
  * Poveznica na popis za provjeru se automatski postavlja
  * Kraća sintaksa, manje sklonost greškama
  * Višejezično: Naslov se učitava s jezično specifične stranice
  * **Način predloška:** Tekstovi stavki sa stranica za pregled (naveden je samo status)

===== Atributi =====

==== <wvds:audit> ====

^ Atribut ^ Obavezno ^ Opis ^
| ''stack'' | Ne | Identifikator stacka (vsix, doku, fpc, itd.) |
| ''title'' | Da | Prikazni naslov revizije |

==== <wvds:audit:result> ====

^ Atribut ^ Opis ^
| ''value'' | Nadjačavanje: ''passed'', ''issues'', ''critical'' ili ''auto'' |

==== <wvds:section> ====

^ Atribut ^ Obavezno ^ Opis ^
| ''title'' | Da | Naslov sekcije |
| ''ref'' | Ne | Wiki poveznica na popis za provjeru (bez jezičnog prefiksa) |
| ''critical'' | Ne | Ako ''true'', ''[ ]'' rezultira u CRITICAL umjesto ISSUES |

==== <wvds:include> (NOVO) ====

^ Atribut ^ Obavezno ^ Opis ^
| ''ref'' | Da | Wiki poveznica na popis za provjeru (npr. ''code:qualitaet'', ''stacks:vscode-extension'') |
| ''critical'' | Ne | Ako ''true'', ''[ ]'' rezultira u CRITICAL umjesto ISSUES |

**Napomena:** Naslov sekcije se automatski učitava iz prvog naslova (''====== Naslov ======'') referencirane stranice.

----

===== Sintaksa potvrdnih okvira =====

^ Sintaksa ^ Status ^ Značenje ^
| ''[x]'' | passed | Kontrolna točka prošla |
| ''[ ]'' | failed | Kontrolna točka nije prošla |
| ''[-]'' | na | Nije primjenjivo (zanemareno) |

----

===== Izračun statusa =====

^ Uvjet ^ Status ^ Boja ^
| Sve ''[x]'' | passed | Zelena (#dff6dd) |
| Najmanje jedan ''[ ]'' (nekritično) | issues | Narančasta (#fff4ce) |
| ''[ ]'' u ''critical="true"'' sekciji | critical | Crvena (#fde7e9) |

----

===== Primjeri =====

==== Sve prošlo (Zeleno) ====

<wvds:audit stack="demo" title="Savršen modul">
  <wvds:section title="Kvaliteta koda" ref="code:qualitaet">
    [x] Bez TODO komentara
    [x] Bez FIXME komentara
  </wvds:section>
</wvds:audit>

==== S problemima (Narančasto) ====

<wvds:audit stack="demo" title="Modul s problemima">
  <wvds:section title="Dokumentacija" ref="infrastruktur:dokumentation">
    [x] README prisutan
    [ ] API dokumentiran
  </wvds:section>
</wvds:audit>

==== Kritično (Crveno) ====

<wvds:audit stack="demo" title="Kritičan modul">
  <wvds:section title="Sigurnost" ref="sicherheit:kritis" critical="true">
    [ ] Validacija unosa
    [x] Rukovanje greškama
  </wvds:section>
</wvds:audit>

----

===== Datoteke =====

<code>
lib/plugins/wvdsaudit/
├── plugin.info.txt     # Metapodaci dodatka
├── syntax.php          # Parser sintakse
├── helper.php          # Izračun statusa i renderiranje
├── style.css           # Fluent Design stilizacija
├── conf/
│   ├── default.php     # Zadane postavke
│   └── metadata.php    # Admin UI
└── lang/
    ├── de/lang.php     # Njemački
    ├── en/lang.php     # Engleski
    └── sl/lang.php     # Slovenski
</code>

----

===== CSS klase =====

^ Klasa ^ Opis ^
| ''.wvds-audit'' | Spremnik |
| ''.wvds-audit-passed'' | Zeleni status |
| ''.wvds-audit-issues'' | Narančasti status |
| ''.wvds-audit-critical'' | Crveni status |
| ''.wvds-audit-header'' | Područje zaglavlja |
| ''.wvds-audit-body'' | Tijelo sa sekcijama |
| ''.wvds-audit-section'' | Pojedinačna sekcija |
| ''.wvds-audit-item-passed'' | Prošla stavka |
| ''.wvds-audit-item-failed'' | Neuspješna stavka |
| ''.wvds-audit-item-na'' | N/A stavka |

----

===== Vidi također =====

  * [[.:hr:review:start|Popisi za pregled]]
  * [[.:hr:test:wvdsaudit_demo|Demo stranica]]

----

<wvds:audit stack="doku" title="wvdsaudit Dodatak">
  <wvds:include ref="code:qualitaet" critical="true">[x][x][x][x]</wvds:include>
  <wvds:include ref="stacks:dokuwiki-php">[x][x][x][x][x]</wvds:include>
  <wvds:include ref="sicherheit:kritis" critical="true">[x][x][x][-][-]</wvds:include>
</wvds:audit>

~~DISCUSSION:off~~