Zum Inhalt springen

App-Dokumentation · DE

Bau / Handwerk

Projektakte mit Stundenrapport und Abschlagsrechnung

Mit Bau / Handwerk führen Sie Bauvorhaben von der Auftragssumme bis zur Kostenübersicht: Stundenrapporte erfassen, Akonto-/Abschlagsrechnungen stellen und den Projektfortschritt verlässlich im Blick behalten.

Bereiche

  • Projekte: die Projektliste und ein Formular für ein neues Projekt (Bezeichnung, optionaler Kunde, Auftragssumme, Währung, Status). Beim Öffnen eines Projekts werden die Kostenübersicht, die Stundenrapporte (Liste + Erfassen) und die Akonto-Rechnungen (Liste + Erstellen) angezeigt.
  • Hilfe: In-App-Hinweise.

Felder und Begriffe

  • Projekt: name, optional customer_id, contract_value (Auftragssumme), currency (ISO 4217) und ein Lebenszyklus-status (open|active|completed|cancelled).
  • Stundenrapport: report_date, worker, hours, labor_rate, optional material_cost, optional note. Die total wird vom Backend als hours × labor_rate + material_cost berechnet.
  • Akonto-/Abschlagsrechnung: abgerechnet entweder als fester amount oder als percent der Auftragssumme (Prozent hat Vorrang). Jede Rechnung speichert ihre sequence und das laufende cumulative. Die kumulierte Summe darf die Auftragssumme nicht überschreiten — Überzahlung wird abgelehnt.
  • Kostenübersicht: contract_value, billed, remaining_to_bill, labor_cost, material_cost, total_cost, hours_total und Zähler.

Alle Geld-/Dezimalfelder sind BCMath-Dezimal-Strings; die Oberfläche zeigt sie unverändert an und wandelt sie nie in Gleitkommazahlen um.

Backend-Vertrag

Alle Routen liegen unter /api/erp/construction, mandantenbezogen, mit dem {success, data}-Umschlag.

  • GET /projects — Projekte auflisten.
  • POST /projects — Projekt erstellen. Body: {name, customer_id?, contract_value?, currency?, status?}. Liefert 201, 422 bei Validierungsfehlern oder 409 bei doppelter Bezeichnung.
  • GET /projects/{id} — ein Projekt lesen.
  • GET /projects/{id}/cost-summary — Kosten-Roll-up je Projekt.
  • GET /projects/{id}/work-reports und POST /projects/{id}/work-reports — Stundenrapporte auflisten / erfassen.
  • GET /projects/{id}/progress-invoices und POST /projects/{id}/progress-invoices — Akonto-Rechnungen auflisten / erstellen.

Die Authentifizierung erfolgt über httpOnly-Cookie + CSRF mittels @it-tremmel.de/platform-http authedFetch (credentials: 'include'); es werden keine Tokens aus localStorage gelesen.

  • Während des Speicherns sind die Formulare für Projekt, Stundenrapport und Akonto-Rechnung als beschäftigt markiert und die Schaltfläche gesperrt. Ein Doppelklick erzeugt daher nur einen Vorgang; nach Abschluss kann bewusst erneut erfasst werden.

Typischer Ablauf

  1. Ein Projekt mit Bezeichnung und Auftragssumme anlegen.
  2. Das Projekt öffnen und Stundenrapporte während der Arbeit erfassen.
  3. Akonto-Rechnungen als Betrag oder Prozent der Auftragssumme stellen.
  4. Die Kostenübersicht für abgerechnet vs. offen sowie aufgelaufene Lohn-/Materialkosten beobachten.