====== WvdS Audit Plugin - Demo ======

Diese Seite demonstriert das neue wvdsaudit Plugin mit verschiedenen Status-Varianten.

----

===== Live-Beispiel: FPC Solution Explorer 2 =====

Dieses Audit wurde automatisch aus der Code-Analyse generiert:

<wvds:audit stack="vsix" title="FPC Solution Explorer 2">
  <wvds:section title="Code-Qualität" ref="code:qualitaet" critical="true">
    [ ] Keine TODO-Kommentare (22 gefunden)
    [ ] Keine FIXME-Kommentare
    [x] Keine Stub-Funktionen
    [x] Keine Magic Numbers (Constants.pas)
  </wvds:section>
  <wvds:section title="VSCode Extension" ref="stacks:vscode-extension">
    [ ] activationEvents definiert
    [x] Commands konsistent (IDs, Titles, Category)
    [x] Settings dokumentiert und validiert
    [ ] repository Feld in package.json
    [ ] CHANGELOG.md existiert
    [x] README.md vorhanden
  </wvds:section>
  <wvds:section title="Projektstruktur" ref="projekt:struktur">
    [x] src/ Source Code (sauber)
    [x] dist/ Build Output
    [x] Namespace-Struktur korrekt
  </wvds:section>
</wvds:audit>

**Ergebnis:** CRITICAL (Rot) - weil Code-Qualität Section ''critical="true"'' ist und [ ] Items enthält.

----

===== Test: Alles bestanden (Grün) =====

<wvds:audit stack="demo" title="Perfektes Modul">
  <wvds:section title="Code-Qualität" ref="code:qualitaet">
    [x] Keine TODO-Kommentare
    [x] Keine FIXME-Kommentare
    [x] Keine Stub-Funktionen
  </wvds:section>
  <wvds:section title="Dokumentation" ref="infrastruktur:dokumentation">
    [x] README vorhanden
    [x] API dokumentiert
  </wvds:section>
</wvds:audit>

----

===== Test: Anmerkungen (Orange) =====

<wvds:audit stack="demo" title="Modul mit Anmerkungen">
  <wvds:section title="Code-Qualität" ref="code:qualitaet">
    [x] Keine TODO-Kommentare
    [ ] Keine FIXME-Kommentare
    [x] Keine Stub-Funktionen
  </wvds:section>
  <wvds:section title="Dokumentation" ref="infrastruktur:dokumentation">
    [x] README vorhanden
    [ ] API dokumentiert
  </wvds:section>
</wvds:audit>

**Ergebnis:** ISSUES (Orange) - [ ] Items vorhanden, aber keine critical Section betroffen.

----

===== Test: Kritisch (Rot) =====

<wvds:audit stack="demo" title="Kritisches Modul">
  <wvds:section title="Code-Qualität" ref="code:qualitaet">
    [x] Keine TODO-Kommentare
    [ ] Keine FIXME-Kommentare
  </wvds:section>
  <wvds:section title="Sicherheit" ref="sicherheit:kritis" critical="true">
    [ ] Input-Validierung
    [x] Fehlerbehandlung
  </wvds:section>
</wvds:audit>

**Ergebnis:** CRITICAL (Rot) - [ ] in critical Section.

----

===== Test: Override auf Grün =====

<wvds:audit stack="demo" title="Override-Beispiel">
  <wvds:audit:result value="passed" />
  <wvds:section title="Code-Qualität" ref="code:qualitaet">
    [x] Keine TODO-Kommentare
    [ ] Bekannte Ausnahme (akzeptiert)
  </wvds:section>
</wvds:audit>

**Ergebnis:** PASSED (Grün) - manuelles Override überschreibt automatische Berechnung.

----

===== Test: Mit N/A Items =====

<wvds:audit stack="demo" title="Mit N/A Items">
  <wvds:section title="Code-Qualität" ref="code:qualitaet">
    [x] Keine TODO-Kommentare
    [-] Unit-Tests (nicht anwendbar für dieses Projekt)
    [x] Keine Stub-Funktionen
  </wvds:section>
</wvds:audit>

**Ergebnis:** PASSED (Grün) - [-] Items werden ignoriert.

----

===== Test: Template-Modus (horizontal) =====

Kompakte Inline-Syntax - alle Status in einer Zeile:

<wvds:audit stack="demo" title="Horizontal-Test">
  <wvds:include ref="code:qualitaet">[x][x][ ][x]</wvds:include>
  <wvds:include ref="stacks:vscode-extension">[x][x][ ][x][x]</wvds:include>
</wvds:audit>

**Ergebnis:** Template-Texte werden automatisch aus den Review-Seiten geladen.

----

===== Test: Template-Modus (vertikal) =====

Alternativ: Ein Status pro Zeile:

<wvds:audit stack="demo" title="Vertikal-Test">
  <wvds:include ref="code:qualitaet">
[x]
[x]
[ ]
[x]
  </wvds:include>
</wvds:audit>

**Ergebnis:** Gleiche Funktion, andere Formatierung.

----

===== Test: Include mit vollem Text =====

<wvds:audit stack="demo" title="Include-Test">
  <wvds:include ref="code:qualitaet" critical="true">
    [x] Keine TODO-Kommentare
    [ ] Keine FIXME-Kommentare (2 gefunden)
    [x] Keine Stub-Funktionen
    [x] Vollständig implementiert
  </wvds:include>
  <wvds:include ref="sicherheit:kritis">
    [x] Keine exec/shell_exec/system Aufrufe
    [x] Keine eval() Aufrufe
    [x] Output Escaping
    [-] SQL Injection (keine DB)
    [-] CSRF Protection (keine Forms)
  </wvds:include>
</wvds:audit>

**Ergebnis:** CRITICAL (Rot) - weil code:qualitaet critical ist und [ ] enthält.

----

===== Syntax-Referenz =====

==== Variante 1: Explizite Sections ====

<code xml>
<wvds:audit stack="stack-name" title="Modul-Titel">
  <wvds:audit:result value="passed|issues|critical" />  <!-- Optional: Override -->

  <wvds:section title="Section-Titel" ref="wiki:link" critical="true">
    [x] Bestanden
    [ ] Nicht bestanden
    [-] Nicht anwendbar
  </wvds:section>
</wvds:audit>
</code>

==== Variante 2: Include (empfohlen) ====

<code xml>
<wvds:audit stack="stack-name" title="Modul-Titel">
  <!-- Mit vollem Text -->
  <wvds:include ref="code:qualitaet" critical="true">
    [x] Keine TODO-Kommentare
    [ ] Keine FIXME-Kommentare
  </wvds:include>

  <!-- Status-only horizontal (kompakt) -->
  <wvds:include ref="stacks:vscode-extension">[x][ ][x][x][x]</wvds:include>

  <!-- Status-only vertikal -->
  <wvds:include ref="sicherheit:kritis">
[x]
[ ]
[x]
  </wvds:include>
</wvds:audit>
</code>

==== Attribute ====

^ Attribut ^ Beschreibung ^
| ''stack'' | Stack-Identifikator (vsix, doku, fpc, etc.) |
| ''title'' | Anzeige-Titel des Audits |
| ''ref'' | Wiki-Link zur Checklist (ohne Sprach-Prefix) |
| ''critical'' | Wenn true, führt [ ] zu CRITICAL statt ISSUES |

----

Zurück zu [[.:de:review:start|Review Checklists]]