01Premisa

Doc 11 detalla qué hace el sistema a nivel granular: qué herramienta específica toma cada decisión · cómo conversan entre sí · qué disparadores activan cada flujo · qué endpoints toca · qué tablas DB · qué UI screen.

02Mapa funcional de herramientas

03Catálogo de herramientas externas (granular)

04Workflows por modo · paso a paso

4.1 · Modo stock propio compra local Chile (Y1 prioridad)

3 canales del mismo modo stock propio:

4.2 · Modo dropshipping (paralelo)

4.3 · Modo Nexport importación (Fase 2 · Y2+)

Same flow que 4.1 más sub-proceso importación previo (ciclo 30-90 días USD). Documentado en Doc 02 BBP P02b.

0524 casos de uso · detalle granular

Cada CU tiene 6 atributos: Trigger · Tools · Endpoint · Tablas · UI screen · Output.

Fase 1 · Reputación Q4-26 (CU-001 → CU-006)

CU-001 · Crear producto en catálogo maestro

CU-002 · Configurar listing MeLi

CU-003 · Primera venta (regalo o costo)

CU-004 · Recibir orden vía webhook (genérico)

CU-005 · Emitir DTE 39 boleta

CU-006 · Tracker reputación · 10 ventas verdes

Fase 2 · Escala MeLi Q1-27 (CU-007 → CU-012)

CU-007 · Configurar Mercado Ads campaign

CU-008 · Monitor ROAS · pausar si <1.5x

CU-009 · Migrar SKU a Full Fulfillment MeLi

CU-010 · Subir a Medalla Plata

CU-011 · Cerebro IA alertas oportunidades

CU-012 · Cerrar Fase 2 (30 órdenes/mes sostenidas)

Fase 3 · Diversificación Q2-27 (CU-013 → CU-018)

CU-013 · Sync diario licitaciones Mercado Público

CU-014 · Cerebro filter + scoring licitaciones

CU-015 · Postular a licitación MP

CU-016 · Webhook adjudicación MP

CU-017 · Cliente B2B envía RFQ

CU-018 · Cierre Fase 3

Threshold: 1+ adjudicación MP + 1+ B2B + MeLi 30+/mes sostenidos.

Fase 4 · Consolidación Q3-27 (CU-019 → CU-024)

CU-019 conciliación pagos vs DTE · CU-020 evaluación Nexport · CU-021 D2C prep · CU-022 setup primer supplier dropship · CU-023 risk review · CU-024 cierre Y1 con break-even.

Detalle por CU sigue mismo formato 6 atributos.

0618 reglas de negocio · ejemplo concreto cada una

Cada BR ahora con implementación específica:

BR-001 · Fotos pro propias siempre
  Implementación:
  · Validation Zod en POST /api/products requiere >= 3 images
  · Cada imagen pasa por detector "is_provider_default" (perceptual hash
    contra base fotos típicas proveedores Chile)
  · Si match > 80% similarity → bloquear publish con error
    "Esta foto es del proveedor · subí foto propia · ver Doc 17 Estrategia Fase 1"

BR-005 · pg_notify cross-canal stock < 1s
  Implementación:
  · Trigger Postgres ON UPDATE OF inventory.stock_real
  · NOTIFY 'inventory_changed' con product_id payload
  · Listener Node.js suscrito · llama channels-sync API por adapter
  · Timeout máx 1s · si excede → alerta CloudWatch

BR-010 · DTE 39 boleta default · 33 si RUT empresa
  Implementación:
  · POST /api/invoices/emit valida campo customer_rut
  · Si rut termina en -K o letra después número → empresa → DTE 33
  · Sino → DTE 39 (boleta persona natural)
  · Edge case: RUT 60-66M (entidades públicas) → DTE 33 forzado

BR-016 · Fallback chain IA · NUNCA Claude
  Implementación:
  · OpenRouter routing con preferences order:
    1. groq/llama-3.3-70b-versatile (primary · rate 12K TPM)
    2. google/gemini-2.0-flash-001 (fallback · free tier)
    3. deepseek/deepseek-chat (fallback 2 · cheap)
  · Claude excluido explícitamente en config preferences
  · Si los 3 fallan → retornar mensaje "IA temporalmente no disponible · reintentando..."

(13 BRs restantes con tratamiento similar granular)

07Maquetas mínimas Y1 · qué construir

08Criterios aceptación medibles con SQL

-- Fase 1 cerrada · 10 ventas verdes
SELECT COUNT(*) >= 10 AS phase_1_closed
FROM orders
WHERE channel='meli'
  AND status='delivered'
  AND reputation_color='green'
  AND completed_at > NOW() - INTERVAL '60 days';

-- Fase 2 · 2 meses consecutivos 30+ órdenes
SELECT COUNT(*) >= 2 AS phase_2_closed
FROM (
  SELECT DATE_TRUNC('month', completed_at) AS month,
         COUNT(*) AS orders_count
  FROM orders
  WHERE channel='meli' AND status='delivered'
  GROUP BY month
  HAVING COUNT(*) >= 30
) recent_months
WHERE month >= NOW() - INTERVAL '3 months';

-- Margen blended mensual
SELECT
  DATE_TRUNC('month', completed_at) AS month,
  SUM(total) AS revenue,
  SUM(cogs) AS cogs,
  ROUND(((SUM(total) - SUM(cogs))::float / NULLIF(SUM(total), 0) * 100)::numeric, 2) AS margin_pct
FROM orders
WHERE status='delivered'
GROUP BY month
ORDER BY month DESC LIMIT 12;

-- ROAS Mercado Ads por campaña últimas 7d
SELECT
  c.name,
  c.product_id,
  SUM(m.revenue) AS revenue_7d,
  SUM(m.spend) AS spend_7d,
  CASE WHEN SUM(m.spend) > 0
    THEN ROUND((SUM(m.revenue) / SUM(m.spend))::numeric, 2)
    ELSE NULL
  END AS roas
FROM ads_campaigns c
JOIN ads_metrics_daily m ON m.campaign_id = c.id
WHERE m.date > NOW() - INTERVAL '7 days'
GROUP BY c.id, c.name, c.product_id
ORDER BY roas ASC NULLS LAST;

09Out of scope explícito Y1

❌ NO hace Y1:

• App mobile (web responsive es suficiente · pwa Y2)
• Multi-tenant entre marcas (1 tenant = SMC SpA · multi-tenant Y3+)
• Multi-moneda (CLP único · USD solo Nexport Fase 2)
• Garantías / seguros productos (Y2)
• Programa fidelidad clientes (Y2)
• Marketplace interno (no vendemos a otros vendedores)
• Operación fuera Chile (territorialmente Chile-only)
• Pago directo sistema (siempre vía pasarela externa)
• Voice / audio interface (Y3+ si vale)

10Próximos pasos

• ✅ Doc 11 v2 · granular · herramientas + flujos detallados
• ⏭️ Doc 13 v2 · Espec Técnica granular alineada con Doc 07 Architecture
• ⏭️ Tu OK para empezar maquetas (Doc 18 detalla qué construir)
• ⏭️ Doc 19 UAT post-construcción