rckrdmrd 928eb795e6 [SIMCO-V38] feat: Actualizar a SIMCO v3.8.0 + cambios apps

- HERENCIA-SIMCO.md actualizado con directivas v3.7 y v3.8
- Cambios en backend y frontend

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-01-10 08:53:05 -06:00

4.3 KiB

Raw Blame History

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

Catalogos de productos por proveedor
Templates por giro de negocio
Precios sugeridos actualizados
Imagenes de productos
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

// 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

500+ productos en templates
Imagenes de alta calidad
Barcodes correctos y verificados
Precios actualizados (2026)
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

4.3 KiB Raw Blame History