# A4W Programmhilfe pflegen

Die lokale Hilfe liegt unter `Docs/Help` und wird durch die Projektdatei als `docs\Help\**\*` in Build und Publish kopiert. Sie funktioniert offline und verwendet keine externen Abhaengigkeiten.

## Neue Hilfeseite

1. HTML-Datei in einem passenden Unterordner anlegen.
2. Navigation in `assets/help-shell.js` ergaenzen.
3. Suchindex in `assets/search-index.js` ergaenzen.
4. Querverweise am Seitenende setzen.
5. Falls die Seite kontextbezogen aus der App erreichbar sein soll, Pfad in `Pages/Shared/_Layout.cshtml` hinterlegen.

## Suchindex

Jeder Eintrag sollte enthalten:

- `title`: sichtbarer Titel
- `url`: lokaler `/help/...` Pfad
- `headings`: wichtige Überschriften
- `keywords`: Suchbegriffe und Synonyme, z. B. `offene Rechnung`, `Zahlung buchen`, `Beleg aus Vorlage`
- `text`: kurzer Beschreibungstext für Suchtreffer

## Screenshots

Screenshots gehoeren nach `Docs/Help/assets/screenshots/`.

Alle Screenshots müssen aus fiktiven Demo-Musterdaten erstellt werden. Echte Kunden-, Firmen-, Verkaufs-, Adress-, Telefon- oder E-Mail-Daten duerfen nicht in die Programmhilfe gelangen. Vor einer Veroeffentlichung die Hilfequellen und die kritischen Screenshots Kunden, Belege/Rechnung und Dashboard gezielt auf Echtdaten prüfen.

Empfohlene Dateinamen:

- `kundenverwaltung-übersicht.png`
- `beleg-erstellen-positionen.png`
- `zahlungen-offene-rechnungen.png`
- `mahnung-erstellen.png`

Screenshots in Hilfeseiten mit `figure.screenshot-frame` einbinden. Wenn noch kein verlaesslicher Screenshot vorhanden ist, einen Platzhalter mit Ziel-Dateiname verwenden und die geplante Aufnahme in `settings/screenshot-maintenance.html` dokumentieren.

## Begriffe

Belegstatus, Ablage und Zahlung immer getrennt beschreiben:

- Belegstatus: Entwurf, Offen, Bezahlt, Storniert
- Ablage: Nicht abgelegt, Archiviert, Exportiert
- Zahlung: Offen, Teilbezahlt, Bezahlt

Zahlungserinnerungen und Mahnungen erzeugen keine neue Forderung; Zahlungen werden weiterhin auf die ursprüngliche Rechnung gebucht.


