=== HatchDeal — Cupones vivos con referidos ===
Contributors: hatchdeal
Tags: woocommerce, coupons, referrals, loyalty, discounts
Requires at least: 6.3
Tested up to: 6.6
Requires PHP: 7.4
Stable tag: 0.2.0
License: GPLv2 or later

Haz que tus clientes empollen descuentos, no acumulen puntos. HatchDeal crea cupones vivos que crecen con compras referidas.

== Description ==

HatchDeal convierte cada compra en un "huevo de descuento": un cupón temporal que empieza pequeño y crece cuando otras personas compran desde el link único del cliente.

* Cupones porcentuales imaginables (3%, 10%, 30%) en vez de puntos abstractos.
* Modelos de crecimiento: acumulativo, escalera y huevo premium.
* Atribución por link, cookie y metadata de pedido.
* Antifraude: bloqueo de autoreferidos, reversión por cancelación/reembolso.
* Calculadora de ofertas integrada en el admin.
* Compatible con HPOS.

== Installation ==

1. Sube la carpeta `hatchdeal` a `wp-content/plugins/`.
2. Activa el plugin desde el menú Plugins.
3. Ve a WooCommerce → HatchDeal para configurar campañas.
4. Usa la Calculadora de ofertas para diseñar la mejor configuración.

== Frequently Asked Questions ==

= ¿Necesito WooCommerce? =
Sí. HatchDeal crea cupones reales de WooCommerce y se apoya en sus pedidos para atribuir referidos y eclosionar huevos. Requiere WooCommerce 7.0 o superior y es compatible con HPOS.

= ¿Cómo crece el descuento del huevo? =
Cada cliente que compra recibe un huevo con un descuento inicial pequeño. Cuando otras personas compran desde su link, el descuento crece según el modelo de campaña elegido (acumulativo, escalera o premium) hasta llegar al máximo configurado.

= ¿Qué pasa cuando un pedido se cancela o reembolsa? =
HatchDeal revierte la atribución: el referido deja de contar, el descuento del huevo se recalculará y, si el huevo ya había eclosionado y baja del umbral, el cupón emitido se revoca automáticamente.

= ¿Funciona sin conexión a Internet / sin cuenta de pago? =
Sí. El plugin incluye un modo trialware local de 7 días con todas las funciones Pro, sin requerir tarjeta ni cuenta externa. La integración con Freemius es opcional para habilitar el cobro de planes Pro y Premium.

= ¿El cliente necesita estar registrado? =
No. La atribución funciona por email y cookie. Si el cliente tiene cuenta, sus huevos también se asocian a su usuario y se muestran en la página "Mi Nido".

= ¿Mis datos viajan a terceros? =
No. Los emails se hashean (SHA-256 + salt) antes de almacenarse, las IPs se anonimizan y no hay telemetría propia. Las únicas llamadas externas son a Freemius, y solo si tú lo activas.

== Screenshots ==

1. Panel de control con KPIs de campañas, huevos, referidos y eclosionados.
2. Wizard de campaña: configura modelo de crecimiento, topes y incentivo al amigo.
3. Calculadora de ofertas integrada: simula rentabilidad, k-factor y CAC, con sugeridor de configuración óptima.
4. Vista "Mi Nido" del cliente: sus huevos, progreso y link de referido para compartir.
5. Caja en la página de agradecimiento: el cliente comparte su huevo recién nacido.

== Upgrade Notice ==

= 0.2.0 =
Primera versión pública: emails al cliente, incentivo al amigo, reversión real de fraudes/reembolsos y endpoints REST seguros.

== Changelog ==

= 0.2.0 =
* Emails transaccionales: aviso de huevo creado y código al eclosionar.
* Incentivo al amigo: el comprador referido recibe su cupón de bienvenida.
* Reversión real en cancelaciones/reembolsos: recalcula el huevo y revoca cupones.
* Seguridad REST: el progreso de un huevo requiere ownership o el token del link.
* Antifraude: velocity check por IP ahora funcional + flag de revisión manual.
* Limpieza completa en uninstall y cron al desactivar.

= 0.1.0 =
* Versión inicial: campañas, huevos, referidos, reward engine, calculadora de ofertas y frontend.
