feat(mirror): Gap Report /demo/gap

app/demo_gap.py

@@ -0,0 +1,87 @@
+"""Gap Report — the value-first proof artifact of the "Mirror" acquisition method.
+
+For a store we already crawled (a demo tenant), we ask the high-intent buyer
+questions every store gets and check whether the store's OWN public content
+actually answers them. Each MISS is a real lost-sale / support-ticket the
+merchant can see — and the bot (which DOES answer them) is the obvious fix.
+
+Honest by construction: the questions are universal real buyer questions (not
+fabricated), the HIT/MISS verdict comes from the store's own indexed pages via
+the same retrieval the bot uses, and we label MISS conservatively (a stricter
+threshold than the bot's answer floor) so we never wrongly tell a merchant their
+site fails to answer something it does. No invented figures.
+"""
+
+from __future__ import annotations
+
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from app.models import Tenant
+from app.rag import index as rag_index
+
+# A MISS must be a GENUINE gap, so we require the best match to be clearly below
+# the bot's answer floor (RAG_MIN_SCORE ~0.25). Conservative => credible.
+_GAP_THRESHOLD = 0.32
+
+# Universal, high-intent buyer questions — the ones that drive cart abandonment
+# and support tickets in EVERY store. Real questions, store-agnostic.
+GAP_QUESTIONS = {
+    "es": [
+        "¿Cuánto cuesta el envío y cuánto tarda en llegar?",
+        "¿Hacéis envíos a mi país / a Canarias?",
+        "¿Cuál es vuestra política de devoluciones y cuántos días tengo?",
+        "¿Cómo puedo seguir el estado de mi pedido?",
+        "¿Las tallas son fieles? ¿Tenéis guía de tallas?",
+        "¿De qué material están hechos los productos?",
+        "¿Este producto está disponible / cuándo vuelve a haber stock?",
+        "¿Qué métodos de pago aceptáis? ¿Puedo pagar a plazos?",
+        "¿Los productos tienen garantía?",
+        "¿Tenéis algún código de descuento o promoción?",
+        "¿Puedo cambiar o cancelar mi pedido después de comprarlo?",
+        "¿Cómo contacto con una persona del equipo?",
+    ],
+    "en": [
+        "How much is shipping and how long does delivery take?",
+        "Do you ship to my country?",
+        "What is your return policy and how many days do I have?",
+        "How can I track my order?",
+        "Do the sizes run true? Is there a size guide?",
+        "What are the products made of?",
+        "Is this item in stock / when will it be back?",
+        "What payment methods do you accept? Can I pay in installments?",
+        "Do the products come with a warranty?",
+        "Do you have any discount code or promotion?",
+        "Can I change or cancel my order after buying?",
+        "How do I reach a human on your team?",
+    ],
+}
+
+
+async def generate_gap_report(
+    db: AsyncSession, tenant: Tenant, lang: str = "es"
+) -> dict:
+    """Return a gap report for an already-crawled demo tenant:
+    {brand, total, answered, gap_count, questions:[{q, status, score}], gaps:[q...]}.
+    status is "hit" (the store's pages answer it) or "miss" (a real gap)."""
+    questions = GAP_QUESTIONS.get("en" if lang == "en" else "es", GAP_QUESTIONS["es"])
+    out = []
+    for q in questions:
+        try:
+            hits = await rag_index.search(db, q, k=3, tenant_id=tenant.id)
+        except Exception:  # noqa: BLE001 - one bad query never breaks the report
+            hits = []
+        top = hits[0][1] if hits else 0.0
+        out.append({
+            "q": q,
+            "status": "hit" if top >= _GAP_THRESHOLD else "miss",
+            "score": round(float(top), 3),
+        })
+    gaps = [r["q"] for r in out if r["status"] == "miss"]
+    return {
+        "brand": tenant.brand_name or tenant.name or tenant.slug,
+        "total": len(questions),
+        "answered": len(questions) - len(gaps),
+        "gap_count": len(gaps),
+        "gaps": gaps,
+        "questions": out,
+    }

app/routes/demo.py

@@ -561,11 +561,26 @@ async def _email_trial_activated(email: str, slug: str, token: str, base: str) -
         "Un saludo,\nVictor — Atendyo"
     )
     try:
-        await mailer.send_email(get_settings(), email, "Tu bot ya está activo (prueba gratis)", body)
+        await mailer.send_email(
+            get_settings(), email, "Tu bot ya está activo (prueba gratis)", body
+        )
     except Exception:  # noqa: BLE001 - email must never break activation
         log.warning("trial activation email failed (non-fatal)", exc_info=True)
 
 
+@router.get("/demo/gap")
+async def demo_gap(d: str, lang: str = "es", db: AsyncSession = Depends(get_session)) -> dict:
+    """Gap Report for a demo store: the high-intent buyer questions the store's
+    OWN site fails to answer (the value-first proof of the Mirror method). The
+    bot answers all of them — each gap is a lost sale the merchant can see."""
+    from app.demo_gap import generate_gap_report
+
+    tenant = await get_tenant_by_slug(db, d)
+    if tenant is None or not tenant.is_demo:
+        raise HTTPException(status_code=404, detail="Demo no encontrada o caducada.")
+    return await generate_gap_report(db, tenant, lang=lang)
+
+
 @router.get("/demo/status")
 async def demo_status(d: str, db: AsyncSession = Depends(get_session)) -> dict:
     """Live progress for the demo page. Falls back to the DB when the

docs/SECURITY-POLICY.md

@@ -0,0 +1,58 @@
+# Atendyo — Política de seguridad y protección de datos
+
+Documento de respaldo para las respuestas del cuestionario de "datos protegidos
+del cliente" de Shopify. Refleja cómo opera Atendyo (flexigobe.com / atendyo.com).
+
+## Datos que tratamos y finalidad
+- **Finalidad única: atención al cliente** en nombre del comerciante. El asistente
+  responde dudas de los clientes del comerciante (productos, envíos, pedidos).
+- **Datos personales tratados:** nombre, correo electrónico y dirección de envío,
+  y SOLO cuando el propio cliente consulta el estado de SU pedido en el chat. No
+  tratamos teléfono. No usamos datos para marketing, perfilado ni venta.
+- **Minimización:** solo se accede al pedido que el cliente identifica, tras
+  verificar su identidad (email + un dato adicional). Nunca se vuelca el catálogo
+  de clientes del comerciante.
+
+## Almacenamiento
+- **Cifrado en tránsito:** todo el tráfico va por HTTPS/TLS.
+- **Cifrado en reposo:** base de datos gestionada (Neon Postgres) con cifrado en
+  reposo, incluidos los backups. Los secretos por comerciante (credenciales de
+  Shopify/WhatsApp) se guardan **cifrados** en la aplicación.
+- **Retención mínima:** las conversaciones del chat se borran automáticamente a
+  las 72 horas; los datos de sesión se purgan según la política de retención. No
+  conservamos datos personales más tiempo del necesario.
+- **Backups y prevención de pérdida:** backups automáticos del proveedor gestionado
+  con recuperación a un punto en el tiempo; control de acceso a la base de datos.
+- **Separación prueba/producción:** los entornos y tiendas de prueba (tenants
+  `is_demo`) están aislados por `tenant_id` y se autodestruyen; no se mezclan con
+  datos de producción.
+
+## Acceso
+- **Acceso limitado:** operación de un único fundador. El acceso administrativo
+  está protegido por un token de administrador; el portal de cada comerciante por
+  un token propio que solo desbloquea sus propios datos (aislamiento multi-tenant).
+- **Contraseñas/credenciales:** credenciales fuertes y únicas; los tokens y claves
+  se guardan como secretos cifrados, nunca en el código.
+- **Registro de acceso:** los accesos a datos de pedidos quedan registrados como
+  eventos de la aplicación, además de los logs del servidor.
+
+## Consentimiento y derechos
+- **Acuerdo de tratamiento:** disponemos de un encargo de tratamiento para los
+  comerciantes (atendyo.com/legal/encargo) y política de privacidad pública
+  (atendyo.com/legal/privacidad).
+- **RGPD:** infraestructura en la UE. Atendemos los webhooks de cumplimiento de
+  Shopify: `customers/data_request` (acceso), `customers/redact` (borrado de un
+  cliente) y `shop/redact` (borrado total de la tienda 48 h tras desinstalar).
+- **Sin venta de datos** ni decisiones automatizadas con efectos legales o
+  significativos sobre las personas.
+
+## Respuesta a incidentes
+- **Detección:** monitorización de errores y logs del servicio.
+- **Contención y remediación:** rotación inmediata de credenciales comprometidas,
+  corrección de la causa raíz y despliegue.
+- **Notificación:** aviso a los comerciantes afectados y a la autoridad de control
+  cuando proceda, dentro de los plazos del RGPD (72 h para brechas notificables).
+
+## Auditorías externas
+Ninguna por el momento (aplicación nueva). Se valorará a medida que el volumen lo
+justifique.

docs/SHOPIFY-APP-STORE-PLAN.md

@@ -51,3 +51,45 @@ Listarse **no** trae instalaciones solo. El App Store es un **canal de conversi
 confianza** (instalar fácil + reviews + "está en la tienda oficial"), que alimenta
 lo que de verdad capta: la máquina de demos, el SEO en español y los partners. Por eso
 va en paralelo, no en el camino crítico de conseguir el próximo cliente.
+
+---
+
+## Estado real (2026-06-17): la app YA es instalable
+- Credenciales puestas (Client ID `b11f102b94a15862d85e725a16e4d5e3`, secret en HF).
+- **Instalación en 1 clic PROBADA** en dev store `atendyo-test` (tenant OAuth + catálogo en vivo OK).
+- **App embebida CONSTRUIDA + probada** (panel dentro del admin de Shopify, App Bridge + session token; backend `SHOPIFY_APP_EMBEDDED=true`).
+- Falta solo, en el Dev Dashboard: marcar "Incrustar app", App URL=`.../shopify/app`, y los pasos de abajo para PUBLICAR.
+
+## Webhooks de cumplimiento (GDPR) — pegar en la config de la app
+Endpoints ya implementados + verificados (HMAC). En el Dev Dashboard → la app → sección de webhooks de cumplimiento / privacidad, pega estas URLs:
+- **customers/data_request:** `https://victor34593993-flexigo-support-bot.hf.space/shopify/webhooks/customers_data_request`
+- **customers/redact:** `https://victor34593993-flexigo-support-bot.hf.space/shopify/webhooks/customers_redact`
+- **shop/redact:** `https://victor34593993-flexigo-support-bot.hf.space/shopify/webhooks/shop_redact`
+- **app/uninstalled** (suscripción de webhook): `https://victor34593993-flexigo-support-bot.hf.space/shopify/webhooks/app_uninstalled`
+
+## Icono del listado
+`app/landing_ui/app-icon.png` — 1200×1200, bocadillo blanco sobre azul Atendyo. Súbelo como icono de la app.
+
+## Copy del listado (listo para pegar)
+
+**Nombre:** Atendyo — Asistente de IA y soporte
+**Tagline (ES):** La IA que atiende tu tienda y vende, 24/7, en su idioma.
+**Tagline (EN):** The AI that answers your store and sells, 24/7, in any language.
+
+**Descripción corta (ES):**
+> Atendyo es un asistente de IA que se entrena con TU tienda (productos, envíos, devoluciones) y responde solo a tus clientes en su idioma, en la web y en WhatsApp. Muestra productos con foto/precio/stock en vivo, consulta el estado de pedidos, informa de zonas y tarifas de envío, y capta contactos cuando no puede resolver. Sin montar flujos: responde desde el primer día.
+
+**Puntos clave (bullets del listado):**
+- Se entrena solo con tu web y tus PDFs — sin programar ni montar árboles de decisión.
+- Catálogo en vivo: foto, precio, stock y enlace de compra dentro del chat.
+- Estado de pedidos y seguimiento, con verificación de identidad.
+- Zonas y tarifas de envío reales de tu Shopify (incluido Canarias).
+- Web y WhatsApp con el mismo asistente. Más de 50 idiomas, detección automática.
+- Captura de contactos cuando no sabe algo (nunca se inventa nada).
+- Precio plano 29 €/mes, 14 días de prueba sin tarjeta. Nativo de la UE (RGPD).
+
+**Categoría:** Atención al cliente / Customer support.
+**Términos de búsqueda:** ai chatbot, customer support, whatsapp, sales assistant, multilingual, atención al cliente, chatbot español.
+
+## Capturas (las preparo yo)
+Puedo capturarlas del bot real en la dev store `atendyo-test` (widget respondiendo, tarjetas de producto, WhatsApp). Pídemelo cuando vayas a subir el listado.