@bytebrand/export-cars 1.26.44 → 1.26.46

package/docs/marktde/AUDIT.md

@@ -0,0 +1,84 @@
+# markt.de vehicle feed — audit (ADV-328)
+
+Status 12.11.2026: DEV only, dry-run by default, nothing is sent to markt.de. No current markt.de
+feed specification exists (partner contacted 15.10.2026, `PARTNER-QUESTIONS.md`), so the legacy
+ACF-4370 format is kept as it is and only clear defects are fixed. Old Jira / Confluence column
+letters are code evidence, not a contract.
+
+## 1. What exists (code + runtime)
+
+| Item | Evidence |
+|---|---|
+| Exporter | `export-cars` `exportType=marktde`. Until 1.26.44 the shared `MobileExporter` (also eauto / yescar / evium); from 1.26.45 `MarktdeExporter` → `MarktdeFeedRun` |
+| Row format | `MobileTransformer` + Google sheet `147qz9sT…` tab `mobile_yescar` (165 rules, ACF-4370 reused the YesCar / mobile.de CSV). `;` separated, every cell quoted, no header row, UTF-8, 517–528 columns per row |
+| Files | `api_export_cars_marktde.csv` + `.zip` (was `resources/marktde-export/`) |
+| DEV Cronicle | `9c.0 Export markt.de - part 1` `ekpy4pqg21u` (rule `metaData.ownerId:xo1ag9JooQebXhnfSclw3NhZyG63`) → `9c.1 … part 2` `ekyvib2rm06` (plain `ftp -pinv 185.15.211.90`, uploads `develop_marktde.zip/.csv`, credentials in the script) → `9d.0 facebook shop`. Triggered by the chain after `9b.1 Export Focus`. No run in the job history |
+| DEV runtime defects found | (a) the Google Sheets API key in `9c.0` is **expired** — the mapping sheet cannot load, every row-building run fails; (b) the filtered dealer has 0 cars in the DEV snapshot; (c) the host has no `zip` binary — the legacy run wrote the CSV, failed the ZIP and still reported `code 0`; (d) `9c.1` uploads names the exporter never writes; (e) 185.15.211.90 is the legacy Jelastic FTP (port 21 closed, see ADV-319 4.1) |
+| PROD | not checked (DEV-only task). Old contract / account belong to the former auto.de Media GmbH — not transferable (Daniel, 16.10) |
+
+## 2. Source → target matrix (columns the feed relies on)
+
+Column = 0-based sheet `importField` (letter in brackets). "Changed" = 1.26.45 vs 1.26.44 on the same
+DEV snapshot (11.11 15:00, 2,453 common rows).
+
+| Col | Field | Source | 1.26.44 | 1.26.45 | Changed rows |
+|---|---|---|---|---|---|
+| 0 (A) | customer no. | constant `04109003` | same | same (legacy markt.de account → new entity needs its own, Q4) | 0 |
+| 1 (B) | vehicle id | `metaData.vehicleId` | same | same; a car without it is excluded | 0 |
+| 3 / 4 (D / E) | make / model | `mainData.make`, `model + subModel` | same | same | 0 |
+| 10 (K) | price | `price.currentSalesPrice` | net if deductible, **but gross when `vatRate` was null while AD said 19** | net = gross·100/(100+rate) with the same rate as AD | **329** (13 %: legacy would have shown +19 %) |
+| 11 (L) | VAT flag | `!price.vatDeductible` | 0 / 1 | same | 0 |
+| 14 (O) | VIN | `metaData.vin` | own VIN, else `marketing.fakeVIN`, else a **random generated VIN** | own VIN if ISO-3779-valid, else empty | **1,291** (53 % fake VINs gone) |
+| 25 (Z) | description | dealer default summary (header / body / footer, `car-description` Mobile) | as built | contact data removed (§4) | 1,531 |
+| 26 (AA) | images | Imbo | default profile incl. **noimage placeholders** | validated clean ADV-336 list, hero first, `;` | 2,453 |
+| 29 (AD) | VAT rate | `price.vatRate` | `vatRate‖19` | same rule, now also used for K | 0 |
+| 98 (CU) | fuel combined | legacy `consumptionCombined` | raw (BEV kWh, estimated) | Google EnVKV pick (WLTP first), BEV empty, decimal comma | 959 |
+| 99 (CV) | CO2 | `environmentEmissions.co2` | raw, `"undefined"` possible | Google EnVKV pick, BEV 0, nothing usable → empty | 928 |
+| 402 (OM) | clickout | `_id` | `https://www.auto.de<id>?source=classifieds…` — **no slash, no path: broken link** | `/search/vehicle/<id>?source=marktde&medium=listing&campaign=listing` + same `utm_*` | 2,453 |
+
+No other column changed (column-by-column diff). eauto / yescar / evium keep `MobileExporter`; the only
+shared-code change is the removed marktde-only fake-VIN branch.
+
+## 3. Price / VAT semantics (kept from ACF-4370)
+
+`currentSalesPrice` is the gross consumer price. VAT-deductible: K = net, L = 0, AD = rate → the partner
+shows K·(1+AD/100) = the gross price again. Not deductible (margin scheme, private, exempt): K = gross,
+L = 1, AD = 0 — VAT is never added to an already gross price. DEV: 2,433 deductible / 20 not;
+329 deductible cars without a stored rate get 19 % for both K and AD (`vat.rateDefaulted`). Whether
+markt.de still reads K as net is open (Q9); a net price must not be shown as the consumer price.
+
+## 4. Marketplace terms in the description
+
+markt.de's public terms forbid phone numbers, addresses, website links and QR codes in the description
+and images. `sanitizeMarktdeDescription` removes: links with scheme / `www.`, other bare domains,
+e-mails, phone numbers (8–16 digits, label included), street + number, postcode + town; the label left
+before a cut ("Tel.:") goes too; nothing else in the text changes. Kept: `auto.de` / `Auto.de` as a word
+(brand and legal entity auto.de GmbH — commercial identification), dates, prices, mileage, model names.
+Real DEV text (1,701 descriptions): only the template's contact block (Tel / WhatsApp / SMS / E-Mail,
+twice per text) and the `www.auto.de/z/<id>` short link are cut; one false positive ("Touring 3.0" as a
+street) was found and fixed. Images: clean profile = the car's own photos, no marketing overlays.
+Not detectable here: text inside photos (dealer watermarks / QR) — image ticket.
+
+## 5. Run safety (same as AutoUncle / meinestadt)
+
+Fail-closed `FeedGuard`: complete and fresh base snapshot, minimum / drop checks, lock, temp file →
+atomic rename, `.prev`, `.rejected`, report in `resources/marktde-state/<mode>/last-run-report.json`.
+Excluded: duplicate id, Cronicle rules / no images, no `_id`, no vehicle id, reserved / sold, no valid
+price, no valid 3/4 hero image. ZIP in-process (adm-zip, as meinestadt). Removal = the car is missing
+from the next full file (markt.de delta / deletion semantics: Q12).
+
+## 6. DEV dry-run 12.11.2026 (host, harness — see RUNBOOK)
+
+Snapshot 3,094 cars → 2,453 rows, 370 dealers; excluded: 471 by rules (no images), 170 without a valid
+hero image (the legacy file sent them with placeholders). Images 12,197/12,197 OK, 1–28 per car.
+VIN sent 1,162 / empty 1,291. Fuel empty 153 (BEV / nothing usable), CO2 never empty. Event params as
+configured (one dealer) → 0 cars → blocked `published_too_small`, nothing written.
+
+## 7. Known, not changed (need a decision or the partner spec)
+
+- Description body quality comes from `car-description` (English labels "Manufacturer", "Basic data",
+  `Erstzulassung: <unix seconds>`): shared library, also mobile.de — separate ticket.
+- Rate columns 150 / 293 (monthly installment, `"0"` when none) and financing columns 160–166 from the
+  sheet: a rate claim needs the PAngV disclosure; markt.de has to confirm whether they are read at all.
+- Seller identity: all rows under one customer number, dealer not in a column of its own — Q5.
+- Column count differs per row (517–528, trailing empty cells omitted) — legacy, fine for the old importer.

package/docs/marktde/PARTNER-QUESTIONS.md

@@ -0,0 +1,49 @@
+# markt.de — open partner questions (ADV-328 / ADV-330)
+
+Drafts for the user's review only — nothing is sent by engineering. Contact: online-marketing@markt.de
+(Alexandra Roth's auto-reply, 15.10.2026). Contracting party: auto.de GmbH, Max-Planck-Straße 19,
+06796 Sandersdorf-Brehna (imprint); the former auto.de Media GmbH account / contract is not assumed
+to carry over.
+
+## Commercial / account
+
+1. Current partnership model for nationwide vehicle inventory: free listing, CPC, CPM, CPS, fixed fee,
+   insertion fees, caps, minimums, credits for invalid clicks, termination, invoice workflow?
+2. Business account for auto.de GmbH: new account or transfer? Commercial seller role shown how?
+3. Inventory upload rights: may auto.de list dealer vehicles (marketplace / agent role), or only own stock?
+4. Customer / account number for the feed (the legacy file sends `04109003` in column A).
+5. Seller identity per listing: one auto.de account, or per-dealer identity (name / location fields)?
+
+## Feed specification
+
+6. Current official automotive feed spec and a reference file: transport (CSV / XML / JSON), schema,
+   required / optional fields, enum values and language, header row, field order, encoding, delimiter,
+   quoting, decimal format, ZIP packaging.
+7. Is the legacy mobile.de-style CSV (ACF-4370, ~528 columns, no header) still accepted?
+8. Transport: pickup URL, SFTP / FTPS endpoint, credentials, schedule, max file size.
+9. Price: is column K read as a net price with L (VAT flag) and AD (VAT rate), or should the feed send
+   the gross consumer price? Margin-scheme / exempt cars?
+10. Images: number, minimum resolution, aspect ratio, file size, URL vs. files in the ZIP, ordering;
+    which logos / overlays are allowed; rules for AI-edited images.
+11. Listing limits, category conditions (cars only? vans, motorbikes?), new vs. used.
+12. Updates / deletions: full file each run (car missing = removed) or delta with explicit deletes?
+    How fast is a sold car taken offline?
+13. Importer diagnostics: error report per row, test account / staging importer.
+
+## Clickout, enquiries, reporting (ADV-330)
+
+14. Is a structured clickout field (link to the auto.de vehicle page) allowed for an enterprise
+    partner? Which field? (The public terms forbid links in description and images; we will not put
+    any there.) May the link carry `source=marktde&medium=listing&campaign=listing` + `utm_*`?
+15. Does markt.de append its own click / listing / campaign id to the clickout? Name and format?
+16. Or do buyers contact the seller on markt.de (messages / calls)? If so: lead delivery path
+    (e-mail, API, export), fields, lead id, listing id, timestamp, consent / privacy terms (DPA).
+17. Reporting: clicks / impressions / enquiries per listing and day? Format, delivery, time zone,
+    restatements, invoice file with credits.
+18. Any postback / pixel / server API offered (we will not build one without a written spec)?
+19. Consent: is a clickout from markt.de covered by our own CMP on landing only (current state)?
+
+## Compliance
+
+20. EnVKV / Pkw-EnVKV: which fields does markt.de show (consumption, CO2, class, electric range)?
+21. Financing rate columns (monthly installment): shown at all? Required PAngV disclosure fields?

package/docs/marktde/RUNBOOK.md

@@ -0,0 +1,58 @@
+# markt.de feed — runbook (ADV-328)
+
+## Parameters (Cronicle event, export-cars plugin, `exportType=marktde`)
+
+| Param | Default | Meaning |
+|---|---|---|
+| `apikey` | — | Google Sheets API key for the mapping sheet `mobile_yescar`. **DEV 9c.0: expired (12.11.2026)** |
+| `String` / `Number` / `Date` | — | Cronicle filter rules (DEV 9c.0: one dealer, 0 cars today) |
+| `marktdeDryRun` | dry-run | only the exact text `false` makes a live run |
+| `marktdeMaxImages` | no cut | cut the image list (no markt.de limit known) |
+| `marktdeImageConcurrency` | 16 | parallel image URL checks |
+| `feedGuardMinSourceItems` | 1000 | DEV snapshot ~3,100 cars |
+| `feedGuardMinPublishedItems` | 1 | set a real minimum per job once the dealer scope is known |
+| `feedGuardMaxDropPercent` | 20 | max drop of source / rows against the last good run |
+| `feedGuardMaxSourceAgeHours` | 26 | newest base export chunk must be younger |
+| `feedGuardMaxStaleHours` | 48 | last good file reported STALE after this |
+| `feedGuardAcceptDrop` | off | `true` for ONE run after a real stock drop |
+
+No new parameter is needed for a run: the defaults give a safe dry-run.
+
+## Files
+
+| Mode | Output | State |
+|---|---|---|
+| dry-run | `resources/marktde-dryrun/api_export_cars_marktde.{csv,zip}` | `resources/marktde-state/dryrun/` |
+| live | `resources/marktde-export/api_export_cars_marktde.{csv,zip}` | `resources/marktde-state/export/` |
+
+State dir: `last-good.json`, `last-run-report.json` (every run: guard code, exclusions, VIN / VAT /
+EnVKV / description-cut counts, image stats), `run.lock`. A blocked run leaves `<csv>.rejected`; the
+published CSV/ZIP and `<csv>.prev` stay.
+
+## Exit codes and the chain
+
+Blocked or failed runs exit 1, so the chained `9c.1 … part 2` FTP step does not run (and with it the
+rest of the DEV chain: `9d.0 facebook shop …`). A dry-run exits 0 and `9c.1` then tries to upload
+`develop_marktde.*`, which does not exist, to the legacy Jelastic FTP. To run 9c.0 alone, start it via
+the API with `chain: ""` (see below) or from the UI with the chain removed for that run.
+
+## One-off DEV dry-run without the event (what was done 12.11.2026)
+
+```
+D=/home/deploy/export-cars-<ver>-dryrun/<name>   # job.json (chmod 600) + credentials + resources/cars-export symlinks
+NODE_PATH=<pkg>/dist:/opt/cronicle/node_modules node <pkg>/dist/main.js < job.json > run.log
+```
+While the event's Sheets key is expired: `node harness.js <pkg> < job.json` — the harness runs the same
+`main.js` but loads the mapping rules from the public CSV of the same sheet tab (gviz) with the same
+post-processing as `MappingService`.
+
+## Before anything goes live (not done; each step needs explicit OK)
+
+1. Signed contract / account for auto.de GmbH, current markt.de feed spec + test importer
+   (`PARTNER-QUESTIONS.md`); written acceptance of a test import of the 20-row sample.
+2. New Sheets API key in the 9c.0 params (or move the mapping out of Google Sheets).
+3. Dealer scope (the rule in 9c.0) and `feedGuardMinPublishedItems` from a PROD dry-run.
+4. Replace `9c.1`: transport and file names from the spec, credentials out of the script; never the
+   legacy Jelastic host. Only then `marktdeDryRun=false`.
+5. Customer number (col A `04109003`) for the new entity; clickout field permission (col OM).
+6. Tracking: `web-funnel-tracking-health` ≥ 1.5.6 (CLASSIFIEDS_MARKTDE) on the target Cronicle.

package/docs/marktde/TRACKING.md

@@ -0,0 +1,69 @@
+# markt.de — measurement design (ADV-330)
+
+Status 12.11.2026: DEV only. Implemented: the clickout link (export-cars 1.26.45) and the reporting
+channel `CLASSIFIEDS_MARKTDE` (web-funnel-tracking-health 1.5.6). Not implemented, by design, until
+markt.de confirms a path in writing: partner click ids, hosted-enquiry ingestion, cost import.
+
+## Evidence
+
+- ACF-4370 link (legacy feed, column OM): `?source=classifieds&medium=listing&campaign=marktde` —
+  and the URL itself was broken (`https://www.auto.de<id>`, no `/search/vehicle/`), so no historic
+  markt.de session could be expected from it.
+- ADV-260: fe-main stores `source/medium/campaign/utm_*` + click ids in the marketing cookie and sends
+  them with every lead (REQ → Odoo `crm_source`, BigQuery event / journey views).
+- Classification before 1.5.6: `source=classifieds` without a known campaign → generic classifieds /
+  UTM rules; partner identity was lost (same finding as AutoUncle ADV-324).
+- No markt.de click id, postback, pixel or reporting API is known. Public terms forbid links in the
+  description and images.
+
+## Path A — clickout to auto.de (only if markt.de allows a structured link field)
+
+```
+markt.de listing ──(structured field OM)──► https://www.auto.de/search/vehicle/<car _id>
+    ?source=marktde&medium=listing&campaign=listing&utm_source=marktde&utm_medium=listing&utm_campaign=listing
+  → fe-main marketing cookie (ADV-260)        → visitor session, landing_url keeps the raw query
+  → views: reporting_channel CLASSIFIEDS_MARKTDE, family Classifieds, detail markt.de, publisher MARKTDE
+  → form → REQ → Odoo crm_source "marktde" (lower-case source, no SQL change needed)
+  → rpt_episode_touchpoint → canonical 90-day episode (original episode_start_date) → sale / CM
+```
+
+- Grain: session (visitor_id + session). No click id → aggregate reconciliation only (platform
+  `marktde` in the click-reconciliation view, used only where `fact_marketing_media` has markt.de rows).
+- Raw and normalized are separate: `source / medium / campaign / utm_*` stay as received in the event
+  rows; the channel is derived. Legacy `classifieds + campaign=marktde` and the spelling `markt.de`
+  resolve to the same channel. Any medium; not `PAID_*` (paid / free is a contract attribute), so
+  the paid click-id health rates are not affected.
+- Same car id = feed row → VDP → lead car id, so listing-level joins work without a partner id.
+- If markt.de appends its own click / listing id: add it to the ADV-260 capture list and the
+  `CLICK_ID_COLUMNS` only after the name / format is confirmed (Q15). Never manufacture one.
+- Bots: KNOWN_CRAWLER / BOT_SUSPECT rules apply before attribution as for every channel.
+
+## Path B — enquiries on markt.de (no visit to auto.de)
+
+Only if markt.de offers a lead delivery with a contract (Q16): separate ingestion keyed by partner lead
+id + listing id (= vehicle id / car id) + created timestamp, **no website session is created**. REQ
+duplicate check by partner lead id; GDPR: only the fields needed for the enquiry, consent text from the
+partner, DPA first. Nothing is built before the schema is known; no scraping of partner messages.
+
+## Costs
+
+When a tariff exists: invoice / partner report rows into `fact_marketing_media` (existing table, no new
+collection or table) with `source_system = marktde_invoice`, date, account, channel `marktde`,
+listing / campaign id when supplied, currency, billed clicks, fees, credits as negative rows, contract
+version, file hash for idempotent upsert / replay. No estimated CPC as actual cost. A CPS / fixed fee
+is marketing cost only, never a second CM deduction. Tabs 03 / 07 / 13 / 91 and the cost guardrails
+stay unchanged (live report layout changes need approval).
+
+## QA
+
+| Case | Expected | Status |
+|---|---|---|
+| link with `source=marktde` + utm (consent given) | CLASSIFIEDS_MARKTDE session + event rows | unit test ✓, DEV run see below |
+| legacy `source=classifieds&campaign=marktde` | CLASSIFIEDS_MARKTDE | unit test ✓ |
+| `utm_source=markt.de`, other medium (`cpc`) | CLASSIFIEDS_MARKTDE, not PAID_OTHER | unit test ✓ |
+| Google click id + markt.de utm | click id wins (PAID_SEARCH_GOOGLE) | rule order test ✓ |
+| no consent / revoked | no marketing cookie → lead without source (unchanged behaviour) | not run (needs browser) |
+| lead → REQ → episode → sale | crm_source marktde, episode keeps original start | not run (no markt.de traffic) |
+| partner id, hosted leads, invoice import, credits, double import | — | blocked on partner spec |
+
+Launch blockers: contract (auto.de GmbH), clickout permission, spec, legal / data QA, feed + image tests.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bytebrand/export-cars",
-  "version": "1.26.44",
+  "version": "1.26.46",
   "description": "",
   "author": "bytebrand",
   "license": "UNLICENSED",
@@ -11,7 +11,7 @@
     "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
     "lint": "eslint -c .eslintrc.js --ext .ts src/",
     "start:dev": "nest start --watch",
-    "test": "ts-node --transpile-only test/google-feed-envkv.test.ts && ts-node --transpile-only test/google-feed-item-row.test.ts && ts-node --transpile-only test/publication-gate.test.ts && ts-node --transpile-only test/images-regression.test.ts && ts-node --transpile-only test/clean-images.test.ts && ts-node --transpile-only test/image-url-validator.test.ts && ts-node --transpile-only test/openai-image-fields.test.ts && ts-node --transpile-only test/openai-ads-mapping.test.ts && ts-node --transpile-only test/openai-ads-feed-run.test.ts && ts-node --transpile-only test/openai-ads-finance.test.ts && ts-node --transpile-only test/openai-ads-price-cap.test.ts && ts-node --transpile-only test/meinstadt-mapping.test.ts && ts-node --transpile-only test/meinstadt-feed-run.test.ts && ts-node --transpile-only test/autouncle-mapping.test.ts && ts-node --transpile-only test/autouncle-feed-run.test.ts && ts-node --transpile-only test/criteo-images.test.ts && ts-node --transpile-only test/criteo-mapping.test.ts && ts-node --transpile-only test/criteo-feed-run.test.ts"
+    "test": "ts-node --transpile-only test/google-feed-envkv.test.ts && ts-node --transpile-only test/google-feed-item-row.test.ts && ts-node --transpile-only test/publication-gate.test.ts && ts-node --transpile-only test/images-regression.test.ts && ts-node --transpile-only test/clean-images.test.ts && ts-node --transpile-only test/image-url-validator.test.ts && ts-node --transpile-only test/openai-image-fields.test.ts && ts-node --transpile-only test/openai-ads-mapping.test.ts && ts-node --transpile-only test/openai-ads-feed-run.test.ts && ts-node --transpile-only test/openai-ads-finance.test.ts && ts-node --transpile-only test/openai-ads-price-cap.test.ts && ts-node --transpile-only test/meinstadt-mapping.test.ts && ts-node --transpile-only test/meinstadt-feed-run.test.ts && ts-node --transpile-only test/autouncle-mapping.test.ts && ts-node --transpile-only test/autouncle-feed-run.test.ts && ts-node --transpile-only test/marktde-mapping.test.ts && ts-node --transpile-only test/marktde-feed-run.test.ts && ts-node --transpile-only test/criteo-images.test.ts && ts-node --transpile-only test/criteo-mapping.test.ts && ts-node --transpile-only test/criteo-feed-run.test.ts"
   },
   "dependencies": {
     "@bytebrand/autode-request": "^1.19.2",

package/src/configs/marktde.config.ts

@@ -1,15 +1,67 @@
-import { ExportType, FileType, ImageType } from 'src/enums';
+import { toNumber } from 'lodash';
+
+import { ExportType, FileType, ImageType } from '../enums';
 import { Params } from '../interfaces/params.interface';
+import { FeedGuardOptions } from '../services/feed-guard';
 import { Config } from './config';
 
+const text = (value: unknown): string => (typeof value === 'string' ? value.trim() : '');
+
+const positiveNumber = (value: unknown, fallback: number): number => {
+  const parsed = toNumber(text(value));
+  return text(value) && Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+};
+
+// Guard defaults (same as AutoUncle). The DEV job exports one dealer via the Cronicle rules, so the
+// published count is far below the base snapshot: minPublishedItems only forbids an empty file.
+export const MARKTDE_DEFAULTS = {
+  imageConcurrency: 16,
+  minSourceItems: 1000,
+  minPublishedItems: 1,
+  maxDropPercent: 20,
+  maxSourceAgeHours: 26,
+  maxStaleHours: 48,
+};
+
+/**
+ * markt.de vehicle feed (ADV-328): the legacy mobile.de-style CSV (mapping sheet `mobile_yescar`,
+ * ACF-4370) plus a ZIP of it, with clean ADV-336 images. There is no current markt.de spec yet, so
+ * the format (columns, file names, no header row, `;` separator, UTF-8) stays as it was.
+ * Dry-run is the default: the files go to resources/marktde-dryrun, which no Cronicle step reads.
+ * Only marktdeDryRun=false writes resources/marktde-export (the directory `9c.1 … part 2` uploads
+ * from). Each mode has its own guard state.
+ */
 export class MarktdeConfig extends Config {
+  dryRun: boolean;
+  imageConcurrency: number;
+  // 0 = no limit (no partner limit known)
+  maxImages: number;
+  stateDir: string;
+  feedGuard: FeedGuardOptions;
+
   constructor(params: Params) {
     super(params);
     this.campaign = ExportType.MARKTDE;
-    this.pathesConfig.localConvertedDirectory = `resources/${ExportType.MARKTDE}-export`;
+    this.dryRun = text(params.marktdeDryRun).toLowerCase() !== 'false';
+    const mode = this.dryRun ? 'dryrun' : 'export';
+    this.pathesConfig.localConvertedDirectory = `resources/${ExportType.MARKTDE}-${mode}`;
+    this.stateDir = `resources/${ExportType.MARKTDE}-state/${mode}`;
     this.imageUrl = `https://images.${this.domain}/carimage`;
     this.mappingSpreadsheetTitle = 'mobile_yescar';
+    // MobileTransformer still builds its legacy `image` column; marktde.transformer replaces it with
+    // the validated clean list.
     this.imageType = ImageType.default;
+    this.imageConcurrency = positiveNumber(params.marktdeImageConcurrency, MARKTDE_DEFAULTS.imageConcurrency);
+    this.maxImages = Math.floor(positiveNumber(params.marktdeMaxImages, 0));
+    this.feedGuard = {
+      stateDir: this.stateDir,
+      minSourceItems: positiveNumber(params.feedGuardMinSourceItems, MARKTDE_DEFAULTS.minSourceItems),
+      minPublishedItems: positiveNumber(params.feedGuardMinPublishedItems, MARKTDE_DEFAULTS.minPublishedItems),
+      maxDropPercent: positiveNumber(params.feedGuardMaxDropPercent, MARKTDE_DEFAULTS.maxDropPercent),
+      maxSourceAgeHours: positiveNumber(params.feedGuardMaxSourceAgeHours, MARKTDE_DEFAULTS.maxSourceAgeHours),
+      maxStaleHours: positiveNumber(params.feedGuardMaxStaleHours, MARKTDE_DEFAULTS.maxStaleHours),
+      acceptDrop: text(params.feedGuardAcceptDrop).toLowerCase() === 'true',
+    };
     this.outputFiles = [
       `${this.pathesConfig.localConvertedDirectory}/api_export_cars_${ExportType.MARKTDE}.${FileType.CSV}`,
       `${this.pathesConfig.localConvertedDirectory}/api_export_cars_${ExportType.MARKTDE}.${FileType.ZIP}`,

package/src/constants/fb.constants.ts

@@ -1,34 +1,34 @@
-export const FB_MAX_TRIM_LENGTH = 50;
-export const FB_MAX_IMAGE_COUNT_FOR_DEAFULT = 47;
-export const FB_MIN_MILEAGES = 900;
-export const DEFAULT_ZIP = '06796';
-export const DEFAULT_CITY = 'Sandersdorf-Brehna';
-export const DEFAULT_ADDR1 = 'Max-Planck-Str. 19';
-export const TIMESTAMP_FIRST_YEAR = 1970;
-export const META_PUSH_PRIORITY_STANDARD = 'standard';
-export const META_PUSH_PRIORITY_ALLOWED_VALUES = ['dealer_priority_1', 'dealer_priority_2'];
-
-// MarketingImageExportConfig channel code for the Meta AIA overlay images (image-generator's
-// MetaAiaImagesService.CHANNEL_CODE) — distinct from this feed's now-disabled legacy "fb" config.
-export const META_AIA_CHANNEL_CODE = 'meta_aia';
-// Only the financing variant exists so far; leasing/other modes will be added once image-generator
-// renders them too (see MetaAiaImagesService's MetaAiaMode).
-export const META_AIA_MODE_FINANCING = 'financing';
-
-// Values must match Meta's Automotive Model Ads offer_type enum exactly (lease/finance/cash) —
-// the old 'financing'/'leasing'/'buy' values are not recognized by the AMA Vehicle Offers Feed.
-export enum OfferType {
-  financing = 'finance',
-  leasing = 'lease',
-  buy = 'cash',
-}
-
-export const AMOUNT_QUALIFIER_APR = 'APR';
-export const TERM_QUALIFIER_MONTHS = 'months';
-
-export const OFFER_DISCLAIMER = 'Für Ihre Finanzierungswünsche stellen wir eine Bonitätsanfrage. Bonität ' +
-  'vorausgesetzt, ist dies ein repräsentatives Berechnungsbeispiel gem. der Angaben, welches 2/3 aller Kunden, ' +
-  'im Sinne des § 17a Abs. 4 PAngV, erhalten. Dieses freibleibende Angebot der Santander Consumer Bank AG, ' +
-  'Santander-Platz 1, 41061 Mönchengladbach wird vermittelt durch die auto.de GmbH, Max-Planck-Str. 19, 06796 ' +
-  'Sandersdorf-Brehna, die als ungebundener Vermittler nicht beratend tätig ist. Irrtümer vorbehalten. Preise ' +
-  'ggf. inkl. MwSt.';
+export const FB_MAX_TRIM_LENGTH = 50;
+export const FB_MAX_IMAGE_COUNT_FOR_DEAFULT = 47;
+export const FB_MIN_MILEAGES = 900;
+export const DEFAULT_ZIP = '06796';
+export const DEFAULT_CITY = 'Sandersdorf-Brehna';
+export const DEFAULT_ADDR1 = 'Max-Planck-Str. 19';
+export const TIMESTAMP_FIRST_YEAR = 1970;
+export const META_PUSH_PRIORITY_STANDARD = 'standard';
+export const META_PUSH_PRIORITY_ALLOWED_VALUES = ['dealer_priority_1', 'dealer_priority_2'];
+
+// MarketingImageExportConfig channel code for the Meta AIA overlay images (image-generator's
+// MetaAiaImagesService.CHANNEL_CODE) — distinct from this feed's now-disabled legacy "fb" config.
+export const META_AIA_CHANNEL_CODE = 'meta_aia';
+// Only the financing variant exists so far; leasing/other modes will be added once image-generator
+// renders them too (see MetaAiaImagesService's MetaAiaMode).
+export const META_AIA_MODE_FINANCING = 'financing';
+
+// Values must match Meta's Automotive Model Ads offer_type enum exactly (lease/finance/cash) —
+// the old 'financing'/'leasing'/'buy' values are not recognized by the AMA Vehicle Offers Feed.
+export enum OfferType {
+  financing = 'finance',
+  leasing = 'lease',
+  buy = 'cash',
+}
+
+export const AMOUNT_QUALIFIER_APR = 'APR';
+export const TERM_QUALIFIER_MONTHS = 'months';
+
+export const OFFER_DISCLAIMER = 'Für Ihre Finanzierungswünsche stellen wir eine Bonitätsanfrage. Bonität ' +
+  'vorausgesetzt, ist dies ein repräsentatives Berechnungsbeispiel gem. der Angaben, welches 2/3 aller Kunden, ' +
+  'im Sinne des § 17a Abs. 4 PAngV, erhalten. Dieses freibleibende Angebot der Openbank Deutschland AG, ' +
+  'Santander-Platz 1, 41061 Mönchengladbach wird vermittelt durch die auto.de GmbH, Max-Planck-Str. 19, 06796 ' +
+  'Sandersdorf-Brehna, die als ungebundener Vermittler nicht beratend tätig ist. Irrtümer vorbehalten. Preise ' +
+  'ggf. inkl. MwSt.';

package/src/export.schema.ts

@@ -32,6 +32,7 @@ import {
   ByOwnerExporter,
   FbExporter,
   GoogleExporter,
+  MarktdeExporter,
   MeinstadtExporter,
   MobileExporter,
   OoyyoExporter,
@@ -56,7 +57,7 @@ export const exportSchema = {
   },
   [ExportType.MARKTDE]: {
     config: MarktdeConfig,
-    exporter: MobileExporter,
+    exporter: MarktdeExporter,
   },
   [ExportType.GOOGLE]: {
     config: GoogleConfig,

package/src/exporters/index.ts

@@ -5,6 +5,7 @@ export * from './by-owner.exporter';
 export * from './criteo.exporter';
 export * from './fb.exporter';
 export * from './google.exporter';
+export * from './marktde.exporter';
 export * from './meinstadt.exporter';
 export * from './mobile.exporter';
 export * from './modix.exporter';

package/src/exporters/marktde.exporter.ts

@@ -0,0 +1,78 @@
+import { Injectable } from '@nestjs/common';
+import { ModuleRef } from '@nestjs/core';
+
+import { FsChunkInterface } from '@bytebrand/chunkable';
+import { LoggerService } from '@bytebrand/cronicle-helper';
+
+import { CarService, RulesService, LoaderService, ConfigService, ImagesService } from '../services';
+import { ImageUrlValidator } from '../services/image-url-validator.service';
+import { FeedGuard } from '../services/feed-guard';
+import { MarktdeFeedRun, MarktdeSourceCar } from '../services/marktde-feed-run';
+import { zipSingleFile } from '../services/meinstadt-feed-run';
+import { MobileTransformer } from '../transformers/mobile.transformer';
+import { toMarktdeImages } from '../transformers/marktde.transformer';
+import { resolveOpenAiImageFields } from '../transformers/openai-image-fields';
+import { MarktdeConfig } from '../configs/marktde.config';
+import { Exporter } from '../interfaces/exporter.interface';
+
+/**
+ * ExportType.MARKTDE (ADV-328). Was the shared MobileExporter; now wires the Cronicle/Nest services
+ * into MarktdeFeedRun, which holds the logic. The row itself still comes from MobileTransformer (same
+ * mapping sheet, same columns); only the markt.de columns are replaced. EAUTO / YESCAR / EVIUM keep
+ * the MobileExporter unchanged.
+ */
+@Injectable()
+export class MarktdeExporter implements Exporter {
+  constructor(
+    private carService: CarService,
+    private configService: ConfigService,
+    private rulesService: RulesService,
+    private loaderService: LoaderService,
+    private imagesService: ImagesService,
+    private moduleRef: ModuleRef,
+  ) {}
+
+  async export(): Promise<void> {
+    const config = this.configService.config as MarktdeConfig;
+    const [csvFile, zipFile] = config.outputFiles;
+    const validator = new ImageUrlValidator({ concurrency: config.imageConcurrency });
+    const transformer = await this.moduleRef.create(MobileTransformer);
+
+    const run = new MarktdeFeedRun(
+      {
+        forEachChunk: fn => this.loaderService.process((chunk: FsChunkInterface) => fn(chunk.data as MarktdeSourceCar[])),
+        filterCar: source => this.carService.filterCar(source, this.rulesService.rules),
+        resolveImages: async ({ car, images }) => toMarktdeImages(
+          await resolveOpenAiImageFields(this.imagesService.getCleanImages(car._id, images), validator),
+          config.maxImages,
+        ),
+        legacyRow: async ({ car, images }) => (await transformer.transform(car, images)) as Record<string, unknown>,
+        imageStats: () => validator.stats,
+        zip: zipSingleFile,
+        guard: new FeedGuard(config.feedGuard),
+      },
+      {
+        runId: config.runId,
+        dryRun: config.dryRun,
+        domain: config.domain,
+        sourceDirectory: config.pathesConfig.localDirectory,
+        sourceBaseFileName: config.pathesConfig.baseFileName,
+        csvFile,
+        zipFile,
+        stateDir: config.stateDir,
+      },
+    );
+
+    try {
+      const report = await run.run();
+      if (report.stale) {
+        console.log(`marktde feed STALE: last good file ${report.lastGoodAgeHours?.toFixed(1)} h old`);
+      }
+    } catch (error) {
+      // main.ts would report a rejected run as {"complete":1,"code":0}; fail the job so the chained
+      // upload step does not run (report + lock already handled by the run).
+      LoggerService.exitError(`marktde feed not published: ${error?.message ?? error}`);
+      process.exit(1);
+    }
+  }
+}

package/src/interfaces/params.interface.ts

@@ -48,6 +48,11 @@ export interface Params {
   autouncleDryRun?: string;
   autouncleImageConcurrency?: string;
   autouncleMaxImages?: string;
+  // markt.de feed only (ADV-328), Cronicle text params; see configs/marktde.config.ts.
+  // Live output needs marktdeDryRun=false explicitly.
+  marktdeDryRun?: string;
+  marktdeImageConcurrency?: string;
+  marktdeMaxImages?: string;
 }
 
 // Parsed from feedItemsBq* by GoogleConfig.