Travelbear-dolibarr/01_data_model.md

Travelbear Dolibarr – Datenmodell

Dieses Dokument beschreibt die Module, Felder und Mappings für das B2B-Reisebüro-Setup in Dolibarr.
Ziel: einheitliche Struktur für die Digitalisierung der Workflows (Anfrage → Projekt → Teilnehmer → Abrechnung).

---

1. Projekte (Reisen)

• Label: Name der Reise (z. B. "Opera in Germany 2025")
• Customer (Thirdparty): Referenz auf Reisebüro (z. B. Limelight Arts Travel)
• Start / Enddatum: Zeitraum der Reise
• Ref. (Dolibarr-intern): automatisch generiert von Dolibarr (z. B. PRJ250001)
• Description: Freitext, allgemeine Hinweise

Extra Fields (Custom Fields)

• target_group_size (int) → Teilnehmerzahl Szenario (z. B. 10, 12, 16)
• project_type (dropdown) → Tourtyp (Opera, Studienreise, etc.)

---

2. Aufgaben (Tasks)

• Label: Kurztitel der Aufgabe (z. B. „Day 1 – Canapés Hilton Berlin“)
• Date Start/End: Uhrzeit & Datum der Aktivität oder Deadline
• Parent Project: Verknüpfung zur Reise

Extra Fields

• supplier (link → Thirdparty) → z. B. Hotel, Restaurant, Busunternehmen
• location (string) → Adresse / Ort
• meal (dropdown) → B / L / D
• notes (text) → Zusätzliche Hinweise (z. B. „Passport mitnehmen Reichstag“)

---

3. Kunden (Thirdparties)

• Typ: Customer
• Beispiel: Limelight Arts Travel, Academy Travel, Studentenreisen

Kontakte (Linked Contacts)

• Tour Leader, Tour Manager, Ops Manager
• Felder: Name, Email, Telefon, Rolle

---

4. Lieferanten (Thirdparties)

• Typ: Supplier
• Beispiel: Hilton Berlin, Marriot Leipzig, Steigenberger Dresden, NH München, Spacebase Conference Centre

---

5. Produkte / Dienstleistungen

• Label: Name (z. B. „Hotelnacht DZ Hilton Berlin“, „Opernticket Semperoper“)
• Type: Service
• Base Price: Nettopreis pro Einheit (optional je nach Kalkulation)

---

6. Supplier Orders

• Linked Supplier: Hotel, Restaurant, Bus etc.
• Products/Services: gebuchte Leistungen
• Payment Terms: z. B. 90 Tage, Anzahlung 30 %
• Status: Draft / Validated / Paid

---

7. Teilnehmer (eigenes Modul – geplant)

• Vorname / Nachname
• Geburtsdatum
• Passnummer
• Nationalität
• Kontaktinfos (Telefon, Mail)

Extra Fields

• meal_preference (dropdown: vegan, vegetarisch, glutenfrei, normal)
• arrival_date (date)
• departure_date (date)
• room_type (dropdown: Single, Double, Twin, Suite)
• nok_name (text) → Notfallkontakt Name
• nok_phone (text)
• insurance_company (string)
• insurance_policy (string)

Verknüpfung: Teilnehmer ↔ Projekt (n:m), damit ein Teilnehmer auf mehreren Reisen sein kann.

---

8. Dokumente / Vorlagen

• Kundenquote (mit Preisen) → PDF aus Angebot
• Operator Itinerary (ohne Preise) → PDF aus Projekt-Tasks
• Teilnehmerlisten → PDF/Excel-Export aus Teilnehmer-Modul

---

9. Mapping aus Anfrage (Word)

Word-Dokumentfeld	Dolibarr-Feld
„Opera in Germany“	Project Label
„24 June – 8 July 2025“	Project Start/End
„OSR_PER2506A“	Project Customer Reference
„Limelight Arts Travel“	Thirdparty (Customer)
Tour Leader/Manager	Linked Contacts
Day 1, 24 June	Task (Date Start)
„18h30 Canapés“	Task Label
„Hilton Hotel Berlin“	Supplier (linked)
Notes	Task Notes

---

10. Nächste Schritte

1. Extra Fields in Dolibarr anlegen (Projekte, Tasks, Teilnehmer)
2. Beispielprojekt manuell anlegen → Felder testen
3. Datenmodell in Gitea aktuell halten
4. Parser (Word → JSON) auf dieses Mapping ausrichten
5. API-Workflow (n8n) entwickeln → automatisierte Projekterstellung