Territory-Hierarchie (Land → Bundesland/Kanton) auf CRM Lead befüllen #3

New issue

Closed

opened 2026-07-25 17:28:41 +00:00 by forgejo-admin · 0 comments

forgejo-admin commented

2026-07-25 17:28:41 +00:00

Owner

Kontext

Beim Testen von feature/lead-origin-note aufgefallen: CRM Lead hat ein territory-Feld (Link auf CRM Territory), das wir bisher nicht befüllen.

Recherche

CRM Territory ist ein Baum-Doctype (is_tree: 1, nsm_parent_field: parent_crm_territory), Autoname field:territory_name, aktuell komplett leer in der DB.
Kein Root-Zwang im Controller (reiner pass-Controller) — mehrere Wurzelknoten (mehrere Länder nebeneinander) sind mit Frappes generischem Nested-Set-Framework unproblematisch.

Entscheidung (abgestimmt)

Automatisch zweistufig anlegen:

ensure_territory(country_name, region_name) in crm_lead_sync.py, analog zu ensure_lead_source():
- Land als Gruppen-Knoten (is_group=1, kein Parent) falls nicht vorhanden.
- Bundesland/Kanton als Kind-Knoten (is_group=0, parent_crm_territory=<Land>) falls nicht vorhanden.
Braucht ausgeschriebene Namen statt Codes (BY → Bayern) → REGION_NAMES-Tabelle aus dem alten Mautic-Projekt (GitLab/wsc_py_leadscraper/import_leads.py) für DE/AT/CH nach crm_lead_sync.py übernehmen (oder eigenes Modul region_names.py, falls zu groß).
build_lead_fields() bekommt ein neues Feld "territory": region_name.
Land-Ebene nutzt dieselben deutschen Anzeigenamen wie COUNTRY_NAMES_DE (Konsistenz zu custom_country).

Verifikation

Neuer Lead in einer bisher unbekannten Region → Land- und Bundesland-Territory werden automatisch angelegt
Zweiter Lead in derselben Region → keine doppelten Territory-Einträge
territory-Feld im CRM-Frontend auf dem Lead sichtbar/korrekt

Fachlicher Ursprung: #1

## Kontext Beim Testen von `feature/lead-origin-note` aufgefallen: `CRM Lead` hat ein `territory`-Feld (Link auf `CRM Territory`), das wir bisher nicht befüllen. ## Recherche - `CRM Territory` ist ein Baum-Doctype (`is_tree: 1`, `nsm_parent_field: parent_crm_territory`), Autoname `field:territory_name`, aktuell **komplett leer** in der DB. - Kein Root-Zwang im Controller (reiner `pass`-Controller) — mehrere Wurzelknoten (mehrere Länder nebeneinander) sind mit Frappes generischem Nested-Set-Framework unproblematisch. ## Entscheidung (abgestimmt) Automatisch zweistufig anlegen: - `ensure_territory(country_name, region_name)` in `crm_lead_sync.py`, analog zu `ensure_lead_source()`: - Land als Gruppen-Knoten (`is_group=1`, kein Parent) falls nicht vorhanden. - Bundesland/Kanton als Kind-Knoten (`is_group=0`, `parent_crm_territory=<Land>`) falls nicht vorhanden. - Braucht ausgeschriebene Namen statt Codes (`BY` → `Bayern`) → `REGION_NAMES`-Tabelle aus dem alten Mautic-Projekt (`GitLab/wsc_py_leadscraper/import_leads.py`) für DE/AT/CH nach `crm_lead_sync.py` übernehmen (oder eigenes Modul `region_names.py`, falls zu groß). - `build_lead_fields()` bekommt ein neues Feld `"territory": region_name`. - Land-Ebene nutzt dieselben deutschen Anzeigenamen wie `COUNTRY_NAMES_DE` (Konsistenz zu `custom_country`). ## Verifikation - [ ] Neuer Lead in einer bisher unbekannten Region → Land- und Bundesland-Territory werden automatisch angelegt - [ ] Zweiter Lead in derselben Region → keine doppelten Territory-Einträge - [ ] `territory`-Feld im CRM-Frontend auf dem Lead sichtbar/korrekt Fachlicher Ursprung: #1

forgejo-admin referenced this issue

2026-07-25 17:28:54 +00:00

Adresse Weg 1: PLZ als eigenes Custom Field, custom_address bereinigen #4

forgejo-admin referenced this issue

2026-07-25 17:29:11 +00:00

Adresse Weg 2: Echtes Address-Dokument statt Custom-Field-Text (spätere Ausbaustufe) #5

forgejo-admin referenced this issue from a commit

2026-07-25 17:35:16 +00:00

feat(app): populate CRM Territory (Country -> Region hierarchy) on leads

forgejo-admin referenced this issue from a pull request that will close it,

2026-07-25 17:35:26 +00:00

feat: populate CRM Territory (Land → Bundesland/Kanton) on leads #6