# Changelog of Audi Catalog & Price Tracker (`rastriq/audi-catalog-scraper`) Actor

- **URL**: https://apify.com/rastriq/audi-catalog-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/rastriq/audi-catalog-scraper.md

## Changelog — audi-catalog-scraper

### 0.1 (2026-11-11, build 0.1.27) — potencia, cambio y tracción en todos los mercados

#### El fallo

`parse_power` solo entendía el formato español `110(150) kW(CV)`. En el run completo del build
0.1.25 (4 473 items), `power_kw` venía relleno en **225 registros, todos de España**; las otras 31
variantes de mercado daban 0. `transmission` no reconocía el manual fuera de España
(`Schaltgetriebe`, `6 vitesses`, `6-marce`…), y `drivetrain` ponía `FWD` a todo lo que no dijera
`quattro`: los RS3/S5/SQ5 (quattro de serie) y los e-tron de propulsión trasera (Q4, Q6, A6 e-tron).

#### El arreglo

- **Potencia del nombre en todos los formatos:** `150 kW`, `160 ch`, `150 PS`, `(170 PS)`,
  `272 hp`, `110(150) kW(CV)`.
- **`technicalData` de omnigraph como respaldo** cuando el nombre no trae potencia
  (`engine.power.maxPowerKW`, numérico) y para el cambio (`gearbox.formattedValue`, texto
  localizado que se normaliza). La introspección está desactivada: los campos se encontraron
  probando nombres, ver comentario en `main.py`.
- **El nombre gana a `technicalData`:** en los híbridos enchufables `maxPowerKW` es a veces solo el
  motor térmico (A6 e-hybrid: 185 kW frente a los 220 kW / 299 PS de sistema del nombre). En 955
  modelos con ambas fuentes, coinciden en 922; las 33 discrepancias son todas de este tipo. Lo
  mismo con el cambio: en Luxemburgo `30 TFSI 6 vitesses` trae `gearbox` "S tronic à 7 rapports".
  El `gearbox` solo completa el número de marchas cuando el nombre dice manual sin número
  (`Schaltgetriebe`).
- Potencia de `technicalData` por debajo de 50 kW se descarta: Finlandia publica el RS3 con
  `maxPowerKW` 29 (y `gearbox` "quattro-neliveto").
- `power_hp`: el CV/PS impreso en el nombre si lo hay; si no, kW × 1,35962.
- Campo nuevo **`power_source`** (`model_name` | `technical_data` | null). Aditivo.
- Número de marchas tomado junto a la palabra de marcha: antes `TDI 85 kW 6 biegów` daba
  `85-speed manual`.
- `drivetrain`: quattro también por carline (`rs*`, `sq*`, `s<n>*`, e-tron GT). Para BEV sin
  quattro pasa de `FWD` (falso) a `null`: la API no tiene campo de tracción.
- **`technicalData` nunca cuesta los precios:** si un modelo falla en `technicalData`, GraphQL anula
  el árbol entero (Bélgica y Omán siempre; Finlandia, Luxemburgo y Sudáfrica a ratos). El mercado
  se repite sin `technicalData` y conserva precios y potencia del nombre.
- **Reintentos con backoff** (3 intentos, 2 s / 4 s) ante 429/5xx y errores de red. Antes un 504
  suelto perdía el mercado entero; vimos uno al medir.

#### Medido (run completo `{}`, mismo día, residencial)

| | `latest` 0.1.25 | `beta` 0.1.27 |
|---|---|---|
| items / con precio | 4 473 / 3 966 | 4 473 / 3 966 |
| `power_kw` | 225, 1 mercado | 3 497, 32 mercados (70–680 kW, PS/kW sin outliers) |
| `transmission` | 3 012 | 3 245 (`6-speed manual` 15 → 239) |
| `drivetrain` | FWD 2 728 / quattro 1 745 | FWD 1 505 / quattro 2 315 / null 653 (BEV) |
| duración | 22 s | 39 s |

`power_kw` varía unos cientos entre runs según qué mercados caen al respaldo sin `technicalData`
(en este, Bélgica, Omán, Suiza-IT y Kuwait).

Los nulos que quedan son modelos sin potencia publicada (S/RS, parte de los e-tron).

Coste: la consulta con `technicalData` tarda 1–2,5 s por mercado frente a 0,5 s.

Tests: `make test-audi` (16), con `tests/fixtures/technical_data_samples.json` sacado de respuestas
reales.

### 0.1 (2026-11-11) — un run con `{}` ya no se rechaza

Apify marcó el actor "Under maintenance" tras tres días de fallos en su test automático
("we couldn't start the Actor").

**Causa:** `proxyConfiguration` era `required` con `prefill` y sin `default`. El `prefill` solo
rellena el formulario de la consola; un run por API con `{}` no lo recibe, así que la validación
devolvía `invalid-input: Field input.proxyConfiguration is required` y el contenedor no arrancaba.
Reproducido el 2026-11-11 contra el build 0.1.23.

**Arreglo:**

- `proxyConfiguration` lleva `default` = RESIDENTIAL (igual que el `prefill`) y deja de ser
  `required`. El código ya caía a Apify Proxy si el campo falta.
- La descripción del esquema prometía "10 resultados de España"; el prefill es A3 en Alemania
  (unos 50 resultados). Texto corregido.

**Medido (build 0.1.23, proxy RESIDENTIAL):** el prefill (A3, `de`) da 48 items en 6 s; un run sin
filtros, 4 473 items en 32 variantes de mercado en 23 s. Ambos quedan muy por debajo del límite de
5 min del test.

Tests: `make test-audi`.
