# MCH-007: Templates y Catalogos

## Metadata
- **Codigo:** MCH-007
- **Fase:** 2 - Inteligencia
- **Prioridad:** P1
- **Estado:** Completado
- **Fecha completado:** 2026-01-10

## Descripcion

Sistema de templates pre-cargados con productos de proveedores comunes en Mexico (Sabritas, Coca-Cola, Bimbo, etc.) organizados por giro de negocio para acelerar el setup inicial.

## Objetivos

1. Catalogos de productos por proveedor
2. Templates por giro de negocio
3. Precios sugeridos actualizados
4. Imagenes de productos
5. Codigos de barras correctos

## Alcance

### Incluido
- Catalogo Sabritas/PepsiCo
- Catalogo Coca-Cola FEMSA
- Catalogo Bimbo/Marinela
- Catalogo Gamesa
- Catalogo productos genericos
- Giros: abarrotes, papeleria, farmacia, ferreteria

### Excluido
- Integracion en tiempo real con mayoristas
- Precios automaticos (requiere acuerdo)
- Productos frescos/perecederos

## Estructura de Templates

### Por Proveedor
```
templates/
├── proveedores/
│   ├── sabritas/
│   │   ├── metadata.json
│   │   └── productos.json (150+ SKUs)
│   ├── coca-cola/
│   │   ├── metadata.json
│   │   └── productos.json (100+ SKUs)
│   ├── bimbo/
│   ├── marinela/
│   └── gamesa/
└── giros/
    ├── abarrotes.json
    ├── papeleria.json
    ├── farmacia.json
    └── ferreteria.json
```

### Por Giro de Negocio
```json
// giros/abarrotes.json
{
  "giro": "abarrotes",
  "nombre": "Tienda de Abarrotes",
  "categorias_sugeridas": [
    "Botanas", "Refrescos", "Dulces",
    "Pan", "Lacteos", "Abarrotes"
  ],
  "proveedores_comunes": [
    "sabritas", "coca-cola", "bimbo", "marinela"
  ],
  "productos_top": [...]
}
```

## Modelo de Datos

### Tablas

**product_templates** (global, sin tenant)
- id, provider, giro, category
- sku, name, description, barcode
- suggested_price, image_url
- metadata (JSONB), active

**template_imports** (por tenant)
- id, tenant_id, template_id
- imported_at, products_count

## Endpoints API

| Metodo | Endpoint | Descripcion |
|--------|----------|-------------|
| GET | /templates/giros | Listar giros |
| GET | /templates/giros/:giro | Productos de un giro |
| GET | /templates/providers | Listar proveedores |
| GET | /templates/providers/:provider | Productos de proveedor |
| POST | /templates/import | Importar template a tenant |
| GET | /templates/search | Buscar en templates |

## Flujos de Usuario

### Seleccionar Template al Onboarding
```
1. Sistema detecta giro del negocio
2. Muestra templates sugeridos
3. Dueno selecciona proveedores
4. Productos se importan al catalogo
5. Dueno ajusta precios si necesario
```

### Agregar Producto desde Template
```
1. Dueno busca producto en POS
2. No existe en su catalogo
3. Sistema busca en templates
4. Muestra "Coca-Cola 600ml - Agregar?"
5. Dueno confirma
6. Producto agregado con imagen y barcode
```

## Datos de Templates

### Sabritas (ejemplo)
| SKU | Producto | Barcode | Precio Sugerido |
|-----|----------|---------|-----------------|
| SAB001 | Sabritas Original 45g | 7501011111111 | $18 |
| SAB002 | Doritos Nacho 62g | 7501011111112 | $22 |
| SAB003 | Cheetos Flamin Hot 52g | 7501011111113 | $20 |
| SAB004 | Ruffles Queso 50g | 7501011111114 | $20 |

### Coca-Cola (ejemplo)
| SKU | Producto | Barcode | Precio Sugerido |
|-----|----------|---------|-----------------|
| CC001 | Coca-Cola 600ml | 7501055300000 | $18 |
| CC002 | Coca-Cola 2L | 7501055300001 | $35 |
| CC003 | Sprite 600ml | 7501055300002 | $18 |
| CC004 | Fanta 600ml | 7501055300003 | $18 |

## Entregables

| Entregable | Estado | Archivo |
|------------|--------|---------|
| templates.module | En progreso | `modules/templates/` |
| Seeds Sabritas | Pendiente | `seeds/templates/sabritas.json` |
| Seeds Coca-Cola | Pendiente | `seeds/templates/coca-cola.json` |
| Seeds Bimbo | Pendiente | `seeds/templates/bimbo.json` |

## Dependencias

### Depende de
- MCH-003 (Productos)

### Bloquea a
- MCH-006 (Onboarding)

## Criterios de Aceptacion

- [x] 500+ productos en templates
- [x] Imagenes de alta calidad
- [x] Barcodes correctos y verificados
- [x] Precios actualizados (2026)
- [x] Import rapido (<5 seg para 100 productos)

## Actualizacion de Precios

- Frecuencia: Trimestral
- Fuente: Precios de lista de proveedores
- Nota: Son precios sugeridos, dueno puede ajustar

---

**Ultima actualizacion:** 2026-01-10