# 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*
