Richte Nutzerdoku auf Bedienungsanleitung mit Frontend-Seitenkategorie aus

This commit is contained in:
2026-04-22 19:21:32 +02:00
parent 6224a25c38
commit 3562d55a12
17 changed files with 7384 additions and 1297 deletions

8
docs/bedienung/README.md Normal file
View File

@@ -0,0 +1,8 @@
# Bedienung
Diese Sektion beschreibt die Nutzung der Software aus Anwendersicht.
## Bereiche
- Frontend-Funktionen je Seite: `frontend/README.md`
- Detaillierte Feld-Erklärungen: z. B. `frontend/ausgangsbelege-editor.md`

View File

@@ -0,0 +1,9 @@
# Frontend-Funktionen
Diese Kategorie enthält die Bedienung der einzelnen Seiten im Web-Frontend.
## Enthaltene Inhalte
- Vollständige Seitenübersicht mit erkannten Eingabefeldern: `alle-seiten-und-felder.md`
- Detaillierte Anleitung Ausgangsbeleg-Editor: `ausgangsbelege-editor.md`
- Detaillierte Anleitung Serienrechnungen: `serienrechnungen.md`

File diff suppressed because it is too large Load Diff

View File

@@ -0,0 +1,62 @@
# Ausgangsbeleg-Editor
Seite: `/createDocument/edit/:id?`
Diese Maske dient zum Erstellen und Bearbeiten von Ausgangsbelegen wie Rechnungen, Abschlagsrechnungen, Angebote, Lieferscheine, Packscheine und Serienrechnungen.
## Bereich: Grunddaten
- `Dokumenttyp`: Legt die Belegart fest und steuert verfügbare Felder sowie Nummernlogik.
- `Steuertyp`: Steuert Steuerberechnung und Steuertexte (z. B. Standard, 13b UStG, 19 UStG, 12.3 UStG).
- `Briefpapier`: Definiert das verwendete Layout/Letterhead für PDF und Druck.
- `Kunde`: Hauptempfänger des Belegs; beeinflusst Vorschlagswerte (Adresse, Zahlungsart, Zahlungsziel).
- `Ansprechpartner`: Kontaktperson beim Kunden für den Beleg.
- `Adresse`:
- `Straße + Hausnummer`: Liefer-/Rechnungsstraße.
- `Adresszusatz`: Zusätzliche Adressinformationen.
- `PLZ`: Postleitzahl.
- `Ort`: Ort der Adresse.
- `Belegnummer` (z. B. Rechnungsnummer): Eindeutige Referenz des Belegs.
- `Lieferdatumsart`: Definiert, ob Einzel- oder Zeitraumdatum angezeigt wird.
- `Liefer-/Leistungsdatum Start`: Startdatum für Leistung/Lieferung.
- `Liefer-/Leistungsdatum Ende`: Enddatum bei Zeitraum.
- `Belegdatum`: Offizielles Dokumentdatum.
- `Zahlungsziel in Tagen`: Frist bis zur Fälligkeit (für Rechnungsarten).
- `Zahlungsart`: Überweisung oder SEPA-Lastschrift.
- `Individueller Aufschlag`: Prozentualer Zuschlag auf Positionen laut Beleglogik.
- `Mitarbeiter`: Verantwortlicher Bearbeiter/Ersteller.
- `Kontakt Telefon`: Telefon des Ansprechpartners im Dokument.
- `Kontakt E-Mail`: E-Mail des Ansprechpartners im Dokument.
- `Im Kundenportal anzeigen`: Gibt den Beleg für das Portal frei.
- `Objekt`: Zugeordnetes Objekt/Standort.
- `Projekt`: Zugeordnetes Projekt.
- `Vertrag`: Zugeordneter Vertrag.
## Bereich: Serienrechnung (nur Typ `serialInvoices`)
- `Datum erste Ausführung`: Start der automatischen Ausführung.
- `Datum letzte Ausführung`: Enddatum der Serienausführung.
- `Aktiv`: Aktiviert/deaktiviert die Serienlogik.
- `Intervall`: Ausführungsrhythmus (z. B. monatlich, vierteljährlich).
- `Richtung`: Zeitliche Berechnung (rückwirkend oder im Voraus).
## Bereich: Inhaltstexte
- `Titel`: Belegtitel (abhängig von Belegart und Nummernlogik).
- `Beschreibung`: Kurzbeschreibung unterhalb des Titels.
- `Vorlage auswählen`: Übernimmt Textbausteine in den Einleitungstext.
- `Einleitung`: Freitext vor den Positionen.
- `Positionen`: Zeilen mit Mengen, Einheiten, Preisen, Steuern, Rabatten und Summen.
## Bereich: Aktionen
- `Speichern`: Persistiert Entwurf oder Änderungen.
- `Buchen`: Finalisiert den Beleg (abhängig von Belegart/Validierung).
- `PDF/Vorschau`: Erstellt Vorschau bzw. Ausgabe.
- `Kopier-/Übernahmefunktionen`: Übernimmt Inhalte aus verknüpften Dokumenten (z. B. Lieferschein zu Rechnung).
## Typische Eingabefehler vermeiden
- Vor dem Buchen immer `Briefpapier`, `Kunde`, `Belegdatum` und (bei Rechnungstypen) `Zahlungsziel` prüfen.
- Bei Zeiträumen Start und Ende vollständig setzen.
- Für Portalfreigabe prüfen, ob Belegstatus nicht mehr `Entwurf` ist.

View File

@@ -0,0 +1,41 @@
# Serienrechnungen
Seite: `/createDocument/serialInvoice`
Diese Seite verwaltet Vorlagen für Serienrechnungen und erlaubt die manuelle Ausführung von Rechnungsläufen.
## Oberer Bereich
- `Suche`: Filtert die Vorlagenliste.
- `Ausführungen`: Öffnet die Übersicht bestehender Ausführungsläufe.
- `Ausführen`: Startet den Dialog zur manuellen Ausführung.
- `+ Serienrechnung`: Öffnet den Editor zur Anlage einer neuen Serienrechnungsvorlage.
## Filterbereich
- `Filter`: Mehrfachfilter für die Tabellenansicht (je nach verfügbarer Konfiguration).
## Dialog: Serienrechnungen manuell ausführen
- `Ausführungsdatum (Belegdatum)`: Dokumentdatum für den Lauf; beeinflusst Leistungszeitraum laut Konfiguration.
- `Heute`: Setzt das Ausführungsdatum auf den aktuellen Tag.
- `Kunde oder Vertrag suchen`: Freitextsuche innerhalb der Vorlagenliste.
- `Intervall`: Filtert Vorlagen nach Ausführungsrhythmus.
- `Alle auswählen`: Markiert alle sichtbaren Vorlagen.
- `Keine`: Entfernt die Auswahl.
- `Checkbox je Zeile`: Wählt einzelne Vorlagen aus.
- `Ausführen`: Startet den Lauf für die ausgewählten Vorlagen.
## Tabellenspalten (typisch)
- `Typ`: Belegtyp der Vorlage.
- `Partner`: Kunde der Vorlage.
- `Betrag`: Errechneter Vorlagenbetrag.
- `Intervall`: Ausführungsrhythmus.
- `Vertrag`: Zugeordneter Vertrag.
- `Objekt`: Zugeordnetes Objekt.
## Laufende Ausführungen
- `Fertigstellen`: Schließt einen laufenden Ausführungsvorgang ab.