Eduard Wisch
5db126210c
All checks were successful
Deploy bericht / deploy (push) Successful in 2s
Unterschrift (api/pages.php?action=signature): - Metadaten einbrennen: Überschrift, Bericht-Ref, Parent-Ref, Kunde, Datum/Zeit (Server), Unterzeichner-Name, Bestätigungstext, GPS - SHA256 Hash-Verkettung über alle vorherigen Seiten + Bericht-Ref → nachträgliches Austauschen von Seiten fällt auf - Composite-Canvas: Header mit Metadaten, Unterschrift mittig, Footer mit Hash + Server + Zeitstempel - Metadaten-JSON neben der PNG (für spätere Verifikation) - signer_name ist Pflicht, gps_lat/gps_lon optional - Page-Note zeigt Unterzeichner + Zeit statt nur 'Unterschrift Kunde' Kundenkarten-API (api/customers.php): - GET ohne id = Liste mit Suche (q-Param), zeigt Stammdaten + Bericht-Count - GET mit id = Detail: Stammdaten, letzten 50 Aufträge, 50 Rechnungen, 100 Berichte über UNION aus commande/facture JOIN - Nur echte Kunden (client IN (1,2,3)), keine reinen Lieferanten Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> [deploy]
157 lines
7.4 KiB
Markdown
157 lines
7.4 KiB
Markdown
# Bericht-Modul — Projekt-Status & Architektur
|
|
|
|
## Stand 2026-04-08
|
|
|
|
Dolibarr-Custom-Modul für Arbeitsberichte mit Browser-PDF-Editor.
|
|
|
|
## Architektur (final)
|
|
|
|
### Tab-Verteilung
|
|
- **Auftrag (commande)** — primärer Erstellungsort, Berichte mit `element_type='order'`, Auftragsnummer = `commande->ref` direkt
|
|
- **Rechnung (facture)** — Berichte mit `element_type='invoice'`, Auftragsnummer aus `array_options['options_auftragsnummer']`
|
|
- **Angebot (propal)** — möglich, gleiche Logik
|
|
- **Kundenkarte (thirdparty)** — read-only Übersicht (Phase 1.7), zeigt alle Berichte des Kunden über Joins, **kein** Anlegen, **kein** Speicher-Ort
|
|
|
|
### Verknüpfung Auftrag → Rechnung
|
|
Berichte gehören 1:1 zu einem Parent (`element_type` + `fk_element`). Auf einer Rechnungs-Seite werden ZUSÄTZLICH die Berichte der verknüpften Aufträge angezeigt — über `fetchObjectLinked()` der Rechnung. Mit Button "→ Dieser Rechnung zuordnen" erzeugt man einen Eintrag in `llx_element_element` (Standard-Dolibarr-n:m-Verknüpfung), damit der Bericht beim Finalisieren auch im ECM der Rechnung landet.
|
|
|
|
### DB-Tabellen
|
|
- `llx_bericht` — Bericht (rowid, ref, titel, element_type, fk_element, auftragsnummer, template_odt, status, final_pdf_path, format, orientation, ...)
|
|
- `llx_bericht_page` — Seite (rowid, fk_bericht, page_order, source_type, source_path, source_page, rotation, fabric_json, note, layout, image_scale, image_align, ...)
|
|
- `llx_bericht_upload_token` — Phase 2: Mobile-Upload-Tokens (rowid, token, fk_bericht, expires_at, created_by)
|
|
|
|
### Permissions
|
|
- `bericht/read` (Standard für alle)
|
|
- `bericht/write` (Standard für alle)
|
|
- `bericht/delete` (Standard für alle)
|
|
- `bericht/admin` (nur explizit)
|
|
|
|
**WICHTIG:** `$this->rights[$r][4]` = perms-Name (`'read'`), `[5]` = subperms (leer). NICHT Modul-Name in [4]!
|
|
|
|
### Modul-Numero
|
|
**500033** — kollidiert NICHT mit BankImport (500021). Permission-IDs sind 500033 + n.
|
|
|
|
### CSS-Variablen (Dolibarr awl-dark Theme)
|
|
Verwendete: `--colorbacktitle1`, `--colortext`, `--colorbackbody`, `--colorboxbordertitle1`, `--colortextlink`, `--colorbackhmenu1`, `--colortextbackhmenu`, `--colorbackvmenu1`
|
|
|
|
NICHT vorhanden im awl-dark: `--inputbackgroundcolor`, `--inputtextcolor` — stattdessen Fallbacks nutzen.
|
|
|
|
### JS-Libraries (lokal in js/lib/)
|
|
- pdf.min.js (PDF.js 3.11)
|
|
- pdf.worker.min.js
|
|
- fabric.min.js (Fabric.js 5.3)
|
|
- Sortable.min.js (SortableJS 1.15)
|
|
|
|
### LocalStorage Settings
|
|
Key: `bericht.editor.settings.v1`
|
|
Speichert: color, stroke, fontFamily, fontSize, bold, italic, zoom
|
|
|
|
### Forgejo
|
|
- Repo: `data/bericht` (NICHT `data-it/bericht` — Token hat keine org-write rechte)
|
|
- Workflow: `[deploy]`-Tag triggert rsync nach `/mnt/appdata/firma/dolibarr-202509/modules/bericht`
|
|
- Lokaler Symlink: `/var/www/dolibarr/custom/bericht` → `/mnt/17 - Entwicklungen/30 - Scripts/php/Dolibarr - Module/Bericht/repo`
|
|
- Lokales Apache läuft als User `data` (NICHT `http`)
|
|
|
|
---
|
|
|
|
## Phase 1 — Bericht-Modul-Erweiterungen (in Arbeit)
|
|
|
|
### ✅ Erledigt vor Phase 1
|
|
- Modul-Scaffold (modBericht, SQL, Lang, Rechte korrekt nach Stundenzettel-Format)
|
|
- Editor mit PDF.js + Fabric.js
|
|
- Toolbar 2-zeilig, einheitliche Höhe 30px
|
|
- Schriftart/Größe/Bold/Italic mit localStorage-Persistenz
|
|
- Zoom (-/+/Reset), Seitenrotation, Pfeil mit Spitze (drag, drehbar)
|
|
- Seiten-Thumbnails als echte Vorschau (PDF.js + Image), Hell/Dunkel-Toggle
|
|
- ResizeObserver für Console-Open-Resize
|
|
- ODT-Template-Verwaltung im Admin
|
|
- Generate-PDF mit FPDI + Annotationen einbrennen
|
|
- Mobile-Upload-Idee dokumentiert (Phase 2)
|
|
|
|
### Phase 1 Features
|
|
- [x] **1.6 Verknüpfte Sicht Auftrag→Rechnung** ✅
|
|
- [x] **1.1 Live-PDF-Vorschau** ✅
|
|
- [x] **1.2 Anhänge löschen** ✅
|
|
- [x] **1.3 Seitengröße A4/A3/Letter + Hoch/Quer** ✅ — global pro Bericht (nicht pro Seite override)
|
|
- [/] **1.4 Mehrere Bilder pro Seite** — DB + Klassen-Skelett da, Grid-Rendering im PDF + Editor noch offen (siehe TODO unten)
|
|
- [/] **1.5 Bildgröße pro Seite** — image_scale/image_align Spalten da, UI noch offen
|
|
- [ ] **1.7 Kunden-Tab** — Tab "Berichte" auf thirdparty
|
|
|
|
### TODO Phase 1.4 + 1.5 (Folge-Commit)
|
|
- BerichtPage::getImages() liest llx_bericht_page_image
|
|
- Editor: Layout-Dropdown pro Seite (1/2/4/6 Slots)
|
|
- Drag&Drop von Anhängen in Slots oder "Als Grid hinzufügen"-Button
|
|
- generate_pdf/preview_pdf: Grid-Rendering (calculate slot rects)
|
|
- Bei `single`-Layout: image_scale (1.0/0.7/0.5) + image_align (fit/center/topleft/topright)
|
|
|
|
---
|
|
|
|
## Phase 4 Block 1 ✅ (2026-04-09)
|
|
|
|
PWA-Usability-Features:
|
|
- 4.g Seite löschen in PWA (ajax /api/pages.php DELETE)
|
|
- 4.h Notiz pro Seite (POST /api/pages.php {note})
|
|
- 4.j PDF-Vorschau-Modal nach Finalize (api/pdf.php liefert Blob mit JWT)
|
|
- 4.b Touch-Unterschrift (openSignatureModal → api/pages.php?action=signature)
|
|
- 4.e Web Share Target API (manifest + share.html + SW-Interception in IDB)
|
|
|
|
Neue API-Endpoints:
|
|
- api/pages.php — DELETE/POST (note, rotation) + ?action=signature&bericht_id=
|
|
- api/pdf.php — liefert Final-PDF oder on-the-fly Preview, JWT via Query-Param
|
|
|
|
PWA neue Modals (alle in app.js):
|
|
- openPageActionsModal — tap auf Report-Page-Thumb, Notiz + Löschen
|
|
- openPdfModal — iframe mit Blob-URL + Download-Link
|
|
- openSignatureModal — Touch-Canvas 2:1, Clear, Save als PNG
|
|
- openHelpModal — komplette Anleitung (bereits in v4 gebaut)
|
|
|
|
Service Worker v5 (Share Target), manifest.webmanifest mit share_target.
|
|
|
|
## Phase 2 — Mobile-Vorbereitung + API-Layer (geplant)
|
|
- 2.1 Mobile-Upload-Token Tabelle + Cleanup-Cron
|
|
- 2.2 QR-Upload Lite Modal im Editor
|
|
- 2.3 API-Layer unter `bericht/api/` mit JWT-Auth
|
|
- 2.4 REST-Endpoints: /auth/login, /orders, /orders/{id}, /orders/{id}/photos, /reports, /reports/{id}/pages
|
|
|
|
JWT-Secret aus `$dolibarr_main_instance_unique_id`, 7 Tage Lifetime, Multi-Device OK (stateless).
|
|
|
|
Auftragsfilter pro User: `fk_user_author`, `fk_user_valid`, `fk_user_modif` ODER `llx_element_contact` mit "intern verantwortlich".
|
|
|
|
---
|
|
|
|
## Phase 3 — PWA MVP (geplant)
|
|
- Repo: `data-it/baustelle-pwa` (separates SvelteKit-Projekt)
|
|
- Hosting: `awl.data-it-solution.de/baustelle/` (Apache-Alias)
|
|
- Stack: SvelteKit + Workbox + idb-keyval
|
|
- MVP: Login → Auftragsliste → Detail → Foto-Aufnahme → Offline-Queue → Sync
|
|
|
|
---
|
|
|
|
## Phase 4 — PWA Voll (geplant)
|
|
- Sprachnotizen (MediaRecorder)
|
|
- Touch-Skizzen-Editor
|
|
- Schnell-Bericht in PWA
|
|
- Touch-Unterschrift
|
|
- PIN-Schutz / WebAuthn
|
|
- Push-Notifications
|
|
- Web Share Target API
|
|
|
|
---
|
|
|
|
## Phase 5 — Optional Später
|
|
Stamps, Vorher/Nachher, Versionierung, Mess-Werkzeug, Bericht-Vorlagen, Batch-Modus, Whisper-Transkription, Offline-Map
|
|
|
|
---
|
|
|
|
## Wichtige Lessons Learned (für andere Dolibarr-Module)
|
|
|
|
1. **Numero muss kollisionsfrei sein** — sonst werden Permissions stillschweigend verworfen
|
|
2. **Permission-Array-Format**: [4]=perms (action), [5]=subperms (leer) — NICHT [4]=Modulname
|
|
3. **CSS-Variablen** über Theme nutzen, nicht hardcoded Hex
|
|
4. **JS-Libs lokal** in `js/lib/` (Eddys Regel: kein CDN)
|
|
5. **Fabric.js wickelt Canvas** in `.canvas-container` — den positionieren, nicht das innere Canvas
|
|
6. **PDF.js Buffer wird konsumiert** — beim Re-Render `arrayBuffer.slice(0)` nutzen
|
|
7. **Lokales Dolibarr** läuft als User `data`, mit Symlinks aus `/var/www/dolibarr/custom/<modul>` zu `/mnt/17 - Entwicklungen/...`
|
|
8. **Niemals direkt** in `/var/www/dolibarr` oder `/mnt/appdata` editieren — alles über Git
|
|
9. **Niemals schreibend** in `dolibarr_test` MySQL — nur lesend für Debugging
|
|
10. **Computed Extrafields** mit `$object->ref` brauchen Null-Check, sonst PHP-Output beim eval → "headers already sent"
|