Eduard Wisch
923b50d65a
All checks were successful
Deploy bericht / deploy (push) Successful in 1s
Dolibarr-Modul für Arbeitsberichte aus Rechnungs-Anhängen mit Browser-PDF-Editor. - Reiter "Bericht" auf Rechnungen, Aufträgen und Angeboten - Anhänge-Browser inkl. verknüpfter Objekte (Auftrag → Rechnung) - PDF.js + Fabric.js Browser-Editor: Pfeile, Kreise, Rechtecke, Freihand, Text - SortableJS Seiten-Verwaltung mit Drag&Drop - ODT-Deckblatt mit Platzhaltern, Templates im Admin verwaltbar - TCPDF + FPDI Finalisierung mit eingebrannten Annotationen - ECM-Verknüpfung: PDF erscheint unter Verknüpfte Dokumente - Auftragsnummer aus existierendem Extrafield options_auftragsnummer - Mehrere Berichte pro Dokument - Beim Aktivieren werden vorhandene Extrafields nicht überschrieben Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
95 lines
4.9 KiB
Markdown
95 lines
4.9 KiB
Markdown
# 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 und Angeboten (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)
|
|
|
|
## 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 |
|
|
|
|
## Architektur
|
|
|
|
```
|
|
bericht/
|
|
├── core/modules/modBericht.class.php Modul-Descriptor, Tabs, Extrafields-Init
|
|
├── class/bericht.class.php Bericht + BerichtPage CRUD
|
|
├── lib/bericht.lib.php Helper (Anhänge sammeln, Auftragsnr., Templates)
|
|
├── bericht_card.php Editor-Seite (Tab-Inhalt)
|
|
├── admin/setup.php Admin: ODT-Templates, Konstanten
|
|
├── ajax/ 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
|
|
│ ├── 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
|
|
├── js/
|
|
│ ├── editor.js PDF.js + Fabric.js Integration
|
|
│ └── lib/ PDF.js, Fabric.js, SortableJS (lokal)
|
|
├── css/bericht.css
|
|
├── sql/
|
|
│ ├── llx_bericht.sql
|
|
│ ├── llx_bericht.key.sql
|
|
│ ├── llx_bericht_page.sql
|
|
│ └── llx_bericht_page.key.sql
|
|
└── langs/{de_DE,en_US}/bericht.lang
|
|
```
|
|
|
|
## Lizenz
|
|
|
|
GPL v3+
|