Administración de la plataforma
🛍️ 🖨️ Kit de calle

📖 Guía de la plataforma

🛍️ Comprador (index.html)
· Pídeselo a Cerki: chat con la IA vendedora; recomienda por cercanía + calificación + precio solo del catálogo real y cierra la venta (crea la orden en la base de datos).
· Explorar: catálogo por áreas con fotos; los botones Comprar/Agendar le pasan la venta a la IA. Los productos de Amazon abren Amazon con tu enlace de afiliado.
· 🗺️ Mapa: en Explorar, botón "Ver mapa" — negocios cercanos sobre el mapa real (OpenStreetMap) con su emoji de área, distancia, dirección y botón "🍊 Pedir con Cerki" que abre el chat. Respeta el filtro de área y se carga solo al abrirlo (no frena la app).
· 📍 Ubicación: cambia el barrio; distancias y recomendaciones se recalculan.

🏪 Mi negocio (negocio.html)
· Cuenta propia con correo y contraseña; cada dueño solo ve SU negocio (seguridad RLS en la base).
· Registrar: crea el negocio; si su área está inactiva puede dejar listo el portafolio.
· ⭐ Calificación de Google: el negocio escribe su nombre tal cual en Google Maps (o pega el link) y un motor diario (3 am, API oficial de Places) trae sus ★ y nº de reseñas — NUNCA textos, que Google no deja guardar. La IA las cita como prueba social ("★ 4.8 en Google con 320 reseñas"), clave para negocios sin reseñas Cerki aún. Requiere el secreto CERKI_GOOGLE_MAPS_KEY (API key de Google Maps Platform); sin ella todo queda "omitido" en la bitácora (canal google). Al guardar el campo también se sincroniza al instante.
· 📊 Mini-panel: arriba del portal, cada negocio ve sus números reales de los últimos 30 días — vendido, citas/pedidos, calificación con reseñas reales y lo más pedido. Razones para quedarse en Cerki.
· 💡 Onboarding exprés: al entrar a su portafolio le aparecen los servicios típicos de su área con precio de referencia de Medellín (config plantillas, editable): toca uno, ajusta SU precio y lo agrega — el perfil queda montado en minutos.
· Portafolio: servicios y productos con precio, ícono y foto real (se sube al Storage); entran al catálogo y al cerebro de la IA al instante.
· Citas y pedidos: llegan con refresco automático; Confirmar / Completar / Cancelar (cada cambio le avisa al cliente por WhatsApp cuando el número esté conectado).
· 🔔 Push del navegador: con un toque en el banner del portal, cada venta le SUENA al negocio aunque cierre la app (Android/PC; en iPhone requiere agregar Cerki a la pantalla de inicio). Funciona YA, sin esperar el WhatsApp de Meta; las suscripciones muertas se limpian solas y todo intento queda en la bitácora (canal push).
· 🔗 Página pública: cada negocio activo tiene su vitrina compartible en /n/?s=su-nombre con botón "Pídeselo a Cerki" — para su Instagram, estados o vitrina física.
· 🟢 Disponibilidad: interruptor "recibiendo servicios" + franja horaria (hora Colombia). La IA prefiere negocios disponibles AHORA, y el despacho respeta esa disponibilidad.
· 📍 Dirección exacta: obligatoria al registrarse (los antiguos la completan en su portal). La IA se la da textual a quien va a la sede, y sale en la página pública.
· 🧭 Rumbo (solo áreas de movilidad, configurables abajo): el conductor/domiciliario marca "voy hacia X zona" por 1-8 horas (vence solo). Cuando alguien pide ir hacia allá, la IA lo recomienda DE PRIMERO ("va para esa zona ahora mismo") y el despacho en cascada también lo prefiere. El cliente puede guardar su dirección exacta en 📍 de la app y la IA la usa para domicilios y recogidas sin volver a pedirla.
· ⚡ Ofertas relámpago: el negocio publica un ítem con descuento, cupos y hora límite (máx configurable aquí en Configuración; candado en BD: el precio debe ser menor al normal y dura máx 48 h). Salen destacadas en Explorar y en su página pública, la IA las ofrece de primeras con urgencia real, y el cupo se descuenta solo al venderse (se agota o vence automáticamente).

🚦 Despacho automático: cada servicio se asigna por criterio (el más cercano por defecto; "el mejor" o "el más barato" si el cliente lo pide, o el que el cliente elija). Si el negocio no confirma en los minutos configurados (📲 Notificaciones), un motor que corre cada 2 minutos lo reasigna en cascada al siguiente candidato disponible — avisando por WhatsApp al nuevo negocio y al cliente. Con 0 minutos el despacho queda apagado.

📊 Admin (esta página — solo correos de la lista de administradores)
· Áreas: interruptores para lanzar por fases + crear áreas nuevas sin tocar código.
· 🏪 Negocios (todos): lista completa (los más recientes arriba, con etiqueta 🆕 durante 3 días); el interruptor pausa/activa cualquiera al instante (pausado = invisible al público y a la IA, sin borrar nada). Además, si guardas tu WhatsApp de admin en 📲 Notificaciones, cada registro nuevo te llega al celular al instante.
· 🛡️ Seguridad: abrir/cerrar el registro de vendedores, aprobación manual de negocios nuevos (candado a nivel de base de datos: nadie se auto-aprueba), límites del chat IA por visitante y globales por día, y lista de admins. Carlos es dueño fijo: su acceso está grabado en la base y ningún admin puede quitárselo.
· 📲 Notificaciones: interruptor de avisos por WhatsApp + Phone ID de WhatsApp Cloud API. El token va como secreto del servidor (CERKI_WA_TOKEN). Con el número conectado funcionan a la vez: aviso al negocio, confirmación/cancelación al comprador, Cerki vendiendo por WhatsApp (la gente le escribe al número y la IA le resuelve) y reseñas reales (al completarse, el cliente califica 1-5 y el rating del negocio pasa a ser dato real). Todo intento queda en la bitácora cerki_avisos.
· Configuración: nombre, eslogan, bienvenida, personalidad y modelo de la IA, recomendaciones, % comisión, % margen dropshipping, tag de Amazon y lista de admins. Se aplica al instante en todo el sistema.
· Movimiento: negocios, órdenes, ventas, comisión y margen dropshipping (los pedidos pagados en línea salen con 💳).
· 📈 Embudo del experimento: 14 días de respuestas IA → órdenes → leads → valor, con conversión. Es tu tablero de "sigo o corto".
· ⭐ Reseñas desde la app: cuando el negocio marca Completar, al comprador le aparecen las estrellas en su pestaña Pedidos (verificado por su teléfono, una reseña por pedido); el rating del negocio se recalcula solo. Funciona YA, sin esperar el WhatsApp de Meta. Además, si un trabajo entró en $0 (urgencias), al Completar el negocio registra en cuánto quedó — así el embudo y la evidencia muestran plata real.
· 💳 Pagos en línea (Wompi): con la llave pública guardada en Configuración y los dos secretos en el servidor, aparece el botón "Pagar en línea" (PSE, Nequi, tarjetas) en cada pedido; el webhook de Wompi marca la orden como PAGADA sola y el negocio lo ve en su portal.
· 📸 Catálogo por foto: en el portal del negocio, el dueño sube una foto de su lista de precios y la IA propone los ítems (revisa, ajusta y agrega). Usa siempre el modelo económico y descuenta del medidor de gasto.
· 📊 Evidencia: cada negocio ve en su portal cuántas veces lo recomendó la IA, cuántas personas abrieron su perfil y su histórico de ventas — el argumento para cobrar membresía después.
· 🖨️ Kit de calle (botón arriba): flyer con QR, cartel de vitrina y guion de 30 segundos, listos para imprimir para reclutar en Monterrey.
· 🆘 Urgencias ("Que me llamen YA"): landing cerki.pages.dev/s/?a=<area> (pensada para pauta de Google). El cliente deja qué pasó + celular + ubicación; Cerki crea la orden y la despacha al negocio disponible MÁS CERCANO (rumbo primero), que recibe push con botón "📞 Llamar YA". Si no la toma en los minutos configurados, la cascada la pasa sola al siguiente. Cada despacho es un lead cobrable (precio en Configuración, reporte mensual por negocio en 🆘 Leads urgentes). Áreas con urgencia configurables; anti-spam: máx 3 por teléfono/hora. Mide conversiones con el evento cerki_sos.

⚖️ Legal y medición: Términos y Política de Datos (Ley 1581, Habeas Data) en /legal/, enlazados en todas las páginas; aviso de aceptación bajo el chat y en el registro de vendedores. El tracking se enciende poniendo el ID de Google (G-… o AW-…) en Configuración: mide cerki_chat (primer mensaje) y cerki_orden (venta, con valor COP) para campañas de Google Ads.

🧠 Dónde vive todo: tablas cerki_* y función cerki-ia en el proyecto Supabase de HISMED (conviven; Cerki se puede retirar sin tocar HISMED). Documentación completa en cerki/docs/DOCUMENTACION.md.