# Notas sobre la biblioteca seed — Sprint 0

> Todos los archivos de `vmssailor/library/vessels/` y `vmssailor/library/equipment/` están marcados con `data_source: "seed_estimate"`. Antes de Sprint 1, **Álvaro debe revisar y validar contra datasheets oficiales**.

## Filosofía

Para no bloquear el Sprint 0 esperando datasheets de fabricantes, todas las entradas de biblioteca seed traen:

- Valores plausibles tomados de información pública (catálogos de fabricantes, especificaciones técnicas accesibles)
- `data_source: "seed_estimate"` como bandera explícita
- Estructura completa de campos para no requerir migraciones tras validación

El validador `vms-validate-library` emite **INFO** (no error, no warning) por cada entrada `seed_estimate` para que el integrador sepa exactamente qué revisar.

## Entradas a validar

### Vessels

| ID | Modelo | Campos críticos a verificar |
|---|---|---|
| `sunseeker_76` | Sunseeker 76 Yacht | LOA, beam, draft, displacement, bulkhead positions, deck heights |
| `ferretti_850` | Ferretti 850 | Idem |

Específicamente, las **posiciones de mamparos** (`bulkheads[].x_pp`) y las **alturas de cubierta** (`decks[].z_bl_bottom`, `z_bl_top`) son **estimaciones** — el integrador real medirá esto en el GA del buque.

### Equipment models

| ID | Modelo | Campos a verificar |
|---|---|---|
| `mtu_12v_2000_m96` | MTU 12V 2000 M96 | power_kw, rpm_nominal, weight_kg, dimensions, fuel_consumption_lph, **sensores específicos** y sus rangos / alarmas |
| `volvo_d13_900hp` | Volvo Penta D13-900 | Idem |
| `northern_lights_m65c13` | Northern Lights M65C13 | power_kw, voltaje nominal (¿230V o 120/240V split?), corriente, rpm, **sensores y rangos** |

### Sensores típicos (`default_sensors`)

Para cada `EquipmentModel`, los sensores listados con sus rangos normales y umbrales de alarma son **plantillas** sugeridas. Cada buque real puede tener:

- Sensores adicionales no contemplados (RTDs específicos, sondas en lugares no estándar)
- Sensores omitidos por costo
- Umbrales ajustados según armador / sociedad de clasificación

En Sprint 1 (Studio wizard paso 6) el integrador refina los sensores reales para cada equipo concreto.

### Reglas heurísticas

`rules/yacht_motor_planeo.yaml` contiene la heurística inicial de Álvaro. Es esperable que la afine con experiencia de campo. La rule_engine de Sprint 2 las consume.

## Cómo validar al despertar

1. Ejecutar `uv run vms-validate-library --verbose` para ver la lista de INFOs
2. Para cada modelo, abrir su JSON y comparar contra el datasheet oficial:
   - Ajustar valores
   - Cambiar `data_source` a `"manufacturer_datasheet"` cuando esté verificado
3. Correr `uv run pytest tests/library/` para que sigan los tests verdes
4. Si cambia algún rango o umbral de alarma, actualizar también las reglas heurísticas si afectan