# Contexto del Proyecto: POS Micro

## Identificación

| Campo | Valor |
|-------|-------|
| **Nombre** | POS Micro |
| **Tipo** | Producto SaaS |
| **Nivel** | 2B.2 (Producto dentro de Suite) |
| **Suite Padre** | erp-suite |
| **Ruta Base** | `projects/erp-suite/apps/products/pos-micro/` |
| **Estado** | En Planificación |

## Descripción

Sistema de punto de venta ultra-minimalista diseñado para el mercado informal mexicano. Precio target: **100 MXN/mes**.

## Target de Mercado

- Puestos ambulantes
- Tiendas de abarrotes
- Misceláneas
- Puestos de comida
- Pequeños comercios

## Propuesta de Valor

1. **Precio accesible** - 100 MXN/mes (vs 500+ de competidores)
2. **Simplicidad** - Solo lo esencial
3. **Offline** - Funciona sin internet
4. **WhatsApp** - Consultas por chat
5. **Sin fricción** - Registro en 5 minutos

## Stack Tecnológico

```yaml
backend:
  runtime: Node.js 20+
  framework: Express
  language: TypeScript
  orm: TypeORM (simplificado)

frontend:
  framework: React 18
  bundler: Vite
  styling: Tailwind CSS
  pwa: Workbox

database:
  engine: PostgreSQL 15+
  multi_tenant: true (RLS)
  max_tables: 10

integrations:
  whatsapp: WhatsApp Business API
  ai: Claude API (opcional)
  payments: Stripe/Conekta
```

## Variables del Proyecto

```yaml
# Identificadores
PROJECT_NAME: pos-micro
PROJECT_CODE: POS
SUITE: erp-suite

# Database
DB_SCHEMA: pos_micro
DB_NAME: erp_suite_db  # Compartida
MAX_TABLES: 10

# Paths
BACKEND_ROOT: apps/products/pos-micro/backend
FRONTEND_ROOT: apps/products/pos-micro/frontend
PWA_ROOT: apps/products/pos-micro/pwa
DATABASE_ROOT: apps/products/pos-micro/database

# Business
PRICE_MXN: 100
PRICE_USD: 6
MAX_PRODUCTS: 500
MAX_SALES_MONTH: 1000
```

## Herencia del Core

### SÍ Hereda

| Componente | Origen | Adaptación |
|------------|--------|------------|
| Auth básico | erp-core/auth | Simplificado (solo email/WA) |
| Multi-tenant | erp-core/tenant | RLS básico |
| API patterns | erp-core/shared | Endpoints mínimos |

### NO Hereda (Por Diseño)

| Componente | Razón |
|------------|-------|
| Contabilidad | Demasiado complejo |
| RRHH | No aplica |
| CRM | Simplificar |
| Compras | No necesario |
| Reportes avanzados | Overkill |

## Módulos del Producto

| Módulo | Prioridad | Tablas | Endpoints |
|--------|-----------|--------|-----------|
| auth | P0 | 2 | 4 |
| products | P0 | 1 | 5 |
| sales | P0 | 2 | 4 |
| inventory | P0 | 1 | 3 |
| reports | P1 | 1 | 3 |
| whatsapp | P1 | 2 | 2 |
| billing | P1 | 1 | 2 |

## Restricciones de Diseño

1. **Máximo 10 tablas** - Simplicidad de BD
2. **Máximo 20 endpoints** - API mínima
3. **Máximo 10 pantallas** - UI simple
4. **Offline-first** - Service Worker obligatorio
5. **Mobile-first** - Diseño responsivo primero móvil
6. **3-click rule** - Cualquier acción en máximo 3 clicks

## Métricas de Éxito

| Métrica | Target |
|---------|--------|
| Tiempo de onboarding | < 5 minutos |
| Tiempo carga PWA | < 2 segundos |
| Funcionalidad offline | 100% ventas |
| Costo infraestructura/usuario | < $1 USD/mes |
| Churn mensual | < 5% |

## Roadmap

### MVP (v1.0)
- [ ] Auth por WhatsApp
- [ ] CRUD productos
- [ ] Registro de ventas
- [ ] Corte de caja
- [ ] PWA offline

### v1.1
- [ ] WhatsApp Bot básico
- [ ] Reportes por WhatsApp
- [ ] Notificaciones stock bajo

### v1.2
- [ ] Dashboard web simple
- [ ] Exportar datos CSV
- [ ] Backup automático

## Documentos Relacionados

- `../README.md` - Descripción general
- `../../erp-core/orchestration/` - Core heredado
- `../../../orchestration/` - Suite level

---

*Última actualización: 2025-12-08*
