bericht/ChangeLog.md

Changelog

1.3.1 — 2026-07-18

Fixes rund um die PWA-Auftragsanlage

• api/customers.php: Zahlart und Zahlungsbedingung im Kunden-Detail werden jetzt übersetzt — über die Dolibarr-Sprachkeys PaymentTypeShort<code> / PaymentConditionShort<code> (Sprachdatei bills) statt der rohen englischen libelle-Werte aus c_paiement/c_payment_term. Behebt die Anzeige „💳 Payment Condition · 🏦 Credit transfer" in der „Übernommen"-Zeile. Fallback auf libelle, wenn kein Sprachkey existiert (z. B. Custom-Einträge ohne code).
• Baustelle-PWA (Repo baustelle-pwa): „Neuer Auftrag"-Formular saß vertikal zu weit unten (der gemeinsame .fs-body erbte justify-content:center, was bei flex-direction:column vertikal zentriert) und wurde von der Bildschirmtastatur verdeckt → justify-content:flex-start im Modal + scrollIntoView({block:'center'}) beim Feld-Fokus.

1.3.0 — 2026-07-18

PWA Auftrag-Anlegen überarbeitet (Formular + Freigabe)

Formular (Baustelle-PWA, openNewOrderModal)

• Feld-Reihenfolge/Beschriftung angepasst: „Ihr Zeichen" (= ref_client) steht jetzt an erster Stelle und ist Pflicht; „Auftragsbeschreibung" (= Extrafield options_auftragsbeschreibung) an zweiter Stelle und optional. (Vorher genau umgekehrt: Titel Pflicht, Kunden-Referenz optional.)
• Neues Feld „Geplanter Liefertermin" (datetime-local, Datum + Uhrzeit in einem Feld) → Auftrag-Spalte date_livraison.
• Neue Checkbox „Auftrag direkt freigeben".

Backend (api/orders.php?action=create)

• ref_client ist jetzt serverseitig Pflicht (Geschäftsregel — Dolibarr-Core verlangt nur den Kunden).
• Neuer Parameter date_livraison (Unix-TS) → Commande->delivery_date.
• Neuer Parameter validate: legt vor der Freigabe automatisch eine Std-Lohn-Zeile an und ruft dann Commande::valid().
  • Produkt: Kundenkarten-Default options_stundenzettel_default_service, sonst Fallback-Produkt über Ref BERICHT_ORDER_DEFAULT_SERVICE_REF (Default ELEK-STD-M, „Stundenlohn Meister" 45 €).
  • Preis: kundenspezifischer Preis (PRODUIT_CUSTOMER_PRICES) hat Vorrang, sonst Produkt-Standardpreis. Menge 1.
• Response erweitert um ref_client, date_livraison, validated, added_line, validate_warning.

1.2.0 — 2026-05-27

Phase 1.8 Lieferschein-Bestätigung in der PWA

Neuer element_type='shipment'

• Bericht-Modul unterstützt jetzt element_type='shipment' mit fk_element = llx_expedition.rowid
• Tab "Bericht" erscheint auf der Lieferung-Card (Konstante BERICHT_TAB_ON_SHIPMENT)
• bericht_fetch_parent() und bericht_fetch_shipment_with_order() laden Expedition + verknüpften Auftrag

Signatur auf Lieferschein-PDF stempeln

• Neue Tabelle llx_bericht_signature_box: Pro PDF-Template (merou/rouget/espadon/...) konfigurierbare Box-Geometrie (x/y/w/h in mm, Seite first/last, Label)
• Konstante BERICHT_SIGNATURE_BOX_DEFAULT als JSON-Default ({"page":"last","x_mm":120,"y_mm":230,"w_mm":70,"h_mm":35,"label":"Unterschrift Kunde"})
• bericht_stamp_signature_on_pdf(): FPDI importiert Original-Lieferschein, TCPDF stempelt PNG + Name + Datum + GPS in die konfigurierte Box

Visueller Admin-Editor (admin/signature_box_editor.php)

• PDF.js rendert ein Beispiel-Lieferschein-PDF
• Fabric.js-Rechteck zum Drag&Resize der Signatur-Box auf dem Canvas
• Eingabefelder für X/Y/W/H/Label/Seite werden live synchronisiert
• "Speichern" persistiert via AJAX (ajax/save_signature_box.php) in llx_bericht_signature_box (UPSERT auf template_name)
• Reset-Button setzt zurück auf Default-Konstante

Neue PWA-Route (Baustelle-App)

• Order-Detail bekommt Button "🚚 Lieferungen"
• #/orders/:id/shipments zeigt Liste aller verknüpften Expeditionen mit Status- und Signed-Badge
• #/shipments/:id zeigt Lieferschein-PDF inline (PDF.js Canvas) + großen Button "Lieferung unterschreiben lassen"

Vollbild-Querformat-Signatur (openShipmentSignatureModal)

• requestFullscreen() + screen.orientation.lock('landscape') (Best-Effort)
• 2-Spalten-Layout: links Lieferschein-Info + Namens-Input + GPS-Toggle, rechts Vollbild-Canvas
• HiDPI-aware Canvas (devicePixelRatio), Pointer/Touch-Events mit quadratischer Glättung
• Beim Bestätigen: PNG → POST /api/shipments.php?action=confirm → Backend stempelt in PDF und legt es in documents/expedition/<ref>/<ref>-signed.pdf

Auto-Workflow auf der Expedition

• signed_status=1 (via CommonSignedObject::setSignedStatus)
• Wenn Expedition noch Draft (Status 0): erst valid(), dann setClosed()
• Bericht-Record (element_type='shipment') wird angelegt/aktualisiert mit final_pdf_path zum signierten PDF
• <sig>.meta.json neben der PNG mit voller Audit-Spur (signer, user, GPS, IP, Box, Template, signed_at)

Neue API-Endpoints

• GET /api/shipments.php?order_id=<id> — Liste der Lieferungen zu einem Auftrag
• GET /api/shipments.php?id=<id> — Detail einer Lieferung + Bericht-ID falls vorhanden
• GET /api/shipments.php?id=<id>&action=pdf — PDF-Stream (Original oder gestempelt)
• POST /api/shipments.php?id=<id>&action=confirm — Unterschrift einstempeln + Status-Workflow

1.1.0 — 2026-04-08

Phase 1 Bericht-Modul Erweiterungen

1.6 Verknüpfte Sicht Auftrag↔Rechnung

• Bericht-Übersicht zeigt drei Sektionen: direkt zugeordnet, zusätzlich verknüpft, aus verknüpften Aufträgen
• "→ Übernehmen"-Button erstellt llx_element_element-Eintrag (n:m-Verknüpfung)
• "Lösen"-Button entfernt Verknüpfung
• Beim Finalisieren landet das PDF auch unter den verknüpften Elementen im ECM

1.1 Live-PDF-Vorschau

• 👁️ Vorschau-Button im Editor → Modal mit eingebettetem PDF
• Neuer Endpoint ajax/preview_pdf.php (kein ECM-Insert, kein Status-Wechsel)
• ESC oder Klick auf Backdrop schließt das Modal

1.2 Anhänge löschen

• 🗑️ Icon neben jedem Anhang in der linken Spalte
• Confirm-Dialog mit Auftrags-/Rechnungs-Referenz
• Path-Whitelist (nur facture/, commande/, propal/), Thumbs + ECM-Eintrag werden mitgelöscht

1.3 Seitengröße A4/A3/A5/Letter + Hoch/Quer

• Format und Orientation in der Bericht-Meta wählbar
• Auto-Save bei Änderung
• Bilder werden dynamisch auf die Seitengröße skaliert

1.4 + 1.5 Mehrere Bilder pro Seite (DB-Schema)

• Neue Tabelle llx_bericht_page_image für Multi-Image-Seiten
• Spalten layout, image_scale, image_align in llx_bericht_page
• Grid-Rendering im Editor + PDF folgt im nächsten Commit

1.7 Tab „Berichte" auf Kundenkarte

• Read-only Übersicht aller Berichte des Kunden
• Flache Tabelle sortiert nach Datum
• Springt zum Bericht oder zur Quelle (Auftrag/Rechnung/Angebot)
• Konstante BERICHT_TAB_ON_THIRDPARTY zum Aktivieren

Sonstiges

• DB-Migrationen im init() für bestehende Installationen (ALTER TABLE mit Error-Suppress)
• bericht_burn_annotations und bericht_render_cover_internal in lib/bericht.lib.php zentralisiert (gemeinsam von generate_pdf + preview_pdf genutzt)
• Modal-CSS für Vorschau im Dolibarr Dark-Theme

1.0.0 — 2026-04-08

Initiales Release.

• Modul-Scaffold mit Reiter „Bericht" auf Rechnungen, Aufträgen und Angeboten
• CRUD für Bericht und BerichtPage (Tabellen llx_bericht, llx_bericht_page)
• Browser-Editor mit PDF.js + Fabric.js: Pfeile, Kreise, Rechtecke, Freihand, Text, Undo/Redo
• Anhänge-Browser zeigt eigene Anhänge + Anhänge verknüpfter Objekte
• Datei-Upload direkt in den Bericht
• Seiten-Verwaltung mit Drag&Drop (SortableJS), Löschen, Drehen
• Notizen pro Seite (werden im PDF gedruckt)
• Admin-Setup mit ODT-Template-Verwaltung (Upload, Löschen, Standard wählen)
• Platzhalter-System für ODT-Templates ({auftragsnummer}, {kunde_name}, …)
• PDF-Finalisierung mit TCPDF + FPDI, ODT→PDF Konvertierung des Deckblatts via LibreOffice
• Annotationen werden beim Export ins PDF eingebrannt
• Auftragsnummer wird automatisch aus dem vorhandenen Extrafield options_auftragsnummer geholt
• Beim Aktivieren werden fehlende Extrafields auf llx_facture_extrafields angelegt, vorhandene NICHT überschrieben
• Mehrere Berichte pro Dokument möglich
• Forgejo-Workflow für Deploy nach Dolibarr (Tag [deploy])