# Bericht — Arbeitsberichte für Dolibarr Erstellt aus den Anhängen einer Rechnung (oder eines Auftrags / Angebots) einen Arbeitsbericht als PDF. Bilder und PDFs lassen sich im Browser annotieren (Pfeile, Kreise, Rechtecke, Text, Freihand) — der fertige Bericht wird unter *Verknüpfte Dokumente* der Rechnung abgelegt. ## Funktionen - **Reiter „Bericht"** auf Rechnungen, Aufträgen, Angeboten und Lieferungen (jeweils per Konstante deaktivierbar) - **Anhänge-Browser** zeigt alle Dateien des aktuellen Dokuments **und** der direkt verknüpften Objekte (z. B. der Auftrag zur Rechnung) - **Auswahl per Checkbox** — markierte Dateien werden als Seiten in den Bericht übernommen - **Browser-Editor** mit PDF.js + Fabric.js: Pfeile, Kreise, Rechtecke, Freihand, Text, Farbe, Strichstärke, Undo/Redo - **Seiten-Verwaltung** per Drag&Drop (SortableJS): umordnen, löschen, drehen, neue Seiten hochladen - **Notizen pro Seite** — werden im finalen PDF unten auf der Seite gedruckt - **Deckblatt aus ODT-Vorlage** mit Platzhaltern (`{auftragsnummer}`, `{kunde_name}`, `{datum}`, …) - **ODT-Templates** im Admin-Bereich verwaltbar (mehrere Vorlagen, Standard wählbar) - **Auftragsnummer** wird automatisch aus dem Extrafield `options_auftragsnummer` der Rechnung gezogen - **Mehrere Berichte pro Dokument** möglich - Berichte als **Entwurf** speichern (jederzeit wieder editierbar) oder **finalisieren** (PDF erzeugen) - **Lieferschein-Bestätigung mit Kunden-Unterschrift**: Vollbild-Querformat-Signatur in der PWA, Unterschrift wird via ODT-Hook (Platzhalter `{signature}`) ins Lieferschein-PDF gestempelt, Expedition wird automatisch validiert und geschlossen - **PWA-API** für Mobile-Nutzung: Aufträge, Fotos, Sprachnotizen, Materiallisten, Lieferungen, Signaturen - **PDF-Viewer in PWA** mit PDF.js Canvas-Rendering (Zoom, Seitennummerierung, Download) ## Voraussetzungen - Dolibarr ≥ 19.0 - PHP ≥ 7.4 - TCPDF (in Dolibarr enthalten) - **FPDI** (für PDF-Anhänge in den Bericht zu mergen) — empfohlen, optional - **LibreOffice headless** (für ODT→PDF Konvertierung der Deckblätter) - Optional: `pdfinfo` oder `imagick` für PDF-Seitenanzahl-Erkennung ## Installation 1. Modul-Verzeichnis nach `dolibarr/htdocs/custom/bericht/` (oder per Symlink aus dem Module-Mount-Pfad) kopieren 2. In Dolibarr unter **Konfiguration → Module/Anwendungen** das Modul **Bericht** aktivieren 3. Beim Aktivieren werden die SQL-Tabellen `llx_bericht` und `llx_bericht_page` angelegt 4. Vorhandene Extrafields auf `llx_facture_extrafields` (`auftragsnummer`, `angebotsnummer`, …) werden erkannt und nicht überschrieben — fehlende werden angelegt 5. Im Admin-Bereich (`/bericht/admin/setup.php`) die ODT-Templates hochladen und Standard-Template setzen ## Verwendung 1. Eine Rechnung öffnen (`/compta/facture/card.php?id=…`) 2. Reiter **Bericht** auswählen 3. **+ Neuer Bericht** klicken — die Auftragsnummer wird automatisch übernommen 4. Im Editor links die gewünschten Anhänge ankreuzen → **Auswahl in Bericht übernehmen** 5. Im mittleren Editor mit den Werkzeugen Pfeile, Texte etc. zeichnen 6. Seiten rechts per Drag&Drop sortieren, einzelne Seiten löschen, neue Dateien hochladen 7. **Bericht finalisieren** — PDF wird erzeugt, Deckblatt aus der ODT-Vorlage gerendert und unter den verknüpften Dokumenten der Rechnung abgelegt ## ODT-Template Platzhalter | Platzhalter | Inhalt | |---|---| | `{auftragsnummer}` | Aus extrafield `options_auftragsnummer` der Rechnung | | `{angebotsnummer}` | Aus extrafield `options_angebotsnummer` | | `{rechnungsnummer}` | `ref` der Rechnung | | `{kunde_name}` | Name des Kunden (Société) | | `{kunde_adresse}` | Adresse des Kunden, mehrzeilig | | `{datum}` | Heutiges Datum | | `{beschreibung}` | extrafield `options_beschreibung` | | `{hinweis}` | extrafield `options_hinweis` | | `{bericht_titel}` | Titel des Berichts | | `{ersteller}` | Login-Name des erstellenden Users | | `{signature}` | Kunden-Unterschrift als Bild (nur Lieferschein-Workflow, ersetzt Text-Platzhalter durch eingebettetes PNG; Größe via `BERICHT_SIGNATURE_IMAGE_RATIO`) | | `{signer_name}` | Name des unterschreibenden Kunden | | `{signed_at}` | Zeitstempel der Unterschrift | | `{gps}` | GPS-Koordinaten zum Zeitpunkt der Unterschrift (falls erlaubt) | ## PWA-Integration (Baustelle Mobile App) Die **Baustelle-PWA** (`https://awl.data-it-solution.de/baustelle/`) nutzt die folgenden API-Endpoints des Bericht-Moduls: ### Authentifizierung ``` POST /custom/bericht/api/auth.php Body: { login: string, password: string } Response: { ok: true, token: JWT, user: {...} } ``` JWT-Token hat 7 Tage Gültigkeit und enthält: `sub` (user id), `login`, `name`, `perms` (read/write/delete/admin). ### Order-APIs ``` GET /custom/bericht/api/orders.php GET /custom/bericht/api/orders.php?id= GET /custom/bericht/api/orders.php?id=&action=photos POST /custom/bericht/api/orders.php?action=create ``` ### Dateien ``` GET /custom/bericht/api/photo.php?relpath=&jwt= Liefert Dateien aus DOL_DATA_ROOT (Whitelist: facture/, commande/, propal/, bericht/) Optional: ?size=small|mini (Thumbnails), ?download=1 (Attachment-Header) ``` ### PDF-Ansicht ``` GET /custom/bericht/api/pdf.php?id=&jwt= Liefert finalisiertes Bericht-PDF als Blob ``` ### Seiten-Verwaltung (PWA) ``` DELETE /custom/bericht/api/pages.php?id= POST /custom/bericht/api/pages.php?id= Body: { note: string } POST /custom/bericht/api/pages.php?action=signature&bericht_id= Body: FormData mit file=, signer_name, gps_lat, gps_lon ``` ### Lieferungen + Unterschrift (PWA) ``` GET /custom/bericht/api/shipments.php?order_id= Liste aller Expeditionen zum Auftrag (id, ref, date_delivery, status, signed_status, has_bericht) GET /custom/bericht/api/shipments.php?id= Detail einer Lieferung inkl. bericht_id GET /custom/bericht/api/shipments.php?id=&action=pdf[&variant=auto|signed|unsigned] Liefert Lieferschein-PDF (Default auto: signed wenn vorhanden, sonst Original) POST /custom/bericht/api/shipments.php?id=&action=confirm FormData mit signature_png, signer_name, gps_lat, gps_lon, signed_at Stempelt Unterschrift via ODT-Hook ({signature}-Platzhalter), legt -signed.pdf in documents/expedition//, setzt signed_status=1, validiert+schließt Expedition wenn noch Draft. Response: { ok: true, pdf_url, bericht_id } ``` ## Konfigurations-Konstanten Per `admin/setup.php` oder `llx_const`: | Konstante | Default | Zweck | |---|---|---| | `BERICHT_TAB_ON_INVOICE` | 1 | Reiter "Bericht" auf Rechnungen anzeigen | | `BERICHT_TAB_ON_ORDER` | 1 | Reiter "Bericht" auf Aufträgen anzeigen | | `BERICHT_TAB_ON_PROPAL` | 1 | Reiter "Bericht" auf Angeboten anzeigen | | `BERICHT_TAB_ON_SHIPMENT` | 1 | Reiter "Bericht" auf Lieferungen anzeigen | | `BERICHT_TAB_ON_THIRDPARTY` | 0 | Read-only Bericht-Tab auf Kundenkarte | | `BERICHT_SIGNATURE_IMAGE_RATIO` | 0.35 | Größen-Faktor für `{signature}`-Platzhalter im ODT (höher = größer) | | `BERICHT_SIGNATURE_BOX_DEFAULT` | JSON | Default-Geometrie für FPDI-Stempel-Fallback (`{"page":"last","x_mm":120,"y_mm":230,"w_mm":70,"h_mm":35,"label":"Unterschrift Kunde"}`) | | `BERICHT_BURN_ANNOTATIONS` | 0 | Annotationen ins PDF einbrennen statt als PDF-Annotation einbetten | | `BERICHT_LIBREOFFICE_BIN` | `soffice` | Pfad zur LibreOffice-Binary (für ODT→PDF) | ## Datenbank | Tabelle | Zweck | |---|---| | `llx_bericht` | Bericht-Header (element_type ∈ {invoice, order, propal, shipment}, fk_element, status, …) | | `llx_bericht_page` | Einzelne Seiten mit Fabric-JSON-Annotationen, Layout, Notiz | | `llx_bericht_page_image` | Multi-Image-Layout pro Seite (Phase 1.4) | | `llx_bericht_upload_token` | Mobile-Upload-Tokens (geplant) | | `llx_bericht_signature_box` | Pro Lieferschein-Template gespeicherte Signatur-Box-Geometrie (mm) | ## Architektur ``` bericht/ ├── core/modules/modBericht.class.php Modul-Descriptor, Tabs, Extrafields-Init, Konstanten ├── class/ │ ├── bericht.class.php Bericht + BerichtPage CRUD │ └── actions_bericht.class.php Hook: beforeODTSave setzt {signature} + Meta-Variablen ├── lib/bericht.lib.php Helper (Anhänge, Auftragsnr., Templates, Shipment-PDF, │ Signature-Box, FPDI-Stempel-Fallback) ├── bericht_card.php Editor-Seite (Tab-Inhalt) ├── admin/ │ ├── setup.php Admin: ODT-Templates, Konstanten, Signatur-Größe │ ├── signature_box_editor.php Visueller PDF-Editor für Signatur-Box-Position │ └── signature_box_preview.php Beispiel-PDF-Renderer für den Editor ├── ajax/ Legacy Endpoints (Token-geschützt) │ ├── _inc.php Gemeinsamer Header │ ├── add_attachment.php Anhang als Seite hinzufügen │ ├── upload_extra.php Direkter Upload │ ├── save_annotations.php Fabric-JSON speichern │ ├── save_signature_box.php UPSERT der Signatur-Box pro Template │ ├── page_meta.php Annotationen + Notiz laden │ ├── page_image.php Seitenbild/PDF ausliefern │ ├── delete_page.php │ ├── reorder_pages.php │ └── generate_pdf.php Finalisierung: TCPDF + FPDI + ODT-Deckblatt ├── api/ REST-API (JWT-Auth) │ ├── _inc.php JWT-Authentifizierung + Dolibarr-Init │ ├── _jwt.php JWT encoding/decoding (mit ?jwt= Query-Fallback) │ ├── auth.php Login-Endpoint │ ├── orders.php Order-Liste, Detail, Fotos, Create │ ├── shipments.php Lieferungen-Liste, PDF-Stream, Unterschrift-Confirm │ ├── photo.php Datei-Serving mit Whitelist │ ├── pdf.php Finalized Bericht-PDF │ ├── pages.php Seiten-Verwaltung (Note, Rotation, Signature) │ ├── reports.php Bericht-CRUD │ ├── templates.php ODT-Templates │ ├── materials.php Materiallisten │ ├── voice.php Sprachnotizen (Upload + Transkription) │ └── transcribe.php Whisper-Transkription ├── js/ │ ├── editor.js PDF.js + Fabric.js Integration │ └── lib/ PDF.js, Fabric.js, SortableJS (lokal) ├── css/bericht.css ├── sql/ │ ├── llx_bericht.sql / .key.sql │ ├── llx_bericht_page.sql / .key.sql │ └── llx_bericht_signature_box.sql / .key.sql └── langs/{de_DE,en_US}/bericht.lang ``` ## Lizenz GPL v3+