Inventory API
Servicio backend empresarial y nativo en la nube
La Inventory API es la columna vertebral operativa que impulsa una sofisticada plataforma de comercio minorista y mayorista para operaciones de alimentos y bebidas. Integra a la perfección las aplicaciones iOS Retail, iOS Wholesale y Admin en un sistema unificado, sirviendo a múltiples empresas independientes con aislamiento total de inquilinos, seguimiento de inventario en tiempo real y un sofisticado motor de participación del cliente.
aspectos destacados
Arquitectura Multi-Inquilino Lista para Producción
Seguridad a nivel de fila de PostgreSQL aplicada en 35 tablas garantiza el aislamiento completo de datos a nivel de base de datos, no solo en la capa de aplicación. Cada inquilino opera de forma independiente con su propia base de clientes, inventario, precios y límites de velocidad.
Motor Sofisticado de Lealtad y Participación
Un programa de lealtad de 4 niveles (Scoops → Silver → Gold → Diamond) con 12 categorías de logros, bonificaciones de racha con lógica de gracia, 10 tipos de cupones incluyendo cadenas de referidos virales y 5 tipos de promociones con evaluación automática.
Idempotencia y Auditoría de Nivel Bancario
Caché de claves de idempotencia de 24 horas previene cargos duplicados por reintentos móviles. Registros de auditoría persistentes rastrean cada mutación con actor, marca de tiempo y tipo de entidad para cumplimiento y análisis forense.
Stack de Observabilidad Completo
Rastreo distribuido OpenTelemetry, registro JSON estructurado con contexto de inquilino/solicitud, captura de errores Sentry y endpoints de salud, integrados desde el primer día, no añadidos posteriormente.
características
Procesamiento de Pedidos y Pagos
- Ciclo de vida completo del pedido con 8 marcas de tiempo de estado y registro de auditoría
- Integración con Stripe con claves de idempotencia — procesamiento de pagos exactamente una vez
- Operaciones masivas de artículos de pedido con validación atómica
- Flujo de recogida en la acera con anuncios de llegada en tiempo real
- Optimización de rutas de entrega con secuenciación de paradas
Gestión de Inventario y Productos
- Seguimiento de stock en tiempo real en múltiples proveedores y ubicaciones
- Flujo de reabastecimiento masivo con transacciones atómicas todo o nada
- Variantes de productos con precios, SKU e imágenes independientes
- Archivado suave preserva la integridad de transacciones históricas
- Costo por unidad y vinculación de proveedores para análisis de adquisiciones
Participación del Cliente y Lealtad
- Sistema de lealtad de 4 niveles con promoción automática basada en ventanas de puntos de 12 meses
- 12 categorías de logros incluyendo diversidad de categorías, rachas y cumpleaños
- Bonificaciones de racha con lógica de gracia — pierda una semana sin perder el progreso
- 10 tipos de cupones incluyendo cadenas de referidos virales con tokens de compartir
- Motor de promociones con 5 tipos × 3 ámbitos y aplicación automática de la mejor oferta
Seguridad y Cumplimiento
- Autenticación JWT con vencimiento de 30 días y revocación por token
- Seguridad a nivel de fila en 35 tablas — ningún error en la capa de aplicación puede filtrar datos entre inquilinos
- Tres tipos de sesión: Cliente (mayorista), Usuario (minorista), Anónimo (invitado)
- Niveles de limitación de velocidad por inquilino (Gratuito / Estándar / Premium)
- Cobertura OWASP Top 10 incluyendo BOLA, inyección, XSS, mitigaciones CSRF
Operaciones y Experiencia del Desarrollador
- 143 endpoints en 32 módulos de router con documentación OpenAPI
- 349 pruebas automatizadas en categorías unitarias, de integración y de humo
- ~98% de cobertura de sugerencias de tipo habilitando análisis estático y refactorización segura
- Script de migración de base de datos idempotente único — completamente re-ejecutable
- Despliegue en Replit Autoscale con soporte de escalado horizontal