📖 Manual General de Operación: TemasGo

TemasGo es una plataforma de Marketplace Multi-Tienda hiper-local, diseñada específicamente para conectar comercios locales, clientes y transportistas (taxistas/repartidores) en un ecosistema unificado.

A continuación, se desglosan todas sus capacidades operativas organizadas por rol y módulo. Usa esta guía para exponer la plataforma.

👥 1. Perfiles de Usuario (Roles)

La plataforma maneja 4 tipos de cuentas, cada una con tableros y permisos exclusivos:

1. Cliente: Navega por las tiendas, agrega al carrito y compra.
2. Operador (Dueño de Tienda): Gestiona su propio catálogo, pedidos, citas y perfil de negocio.
3. Repartidor / Taxista: Se conecta para recibir ofertas de viajes, recolectar paquetes y entregarlos a domicilio o en ruta.
4. Super Administrador: Tiene el control maestro de la plataforma. Aprueba registros, revisa comprobantes de pago de envío y audita toda la logística.

🛒 2. Experiencia del Cliente (El Core del Marketplace)

A. Búsqueda y Navegación

• Buscador Inteligente (FTS): Los clientes pueden buscar un término (ej. "Tacos") y el sistema buscará coincidencias tanto en nombres de tiendas como dentro de los productos de todos los comercios.
• Categorización: Comercios divididos por rubros (Comida, Servicios, Ropa, etc.).

B. Carrito Multi-Tienda Inteligente

• Compra Combinada: El cliente puede agregar productos de Tienda A, Tienda B y Tienda C en un mismo carrito.
• Métodos de Recepción Dinámicos: En la pantalla de pago, el cliente elige, por separado, qué hacer con cada tienda:
  • 🍽️ Comer Ahí: Exclusivo para restaurantes. No genera recargos de envío.
  • 🏪 Recoger en Tienda (Pickup): El sistema le genera un Código QR de seguridad al cliente para que la tienda se lo escanee.
  • 🛵 Envío a Domicilio Local (Taxistas/repartidores): El sistema agrupa todas las tiendas que requieren envío y calcula la ruta óptima.
  • 🚛 Envío Intermunicipal: (para envios por taxi) Para mandar productos fuera de Temascalcingo.
  • 📅 Citas de Servicio: Si el producto es un "Servicio" (ej. Corte de cabello, consulta dental, etc.), el sistema habilita un calendario para agendar fecha y hora.

C. Sistema de Pagos Flexibles

• Mercado Pago: Split de pagos automático. (Falta confirmar conexión completa según versión).
• Transferencia / Efectivo: El cliente sube su comprobante (ticket) y el comercio (o administrador) lo valida antes de despachar.

🚕 3. Logística Avanzada (Módulo de Repartidores)

Este es uno de los motores más robustos de TemasGo, diseñado para eficientar el trabajo de los taxistas y/o repartidores.

A. Algoritmo de Rutas (Multi-Parada)

Si un cliente compró en 3 tiendas distintas, el sistema no le cobra 3 envíos.

1. Calcula la ruta más corta usando coordenadas GPS.
2. Traza la ruta: Origen del repartidor → Tienda 1 → Tienda 2 → Tienda 3 → Casa del Cliente.
3. Calcula un costo justo por kilometraje total y lo muestra al cliente.

B. Panel del Conductor (taxista/repartidor)

• Modo En línea/Desconectado: El taxista o repartidor enciende su estado para empezar a recibir notificaciones sonoras ("Ka-Ching") cuando hay un nuevo viaje.
• Trip Offer (Oferta de Viaje): Ve la distancia total, cantidad de paradas y su Ganancia Neta.
• Linear Delivery Stepper: Una guía paso a paso.
  • Paso 1: Recoger en Tienda A (Le dice qué paquetes son).
  • Paso 2: Recoger en Tienda B.
  • Paso Final: Navegar al destino del cliente.
• PIN de Seguridad: Para evitar robos o confusiones, el cliente tiene un PIN de 4 dígitos en su app. El taxista/repartidor no puede marcar el viaje como "Completado" en el sistema hasta que le pregunte el PIN al cliente en persona.
• Gestión Financiera y Reseñas: El conductor ve su balance, lo que se le debe pagar, y su calificación promedio de estrellas.

🏪 4. Gestión Comercial (Panel del Operador)

Cada dueño de negocio tiene su propio panel de administración (/operador).

• Catálogo: Sube productos, imágenes, maneja stock y clasifica si son "Físicos" o "Servicios".
• Tracking de Pedidos en Vivo: Pantalla que se actualiza sola cada que un cliente compra.
• Citas Inteligentes: Panel para ver servicios agendados. Al recibir una cita, el operador recibe una alerta por WhatsApp automáticamente.
• Branding: Personaliza colores, emojis representativos de su tienda y su información bancaria (CLABE).

👑 5. Centro de Mando (Super Admin)

El núcleo operativo de los dueños de TemasGo.

• Filtro de Calidad (Aprobaciones): Todo negocio y taxista nuevo entra en estado "Pendiente". El admin revisa sus documentos/vehículo y les da acceso.
• Gestión de Envíos (/admin/envios): Cuando un cliente paga su envío por transferencia, el admin ve el ticket de pago. Al darle "Aprobar", automáticamente suena el teléfono de todos los taxistas o repartidores disponibles para que tomen el viaje.
• Envíos Foráneos (/admin/envios-intermunicipales): Monitor de los paquetes que salen de la ciudad, permitiendo actualizar su estatus (En bodega, en tránsito, entregado).

🔔 6. Ecosistema de Notificaciones en Tiempo Real

La aplicación está diseñada para ser proactiva, no reactiva. Usa Progressive Web App (PWA) y Push Notifications nativas.

Momentos clave que disparan alertas automáticas:

1. (Taxista/repartidor) "¡Nuevo Viaje Disponible!": Suena en los celulares de los choferes cuando se confirma un pago de envío.
2. (Cliente y Operador) "Taxi/repartidor Asignado": Cuando un taxista acepta el pedido, ambos reciben una notificación indicando que la recolección ha comenzado.
3. (Cliente) "En Camino": Cuando el taxista o repartidor recoge el último producto de las tiendas, el cliente recibe un aviso de que su comida/producto va hacia su domicilio.
4. (Cliente) "Entregado": Al finalizar el PIN, el cliente recibe la confirmación final y la invitación a calificar.
5. (WhatsApp Outbound): Ciertas acciones críticas (como agendar una cita o rechazar un pago) disparan mensajes automáticos directamente al WhatsApp personal del involucrado.

Lo que hace diferente a TemasGo frente a apps tradicionales (UberEats/Rappi) es su enfoque Logístico Mixto: Permite mezclar múltiples tiendas en un solo viaje para reducir costos de envío al cliente, integra a taxistas tradicionales en lugar de solo motos, y permite compras híbridas (ej. pedir tacos a domicilio mientras agendas un corte de cabello para mañana, todo pagado en el mismo carrito).

🚀 ¿Qué es TemasGo y cómo beneficia a nuestra comunidad?

TemasGo es una aplicación hecha para nuestra gente. Conecta en un solo lugar a los negocios locales, a los clientes y a los taxistas/repartidores, logrando que comprar y vender en nuestro municipio sea más fácil, rápido y seguro.

👥 ¿Quiénes participan en TemasGo?

1. El Cliente: Compra lo que necesita desde su celular sin salir de casa.
2. El Negocio (Comercio): Muestra sus productos o servicios y vende más.
3. El Taxista / Repartidor: Gana dinero extra entregando paquetes, productos, comida o haciendo viajes.
4. El Administrador: Cuida que todo funcione de manera justa y segura.

🌟 Beneficios Principales (Por qué le conviene a todos)

🛒 Para los Clientes: "Todo el pueblo en tu celular o computadora"

• Un solo carrito para varios negocios: Puedes pedir unos tacos de la taquería A, un postre del negocio B y pagar todo en la misma compra.
• Tú decides cómo recibirlo:
  • Comer ahí: Pides con anticipación para llegar a la mesa servida.
  • Pasar a recoger: Pasas a la tienda, enseñas tu código en el celular y te entregan tu pedido sin hacer filas.
  • A domicilio: Un taxista o repartidor te lo lleva hasta la puerta de tu casa.
  • Agendar citas: Si es una barbería, dentista o taller, eliges el día y la hora que más te acomode.
• Formas de pago sencillas: Pagas con tarjeta o mediante transferencia/efectivo subiendo una foto de tu comprobante.

🏪 Para los Dueños de Negocios: "Más ventas sin complicaciones"

• Tu catálogo digital: Subes las fotos de tus productos, platillos o servicios y cambias precios o existencias cuando quieras.
• Avisos al instante por WhatsApp: Cada vez que alguien te hace un pedido o te agenda una cita, te llega un mensaje automático a tu teléfono para que no se te pase ninguno.
• Control total: Ves en una pantalla fácil de usar los pedidos que van entrando para prepararlos a tiempo.

🚕 Para los Taxistas y Repartidores: "Más ingresos en tus tiempos libres"

• Avisos con sonido de dinero ("Ka-Ching"): Enciendes tu aplicación cuando quieras trabajar y te llegará un sonido claro avisándote de un nuevo viaje o entrega disponible.
• Aceptas solo lo que te conviene: Antes de tomar el viaje ves cuánto vas a recorrer, a cuántas tiendas irás y cuánto vas a ganar limpios.
• Guía paso a paso: La app te dice exactamente a qué tienda ir primero, qué recoger y a dónde llevarlo.
• Entrega segura por PIN: Al entregar el paquete, el cliente te da un código de 4 números. Así nadie puede decir que no recibió su pedido y tu cobro queda 100% protegido.

💡 ¿Qué hace a TemasGo DIFERENTE y MEJOR que otras aplicaciones?

1. Ahorro en el envío: Si el cliente pide en 3 tiendas distintas, el sistema calcula la ruta más corta para que solo pague un solo envío justo y no tres cobros separados.
2. Apoyo al transporte local: Integramos a los taxistas de la comunidad para que aprovechen sus rutas y ganen más.
3. Servicios y productos juntos: En la misma app puedes pedir la cena para hoy y dejar agendada tu cita para el corte de cabello de mañana.

"TemasGo no viene a reemplazar a nadie, viene a unirnos. Hace que los negocios vendan más, que los taxistas ganen más y que los clientes reciban todo en su casa de forma fácil y segura."

Módulo de Productos: Gestiona tu Inventario Sin Complicaciones

El Módulo de Productos de TemasGo es el control central de tu negocio. Está diseñado para que cualquier comerciante —ya sea una tienda de abarrotes, farmacia, restaurante o barbería— pueda administrar lo que vende de forma fácil, rápida y sin enredos.

🌟 Funciones Clave para los Negocios

1. Vista Clara y Control al Instante 👁️

• Todo a la vista: Ves tus productos con foto, precio y cuántos te quedan en existencia.
• Activa o desactiva en 1 segundo: Si se te acaba un producto (por ejemplo, el pan dulce), automáticamente pasa como "Agotado". El producto se oculta al momento para que ningún cliente te pida algo que no tienes.
• Organización por categorías: Ordena tus productos por secciones (ejemplo: Bebidas, Lácteos, Botanas) para encontrarlos rápido.

2. Creación de Productos Inteligente 📝

• No pierdes tu información (Borradores): Si estás registrando un producto y se te apaga el teléfono o cierras la pantalla por error, el sistema guarda un borrador automático para que no tengas que empezar desde cero.
• Fotos rápidas y ligeras: La app ajusta y comprime las fotos que subas para que carguen al instante y no gasten tus datos móviles.
• Calculadora de precios automática: ¡Olvídate de las cuentas con calculadora! Solo pones cuánto te costó el producto, cuántas piezas vienen en la caja y qué porcentaje de ganancia quieres tener. La app calcula tu precio de venta ideal al instante.

3. Se Adapta a Cualquier Tipo de Negocio 🏪

El formulario cambia según lo que vendes:

• Para Tiendas y Farmacias: Registra el inventario actual, te avisa cuando te queden pocas piezas y lleva control de fechas de caducidad.
• Para Restaurantes y Cafeterías: Te permite agregar opciones o modificadores (ejemplo: "Sin cebolla", "Tamaño Grande", "Con leche de almendra").
• Para Servicios y Estéticas: Te permite definir la duración de la cita para que los clientes agenden su horario automáticamente.

4. Botón de "Surtir Mercancía" (Restock Fácilsimo) 🚚

• Cuando te llega mercancía nueva, no necesitas editar el producto desde cero.
• Solo usas la opción "Surtir", indicas cuántas cajas o piezas te llegaron y cuánto te costaron. El sistema suma el nuevo inventario solo, actualiza tus costos y reactiva el producto si estaba agotado.

5. Lector de Código de Barras 🏷️

• Si usas una pistola escáner o la cámara de tu celular, puedes registrar el código de barras de tus productos para encontrarlos en segundos al momento de cobrar en tu mostrador.

"Con el Módulo de Productos de TemasGo, no necesitas ser contador ni experto en tecnología. La app hace las cuentas por ti, cuida que no vendas productos caducados y te ayuda a surtir tu negocio en segundos."

📅 Módulo de Citas y Agenda: Tu Tiempo Organizado y Sin Dobles Reservas

El Módulo de Citas de TemasGo está diseñado para que los negocios basados en servicios (estéticas, médicos, dentistas, veterinarias, talleres) automaticen su agenda, reciban reservas por internet y olviden la libreta de papel o los malentendidos de horarios.

🌟 Funciones Clave para los Negocios de Servicios

1. Calendario Fácil y Visual 🗓️

• Control total de tu tiempo: Puedes ver tu agenda por día, semana o mes completo.
• Agenda en 1 toque: Solo tocas un espacio libre en la pantalla o usas el botón "+ Nueva Cita" para registrar a un cliente que llegó directo a tu local.
• Colores para identificar el estado al instante:
  • 🟡 Pendiente: Cita recibida por revisar.
  • 🔵 Confirmada: Espacio reservado con éxito.
  • 🟢 Completada: Servicio atendido y terminado.
  • 🔴 Cancelada: Horario liberado.

2. Avisos al Momento con Sonido 🔔

• Citas en tiempo real: Cuando un cliente agenda desde su celular a cualquier hora del día, la cita aparece de inmediato en tu pantalla.
• Alerta sonora: Tu panel emite un sonido avisándote que entró una nueva reserva, para que no tengas que estar recargando la página a cada rato.

3. Confirmación Automática por WhatsApp 💬

• Al registrar una cita en el panel con el número del cliente, la app prepara automáticamente un mensaje personalizado con el nombre del servicio, la fecha, la hora y el costo.
• Con solo presionar un botón, se abre tu WhatsApp con el mensaje listo para enviárselo al cliente y confirmar su asistencia en segundos.

4. Control de Servicios y Capacidad de Atención ✂️🩺

• Atiende a más de un cliente a la vez: Si tienes 2 sillones de barbería, 2 camillas o 2 doctores, configuras la app para que acepte 2 citas en el mismo horario. Una vez lleno el cupo, la app bloquea automáticamente ese espacio para no saturarte.
• Duración exacta por servicio: Configuras cuánto tiempo tarda cada trabajo (ejemplo: Corte de cabello: 30 min, Tinte: 90 min). Al agendar, el sistema calcula el horario de inicio y fin automáticamente.
• Activa o pausa servicios: Si un tratamiento o servicio no lo estás ofreciendo esta semana, lo pausas con un solo clic sin perder tu configuración.

"Con el Módulo de Citas de TemasGo, tu negocio trabaja para ti las 24 horas. Tus clientes agendan su horario desde su celular, tú confirmas por WhatsApp en un clic y nunca más vuelves a empalmar dos citas a la misma hora."

🍔 Módulo de Menú (Restaurantes): Platillos a la Medida y Sin Errores en Cocina

El Módulo de Menú Digital de TemasGo está diseñado específicamente para restaurantes, fondas, cafeterías, taquerías y negocios de antojitos. Les permite mostrar su comida de forma antojable y permitir que los clientes personalicen su pedido ("con todo", "sin cebolla", "con extra queso") para que la comanda llegue clara a la cocina.

🌟 Funciones Clave para los Negocios de Comida

1. Menú Digital Antojable y Rápido 📸

• Organización clara: Tus platillos quedan divididos por secciones (Desayunos, Bebidas, Postres, Antojitos) para que el cliente encuentre todo al instante.
• Agotado en 1 segundo: Si en la cocina se acaba un guisado o ingrediente, presionas un botón para marcar el platillo como "Agotado". Su imagen se atenúa y nadie más podrá pedirlo, evitando que hagas quedar mal al cliente.
• Borradores automáticos: Si estás dando de alta un platillo nuevo y te interrumpe un cliente en el mostrador, la app guarda lo que escribiste para que no pierdas nada.
• Fotos de platillos superrápidas: La app ajusta las fotos de tus platillos para que el menú abra al instante en el celular de tus clientes, sin gastar sus datos.

2. Modificadores (Personaliza tu Platillo) 🧀🥓

Es el corazón del módulo. Te permite crear opciones para que el cliente arme su platillo a su gusto sin que el mesero o la cocina se confundan:

• Opciones Únicas u Opcionales:
  • Única (Obligatoria): Para elegir tamaño (Chico, Mediano, Grande) o término de la carne.
  • Múltiple (Opcional): Para elegir varios ingredientes a la vez (ejemplo: "Elige hasta 3 ingredientes para tu crepa").
• Límites de selección: Puedes indicarle a la app cuántos ingredientes puede elegir como máximo el cliente (ejemplo: "Elige máximo 2 salsas").

3. Cobro Transparente de Extras 💰

• Ingredientes con costo adicional: Si el cliente quiere un ingrediente extra (ejemplo: Leche de almendra +$15.00 o Extra queso +$20.00), la app lo suma automáticamente al precio del platillo para que el cliente sepa exactamente qué está pagando.
• Desactiva ingredientes agotados: Si te quedas sin aguacate o tocino, apagas únicamente esa opción con un clic (❌), sin necesidad de borrar todo el platillo.

4. Calculadora de Costo por Platillo 🧮

• Calcula tu ganancia real: Ingresas cuánto te cuesta preparar ese platillo (sumando ingredientes y empaques/desechables) y qué porcentaje de ganancia quieres obtener. La app te sugiere el precio de venta ideal al público para asegurar que tu cocina sea rentable.

"Con el Módulo de Menú de TemasGo, las comandas llegan a la cocina exactamente como las quiere el cliente. Vendes extras sin olvidar cobrarlos, muestras fotos antojables y evitas errores o malos entendidos en cada pedido."

💻 Módulo de Punto de Venta (POS): Cobra Rápido en tu Mostrador

El Módulo de Punto de Venta (POS) de TemasGo convierte tu celular, tablet o computadora en una caja registradora inteligente. Está pensado para que las ventas físicas en tu local y tus ventas por internet estén conectadas en un solo lugar, sin pagar sistemas caros ni tener inventarios desordenados.

🌟 Funciones Clave para tu Mostrador

1. Lector de Código de Barras Integrado 🏷️

• Cobro en segundos: Usa la cámara de tu celular, tablet o una pistola escáner conectada a tu computadora para registrar productos al instante, sin tener que buscarlos por nombre.
• Suma automática: Agrega varios productos rápidamente y la pantalla calculará el total a cobrar de forma instantánea.

2. Inventario Sincronizado Siempre 🔄

• Un solo stock: Si tienes 10 refrescos y vendes 2 a un cliente físico en tu tienda usando el POS, la aplicación restará automáticamente esos 2 refrescos de tu tienda en línea.
• Evita vender lo que no tienes: Nunca más un cliente por internet te comprará algo que acabas de vender hace un minuto en el mostrador.

3. Pagos Mixtos y Rápidos 💸

• Acepta múltiples métodos: ¿El cliente quiere pagar la mitad en efectivo y la mitad con transferencia? El sistema POS te permite dividir el cobro de la forma que sea necesaria para no perder la venta.
• Corte de caja preciso: Al final del día, el sistema te entregará un resumen exacto de cuánto debes tener en efectivo y cuánto entró por medios electrónicos.

4. Notas y Tickets Fáciles 🧾

• Tickets digitales: Envíale su comprobante al cliente por WhatsApp en un clic, ahorrando papel.
• Historial de ventas: Registra de forma segura todos los movimientos de tu mostrador para que lleves una contabilidad clara y sencilla de tus ingresos.

"Con el Punto de Venta (POS) de TemasGo, atiendes más rápido a la gente en tu local y mantienes tu inventario al día de forma automática. Es como tener a un cajero y a un contador trabajando para ti, todo desde una misma pantalla."

🛵🚕 Módulo de Repartidores y Logística: Entregas Locales y Envíos por Taxi

El Módulo de Logística de TemasGo es el motor que mueve los productos. Combina dos tipos de entregas: las locales a domicilio (en moto, bici o auto) y los envíos entre municipios aprovechando las rutas tradicionales de las bases de taxis colectivos, priorizando en todo momento la tranquilidad del usuario.

🔒 Filtro de Confianza y Seguridad Identificada (Garantía TemasGo)

Para la tranquilidad de comercios, clientes y familias de la comunidad:

• Filtros de Confianza Estrictos: Ningún repartidor o taxista puede comenzar a entregar paquetes sin antes pasar por un proceso de verificación. El administrador valida previamente su documentación oficial, licencias vigentes y el estado de su vehículo.
• Datos Visibles en Todo Momento: En cuanto se asigna un viaje o entrega, la aplicación muestra al cliente y al negocio la información completa del repartidor o chofer:
  • 👤 Nombre completo y foto de perfil.
  • 🚗 Datos del vehículo: Tipo de transporte, marca, modelo, color y número de placas o número económico del taxi.
  • ⭐ Calificación y reputación otorgada por otros usuarios.

🌟 1. Repartidores Locales (Entrega a Domicilio) 🛵

Pensado para quienes entregan comida o productos dentro de la misma ciudad:

• En línea con un toque: Enciendes tu aplicación cuando quieras trabajar y te desconectas cuando vayas a descansar para no recibir avisos.
• Sonido de dinero ("Ka-Ching") 🔔: Cada vez que entra un nuevo pedido cerca de ti, tu celular emite un sonido claro de caja registradora para que no se te pase ninguna oportunidad de ganar.
• Conoces tu ganancia antes de aceptar: La pantalla te muestra la ruta que vas a recorrer y tu ganancia neta exacta.
• Guía Paso a Paso en Pantalla:
  1. Ir a la tienda a recoger el paquete.
  2. Confirmar que ya lo tienes.
  3. Ir a la casa del cliente.
  4. Confirmar la entrega.
• Filtro por tipo de vehículo: Si andas en moto o bici, la app no te ofrecerá paquetes voluminosos o pesados que requieran auto.
• Cuentas claras: En tu perfil ves en todo momento cuánto has ganado en el día y cuánto se te va a pagar.

🌟 2. Envíos Intermunicipales (Aprovechando Taxis Colectivos) 🚕

Un sistema innovador que conecta municipios (ejemplo: Temascalcingo ↔ Atlacomulco ↔ Acambay) usando las rutas de taxis que ya existen:

• Envíos por Tramos: Un paquete puede viajar en dos partes o dos taxis distintos si la ruta es larga. Cada chofer toma el paquete en la base donde le toca su ruta.
• Ganancia Compartida y Justa 💰: El cobro del envío se divide automáticamente entre el taxista que lleva el paquete y la base/sitio de taxi que lo resguarda mientras pasa la unidad.
• Tipos de Paquete: Tarifas transparentes divididas en tres tamaños:
  1. ✉️ Documentos (sobres o papeles).
  2. 📦 Mediano (cajas de zapatos o compras pequeñas).
  3. 📦 Grande (paquetes voluminosos con mayor pago para el chofer).
• Seguridad y Fotos de Evidencia 📸: Para que nadie pierda un paquete, en cada paso se toma una foto comprobante (al recibirlo, en la base y al entregarlo al cliente final).
• Fondo de Protección Integrado 🛡️: Una pequeña parte del costo del envío se destina a un fondo de reserva de TemasGo. Si un paquete se extravía o sufre un percance en el camino, el cliente o negocio recibe una indemnización rápida y sin líos.

"Con TemasGo, entregar o mandar un paquete es tan seguro como rápido. Conoces exactamente quién lleva tu pedido, en qué carro o taxi viaja y cuentas con repartidores que han pasado por un filtro de confianza para proteger a nuestra comunidad."