Bau / Handwerk

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, optionalcustomer_id,contract_value(Auftragssumme),currency(ISO 4217) und ein Lebenszyklus-status(open|active|completed|cancelled). - Stundenrapport:
report_date,worker,hours,labor_rate, optionalmaterial_cost, optionalnote. Dietotalwird vom Backend alshours × labor_rate + material_costberechnet. - Akonto-/Abschlagsrechnung: abgerechnet entweder als fester
amountoder alspercentder Auftragssumme (Prozent hat Vorrang). Jede Rechnung speichert ihresequenceund das laufendecumulative. 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_totalund 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-reportsundPOST /projects/{id}/work-reports— Stundenrapporte auflisten / erfassen.GET /projects/{id}/progress-invoicesundPOST /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
- Ein Projekt mit Bezeichnung und Auftragssumme anlegen.
- Das Projekt öffnen und Stundenrapporte während der Arbeit erfassen.
- Akonto-Rechnungen als Betrag oder Prozent der Auftragssumme stellen.
- Die Kostenübersicht für abgerechnet vs. offen sowie aufgelaufene Lohn-/Materialkosten beobachten.