# Compatibilidad de recambios, códigos de error y mantenimiento de robots aspiradores Roborock

Datos abiertos de [compatipieza.com](https://compatipieza.com): qué recambios
oficiales encajan en qué modelos de Roborock, qué significa cada código de
error y cada cuánto limpiar y cambiar cada pieza según el manual oficial de
cada modelo. Cada fila enlaza el documento oficial del que sale.

*English summary: replacement-part compatibility, error codes and maintenance
intervals for Roborock robot vacuums, each row traced to an official Roborock
document. CC BY 4.0.*

## Ficheros

| Fichero | Contenido |
|---|---|
| `compatibilidad.csv` | Una fila por pareja modelo–recambio |
| `codigos-error.csv` | Una fila por código de error y modelo |
| `mantenimiento.csv` | Una fila por pieza y modelo: limpieza y cambio |
| `compatipieza-dataset.json` | Lo mismo en un único JSON, con la fecha de los datos |

## Campos de `compatibilidad.csv`

| Campo | Significado |
|---|---|
| `device_slug`, `device_name` | Modelo exacto del robot |
| `component_slug`, `component_name` | Recambio; el nombre es el oficial del fabricante, en inglés |
| `component_type` | Tipo de pieza (`filter`, `main-brush`, `mop-cloth`…) |
| `manufacturer_skus` | Referencias del fabricante, separadas por `;` |
| `result` | `compatible` o `incompatible` |
| `verification` | `verified`: la ficha oficial nombra el modelo exacto en el título y en la descripción. `probable`: solo en uno de los dos |
| `source_urls` | Documentos oficiales que respaldan la fila, separados por `;` |
| `last_checked` | Última vez que se comprobó la fuente |

## Campos de `codigos-error.csv`

| Campo | Significado |
|---|---|
| `device_slug`, `device_name` | Modelo exacto. El mismo número puede significar cosas distintas en modelos distintos |
| `code` | Número del error |
| `message` | Texto literal del manual oficial, en inglés |
| `source_url`, `locator` | Manual en PDF y página |

## Campos de `mantenimiento.csv`

| Campo | Significado |
|---|---|
| `device_slug`, `device_name` | Modelo exacto |
| `part_label` | Pieza tal como la nombra el manual, en inglés |
| `component_type` | Tipo de recambio del catálogo (`main-brush`, `filter`…), vacío si la pieza no es un recambio que catalogamos (sensores, ruedas…) |
| `clean_frequency` | `after_each_use`, `weekly`, `every_2_weeks`, `monthly`, `as_needed` o vacío |
| `replace_months_min`, `replace_months_max` | Intervalo de cambio en meses, si el manual lo da |
| `replace_condition` | `as_needed` o `when_full` cuando el manual da una condición en vez de meses |
| `source_text` | Frase literal del manual, o la fila de su tabla tal como está impresa |
| `source_url`, `locator` | Manual en PDF y página |

## Método y límites

- Solo fuentes oficiales de Roborock (tienda y manuales). Las fichas de
  tiendas y marketplaces no cuentan como prueba.
- Modelo exacto, nunca «serie»: Q7 Max y Q7 Max+ son modelos distintos.
- La ausencia de un modelo no significa incompatibilidad.
- Todas las filas proceden de Roborock: no hay corroboración independiente.
- Una tabla de errores solo se incluye si el manual se lee completo y en orden.
- El mantenimiento de un modelo solo se incluye completo, y cada fila se ha
  revisado contra la página del PDF.

Detalle completo: <https://compatipieza.com/metodologia>

## Licencia y atribución

[CC BY 4.0](https://creativecommons.org/licenses/by/4.0/). Puedes reutilizar
los datos citando «compatipieza.com» con un enlace a
<https://compatipieza.com/datos>.

La licencia cubre la recopilación y su estructura. Los nombres de producto,
los mensajes de error y las frases de mantenimiento son textos de Roborock,
citados de sus documentos oficiales.

Errores o correcciones: info@marianohernando-ia.com