rckrdmrd
928eb795e6
- 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>
174 lines
4.3 KiB
Markdown
174 lines
4.3 KiB
Markdown
# 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
|