rckrdmrd/erp-suite
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
f34aadef41
erp-suite/apps/products/pos-micro/README.md

3.5 KiB
Raw Blame History

POS Micro - Punto de Venta Ultra Básico

Descripción

Sistema de punto de venta minimalista diseñado para el mercado informal mexicano. Enfocado en simplicidad extrema, bajo costo y funcionalidad offline.

Target de Mercado

  • Puestos de calle y ambulantes
  • Tiendas de abarrotes y misceláneas
  • Puestos de comida (tacos, tortas, etc.)
  • Pequeños locales comerciales
  • Vendedores independientes

Precio

~100 MXN/mes + consumo de IA (opcional)

Características

Incluidas en Plan Base (100 MXN/mes)

Característica Descripción
Punto de Venta Registrar ventas, calcular cambio
Catálogo Lista de productos con precios
Inventario Básico Control de stock simple
Corte de Caja Resumen diario
Reportes Ventas día/semana/mes
PWA Offline Funciona sin internet
1 Usuario Operador principal

Opcionales (Por Consumo)

Característica Costo
WhatsApp Bot ~0.02 USD por consulta
Usuario adicional +30 MXN/mes
Soporte prioritario +50 MXN/mes

Stack Tecnológico

  • Backend: Node.js + Express + TypeScript
  • Frontend: React + PWA + Tailwind CSS
  • Database: PostgreSQL (compartida multi-tenant)
  • WhatsApp: WhatsApp Business API
  • IA: Claude API (para bot)

Arquitectura

pos-micro/
├── backend/          # API mínima
├── frontend/         # SPA React
├── pwa/              # Service Worker + Offline
├── database/         # ~10 tablas
├── whatsapp/         # Integración WA Business
├── docs/             # Documentación
└── orchestration/    # Sistema NEXUS

Base de Datos (~10 tablas)

  1. tenants - Empresas/negocios
  2. users - Usuarios del sistema
  3. products - Catálogo de productos
  4. sales - Ventas registradas
  5. sale_items - Detalle de ventas
  6. inventory_movements - Movimientos de inventario
  7. daily_closures - Cortes de caja
  8. whatsapp_sessions - Sesiones WA
  9. ai_usage - Consumo de tokens IA
  10. subscriptions - Suscripciones y pagos

Flujo de Usuario

Registro

  1. Usuario accede a landing page
  2. Ingresa número de WhatsApp
  3. Recibe código de verificación
  4. Configura nombre del negocio
  5. Agrega primeros productos
  6. Listo para vender

Venta Típica

  1. Abrir PWA (funciona offline)
  2. Seleccionar productos
  3. Ver total automático
  4. Registrar pago (efectivo/tarjeta)
  5. Calcular cambio
  6. Venta registrada

Consulta por WhatsApp

Usuario: "ventas de hoy"
Bot: "Ventas hoy: $1,250 MXN (15 tickets)
      Producto más vendido: Coca Cola 600ml (23 unidades)"

Usuario: "stock de sabritas"
Bot: "Sabritas Original: 12 unidades
      Sabritas Adobadas: 8 unidades
      Sabritas Limón: 15 unidades"

Principios de Diseño

  1. Simplicidad extrema - Máximo 3 clicks para cualquier acción
  2. Mobile-first - Diseñado para celulares
  3. Offline-first - Funciona sin internet
  4. Bajo costo - Infraestructura mínima
  5. Sin fricción - Onboarding en 5 minutos

Limitaciones (Por diseño)

  • Máximo 500 productos
  • Máximo 1,000 ventas/mes en plan base
  • Sin facturación electrónica (CFDI)
  • Sin contabilidad
  • Sin multi-sucursal
  • Sin CRM avanzado

Herencia del Core

Este producto hereda de erp-core:

  • Sistema de autenticación básico
  • Multi-tenancy (RLS)
  • Estructura de proyectos

NO hereda (por simplicidad):

  • Módulos financieros
  • RRHH
  • CRM completo
  • Reportes avanzados

Producto: POS Micro v1.0 Precio Target: 100 MXN/mes Mercado: Informal mexicano