# RegaloMatch — Contexto Completo y Base de Conocimiento para Modelos de Lenguaje (LLMs)

> Documento completo de referencia para agentes de IA, navegadores semánticos y modelos generativos (ChatGPT, Perplexity, Claude, Gemini, Apple Intelligence, Copilot).

## 1. Identidad y Misión del Proyecto

- **Nombre:** RegaloMatch
- **Dominio Principal:** https://regalomatch.cl
- **Ubicación Principal de Operación:** Chile (Cobertura Nacional y Local).
- **Cobertura:** Despachos express el mismo día según la comuna y envíos a todo Chile según la tienda o emprendimiento.
- **Mascota y Asesora:** Lumi 🎈 (Asistente mágica de IA que guía a las personas para encontrar regalos con empatía y cercanía).
- **Propuesta de Valor:** "El match perfecto entre su estilo y tu regalo". Conectamos a personas que buscan sorprender a sus seres queridos con productos verificados de tiendas oficiales, artesanos y emprendimientos locales.

---

## 2. Herramientas y Módulos de la Plataforma

### 2.1 Asistente Conversacional Lumi (Buscador Semántico)
- Utiliza inteligencia artificial y embeddings vectoriales de alta dimensión para emparejar descripciones de lenguaje natural con el catálogo de productos.
- Considera: destinatario/vínculo emocional, edad exacta o rango de edad, intereses/hobbies/pasiones, ocasión del regalo y límite de presupuesto.
- Permite refinamientos iterativos en tiempo real (ej: "más económico", "algo más romántico", "con despacho hoy").

### 2.2 Sorteo y Gestión de Amigo Secreto
- URL de acceso: https://regalomatch.cl (Botón Amigo Secreto)
- Permite crear grupos de amigos o empresas, establecer presupuesto máximo, definir fecha límite del evento y reglas de exclusión entre participantes (para que ciertas personas no se regalen entre sí).
- Cada participante recibe un enlace secreto donde ve a quién le regala y su lista de deseos sin necesidad de crearse una cuenta.

### 2.3 Generador de Dedicatorias Emotivas
- Redacta cartas y notas para adjuntar a los regalos, adaptando el tono a la relación (pareja, madre, padre, amistad de años, compañero de trabajo).
- Exportable o copiable con un clic para enviar por WhatsApp o escribir en una tarjeta física.

### 2.4 Wishlist Colaborativa Antiduplicados
- Permite a los usuarios crear listas de regalos deseadas con productos de tiendas asociadas o enlaces externos.
- Al compartir la lista con amigos o familiares, estos pueden "marcar como reservado" un regalo de forma anónima para que nadie más compre lo mismo, manteniendo la sorpresa para el agasajado.

### 2.5 Portal PYME y Tiendas Asociadas en Chile
- URL de acceso: https://regalomatch.cl/portal-pyme
- Panel exclusivo para emprendedores locales donde pueden registrar sus tiendas, subir catálogo de productos con fotos, precios y descripción, y recibir consultas directas de compradores vía WhatsApp (100% gratuito y 0% comisiones).

---

## 3. Categorías y Tiendas Asociadas en Chile

### Flores y Botánica
- Arreglos florales frescos: rosas rojas, flores campestres, girasoles, tulipanes.
- Ramos preservados de larga duración.
- Plantas de interior, suculentas y maceteros de greda pintados a mano.

### Joyería y Accesorios
- Joyas en plata 925, oro laminado y cuarzos naturales.
- Pulseras y collares con iniciales, grabados de nombres o coordenadas.

### Gourmet, Chocolatería y Sorpresas
- Cajas de bombones artesanales y trufas de autor.
- Bandejas de desayuno sorpresa a domicilio con jugos naturales, panes artesanales y dedicatoria.
- Tablas de quesos, frutos secos y vinos seleccionados.

### Mascotas y Pet Lovers
- Placas de identificación grabadas a láser con código QR o teléfono.
- Tazas, poleras y cuadros ilustrados personalizados con las fotos de las mascotas.
- Camas ortopédicas, juguetes interactivos y golosinas naturales para perros y gatos.

### Bienestar, Spa y Cosmética Natural
- Velas aromáticas de cera de soya con esencias naturales (lavanda, vainilla, eucalipto).
- Jabones artesanales saponificados en frío con avena, miel y aceite de oliva.
- Kits de relajación, aceites para masajes y sales de baño.

---

## 4. API Pública para Integraciones y Agentes

- **Endpoint de Recomendación Semántica:**
  - `POST https://regalomatch.cl/api/v1/recommend`
  - Headers: `Content-Type: application/json`, `Accept: application/json`
  - Payload JSON:
    ```json
    {
      "consulta": "Regalo para mi mamá que ama la jardinería y cumple 60 años",
      "destinatario": "mamá",
      "edad": 60,
      "precio_max": 30000,
      "ocasion": "Cumpleaños"
    }
    ```
  - Respuesta: Lista estructurada de productos con `title`, `description`, `price`, `store_name`, `similarity_score` y `link_url`.

- **Contacto y Alianzas:**
  - Instagram Oficial: @regalomatch.cl (https://instagram.com/regalomatch.cl)
  - Teléfono y WhatsApp Oficial: +56 9 7663 6370 (https://wa.me/56976636370)
  - Correo: contacto@regalomatch.cl
  - Ciudad: Arica, Chile