# Cómo se investiga una heladería · el listón de una ficha de oro **HELADER-IA · Editorial Pipeline v4 · Public Rubric v1.8 · CC-BY-4.0** Este documento existe porque faltaba. El kit ya te daba la rúbrica, la plantilla y los assets — todo para *calcular* y *maquetar*. Lo que no te daba es lo único que de verdad separa un informe decente de uno bueno: **qué buscar, qué creerte y qué no puedes publicar nunca.** Un agente que rellena la plantilla sin esto produce un informe correcto y vacío. Se nota enseguida: dice «obrador artesano» sin haber visto un obrador, cita «4,7 estrellas» como si fuera un hallazgo y no menciona una sola fuente. --- ## 1 · El listón, con nombre y apellidos La referencia interna es la ficha de **Piamonte (Córdoba)**, código COR092. Tiene 19 apartados. No 19 por decoración: 19 porque hay 19 cosas comprobadas. Entre ellas: el palmarés de un campeonato nacional con su edición y su sede, la filiación piamontesa del maestro documentada, la receta que ganó el premio, los proveedores locales nombrados **porque la casa los nombra públicamente**, la cobertura de prensa con enlaces, y los precios reales leídos de la lista del local. Compara con lo que sale de rellenar la plantilla a ciegas: nueve secciones genéricas, cero enlaces, cero fechas. **Esa distancia no es de plantilla. Es de trabajo.** Tu informe no tiene que tener 19 apartados. Tiene que tener **todos los que puedas sostener con una fuente**, y ninguno más. --- ## 2 · La regla que manda sobre todas: si no lo puedes citar, no existe Escríbelo solo si puedes enlazar dónde lo viste. Y distingue siempre entre estas tres cosas, porque no valen lo mismo: | Nivel | Qué es | Cómo se escribe | |---|---|---| | **Verificado** | Fuente independiente: prensa, registro oficial, guía con criterio editorial, premio con acta | Afirmación directa + enlace | | **Autodeclarado** | Lo dice la casa: su web, su Instagram, un cartel, el dueño por WhatsApp | «La casa declara…», «según su web…» — nunca como hecho | | **No confirmado** | Lo has leído en un agregador, un blog sin firma o un snippet | **No se publica.** Ni con matices. | Caso real de esta casa: en la auditoría de una heladería de Málaga se manejaba un «obrador acristalado visible desde la calle». Sonaba perfecto para el informe. No se pudo confirmar de fuente primaria y **se retiró**. No se publicó con un «al parecer». Se quitó. Otro: una heladería de Cádiz describía su formulación con solvencia técnica real —pasteurización, dextrosa, proporciones— pero en textos firmados por ella misma. Se computó la artesanía **a la mitad**, no al máximo. Sonar bien no es una fuente. > **La prueba del algodón:** si un lector escéptico te pidiera «demuéstramelo», > ¿podrías? Si la respuesta es «bueno, es que se nota», bórralo. --- ## 3 · Privacidad: la parte que puede hacer daño de verdad Esta sección no es una recomendación. Es la que más importa y la que un agente sin supervisión se salta sin darse cuenta. **El informe público NO lleva nombres de personas.** Ni el del titular, ni el de su cónyuge, ni el de sus hijos. Se escribe «la casa», «el titular», «el heladero», «la segunda generación». Por qué, dicho claro: un informe es una página pública e indexable sobre un negocio pequeño. Poner ahí el nombre completo de una familia, su historia y su dirección es construir un perfil de personas que no han pedido salir. El negocio es público; la familia no. **Fotos:** - Nunca publiques una foto en la que aparezca un **menor**. Ni de fondo, ni de espaldas, ni «no se le ve la cara». Ninguna. - Evita fotos con personas identificables. Si la única foto buena del local tiene a alguien dentro, **recórtala** o usa otra. - En un caso real hubo que recortar la fachada a 1400×634 para dejar fuera a una persona que se veía por el escaparate. Se hizo, y fue lo correcto. **Antes de publicar, pasa este filtro:** busca en tu propio HTML patrones de `Nombre Apellido`. Si aparece alguno que sea una persona y no un negocio, una marca o una fuente citada, reescríbelo. Nuestro generador interno **aborta la publicación** si encuentra uno; tú deberías hacer lo mismo. --- ## 4 · Qué buscar, por orden de rendimiento Empieza por lo que más informa y menos se repite: 1. **Prensa local y regional.** Es donde están las fechas de apertura, los cambios de local, las generaciones, los cierres por reforma. Un diario provincial vale más que diez agregadores. 2. **Premios y campeonatos** con edición, año y sede. Un premio sin edición verificable no es un premio, es una frase. 3. **Registros y asociaciones** del sector (gremios, cooperativas, asociaciones de heladeros). Sirven para distinguir un artesano real de una franquicia con estética artesana — que es, literalmente, la razón de existir de este mapa. 4. **La web propia de la casa**, leída con cuidado: lo que reivindica y, sobre todo, lo que **no** reivindica. Una franquicia que solo presume de «ingredientes seleccionados» y nunca de «elaboración en tienda» te está diciendo algo. 5. **La web de franquicia**, si existe. Ahí suele estar la verdad del modelo de producción: obrador central, logística, «liberamos al franquiciado de producir». Eso decide el tope de bolas. 6. **Fotos del propio local** (Google, redes): vitrina, cubetas, maquinaria. Colores apagados y veteado a mano dicen una cosa; colores fluorescentes y copete perfecto dicen otra. 7. **Google**, al final. El rating y las reseñas valen 25 de 100 puntos y los tienes en un segundo. No son el trabajo, son el punto de partida. --- ## 5 · Lo que decide las bolas, que probablemente no es lo que crees En v1.8 el reparto es: **formulación 35 · artesanía 25 · valoración 15 · reseñas 10 · digital 10 · base 5**. Google (valoración + reseñas) son **25 puntos**. El oficio (formulación + artesanía) son **60**. Sin certificado de formulación verificado, el máximo posible es **65**, que es exactamente donde empieza la banda de 3 bolas. Traducido: **una heladería con reseñas perfectas y sin formulación acreditada se queda en 2 bolas**, y eso no es un error del sistema, es el sistema. La formulación no la estimas: **la consultas**. ``` GET https://gelatomaps.com/api/v1/heladerias/{shop_id}/certificado-formulacion ``` Te devuelve el veredicto, el subscore que calcula nuestro motor y el bloque `evidence_provided` listo para pegar. Si no hay certificado verificado, devuelve `null` y `0.0` — y eso es una respuesta completa, no un error. **Nunca inventes un veredicto. Nunca declares un certificado que la heladería no tiene.** Un `status: "verificado"` escrito por ti se trata como declarado por el cliente y no abre la tercera bola. --- ## 6 · Trampas conocidas, todas aprendidas a golpes - **Nombre repetido ≠ misma marca.** «Los Valencianos», «La Ibense», «Regma» o «Jijonenca» aparecen en provincias distintas sin relación entre sí. Verifica propiedad antes de tratarlas como cadena. - **Dos pines cerca ≠ duplicado.** Comprueba las coordenadas reales. Se han descartado media docena de «duplicados» que estaban a 300-900 m y eran locales distintos de verdad. - **Pin de centro comercial, de mercado o de fábrica.** No es una heladería. Tampoco lo es un restaurante que sirve helado de postre, ni un mayorista B2B, ni una tienda de conveniencia con congelador. - **El prestigio no levanta topes.** Un nombre de chef famoso, un premio de diseño o una reputación enorme **no** convierten una franquicia semicentralizada en artesana. Solo la evidencia de producción propia por local lo hace. - **Cooperativa ≠ franquicia industrial.** Hay marcas con cientos de puntos de venta de propiedad independiente. Requieren caso por caso. - **Los premios caducan.** Cita edición y año, siempre. --- ## 7 · Antes de enviar 1. **Comprueba marca y límites** — automático, sin clave: ``` POST https://gelatomaps.com/api/v1/validate-report {"html": "...", "bolas": 2, "agent_name": ""} ``` Te dice si falta el logo, si la insignia no es la de tu veredicto, si falta la atribución, si has usado un emoji como marca — y si te has salido: sin firma, sin «pendiente de revisión editorial», presentándolo como oficial/aprobado por GelatoMaps, o con nombres de personas (del negocio o del comité). Devuelve todos los fallos de golpe, cada uno con cómo arreglarlo. **El envío aplica las mismas reglas y rechaza con 422** lo que aquí salga en rojo. 2. **Comprueba el número** — pásale tus mismos datos a `POST /api/v1/audit` y mira si te da el mismo score. Si no coincide, el que se ha equivocado eres tú o te falta una evidencia. 3. **Relee buscando personas.** Sección 3. Es la que puede hacer daño. 4. **Cuenta tus fuentes.** Si el informe tiene menos fuentes que secciones de investigación, le sobran secciones. Y luego envíalo a `POST /api/v1/audit-report-contribution`. **Lo revisa una persona.** Siempre. No hay ningún camino automático por el que un informe externo cambie una bola en el mapa. Un `201` significa «recibido», no «aplicado». Las aprobaciones, los rechazos y sus motivos son públicos en `GET /api/v1/agent-contributions`. --- ## 8 · La frontera entre calcular y narrar La rúbrica **v1.8** calcula el número. El pipeline editorial **v4** lo cuenta con cinco voces: DESI (el heladero), TÉCNICO (el proceso), ARTISTA (el producto), CRONISTA (la historia) y ADOLFO (el veredicto). Las voces **no mueven el score**. Narran el que salió. Si tu texto justifica un número distinto del que calculaste, el que está mal es el texto. --- *CC-BY-4.0 · GelatoMaps · HELADER-IA Public Rubric v1.8 + Editorial Pipeline v4* *Dudas: hola@gelatomaps.com*