====== WvdS Audit Plugin ======

**Versione:** 1.0\\
**Autore:** Wolfgang van der Stille <zeljko.petrusic@outlook.de>\\
**Licenza:** GPL 2

----

===== Descrizione =====

Il plugin **wvdsaudit** consente l'incorporamento di badge di audit nelle pagine wiki con calcolo automatico dello stato basato sulla sintassi delle checkbox.

**Funzionalità:**
  * Calcolo automatico dello stato (passed/issues/critical)
  * Le sezioni critiche possono essere contrassegnate
  * Override manuale possibile
  * Schema colori Fluent Design (compatibile con Note plugin)
  * Multilingue (DE, EN, SL, HR, IT)

----

===== Sintassi =====

==== Variante 1: Sezioni esplicite ====

<code xml>
<wvds:audit stack="stack-name" title="Titolo-modulo">
  <wvds:audit:result value="passed|issues|critical" />  <!-- Opzionale: Override -->

  <wvds:section title="Titolo-sezione" ref="wiki:link" critical="true">
    [x] Superato
    [ ] Non superato
    [-] Non applicabile
  </wvds:section>
</wvds:audit>
</code>

==== Variante 2: Include (consigliato) ====

Carica automaticamente il titolo della sezione dalla pagina wiki referenziata:

<code xml>
<wvds:audit stack="vsix" title="FPC Solution Explorer 2">
  <!-- Con testo completo -->
  <wvds:include ref="code:qualitaet" critical="true">
    [ ] Nessun commento TODO (22 trovati)
    [x] Nessuna funzione stub
  </wvds:include>

  <!-- Modalità template: orizzontale (compatta) -->
  <wvds:include ref="stacks:vscode-extension">[x][x][ ][x][x]</wvds:include>

  <!-- Modalità template: verticale -->
  <wvds:include ref="sicherheit:kritis">
[x]
[x]
[-]
  </wvds:include>
</wvds:audit>
</code>

**Vantaggi Include:**
  * Il titolo della sezione viene caricato automaticamente dalla pagina checklist
  * Il link alla checklist viene impostato automaticamente
  * Sintassi più breve, meno soggetta a errori
  * Multilingue: il titolo viene caricato dalla pagina specifica per lingua
  * **Modalità template:** Testi degli elementi dalle pagine di revisione (solo lo stato è indicato)

===== Attributi =====

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

^ Attributo ^ Obbligatorio ^ Descrizione ^
| ''stack'' | No | Identificatore stack (vsix, doku, fpc, ecc.) |
| ''title'' | Sì | Titolo visualizzato dell'audit |

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

^ Attributo ^ Descrizione ^
| ''value'' | Override: ''passed'', ''issues'', ''critical'' o ''auto'' |

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

^ Attributo ^ Obbligatorio ^ Descrizione ^
| ''title'' | Sì | Titolo della sezione |
| ''ref'' | No | Link wiki alla checklist (senza prefisso lingua) |
| ''critical'' | No | Se ''true'', ''[ ]'' risulta in CRITICAL invece di ISSUES |

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

^ Attributo ^ Obbligatorio ^ Descrizione ^
| ''ref'' | Sì | Link wiki alla checklist (es. ''code:qualitaet'', ''stacks:vscode-extension'') |
| ''critical'' | No | Se ''true'', ''[ ]'' risulta in CRITICAL invece di ISSUES |

**Nota:** Il titolo della sezione viene caricato automaticamente dal primo heading (''====== Titolo ======'') della pagina referenziata.

----

===== Sintassi checkbox =====

^ Sintassi ^ Stato ^ Significato ^
| ''[x]'' | passed | Punto di controllo superato |
| ''[ ]'' | failed | Punto di controllo non superato |
| ''[-]'' | na | Non applicabile (ignorato) |

----

===== Calcolo stato =====

^ Condizione ^ Stato ^ Colore ^
| Tutti ''[x]'' | passed | Verde (#dff6dd) |
| Almeno un ''[ ]'' (non critico) | issues | Arancione (#fff4ce) |
| ''[ ]'' in sezione ''critical="true"'' | critical | Rosso (#fde7e9) |

----

===== Esempi =====

==== Tutto superato (Verde) ====

<wvds:audit stack="demo" title="Modulo perfetto">
  <wvds:section title="Qualità codice" ref="code:qualitaet">
    [x] Nessun commento TODO
    [x] Nessun commento FIXME
  </wvds:section>
</wvds:audit>

==== Con problemi (Arancione) ====

<wvds:audit stack="demo" title="Modulo con problemi">
  <wvds:section title="Documentazione" ref="infrastruktur:dokumentation">
    [x] README presente
    [ ] API documentata
  </wvds:section>
</wvds:audit>

==== Critico (Rosso) ====

<wvds:audit stack="demo" title="Modulo critico">
  <wvds:section title="Sicurezza" ref="sicherheit:kritis" critical="true">
    [ ] Validazione input
    [x] Gestione errori
  </wvds:section>
</wvds:audit>

----

===== File =====

<code>
lib/plugins/wvdsaudit/
├── plugin.info.txt     # Metadati plugin
├── syntax.php          # Parser sintassi
├── helper.php          # Calcolo stato e rendering
├── style.css           # Stile Fluent Design
├── conf/
│   ├── default.php     # Impostazioni predefinite
│   └── metadata.php    # UI Admin
└── lang/
    ├── de/lang.php     # Tedesco
    ├── en/lang.php     # Inglese
    ├── sl/lang.php     # Sloveno
    ├── hr/lang.php     # Croato
    └── it/lang.php     # Italiano
</code>

----

===== Classi CSS =====

^ Classe ^ Descrizione ^
| ''.wvds-audit'' | Container |
| ''.wvds-audit-passed'' | Stato verde |
| ''.wvds-audit-issues'' | Stato arancione |
| ''.wvds-audit-critical'' | Stato rosso |
| ''.wvds-audit-header'' | Area header |
| ''.wvds-audit-body'' | Body con sezioni |
| ''.wvds-audit-section'' | Singola sezione |
| ''.wvds-audit-item-passed'' | Elemento superato |
| ''.wvds-audit-item-failed'' | Elemento non superato |
| ''.wvds-audit-item-na'' | Elemento N/A |

----

===== Vedi anche =====

  * [[.:it:review:start|Checklist di revisione]]
  * [[.:it:test:wvdsaudit_demo|Pagina demo]]

----

<wvds:audit stack="doku" title="wvdsaudit Plugin">
  <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~~