Cómo se construye cada calculadora, de qué fuente sale cada número y dónde están sus márgenes de error.

Cuatro filtros antes de publicar una calculadora

Cada calculadora del sitio pasa por cuatro filtros antes de aparecer publicada. Ninguno es opcional, y si alguno falla la herramienta no se sube al servidor. Lo que sigue es el orden exacto en el que se aplican.

1 · Localizar la fuente normativa primaria

Para una tarifa eléctrica, eso significa identificar el Real Decreto, la Orden Ministerial o la Circular de la CNMC que define la fórmula. Para los precios PVPC, el feed oficial de OMIE servido por la API pública apidatos.ree.es de Red Eléctrica de España. Para las ayudas autonómicas, la convocatoria publicada en el boletín correspondiente: Boletín Oficial de la Junta de Andalucía, Diario Oficial de la Generalitat de Catalunya, Diari Oficial de la Generalitat Valenciana y resto de boletines de cada comunidad autónoma. No vale citar una nota de prensa ni un titular de medios generalistas: hay que llegar al documento original publicado por el organismo que lo produce.

2 · Validar con zod los JSON de datos

El comando npm run prebuild aborta el build si cualquier fichero bajo src/data/**/*.json no cumple su esquema. Esto incluye comprobar columnas tipadas, presencia obligatoria de los campos source, sourceUrl y lastUpdated, formato canónico de fechas y, en los datasets por comunidad autónoma, que el listado contiene las diecinueve entradas esperadas (las diecisiete comunidades más Ceuta y Melilla). Una calculadora cuyo dataset base no pase el esquema no llega a producción.

3 · Contrastar contra una factura real

Reproducimos un caso conocido —una factura emitida por la comercializadora con consumo y potencia documentados— y comparamos el resultado de la calculadora con el importe finalmente cobrado. La desviación máxima aceptable es de un uno por ciento en tarifa eléctrica y de un diez a un quince por ciento en autoconsumo solar, margen este último que asume la variabilidad inevitable que introducen la orientación del tejado, las sombras del entorno y la suciedad acumulada durante el año.

4 · Publicar con declaración explícita de precisión

Cada calculadora indica de forma visible si su resultado es un cálculo exacto o una estimación orientativa, con la razón concreta detrás. La tabla que aparece más abajo en esta misma página resume las seis herramientas activas con su grado de precisión real y los motivos de la desviación esperada cuando la hay.

Cadencia de actualización

La frecuencia con la que se refrescan los datos depende de qué tipo de dato sea. Los precios PVPC horarios se renuevan cuatro veces al día (04:15, 10:15, 16:15 y 22:15 UTC) mediante un GitHub Action que llama al script update-pvpc.mjs y verifica que la respuesta sea válida antes de sobrescribir el dataset publicado; si el script falla o devuelve datos con más de dos horas de antigüedad, llega un correo automático al editor para revisar manualmente. Los peajes y cargos publicados por la CNMC, los umbrales del IPREM aplicables al bono social, las convocatorias autonómicas del Plan MOVES III y las instrucciones técnicas complementarias del Reglamento Electrotécnico de Baja Tensión se revisan trimestralmente, o cada vez que el Boletín Oficial del Estado publica una norma nueva del sector. El precio de los combustibles publicado por el Ministerio para la Transición Ecológica y los índices de las comparativas de wallbox, baterías o instaladores se actualizan al menos una vez al año, o cuando un cambio relevante en el mercado lo justifica. Cuando se detecta un error en producción, el parche se aplica en un máximo de 48 horas y queda un aviso visible en la página afectada durante los treinta días siguientes.

Fuentes oficiales que alimentan el sitio

Todas las cifras visibles en el sitio derivan de fuentes oficiales públicas. El catálogo completo de normas BOE citadas, con identificador exacto, vive en /fuentes/. Aquí va el resumen ejecutivo de quién publica qué y por qué se cita en este sitio.

• OMIE (operador del mercado ibérico) — precios horarios mayoristas servidos vía apidatos.ree.es.
• CNMC — peajes de transporte y distribución (Circular 3/2020) y comparador oficial de comercializadoras.
• Red Eléctrica de España (apidatos.ree.es) — feed PVPC y demanda peninsular.
• IDAE — Plan MOVES III, ayudas al autoconsumo y certificados energéticos.
• MITECO — bono social eléctrico (RD 897/2017), bono social térmico y precios oficiales de combustibles.
• BOE — toda la normativa estatal del sector eléctrico, desde la Ley 24/2013 del Sector Eléctrico hasta los recientes RD-Ley 7/2025 y RD 88/2026.
• Boletines autonómicos — convocatorias del Plan MOVES III por comunidad autónoma y bonificaciones del IBI o del ICIO en cada municipio.
• PVGIS (Joint Research Centre, Comisión Europea) — irradiación solar para el dimensionado fotovoltaico.

Arquitectura técnica

El sitio es estático. Lo construye Astro 5 con calculadoras interactivas escritas en Svelte 5 (runes) y estilado con Tailwind 4. La lógica de cálculo vive en archivos TypeScript puros bajo src/lib/calculators/*.ts, sin dependencias externas y sin servidor: el navegador del usuario ejecuta directamente la fórmula descrita en el código fuente. Este diseño tiene cuatro consecuencias prácticas que merece la pena explicitar.

Primero, auditabilidad: cualquier desarrollador con un editor de texto puede leer la fórmula que se está aplicando a sus datos antes de aceptarla. Segundo, privacidad: cero datos introducidos por el usuario salen del navegador, no hay registro de los inputs, ni analítica intrusiva sobre los formularios, ni fingerprinting de ningún tipo. Tercero, rendimiento: Lighthouse Performance supera 95 puntos en las páginas principales porque Astro hidrata únicamente las islas Svelte que necesitan interactividad, dejando el resto como HTML estático. Y cuarto, validación previa: la dependencia zod bloquea el build si los JSON de datos pierden integridad, así que un fichero corrupto nunca llega a producción aunque se cuele accidentalmente al repositorio.

Precisión por calculadora

Tabla pública del grado de precisión real frente a fuentes oficiales o facturas reales, verificada con casos de prueba documentados.

Reglas autoimpuestas sobre independencia editorial

Cuatro reglas autoimpuestas gobiernan la relación entre el contenido del sitio y los intereses comerciales que podrían condicionarlo. La primera es la más simple: ninguna marca paga por aparecer en una comparativa. Las comercializadoras citadas —Endesa, Iberdrola, Naturgy, Repsol, Holaluz, Octopus Energy y demás— están en el ranking porque sus precios públicos así lo justifican, no porque hayan negociado nada con la redacción. La segunda regla es transparencia sobre la afiliación: si en el futuro se activan acuerdos comerciales con instaladores fotovoltaicos, fabricantes de wallbox o comercializadoras eléctricas, los enlaces correspondientes llevarán el atributo rel="sponsored" y aparecerán declarados en la página de transparencia con la fecha de alta del acuerdo; a fecha de mayo de 2026 no hay ningún partner activo. La tercera regla afecta a la publicidad display: el script de Google AdSense solo se carga después de que el usuario acepte cookies de publicidad en el banner de consentimiento; sin aceptación, el dominio pagead2.googlesyndication.com no llega a contactarse.

La cuarta regla, importante hoy más que nunca, atañe al uso de inteligencia artificial. Las cifras y las normativas no se generan con modelos de lenguaje. Los textos editoriales —prosa, transiciones, redacción de ejemplos, primer borrador de algunas guías— pueden tener apoyo de modelos como Claude o ChatGPT, pero todo cálculo numérico, toda cuantía del Plan MOVES III, todo umbral del IPREM y toda cita a una norma proviene de una fuente oficial citada y revisada por el editor antes de publicar. El detalle exhaustivo del uso de IA, con la lista explícita de dónde se aplica y dónde no, está documentado en /disclosures/.