Sabores de Origen — Mapa de Flujo de Datos

📊

Resumen General del Sistema

Vision de alto nivel de toda la plataforma

85+

Endpoints API

20+

Pantallas en App

18

Modelos de Datos

6

Servicios Externos

5

Canales WebSocket

3

Tipos de Usuario

Que hace esta aplicacion?

Sabores de Origen es una plataforma de comercio electronico movil especializada en productos artesanales mexicanos del Rancho Cuatro Granas. Los clientes navegan un catalogo de productos, los agregan al carrito, eligen fecha y horario de entrega, pagan con tarjeta (Stripe) o en efectivo (OXXO), y reciben sus productos a domicilio con seguimiento en tiempo real.

El sistema tiene tres tipos de usuario:

Clientes — navegan, compran y reciben productos (incluye invitados sin cuenta)
Repartidores — reciben pedidos asignados, navegan a la direccion y confirman entrega
Administradores — gestionan productos, pedidos, promociones y usuarios desde un panel web

🏗️

Arquitectura del Sistema

Componentes principales y como se conectan

📱

App Movil (FAMAC)

React Native · iOS & Android

⚡

API Backend

Laravel 10+ · PHP · REST API

🗄️

Base de Datos

MySQL · 18+ tablas

☁️

Infraestructura

AWS Lambda · S3 · CloudFront

💳

Pagos

Stripe · Tarjeta · OXXO

🔔

Notificaciones

Firebase FCM · Pusher

Flujo General de Comunicacion

Usuario

📱 App Movil

React Native

→

HTTP

Axios + JWT

Bearer Token

→

API

occrproductos.com.mx/api

REST Endpoints

→

Logica

Laravel Controllers

Validacion + Negocio

→

Datos

MySQL

Eloquent ORM

🔐

Modulo de Autenticacion

Registro, inicio de sesion, recuperacion de contrasena y acceso como invitado

🔑 Inicio de Sesion (Login)

Pantalla

Login.jsx

Email + Contrasena

→

Endpoint

POST /api/login

{email, password}

→

Controller

AuthenticatedSessionController

Valida credenciales, genera token JWT

→

Modelo

User

Tabla: users

→

Respuesta

{user, token}

Se guarda en AsyncStorage

Post-login: Se configura interceptor Axios con "Authorization: Bearer {token}" para todas las peticiones siguientes. Si el token expira (401), se hace logout automatico.

🔵 Login con Google

Accion

Boton "Google"

Google Sign-In SDK

→

Externo

Google OAuth

Devuelve credential

→

Endpoint

POST /api/auth/google

{credential, email, first_name, last_name, provider: "google"}

→

Logica

WebSiteController

Crea o busca usuario, genera token

→

Resultado

{user, token}

Acceso inmediato

🍎 Login con Apple

Accion

Boton "Apple"

Apple Authentication SDK

→

Externo

Apple Sign-In

Devuelve identity_token + user_id

→

Endpoint

POST /api/auth/apple

{identity_token, user_id, email?}

→

Logica

WebSiteController

Valida token, crea/busca usuario

→

Resultado

{user, token}

Email puede ser "relay" de Apple

Nota: Apple puede ocultar el email real del usuario. El sistema detecta esto y marca el email como tipo "proxy".

📝 Registro de Usuario

Pantalla

Signup.jsx

Nombre, email, contrasena, telefono, fecha nacimiento

→

Validacion

Formik + Yup

Email valido, contrasena min 8 chars, telefono mexicano 10 digitos

→

Endpoint

POST /api/register

{name, email, password, phone, dob, usertype:"User"}

→

Controller

RegisteredUserController

Crea usuario, envia email bienvenida, genera token

→

Modelo

User (nuevo registro)

+ migracion de carrito invitado

Post-registro: Si el usuario tenia un carrito como invitado, los productos se migran a su nueva cuenta (combinando cantidades de productos duplicados).

👤 Acceso como Invitado

Accion

"Continuar sin cuenta"

Se pide solo email

→

Estado

AuthContext

loginAsGuest(email) — sin token JWT

→

Resultado

Navegacion completa

Carrito, compra, historial — todo por email

Capacidades del invitado: puede navegar catalogo, agregar al carrito, hacer pedidos, ver historial de pedidos, y guardar una direccion. Todo se identifica por email.

🔄 Recuperacion de Contrasena

Pantalla

ForgotPassword.jsx

Ingresa email

→

Endpoint

POST /api/forgetpasswordlink

{email}

→

Logica

PasswordResetLinkController

Envia link de reset por email (SMTP Hostinger)

→

Resultado

Email enviado

Link abre formulario web de reset

🛍️

Modulo de Catalogo

Categorias, productos, busqueda y detalle de producto

📂 Listado de Categorias

Pantalla

CategoriesList.jsx

Pantalla principal / Home

→

Endpoint

GET /api/productscats

Sin parametros

→

Controller

ControllsController

getInverterscats() — consulta Modules

→

Modelo

Modules

Tabla: modules (name, photo, description)

→

Resultado

Grid de categorias

Imagen + nombre por categoria

📦 Productos por Categoria

Pantalla

SpecificCategoryProduct.jsx

Tap en una categoria

→

Endpoint

GET /api/products/{category}

category = nombre de la categoria

→

Controller

ControllsController

getInverters() — filtra por module_id

→

Modelo

Inverters + ProductImage

Tabla: inverters con imagenes

→

Resultado

Grid 2 columnas

Nombre, precio, descuento, foto, unidad

🔍 Busqueda de Productos

Pantalla

SearchResults.jsx

Barra de busqueda en Home

→

Endpoint

GET /api/products

Trae todos los productos

→

Filtrado

Client-side

Filtra por nombre o categoria que contenga el texto

→

Resultado

Lista filtrada

Misma grid que categoria

🏷️ Detalle de Producto

Pantalla

ProductDetails.jsx

Tap en un producto

→

Datos

Route Params

No hace llamada API — datos ya cargados

→

Muestra

Carrusel imagenes

Nombre, precio, descuento, unidad, descripcion, selector cantidad

Agregar al carrito: El usuario selecciona cantidad y toca "Agregar". Esto actualiza el CartContext localmente y luego sincroniza con el backend.

🛒

Modulo de Carrito

Gestion del carrito de compras, persistencia y sincronizacion

🛒 Gestion del Carrito

Accion

Agregar/Quitar producto

Desde ProductDetails o Cart

→

Estado

CartContext

Actualizacion inmediata en memoria

→

Sync (500ms)

POST /api/cart/save

{user_id o email, cart_data: [items]}

→

Controller

CartController

saveCart() — guarda JSON en users.cart_data

→

Almacen

users.cart_data (JSON)

O guest_addresses.cart_data para invitados

Operacion	Metodo	Endpoint	Descripcion
Guardar	POST	/api/cart/save	Sincroniza carrito con backend (debounce 500ms)
Cargar	POST	/api/cart/get	Recupera carrito al iniciar sesion
Limpiar	POST	/api/cart/clear	Vacia el carrito tras compra exitosa
Migrar	POST	/api/cart/migrate	Fusiona carrito de invitado a usuario registrado
Actividad	POST	/api/cart-activity	Registra actividad para expiracion 24h

Expiracion: Los carritos expiran automaticamente despues de 24 horas de inactividad. Un cron job ejecuta la limpieza periodicamente.

💰 Calculo de Precios

Concepto	Formula
Subtotal bruto	Suma (precio x cantidad) por cada producto
Descuento por producto	Suma (descuento x cantidad) — descuentos individuales
Subtotal neto	Subtotal bruto - descuentos de producto
Descuento promocional	Subtotal neto x (promotional_discount / 100)
Cupon (si aplica)	Porcentaje o monto fijo sobre total o envio
Costo de envio	Gratis si subtotal >= umbral, o tarifa fija
Total final	Subtotal - promos - cupon + envio

💳

Modulo de Pago y Pedido

Proceso completo de checkout: direccion, fecha, pago y confirmacion

🔄 Flujo Completo de Checkout

El proceso de compra sigue estos pasos en orden:

1

Revisar Carrito

Productos, cantidades y precios

2

Seleccionar Direccion

De las guardadas o nueva

3

Fecha y Horario

Dia y franja horaria de entrega

4

Cupon (opcional)

Codigo de descuento

5

Pagar con Stripe

Tarjeta o OXXO

6

Confirmacion

Pedido creado exitosamente

💳 Procesamiento de Pago (Stripe)

Accion

Tap "Pagar"

Cart.jsx

→

Paso 1

POST /api/create-payment-intent

{user_id, amount, currency:"MXN"}

→

Stripe API

PaymentIntent creado

Devuelve client_secret

→

Paso 2

Payment Sheet

SDK Stripe muestra formulario de tarjeta

→

Confirmacion

Pago exitoso

Se procede a crear el pedido

Webhook: Stripe envia confirmacion a POST /api/stripe/webhook → ControllsController@handle valida la firma y actualiza el payment_status del pedido a "paid".

📋 Creacion del Pedido

Datos

Cart.jsx recopila todo

Items + direccion + fecha + pago

→

Endpoint

POST /api/ordersubmit

{user_id, cart_items, subtotal, total, shipping_cost, delivery_date, delivery_slot, address, phone, coupon_code, payment_intent_id, need_invoice}

→

Controller

RegisteredUserController@orderSubs

Valida cupon en backend, calcula totales, crea Order + OrderDetails

→

Modelos

Order + Ordedetail

order_number: #YYMMDD-XXXXXX

→

Resultado

{order_id, status:"Open"}

+ notificacion push al admin + email confirmacion

Validacion Backend	Descripcion
Cupon	Re-valida en el servidor (previene manipulacion desde frontend)
Precios	Recalcula totales con precios del catalogo actual
Stock	Verifica disponibilidad
Duplicados	Previene incremento doble de uso de cupon por webhook

📦

Modulo de Pedidos

Historial, detalle, estados y seguimiento de pedidos

📊 Estados del Pedido

⏳ Processing Payment→📋 Open→🔧 Pending→🚚 On the Way→✅ Delivered

❌ Cancelled— puede ocurrir en cualquier punto antes de "Delivered"

📜 Historial de Pedidos

Pantalla

Order.jsx

Tab "Pedidos" en navegacion

→

Endpoint

GET /api/orderhistory/{userId}

O /api/guest/orders/{email} para invitados

→

Controller

RegisteredUserController

orderHistory() — ordena por fecha desc

→

Vista

Tabs: Activas | Entregadas | Canceladas

Auto-refresh cada 15s (5s para drivers)

📄 Detalle del Pedido

Pantalla

OrderDetail.jsx

Tap en un pedido

→

Datos

Via Route Params

Datos del pedido ya cargados

→

Muestra

Desglose completo

Productos, precios, direccion, fecha, estado, factura

Acciones disponibles: Ver factura (PDF), enviar comentario/queja, chat con repartidor, seguimiento en mapa.

🚚

Modulo de Entregas

Configuracion de entregas, seguimiento y repartidores

📅 Seleccion de Fecha y Horario

Componente

DeliverySlotPicker.jsx

Dentro de Cart.jsx

→

Endpoint

GET /api/delivery-days

Calcula dias disponibles segun configuracion

→

Modelos

DeliveryDay + DeliveryTimeSlot

Dias activos + franjas horarias no vencidas

→

Resultado

Max 4 fechas futuras

Cada una con sus horarios disponibles

📦 Costo de Envio

Consulta

Cart.jsx

Al cargar el carrito

→

Endpoint

GET /api/shipping-config

Configuracion de envio

→

Modelo

ShippingConfig

min_order_for_free_shipping, standard_shipping_fee

→

Logica

Gratis si subtotal >= umbral

O tarifa estandar si es menor

Motivacion: GET /api/shipping-motivation/{subtotal} devuelve cuanto falta para envio gratis (ej: "Agrega $50 mas para envio gratis").

📍 Seguimiento de Repartidor

Pantallas

DriverTracking / CustomerTracking

Vista del repartidor y del cliente

→

WebSocket

WS order.{orderId}

Canal Pusher en tiempo real

→

Envio ubicacion

POST /api/driverlocsubmit

{orderid, driver_lat, driver_long}

→

Modelo

Driverloc

Tabla: driverlocs

👤

Modulo de Perfil

Datos personales, contrasena y configuracion de cuenta

👤 Gestion del Perfil

Accion	Metodo	Endpoint	Datos
Ver perfil	GET	/api/userdetails/{userId}	nombre, email, telefono, direccion, cumpleanos
Actualizar perfil	POST	/api/updateuserprofile	{userid, first_name, last_name, phone, dob}
Cambiar contrasena	POST	/api/updateusepassword	{userid, current_password, new_password}
Eliminar cuenta	POST	/api/deleteuser	{userid} — marca user_was_deleted, conserva historial
Verificar email	POST	/api/check-email-exists	{email} — verifica si ya existe

Eliminacion segura: Al eliminar una cuenta, el sistema conserva el historial de pedidos (user_was_deleted=true) y limpia datos sensibles. Las ordenes quedan vinculadas por email.

📍

Modulo de Direcciones

Gestion de direcciones para usuarios registrados e invitados

📍 Sistema de Direcciones

👤 Usuarios Registrados

Maximo 3 direcciones
Una puede ser "principal"
Modelo: UserAddress
Tabla: user_addresses

👻 Invitados

1 direccion por email
Persistente entre sesiones
Modelo: GuestAddress
Tabla: guest_addresses

Accion	Metodo	Endpoint (Registrados)	Endpoint (Invitados)
Listar	GET	/api/user/{userId}/addresses	/api/guest/address/{email}
Crear	POST	/api/user/addresses	/api/guest/address
Editar	PUT	/api/user/addresses/{id}	/api/guest/address (sobreescribe)
Eliminar	DELETE	/api/user/addresses/{id}	N/A
Marcar principal	POST	/api/user/addresses/{id}/primary	N/A

Formulario: AddressFormUberStyle.jsx — campos estructurados (calle, numero, colonia, CP, municipio/alcaldia, estado). Incluye validacion de codigo postal mexicano y geocodificacion con Google Maps para obtener coordenadas.

🎁

Modulo de Promociones y Cupones

Descuentos automaticos, cupones manuales y beneficios especiales

🎟️ Sistema de Cupones

Componente

CouponInput.jsx

Campo en el carrito

→

Endpoint

POST /api/validate-coupon

{coupon_code, subtotal, shipping_cost, user_email}

→

Validaciones

ControllsController

Codigo valido, no expirado, monto minimo, usos disponibles

→

Modelo

Proposalbattery

is_coupon=true, max_uses, current_uses

→

Resultado

Descuento aplicado

% o monto fijo, sobre total o envio

🎁 Promociones Automaticas

Trigger

CartContext

Se consultan al cargar carrito (600ms debounce)

→

Endpoint

POST /api/get-automatic-promotions

{subtotal, user_email}

→

Filtrado

Por tipo de usuario

Verifica elegibilidad segun perfil

→

Resultado

Descuento aplicado automaticamente

Sin codigo necesario

Tipo	Aplica a	Condicion
Global	Todos los usuarios	Dentro de fechas vigentes
Individual	Usuario especifico	Asignado por admin
Birthday	Usuario en mes de cumpleanos	DOB coincide con mes actual
Guest	Solo invitados	Usuario no registrado
Google	Usuarios de Google OAuth	provider = "google"
Apple	Usuarios de Apple Sign-In	provider = "apple"
Normal	Usuarios sin OAuth	Registro directo con email

🔔

Modulo de Notificaciones

Push notifications, emails y comunicacion con el usuario

🔔 Notificaciones Push (Firebase FCM)

Trigger

Evento en backend

Pago, cambio de estado, chat, etc.

→

Servicio

FirebaseNotificationService

sendToDevice / sendOrderStatusNotification

→

Firebase

FCM Cloud

Enruta al dispositivo correcto

→

Dispositivo

NotificationService.js

Muestra push notification / in-app

Notificaciones al Cliente

Evento	Titulo	Mensaje	Trigger
Pago confirmado	🎉 ¡Pedido Confirmado!	Tu pedido #N esta listo. Pago de $X recibido.	Stripe webhook: payment_intent.succeeded
Pago fallido	💳 Problema con el pago	El pago de tu pedido #N no pudo procesarse. Intenta de nuevo.	Stripe webhook: payment_intent.payment_failed
Pago OXXO pendiente	📋 ¡Pedido confirmado! Pago pendiente	Tu pedido #N ha sido confirmado. Ve a OXXO a completar tu pago.	Stripe webhook: requires_action
Pedido gratuito	🎉 ¡Pedido Confirmado!	Tu pedido #N ha sido confirmado. ¡Disfruta tu compra gratuita!	Admin crea pedido gratuito
Preparando pedido	👨‍🍳 Preparando tu Pedido	Estamos preparando tu pedido #N con mucho carino.	Admin cambia status a "preparing"
Pedido listo	📦 Pedido Listo	Tu pedido #N esta listo y esperando al repartidor.	Admin cambia status a "ready"
Repartidor asignado	🛵 Repartidor Asignado	{nombre} llevara tu pedido #N.	Repartidor inicia ruta
En camino	🚗 ¡En Camino!	¡Tu pedido esta en camino! {nombre} lo esta llevando. Total: $X 🚚	Repartidor envia primera ubicacion
Llegando	📍 ¡Tu pedido esta llegando!	Tu repartidor esta a solo {X} metros de tu ubicacion. ¡Preparate!	Repartidor a menos de 500m
Entregado	🎉 ¡Entregado!	¡Pedido entregado exitosamente! Total: $X - ¡Esperamos que lo disfrutes! 🎉	Repartidor marca como entregado
Problema con pedido	⚠️ Problema con tu pedido	El repartidor tuvo un problema y no pudo completar la entrega.	Repartidor cancela/rechaza entrega
Mensaje de chat	💬 Mensaje del Repartidor	{nombre}: {mensaje} (primeros 60 caracteres)	Repartidor envia mensaje en chat

Notificaciones al Repartidor

Evento	Titulo	Mensaje	Trigger
Nuevo pedido asignado	📦 Nuevo Pedido	¡Tienes un nuevo pedido! #N. Revisa los detalles.	Admin asigna repartidor al pedido
Pedido cancelado por cliente	❌ Pedido cancelado	El cliente ha cancelado el pedido #N.	Cliente cancela pedido activo
Mensaje de chat	💬 Nuevo Mensaje	{nombre}: {mensaje} (primeros 60 caracteres)	Cliente envia mensaje en chat

Notificaciones al Admin

Evento	Titulo	Mensaje	Trigger
Repartidor rechaza pedido	⚠️ Pedido #N Rechazado	{nombre} rechazo el pedido. Razon: {razon}	Repartidor rechaza pedido asignado

Soporte para invitados: Los usuarios invitados tambien reciben push notifications mediante su fcm_token almacenado en GuestAddress. El token se valida con session_id para garantizar entrega al dispositivo correcto.

💬 Notificaciones por WhatsApp (Admin)

Trigger

Evento en backend

Pedido nuevo, cancelacion, feedback

→

Servicio

WhatsAppService

sendTemplate() / sendMessage()

→

Business API (Meta)

Templates pre-aprobados

→

Destino

Telefono del Admin

Numero configurado en .env

Template	Evento	Parametros	Destinatario
`admin_nuevo_pedido`	Nuevo pedido creado	Numero de orden, nombre cliente, total, fecha y hora de entrega, direccion, RFC/factura	Admin
`_admin_pedido_cancelado`	Pedido cancelado	Numero de orden, nombre cliente, cancelado por, razon, total	Admin
`admin_nuevo_feedback`	Cliente envia feedback	Nombre del cliente, email, mensaje (max 100 chars)	Admin
`otp_verification`	Verificacion de telefono	Codigo OTP de 6 digitos	Cliente
Texto plano	Repartidor rechaza pedido	Numero de orden, nombre repartidor, razon del rechazo	Admin

Configuracion: Los numeros de WhatsApp del admin se configuran en notifications.admin.whatsapp. El sistema verifica credenciales de la API antes de enviar. Si WhatsApp no esta disponible, se usan canales alternativos (email + SMS).

📧 Notificaciones por Email

Email	Trigger	Destinatario
Bienvenida	Nuevo registro	Usuario
Confirmacion de pedido	Pedido creado	Usuario
Nuevo pedido (admin)	Pedido creado	Admin
Pedido entregado	Status = Delivered	Usuario
Pedido cancelado	Status = Cancelled	Usuario
Reset de contrasena	Solicitud de reset	Usuario
OTP verificacion	Registro / verificacion	Usuario

Proveedor: SMTP via Hostinger. El sistema detecta si el email del usuario es real, proxy (Apple) o generado, y ajusta la estrategia de comunicacion.

📱 Verificacion SMS / OTP

Endpoint	Metodo	Servicio	Descripcion
/api/otp/send	POST	Email	Envia codigo OTP por correo
/api/otp/verify	POST	Email	Verifica codigo OTP
/api/sms/send	POST	AWS SNS / WhatsApp	Envia OTP por SMS o WhatsApp segun config
/api/sms/verify	POST	AWS SNS / WhatsApp	Verifica codigo SMS o WhatsApp
/api/guest/email/send-otp	POST	Email	OTP para verificar email de invitado

⚡

Comunicacion en Tiempo Real

WebSockets (Pusher), canales y eventos en vivo

⚡ Canales WebSocket (Pusher)

Canal	Evento	Datos	Uso
`order.{orderId}`	status	Nuevo estado del pedido	Actualizar badge y lista de pedidos
`order.{orderId}`	location	{driver_lat, driver_long}	Mover pin del repartidor en mapa
`order.{orderId}`	chat	{sender, message, timestamp}	Mensajes entre cliente y repartidor
`user.{userId}.orders`	update	Lista de pedidos actualizada	Refrescar automaticamente lista de pedidos
`guest.{emailHash}.orders`	update	Lista de pedidos del invitado	Refrescar pedidos del invitado
`user.{userId}`	account_deleted	Senal de cuenta eliminada	Forzar logout en todos los dispositivos

Fallback: Si la conexion WebSocket falla, el sistema cae a polling HTTP (cada 15s para usuarios, 5s para repartidores).

💬 Chat de Pedido

Pantalla

Chat.jsx

Dentro de OrderDetail

→

Enviar

POST /api/msgsubmit

{orderid, sender, message}

→

Modelo

Communicationord

Tabla: communicationords

→

Broadcast

Pusher → chat.{orderId}

Mensaje llega en tiempo real

⚙️

Panel de Administracion (Web)

Dashboard, gestion de productos, pedidos, usuarios y configuracion

📊 Modulos del Panel Admin

📊

Dashboard

Resumen diario, metricas, exportacion

📦

Productos

CRUD completo + imagenes multiples

📂

Categorias

CRUD de modulos/categorias

📋

Pedidos

Ver, filtrar, cambiar estado, exportar

👥

Usuarios

Clientes, repartidores, staff

🎁

Promociones

Cupones y promos automaticas

🚚

Entregas

Dias, horarios, costo de envio

📸

Instagram

Feed manual + URLs

📊

Inventario

Stock y logs de actividad

🗄️

Modelos de Base de Datos

Tablas principales, campos y relaciones entre modelos

👤 User (users)

id, first_name, last_name, emailstring

password, usertypestring/enum

phone, dob, addressstring/date

provider, apple_idOAuth info

fcm_token, session_idpush/session

cart_data, cart_updated_atJSON/datetime

promotion_id, promotional_discountint/decimal

email_type, has_real_emailenum/bool

→ hasMany: UserAddress, Order

📦 Order (orders)

userid, order_number, ordernoint/string

status, status_spanishenum

delivery_date, delivery_slotdate/string

delivery_address, customer_lat/longstring/decimal

subtotal, shipping_cost, total_amountdecimal

payment_status, payment_idenum/string

coupon_code, discount_amountstring/decimal

dman (driver ID)int

→ belongsTo: User | → hasMany: Ordedetail

📝 Ordedetail (ordedetails)

userid, ordernoint/string

item_name, item_pricestring/decimal

item_qty, item_imageint/string

→ belongsTo: Order

🏷️ Inverters / Productos (inverters)

name, unit, quantity, stockstring/int

module_id (categoria FK)int

price, discount, costdecimal

photo, descriptionstring/text

→ belongsTo: Modules | → hasMany: ProductImage

📂 Modules / Categorias (modules)

name, photo, descriptionstring

→ hasMany: Inverters (productos)

🎁 Proposalbattery (proposalbatteries)

name, coupon_codestring

discount, discount_typedecimal/enum

from, to (rango fechas)date

type, is_coupon, applies_toenum/bool

max_uses, current_usesint

minimum_amount, benefitsdecimal/JSON

📍 UserAddress (user_addresses)

user_id, addressint/string

latitude, longitudedecimal:8

phone, label, is_primarystring/bool

→ belongsTo: User (max 3 por usuario)

👻 GuestAddress (guest_addresses)

guest_email (unique)string

address, latitude, longitudestring/decimal

phone, fcm_tokenstring

cart_data, delivery_infoJSON

1 direccion por email de invitado

☁️

Servicios Externos

Integraciones con terceros y servicios en la nube

Mapa de Integraciones

Servicio	Proposito	Conexion	Datos que fluyen
💳 Stripe	Procesamiento de pagos	API REST + Webhook	Montos en MXN, payment intents, confirmaciones. Soporta tarjeta y OXXO.
🔥 Firebase (FCM)	Push notifications	Firebase Admin SDK	Tokens FCM, titulos, cuerpos de notificacion, datos extras
📡 Pusher	WebSockets en tiempo real	Pusher SDK	Eventos de estado, ubicacion de driver, mensajes de chat
☁️ AWS Lambda	Hosting serverless del backend	Serverless Framework	Toda la API Laravel corre como funcion Lambda
📦 AWS S3	Almacenamiento de archivos	AWS SDK	Imagenes de productos, fotos de perfil, facturas
🌐 AWS CloudFront	CDN para archivos estaticos	Distribucion CDN	URLs de imagenes transformadas a CDN
📱 AWS SNS	SMS / OTP	AWS SNS API	Codigos OTP a numeros de telefono (formato E.164)
🔵 Google OAuth	Autenticacion social	OAuth 2.0	Credenciales, email, nombre del usuario
🍎 Apple Sign-In	Autenticacion social (iOS)	Apple JWT	Identity token, user ID, email (puede ser relay)
📧 Hostinger SMTP	Envio de emails	SMTP	Correos transaccionales (confirmaciones, OTP, resets)
🗺️ Google Maps	Geocodificacion	Geocoding API	Direccion texto a coordenadas lat/long

📡

Referencia Completa de Endpoints

Todos los endpoints de la API organizados por modulo

Endpoints usados por la App Movil

Modulo	Metodo	Endpoint	Controlador	Descripcion
Auth	POST	/api/login	AuthenticatedSessionController	Iniciar sesion
Auth	POST	/api/register	RegisteredUserController	Registro de usuario
Auth	POST	/api/auth/google	WebSiteController	Login con Google
Auth	POST	/api/auth/apple	WebSiteController	Login con Apple
Auth	POST	/api/forgetpasswordlink	PasswordResetLinkController	Enviar link de reset
Catalogo	GET	/api/products/{category?}	ControllsController	Productos por categoria
Catalogo	GET	/api/productscats	ControllsController	Listar categorias
Carrito	POST	/api/cart/save	CartController	Guardar carrito
Carrito	POST	/api/cart/get	CartController	Recuperar carrito
Carrito	POST	/api/cart/clear	CartController	Limpiar carrito
Carrito	POST	/api/cart/migrate	CartController	Migrar carrito invitado a usuario
Carrito	POST	/api/cart-activity	ControllsController	Registrar actividad del carrito
Pedidos	POST	/api/ordersubmit	RegisteredUserController	Crear pedido
Pedidos	GET	/api/orderhistory/{userid}	RegisteredUserController	Historial de pedidos
Pedidos	GET	/api/orderdetails/{orderid}	RegisteredUserController	Detalle de pedido
Pedidos	POST	/api/orderdel	RegisteredUserController	Marcar como entregado
Pedidos	POST	/api/orders/cancel	ControllsController	Cancelar pedido
Pedidos	POST	/api/migrateorders	RegisteredUserController	Migrar pedidos de invitado
Invitados	GET	/api/guest/orders/{email}	RegisteredUserController	Pedidos de invitado
Invitados	POST	/api/guest/address	RegisteredUserController	Guardar direccion invitado
Invitados	GET	/api/guest/address/{email}	RegisteredUserController	Obtener direccion invitado
Pagos	POST	/api/create-payment-intent	ControllsController	Crear intento de pago Stripe
Direcciones	GET	/api/user/{userId}/addresses	RegisteredUserController	Listar direcciones
Direcciones	POST	/api/user/addresses	RegisteredUserController	Agregar direccion (max 3)
Direcciones	PUT	/api/user/addresses/{id}	RegisteredUserController	Editar direccion
Direcciones	DELETE	/api/user/addresses/{id}	RegisteredUserController	Eliminar direccion
Direcciones	POST	/api/user/addresses/{id}/primary	RegisteredUserController	Marcar como principal
Direcciones	POST	/api/addaddress	RegisteredUserController	Agregar direccion (legacy)
Direcciones	GET	/api/fetch_address/{id}	RegisteredUserController	Obtener direcciones (legacy)
Direcciones	GET	/api/fetch_address_single_edit/{id}	RegisteredUserController	Obtener direccion para editar (legacy)
Direcciones	POST	/api/updateaddress	RegisteredUserController	Actualizar direccion (legacy)
Direcciones	POST	/api/deleteaddress	RegisteredUserController	Eliminar direccion (legacy)
Entregas	GET	/api/delivery-days	ControllsController	Dias de entrega disponibles
Entregas	GET	/api/fetch_ddates/{ddate}	ControllsController	Horarios disponibles por fecha
Entregas	GET	/api/shipping-config	ControllsController	Configuracion de envio
Entregas	GET	/api/shipping-motivation/{subtotal}	ControllsController	Monto para envio gratis
Entregas	POST	/api/delivery-info/save	RegisteredUserController	Guardar info de entrega
Entregas	POST	/api/delivery-info/get	RegisteredUserController	Obtener info de entrega
Promos	POST	/api/validate-coupon	ControllsController	Validar cupon
Promos	POST	/api/get-automatic-promotions	ControllsController	Promociones automaticas
Perfil	GET	/api/userdetails/{userid}	RegisteredUserController	Datos del usuario
Perfil	POST	/api/updateuserprofile	RegisteredUserController	Actualizar perfil
Perfil	POST	/api/updateusepassword	PasswordController	Cambiar contrasena
Perfil	POST	/api/deleteuser	RegisteredUserController	Eliminar cuenta
Perfil	POST	/api/check-email-exists	RegisteredUserController	Verificar email existente
OTP	POST	/api/otp/send	OTPController	Enviar OTP por email
OTP	POST	/api/otp/verify	OTPController	Verificar OTP
OTP	POST	/api/guest/email/send-otp	OTPController	OTP para invitado
OTP	POST	/api/guest/email/verify-otp	OTPController	Verificar OTP invitado
SMS	POST	/api/sms/send	SMSVerificationController	Enviar OTP por SMS
SMS	POST	/api/sms/verify	SMSVerificationController	Verificar SMS OTP
SMS	POST	/api/sms/resend	SMSVerificationController	Reenviar SMS OTP
SMS	GET	/api/sms/status	SMSVerificationController	Estado de verificacion SMS
Notif.	POST	/api/update-fcm-token	RegisteredUserController	Actualizar token FCM
Notif.	POST	/api/remove-fcm-token	ControllsController	Remover token FCM
Driver	POST	/api/driverlocsubmit	RegisteredUserController	Enviar ubicacion del repartidor
Driver	GET	/api/driverlocationsagainstorder/{id}	RegisteredUserController	Ubicaciones del repartidor
Driver	GET	/api/orderhistorydriver/{userid}	RegisteredUserController	Pedidos del repartidor
Driver	POST	/api/driver/reject-order	RegisteredUserController	Rechazar pedido
Chat	POST	/api/msgsubmit	RegisteredUserController	Enviar mensaje
Chat	GET	/api/msgfetch/{orderid}	RegisteredUserController	Obtener mensajes
Feedback	POST	/api/compsubmit	RegisteredUserController	Enviar comentario/queja
App	GET	/api/app-version	AppController	Verificar version de la app
Instagram	GET	/api/instagram-feed	InstagramController	Feed de Instagram

🔧 Endpoints de servidor (webhooks, cron jobs, admin)

Estos endpoints NO son llamados por la app movil. Son usados internamente por el servidor, servicios externos, o el panel de administracion web.

Tipo	Endpoint	Descripcion
WEBHOOK	POST /api/stripe/webhook	Stripe envia confirmacion de pago (server-to-server)
WEBHOOK	POST /api/webhooks/apple	Apple envia eventos de cuenta (server-to-server)
CRON	POST /api/cart-cleanup	Limpia carritos expirados (cada 30 min)
CRON	POST /api/cleanup-temp-orders	Elimina pedidos abandonados >2h (cada 30 min)
ADMIN	POST /api/orders/mark-as-free	Marcar pedido como gratis (100% cupon)
ADMIN	GET /api/settings/otp-status	Ver si OTP esta habilitado
ADMIN	POST /api/settings/toggle-otp	Activar/desactivar OTP
ADMIN	POST /api/instagram/*	CRUD de posts de Instagram (admin panel)