RSM XML Import — Projektangebote aus Altsystem

User Story

Als Projektpartner möchte ich auf der SOLCOM-Website aktuelle Projektangebote sehen, auch wenn Salesforce noch nicht live ist, damit ich mich bereits ab Go-Live auf passende Projekte bewerben kann.

Outcome

Das neue Sub-Modul solcom_rsm_import importiert täglich die RSM-XML-Datei aus private://rsm/ und legt project_offer-Nodes an bzw. aktualisiert bestehende. Import und SF-API-Pull schließen sich via State Flag aus. Die Projektliste unter /fuer-freiberufler/projektliste ist ab Tag 1 des Go-Live befüllt.

Scope

In Scope

Neues Sub-Modul solcom_rsm_import unter web/modules/custom/solcom_project_offer/modules/
Drupal Migrate SourcePlugin RsmXmlSource: liest neueste Datei in private://rsm/ (nach filemtime), dekodiert UTF-16, parst <OpenPos><Datensatz>-Struktur
Feldmapping RSM → project_offer-Node:

RSM-Feld	Drupal-Feld	Typ
`lfdNr`	`field_rsm_lfd_nr` (Migration Key)	Integer
`Titel`	`title`	String
`Beschreibung`	`body`	Text (HTML)
`Ort`	`field_location`	String
`Start`	`field_start_date`	Date
`Dauer`	`field_duration`	String
`Stellentyp`	`field_job_type`	String
`Bearbeiter`	`field_contact_email`	Email
`Aktiv`	`status` (published/unpublished)	Boolean
`FreelancerLink` (Minggo-URL, Suffix = SF-ID)	`field_minggo_url` + `field_sf_id` (extrahiert)	String
`Region`	`field_region`	String
`Branche`	`field_industry`	String
`skills`	`field_skills`	Text

State Flag solcom_project_offer.rsm_fallback_enabled: bei 1 läuft RSM-Import-Cron, SF-Import schläft; bei 0 umgekehrt
Cron-Job: täglich, prüft ob Flag aktiv, wählt neueste Datei, führt Migrate aus
Automatisches Unpublish von Nodes deren lfdNr nicht mehr in der neuesten XML erscheint oder Aktiv=0
Alte Dateien in private://rsm/ nach 30 Tagen löschen

Out of Scope

SF-Migration und lfdNr→SF-ID-Mapping (separater Task nach SF-Go-Live)
SFTP-Konfiguration auf dem Server (operativer Schritt, nicht Modul-Code)
Bewerbungsformular (eigene Story: RSM Bewerbungs-Webform)

Akzeptanzkriterien

Wenn drush state:get solcom_project_offer.rsm_fallback_enabled = 1 und eine XML-Datei in private://rsm/ liegt, werden nach Cron-Run alle Aktiv=1-Datensätze als project_offer-Nodes angelegt/aktualisiert.
Datensätze mit Aktiv=0 oder nicht mehr in der XML vorhanden werden unpublished.
Bei mehreren Dateien in private://rsm/ wird die neueste (nach filemtime) verwendet.
Wenn Flag = 0, wird kein RSM-Import durchgeführt (SF-Import läuft stattdessen).
Nodes mit FreelancerLink haben field_minggo_url befüllt und field_sf_id mit dem extrahierten SF-Record-ID-Suffix.
Folgerun mit gleicher Datei erzeugt keine Duplikate (idempotent via field_rsm_lfd_nr).

QA-Plan (Click-Pfade)

AK	URL / Kommando	Aktion	Erwartet
1	`drush state:set … 1 && drush cron`	Flag setzen, Cron laufen lassen	Nodes angelegt, Titel/Ort aus XML korrekt
2	`/fuer-freiberufler/projektliste`	Node mit `Aktiv=0` suchen	Node unpublished, nicht in Listing sichtbar
3	`private://rsm/` (2 Dateien)	Cron laufen lassen	Nur neuere Datei importiert (Datumsstempel prüfen)
4	`drush state:set … 0 && drush cron`	Flag auf 0, Cron	Kein RSM-Import, kein Fehler-Log
5	`/fuer-freiberufler/projektliste/{node}`	Node mit FreelancerLink aufrufen	`field_minggo_url` befüllt, `field_sf_id` korrekt extrahiert
6	`drush cron` (gleiche Datei, 2× laufen)	Zweiter Cron-Run	Node-Anzahl unverändert (kein Duplikat)

Technische Details

XML-Struktur

<?xml version="1.0" encoding="UTF-16"?>
<OpenPos>
  <Datensatz>
    <lfdNr>42773</lfdNr>
    <Titel>Senior PHP Developer</Titel>
    <Beschreibung>...</Beschreibung>
    <Ort>München</Ort>
    <Start>01.07.2026</Start>
    <Dauer>6 Monate</Dauer>
    <Bearbeiter>max.mustermann@solcom.de</Bearbeiter>
    <Aktiv>1</Aktiv>
    <FreelancerLink>https://solcom.minggo.io/UUID/apply/a1WSZ001</FreelancerLink>
    ...
  </Datensatz>
</OpenPos>

SF-ID Extraktion aus FreelancerLink

Pattern: https://solcom.minggo.io/{UUID}/apply/{SF_ID} → letztes URL-Segment ist die SF-ID.

Abhängigkeiten

ADR-0048: Architektur-Entscheidung für RSM-Fallback (0048-rsm-fallback-architecture.html)
SFTP-Setup: RSM-System muss XML in private://rsm/ pushen (operativer Schritt)
Drupal Migrate Plus: Contrib-Modul für Source-Plugin-Infrastruktur
Folge-Task: RSM Bewerbungs-Webform