Bendito Capricho — Plataforma de Supervisión Digital · Fase 1 entregada

03 · Arquitectura técnica

Next.js 16 + Airtable + Vercel · stack en producción

Stack elegido para escala real del cliente: 19 usuarios, no 19.000. La dueña puede editar datos sin developer (Airtable como UI admin), deploy automático con cada commit, PWA instalable en celular sin App Store, cron nativo en Vercel.

80%

Bendito Capricho — High Level Architecture

Next.js 16 + Airtable + Vercel Edge · NextAuth v5 · PWA · WhatsApp + Drive externos

María José Norambuela

dueña · super admin

David Cárdenas

gerente · ve todo

Dani (socio)

marketing + comercial

1 FRONTEND · Next.js

Next.js 16 App Router

app-alpha-beige-15.vercel.app

11 rutas · 25+ componentes
Server Actions + Zod v4.4.3
Tailwind v4 + shadcn/ui
TypeScript 5.x strict

NextAuth v5

email magic link · sin password

8 roles · 10 usuarios
JWT con rol + departamento
middleware protege rutas

▶

PWA · Service Worker

manifest.json · standalone mode

instalable Android Chrome
instalable iPhone Safari
assets cacheados offline

2 DATA · Airtable Cloud

Airtable Base · Fase 1

API v0 · Free → Team $100/mes

8 tablas activas hoy
36 plantillas · ~172 ítems
Plan Free · 1.000 rows max
+10 tablas en Fases 2-5

Cron único Fase 1

/api/v1/cron/generar-checklists

10:00 UTC · 36 plantillas evaluadas
genera instancias del día
token CRON_SECRET
automations $ + escaladas → Fase 2

Views por rol

UI admin para María José

vista Quilpué · San Antonio
vista por departamento
"Pendientes hoy" · "Con descuadre"

3 INFRA · Vercel Edge

▲

Vercel Hobby

CDN global · Edge functions

auto-deploy en git push main
SSL automático Let's Encrypt
preview deployments por PR

⏰

Vercel Cron

10:00 UTC diario (07:00 CL)

/api/v1/cron/generar-checklists
token CRON_SECRET
genera ~14 instancias/día

🔐

Env vars + DNS

app.benditocapricho.cl ⏳

AIRTABLE_API_KEY · BASE_ID
NEXTAUTH_SECRET · URL
CRON_SECRET

📌 En Next.js

Server Components por defecto · cliente solo donde hay interacción
Server Actions + Zod = mismo schema en cliente y servidor
Feature colocation: cada ruta tiene sus _components / _actions / _hooks
Filtrado por rol en middleware antes de cargar la página

📌 En Airtable

8 tablas Fase 1 con relaciones Link · sin SQL
+10 tablas en Fases 2-5 (cierres, mermas, pagos, stands…)
UI admin para edición directa sin developer
⚠ Free 1K rows → Team antes de 3 sem · $100 USD/mes según PDF

Líderes tienda

Quilpué · San Antonio

Emprendedores

portal · fase 5

WhatsApp Business

notificaciones · fase 2

Google Drive

respaldo fotos + docs

REST · Next ↔ Airtable

CRON · Vercel → /api

AUTH · NextAuth JWT

WEBHOOK · externos (fase 2)

N secuencia de carga

⚠️ Punto crítico de escala

Airtable Free tiene 1.000 registros máx por base. Con 228 registros fijos + 36 instancias diarias generadas por cron, la base se llena en ~21 días de uso real. Migración obligatoria a Airtable Team antes de operar en serio (~$20-100 USD/mes según número de seats). Alternativa: migrar capa de datos a Supabase Postgres (500MB free, 50K MAUs) cuando el costo lo justifique.

· Matriz

Matriz · quién hace qué en cada módulo

Navegable con cajitas · sin scroll vertical. Cambia entre permisos, departamentos, usuarios y fases tocando las pestañas. 8 roles · 10 módulos · scope automático por departamento o tienda.

Módulo	Dueña	Gerente	Socio	Jefe Depto	Líder Tienda	Trabajador	Emprendedor
Dashboard general	CRUD	CRUD	R parc.	R depto	R tienda	—	—
Checklists completar	CRUD	CRUD	CRU MKT/COM	CRU depto	CRU tienda	CRU propios	—
Tareas adhoc	CRUD	CRUD	CRU MKT/COM	CRU depto	CRU tienda	R propias	—
Cierres caja	CRUD	CRUD	R	CRUD FIN	CRU tienda	—	—
Pagos emprendedores	CRUD	CRUD	R	CRUD FIN	R	—	R propios
Emprendedores	CRUD	CRUD	CRUD	R rel	R tienda	—	R propio
Inventario / mermas	CRUD	CRUD	R	CRUD INV	CRU tienda	—	R propias
Asistencia	CRUD	CRUD	R	CRUD ADM	CRU tienda	R propia	—
Reportes financieros	TODO	TODO	MKT/COM	Su depto	Su tienda	—	Propios
Configuración sistema	CRUD	R	—	—	—	—	—

CRUD Create+Read+Update+Delete CRU sin Delete scope filtrado por depto/tienda R solo lectura

GER

Gerencia

María José + David

2plantillas

10ítems

FIN

Finanzas

Francis (jefa)

2plantillas

16ítems

MKT

Marketing

Equipo + Dani

2plantillas

12ítems

COM

Comercial

Dani (socio)

2plantillas

8ítems

ADM

Administración

Joel (jefe)

2plantillas

14ítems

INV

Inventario

Encargada inventario

4plantillas

24ítems

LID

Líderes Tienda

Quilpué + San Antonio

18plantillas

72ítems

LOG

Logística Web

Ana Quiñonez

4plantillas

16ítems

Nombre	Email	Rol	Cargo	Scope
María José Norambuela	mariajose@benditocapricho.cl	Dueña	—	Todo
David Cárdenas	david@benditocapricho.cl	Gerente	Gerente General	Todo
Daniel (Dani)	dani@benditocapricho.cl	Socio	Mkt + Comercial	MKT · COM
Francis	francis@benditocapricho.cl	Jefe Depto	Jefa Finanzas	FIN
Joel	joel@benditocapricho.cl	Jefe Depto	Jefe Administración	ADM
Ana Quiñonez	ana@benditocapricho.cl	Jefe Depto	Supervisora Logística Web	LOG
Encargada Inventario	inventario@benditocapricho.cl	Jefe Depto	Enc. Inventario	INV
Líder Quilpué	lider.quilpue@benditocapricho.cl	Líder Tienda	Líder Quilpué	Tienda Q
Líder San Antonio	lider.sanantonio@benditocapricho.cl	Líder Tienda	Líder San Antonio	Tienda SA
Trabajador 1	trabajador@benditocapricho.cl	Trabajador	Personal Operativo	Propios

📧 Pendiente para producción real

Emails provisionales. María José debe confirmar la lista definitiva por persona y activar Google Workspace (Business Starter ~$6 USD/usr/mes) o usar correos personales. Luego se actualizan en Airtable Usuarios y el login funciona inmediato.

Fase	Módulos	Estado	Duración	Tokens est.
Pre-desarrollo	Análisis 25 docs · 4 agentes paralelos · propuesta	✓ Completado	—	~300K
Fase 1	Login · Mi Día · Dashboard · Checklists · Tareas · Emprendedores · Reportes · Calendario · Usuarios · PWA · Cron	✓ En producción	3-4 sem	~1.2M-1.5M
Fase 2	Finanzas (cierres, depósitos, pagos) + Comercial + Marketing + Notificaciones + Upload fotos real	Próxima	2-3 sem	~800K-1M
Fase 3	Inventario digital 8 pasos + Mermas con foto obligatoria	Planificada	2-3 sem	~500K-700K
Fase 4	Administración: asistencia digital, liquidaciones, bonos, contratos	Backlog	2 sem	~300K-500K
Fase 5	Portal Emprendedores + Reportes avanzados	Backlog	2-3 sem	~300K-400K
Fase 6	Logística Web · Paris Marketplace	Backlog	2 sem	~200K-300K

05 · Business Analysis

El antes y el después de cada proceso

Análisis funcional: cada flujo crítico hoy vive en WhatsApp, Word y Excel. La plataforma no agrega trabajo — reemplaza herramientas que ya se usan, con la diferencia de que ahora todo queda registrado y la gerencia lo ve sin pedirlo.

✗ ANTES · Operación manual

Cierre de caja en Excel local de cada tienda
Hojas de ingreso/egreso en papel + WhatsApp
"¿Ya completaste el checklist?" por WhatsApp
Pagos a emprendedores calculados a mano
Mermas reportadas verbalmente o no reportadas
María José sin visibilidad hasta fin de semana
Descuadres descubiertos en cuadratura mensual
Nuevos emprendedores se pierden en mensajes

→

✓ DESPUÉS · Plataforma de supervisión

Formulario digital con cálculo automático de diferencias
Hoja escaneada → Drive → flujo de 8 pasos trackeado
Checklists generados a las 7am · estado en dashboard
Sistema calcula ventas − comisión − mermas − arriendo
Registro con foto obligatoria + clasificación
Dashboard tipo semáforo en tiempo real
Alerta inmediata si descuadre > $5.000
Pipeline 7 etapas en Kanban con SLA por etapa

Reglas de negocio digitalizadas

📅

Calendario fijo de obligaciones

Día 01: planilla sueldos a contadora + presupuesto Gerencia + cobro subarriendo. Día 03: presupuesto MKT. Día 05: pago sueldos + gastos fijos. Día 10: bonos. Día 12: imposiciones. Día 15: reporte financiero integral. Día 20: deadline presupuestos áreas.

11 hitos fijos · alertas automáticas

⏰

SLAs cross-sistema

Hoja inventario procesada en 48 hrs hábiles. Cierre caja enviado antes 20:00. Depósito comprobante en 24 hrs. Respuesta a emprendedor en 24 hrs. Mensajes DM en 2 hrs hábiles. Cobro mora > 60 días → plan de cobro.

6 SLAs · escalamiento automático

⚖️

Cumplimiento legal Chile

Asistencia digital cumple art. 33 Código del Trabajo. Liquidaciones primeros 5 días del mes siguiente. Cotizaciones día 12 (multa si no). Contratos firmados archivados con vencimiento. Subarriendo separado de relación laboral (no son trabajadores).

Sole · análisis legal/RRHH

🚨

Alertas escaladas en 3 niveles

Nivel 1 (responsable) → Nivel 2 (supervisor: Joel/Gerencia) → Nivel 3 (liderazgo: María José/David). Activan en: descuadre, hoja fuera de 48h, planilla fuera de plazo, contrato vencido, stand en mora > 30 días.

10 escenarios definidos

🏷️

Trazabilidad de SKU

Cada producto: PREFIJO_EMPR-CATEGORIA-SECUENCIAL (ej: MARI-ACC-001). Familia, emprendedor, stock por tienda, historial de precio, movimientos. Permite atribución correcta de mermas y pagos.

8 categorías · ACC BIS BOL ROV CAL DEC REG OTR

🎯

Cálculo pago emprendedor

monto_a_pagar = ventas_periodo − comisión_BC − descuento_subarriendo − descuento_mermas_atribuibles − otros_descuentos. Mermas se clasifican: producto (descuentan al emprendedor) vs operación tienda (asume BC).

Quincenal · aprobación María José si > monto

06 · Oportunidades

Pipeline de captación de emprendedores — Kanban 7 etapas

El modelo de subarriendo de stands es el motor de ingresos de BC. Cada nuevo emprendedor activo = revenue mensual recurrente + comisión sobre ventas. Dani lidera, pero hoy todo vive en DMs sueltos. La app convierte el flujo en pipeline Kanban con SLA por etapa.

Prospecto

DM Instagram, Facebook, referido, presencial o campaña. Registrar nombre, rubro y origen.

Dani

SLA: mismo día

Contacto

Primer mensaje WhatsApp con presentación BC, modelo subarriendo, condiciones generales.

Dani

SLA: 24 hrs

Validación

Solicitar fotos productos. Verificar rubro compatible y calidad visual. Evaluar saturación sucursal.

Dani + Daniel

SLA: 48-72 hrs

Exclusividad

Cruzar rubro con stands ocupados. Confirmar si se ofrece exclusividad en esa sucursal.

Dani

Stands Layout

Cierre

Condiciones finales: tarifa stand, comisión, duración, cláusulas. Negociar y firmar contrato.

Dani

Contrato firmado

Integración

Grupo WA · Drive · planilla fotos · stand asignado · onboarding web Ana · post bienvenida MKT.

Dani + equipo

SLA: 7 días

Activo

Estado "Activo". Vende, paga subarriendo, recibe pago quincenal. Calificación interna 1-5.

Permanente

Revisión mensual

🎯 Conversión esperada

Cada emprendedor activo es revenue recurrente. Si la tarifa de stand promedia X UF y la comisión sobre ventas Y%, mejorar conversión de prospecto→activo del 15% al 25% multiplica el ingreso por subarriendo sin más esfuerzo comercial. Pipeline + SLA = no se pierde un solo lead en el ruido.

08 · Diagramas de secuencia

Cómo se conversan los actores y los sistemas

Diagramas de secuencia para los 3 flujos de mayor interacción: integración cross-sistema cuando llega un emprendedor nuevo, generación automática de checklists cada mañana, alerta de descuadre que detona escalamiento.

Secuencia · Nuevo emprendedor activo · integración cross-departamental

Dani             App          Airtable       MKT      Ana(Web)   Inv      Fin
  │               │                │             │           │            │          │
  ├──cerrar etapa 7 (Activo)──────►│                                                  │
  │               │                │                                                  │
  │               ├──UPDATE estado=Activo────────►│                                   │
  │               │                ◄──OK───────────                                   │
  │               │                │                                                  │
  │               │                ├──automation trigger───►                          │
  │               │                │             │           │            │          │
  │               │                ├──notify "post bienvenida"──►MKT                  │
  │               │                ├──notify "iniciar onboarding productos"────►Ana   │
  │               │                ├──notify "crear prefijo SKU"────────────────►Inv  │
  │               │                ├──notify "crear cobro subarriendo mes 1"───►Fin   │
  │               │                │             │           │            │          │
  │               │                ▼             ▼           ▼            ▼          ▼
# Resultado: 4 departamentos reciben tareas auto-asignadas. Cero handoff por WhatsApp.
# SLA cumplido: stand ocupado en 7 días desde cierre comercial.

Secuencia · Cron 7am · generación diaria de checklists

Vercel Cron     /api/cron     Airtable           Usuarios
   │                │              │                       │
   ├──10:00 UTC────►│                                       │
   │   (07:00 CL)   │                                       │
   │                ├──validar CRON_SECRET                  │
   │                │              │                       │
   │                ├──SELECT plantillas WHERE activa=true─►│
   │                │              ◄──36 plantillas──────────
   │                │              │                       │
   │                ├──evaluar frecuencia + día semana/mes  │
   │                │   (Diario: todas)                     │
   │                │   (Semanal: si día_semana coincide)   │
   │                │   (Mensual: si día_mes coincide)      │
   │                │              │                       │
   │                ├──INSERT instancias_hoy────────────────►│
   │                │              ◄──36 instancias creadas─
   │                │              │                       │
   │                │              ├──asignar responsable────────────►usuario
   │                │              │   (lookup tabla usuarios)         │
   │                │              │                                  │
   │                │              ├──estado: "Pendiente"             │
   │                │              │                                  │
   │                ◄──200 OK──────                                    │
   │                │              │                                  │
# Cada usuario abre "Mi Día" y ve sus checklists del día listos para completar.
# Si falla el cron → email a Sergio + retry manual /api/cron/generar-checklists?token=...

Secuencia · Descuadre > $5.000 · escalamiento automático

Líder          App             Airtable          Francis     Gerencia
  │              │                 │                       │            │
  ├──submit cierre caja────────────►                                     │
  │              │                 │                                    │
  │              ├──POST /api/cierres────►                               │
  │              │                 │                                    │
  │              │                 ├──Formula: Diferencia=Real−Sistema  │
  │              │                 │                                    │
  │              │                 ├──¿|Diferencia| > 5000?──── SÍ      │
  │              │                 │                                    │
  │              │                 ├──automation: alerta crítica───────►│
  │              │                 │                       │   Francis  │
  │              │                 │                       │   recibe   │
  │              │                 │                       │   notify   │
  │              │                 │                                    │
  │              │                 ├──si |Diferencia| > 50000──────────►│
  │              │                 │                                    │
  │              │                 │                       │     ──────►│
  │              │                 │                       │   Gerencia │
  │              │                 │                       │   (Nivel 3)│
  │              │                 │                                    │
  │              │                 ├──estado: Pendiente_Revision        │
  │              │                 │                                    │
  │              ◄──200 + warning──                                     │
  │              │                 │                                    │
# Líder ve mensaje: "Cierre registrado con descuadre. Francis ya fue notificada."
# Francis abre app, revisa, dialoga por comentarios, aprueba o pide investigación.

Capa	Tecnología	Versión	Estado
Framework	Next.js App Router	16.2.4 (verificar)	Revisar
Lenguaje	TypeScript strict	5.x	OK
Base de datos	Airtable	API v0 · Free	Migrar
Auth	NextAuth · magic link	v5	OK
UI	Tailwind + shadcn/ui	v4	OK
Validación	Zod	4.4.3	OK
Hosting	Vercel	Hobby	Upgrade Pro
Mobile	PWA · Service Worker	—	OK

Servicio	Hoy	Producción	Cuándo migrar
Vercel	Hobby · $0	Pro · $20 USD/mes	Esta semana
Airtable	Free · $0	Team · $100 USD/mes	Antes 3 sem (1K rows)
Sentry monitor	—	Free tier	2 semanas
Dominio .cl	—	~$12 USD/año	Esta semana
Google Workspace	—	~$6 USD/usr (opcional)	Cuando MJ decida
Total prod	$0	~$121 USD/mes	—

10 · RFP · Documento business

Request for Proposal · Bendito Capricho × Créalo SpA

Contexto · problema · hipótesis · KPIs · riesgos · roadmap. Formato heredado del RFP InfoPet del banco SMC.

ClienteBendito Capricho

ProveedorCréalo SpA

ModeloProject + Care

EstadoFase 1 LIVE

01 🎯 Contexto

Bendito Capricho opera tienda retail de accesorios en Quilpué y San Antonio bajo modelo de subarriendo de stands a emprendedores (cada stand vende productos de un emprendedor distinto · BC cobra arriendo + comisión sobre ventas · paga al emprendedor menos mermas atribuibles).

Hoy toda la operación vive en Word, Excel local y WhatsApp. El equipo de 19 personas trabaja sin visibilidad central. María José y David descubren problemas en la cuadratura mensual, no cuando ocurren.

⚠ Qué resuelve Fase 1 vs qué NO resuelve

Resuelve hoy: los checklists diarios/semanales/mensuales y la trazabilidad de tareas adhoc. Reemplaza WhatsApp para esos dos casos · todo queda registrado con timestamp y María José ve cumplimiento en dashboard tipo semáforo.

NO resuelve aún: cierres de caja, pagos a emprendedores, inventario operativo ni captación comercial. Eso sigue en Excel y WhatsApp como antes · vendrá en Fases 2-3 según el PDF de entrega Créalo.

02 🔥 Problemas del negocio hoy

Status indica qué pain points resuelve Fase 1 entregada y cuáles quedan pendientes para fases siguientes.

✓Checklists por WhatsApp: "¿completaste lo de hoy?" en grupos · RESUELTO Fase 1 ✓ · 36 plantillas digitales con cron 7am + dashboard semáforo
✓Tareas adhoc sin trazabilidad: "te paso por WA esto urgente" · RESUELTO Fase 1 ✓ · módulo tareas con prioridad, plazo, asignación, comentarios
✓María José sin visibilidad real-time: revisaba estado el fin de semana · RESUELTO Fase 1 ✓ · dashboard semáforo en vivo + reportes semanales con ranking
⏳Cierres de caja sin cuadratura automática: Excel propio por tienda · descuadres mensuales · PENDIENTE Fase 2
⏳Pagos a emprendedores manuales: Francis calcula a mano · atrasos 3-5 días · PENDIENTE Fase 2
⏳Captación emprendedores se pierde: DMs Instagram sueltos · sin pipeline · PENDIENTE Fase 2 (en Fase 1 solo hay CRUD emprendedores)
⏳Hojas de inventario en papel: emprendedor entrega · líder firma · se pierden · PENDIENTE Fase 3
⏳Mermas reportadas verbalmente: sin foto, sin clasificación · PENDIENTE Fase 3

03 💡 Hipótesis

Hipótesis Fase 1 (entregada)

Digitalizando los 36 checklists y las tareas adhoc en una sola plataforma con dashboard semáforo en vivo · María José pasa de revisar el fin de semana a ver el estado en tiempo real · el cumplimiento de checklists sube de ~60% (estimado WhatsApp) a ≥90% al mes 2 · cada responsable tiene su Mi Día con lo asignado.

Hipótesis Fases 2-3 (planificadas)

Cuando se digitalicen cierres de caja, pagos a emprendedores e inventario 8 pasos · los descuadres se detectan el mismo día (no en cuadratura mensual) · los pagos salen a tiempo · las mermas se atribuyen correctamente. Pipeline captación 7 etapas mejora conversión prospecto→activo del 15% al 25%+.

04 📊 KPIs · baseline → target

Métrica	Baseline (hoy)	Target 6 meses	Cómo se mide
Cumplimiento checklists diarios	~60% (estimado)	≥90%	Auto · dashboard Mi Día + Reportes
Tiempo procesar hoja inventario	~5-7 días	<48 hrs hábiles	Auto · alerta si excede plazo
Días retraso pago emprendedor	3-5 días	0 días	Sistema calcula · Francis aprueba · MJ firma
Descuadres caja sin investigar	~3-5/mes	0	Auto · alerta >$5K · investigación obligatoria
Conversión prospecto → emprendedor activo	~15%	25%+	Pipeline Airtable · cohort mensual
Mermas con foto + clasificación	~20%	100%	Sistema bloquea registro sin evidencia
NPS staff (Net Promoter Score interno)	—	≥50	Survey trimestral post-implementación
Costo infra mensual	$0 (papel)	<$130 USD/mes	Vercel + Airtable Team + Workspace

05 ⚠️ Riesgos identificados

Riesgo	Probabilidad	Impacto	Mitigación
Airtable Free se llena (1K rows)	Alta	Medio	Upgrade a Team antes de 3 sem · ~$20-100/mes · ya presupuestado
Equipo no adopta (sigue WhatsApp)	Media	Alta	Capacitación 1h + acompañamiento semana 1 · alerta auto si no completa
Líderes no suben foto cierre caja	Media	Media	Sistema bloquea submit sin foto obligatoria
Conexión a internet intermitente en tienda	Media	Bajo	PWA cachea assets · datos requieren conexión · queue local fase 2
Cambio de tarifa subarriendo confunde Airtable	Baja	Medio	Historial de precios versionado · fecha vigencia obligatoria
María José olvida aprobar pagos > umbral	Media	Medio	Recordatorio email + push · escalada a David si >48 hrs
Vercel Hobby supera límites (improbable)	Baja	Bajo	Upgrade a Pro $20/mes si supera 100K req/mes

06 🛠️ Solución · stack y features

Stack

›Frontend: Next.js 16 App Router · Tailwind v4 + shadcn/ui · PWA · TypeScript strict
›Auth: NextAuth v5 magic link email · sin password · 8 roles · JWT con scope
›Datos: Airtable API v0 · 8 tablas Fase 1 (+10 planificadas Fases 2-5) · 36 plantillas · ~172 ítems · UI admin para María José
›Infra: Vercel Hobby · auto-deploy git push · SSL · Edge CDN · cron 10:00 UTC
›Integraciones (fase 2+): WhatsApp Business API (notificaciones) · Google Drive (respaldo fotos) · Bsale/POS (cierres)
›Domain: app.benditocapricho.cl · CNAME → cname.vercel-dns.com

Features clave

›📋 36 plantillas checklist: diario / semanal / mensual · generación auto 7am
›📊 Dashboard semáforo: 8 departamentos en verde/amarillo/rojo en tiempo real
›💰 Cierres caja digitales: 5 medios de pago · cuadratura automática · foto arqueo obligatoria
›📦 Inventario 8 pasos: hoja → foto → Drive → SKU → habilitar · plazo 48 hrs
›🛒 Pipeline emprendedores 7 etapas: Kanban Airtable · SLA por etapa · revenue recurrente
›👥 Asistencia digital: reemplazo libro físico · cumple art. 33 CT
›📱 PWA mobile-first: instalable Android/iPhone · líderes operan desde celular

07 🛣️ Roadmap por fases · 6 fases · ~14-18 semanas

Fase 1 · MVP supervisión ✓ LIVE

3-4 sem · ~1.2-1.5M tokens

Login · Mi Día · Dashboard · Checklists (36 plantillas + cron) · Tareas · Emprendedores · Reportes · Calendario · Usuarios · PWA

Fase 2 · Dinero 🔄 PRÓXIMA

2-3 sem · ~800K-1M tokens

Cierres caja (5 medios) · Depósitos con foto · Pagos emprendedores (fórmula auto) · Marketing · Comercial · Notificaciones · Upload foto real

Fase 3 · Inventario ⏳ PLAN

2-3 sem · ~500-700K tokens

8 pasos digital · mermas con foto obligatoria · clasificación atribución · trazabilidad SKU

Fase 4 · RRHH ⏳ PLAN

2 sem · ~300-500K tokens

Asistencia digital (art. 33 CT) · liquidaciones · bonos · contratos archivados · DT

Fase 5 · Portal Emprendedores ⏳ PLAN

2-3 sem · ~300-400K tokens

Ventas propias · mermas atribuibles · pagos recibidos · estado subarriendo · notificaciones

Fase 6 · Logística Web ⏳ PLAN

2 sem · ~200-300K tokens

Integración Paris Marketplace · catálogo web sincronizado · seguimiento pedidos online

✓ Próximos pasos inmediatos (5 ítems · costo <$200 USD)

1. María José confirma lista definitiva de emails. 2. Activar Google Workspace o usar correos personales. 3. Acceso DNS benditocapricho.cl → CNAME app → cname.vercel-dns.com. 4. Upgrade Airtable Free → Team antes de 1K rows. 5. Capacitación 1h al equipo. Tras estos 5, Fase 1 corre en operación normal y arranca Fase 2 (Dinero).

11 · Reporte · evaluación técnica SMC

Assessment de la Entrega Fase 1 · Créalo SpA

Evaluación independiente del código, infraestructura y entregables. Score actual 67/100 (C+) · con 2 semanas de correcciones llega a 88/100 (B+) · inversión adicional ~$45 USD/mes.

Evaluación técnica · Mayo 2026

El código está bien.
La infraestructura necesita ajustes.

Score actual 67/100 → objetivo 88/100 con 1 semana de fix · $45/mes adicional.

Resumen Ejecutivo

✅

La plataforma funciona correctamente

Código moderno, limpio y bien estructurado. 12 módulos operan. Cron 7am genera 36 checklists. PWA instalable en móvil sin problemas.

🚨

Riesgo crítico bloqueante

Airtable Free tiene límite 1.000 registros. Con 36 checklists/día se alcanza en <3 semanas. Migración urgente a Supabase o Airtable Team.

⚠️

3 entregables ausentes

Falta: (1) manual de usuario por módulo, (2) sistema tickets con SLA, (3) roadmap claro de fases siguientes. Estándar incumplido.

🎯

2 semanas y queda listo

Migrar DB + dashboard por rol + entregables faltantes eleva score 67 → 88. Inversión: $45 USD/mes adicional.

7 secciones del assessment

01 · Scan Tecnológico · Actual vs Recomendado

Diagnóstico de cada capa con recomendación. Mantener · Mejorar · Cambiar urgente

Capa	Lo que tiene Créalo	Estado	Recomendación
Framework	Next.js "v16.2.4" (versión no existe)	Revisar	Solicitar package.json a Créalo. Última estable v14/v15.
Lenguaje	TypeScript 5.x	OK	Mantener. Buena elección.
Componentes UI	Tailwind + shadcn/ui v4	OK	Mantener. Stack moderno. Agregar tokens semánticos.
Base de datos	Airtable Free · ⚠ 1.000 reg max	Cambiar	Migrar a Supabase PostgreSQL. Sin límite · backups auto · transacciones. Free year 1.
Auth	NextAuth v5 · magic link	OK	Mantener. Verificar expiración links 15 min.
Validación	Zod 4.4.3	OK	Mantener. Validar TODOS los endpoints.
Deploy	Vercel Hobby (Free)	Insuficiente	Ruta A: Vercel Pro $20/mes (30 min). Ruta B: AWS en Fase 5+.
Automatización	Vercel Cron · 36 checklists 7am	OK	Mantener. Agregar monitor de fallas.
App móvil	PWA iOS + Android	OK	Agregar sync offline real.
Seguridad	Solo CRON_SECRET en env	Incompleto	Validar permisos server-side · headers HTTP · audit log.
Monitoreo errores	Sin implementar	Ausente	Instalar Sentry (free). Sin esto los errores son invisibles.

02 · Arquitectura · Estado actual vs Objetivo

2 rutas evaluadas: Vercel Pro ahora vs AWS en Fase 5+.

Factor	Ruta A · Vercel Pro	Ruta B · AWS
Setup	30 min · 1 clic	4-8 sem · DevOps
Costo/mes	$20 USD fijo	$80-250+ USD variable
Conocimiento	Ninguno	DevOps dedicado
Compat Next.js	Total · mismo equipo	Requiere adaptación
Aislamiento multi-cliente	Solo código	Total · cuenta AWS por cliente
Timeout reportes	30s · limitado	Sin límite · Lambda
Storage archivos	Vercel Blob	S3 · más control
Cuándo usar	Ahora hasta Fase 4	Fase 5+ · 3+ clientes

💡 Recomendación

Implementar Ruta A (Vercel Pro) esta semana · 30 min · $20/mes · sin tocar código. Evaluar Ruta B (AWS) en Fase 5 cuando haya 3+ empresas usando la plataforma. La complejidad operacional de AWS no se justifica antes.

03 · Roadmap · Lo entregado vs Lo esperado

Qué incluyó Créalo en Fase 1 y qué debería acompañar a cualquier entrega de software profesional.

📦 Lo que entregó Créalo

Funcionalidad ✓

Login magic link · solo email
Mi Día para operarios
36 plantillas · 172 ítems
Generación auto 7 AM
Revisión supervisor
Tareas · emprendedores · reportes · calendario
Gestión usuarios con roles
PWA instalable

Entregables proyecto ✗

Sin manual de usuario
Sin sistema de soporte/SLA
Sin roadmap fases siguientes
Sin plan de backup
Sin ambiente staging
Sin criterios de aceptación

→

📋 Lo que debería acompañar

Documento de alcance firmado por ambas partes
Roadmap de fases con objetivos, entregables y tiempos
Manual de usuario con capturas por módulo
Protocolo soporte con cómo reportar y tiempos SLA
Plan backups con frecuencia y recovery
Ambiente staging idéntico a producción
Criterios aceptación qué define que el módulo está listo
Métricas de éxito cómo medir cumplimiento

Fases recomendadas de aquí en adelante

FASE 2 · Sem 2-5

Completar entregables faltantes

Manual usuario · notificaciones push · export PDF/Excel · dashboard por rol · sync offline

FASE 3 · Mes 2

Sistema de tickets formal

Módulo tickets · SLA por prioridad · escalación auto · historial

FASE 4 · Mes 3

Reportes y métricas ejecutivas

KPIs por local · comparativa periodos · alertas umbral · envío automático

FASE 5 · Mes 4-5

Infraestructura multi-cliente (AWS)

DB separada por empresa · panel multi-cliente · facturación por empresa

FASE 6 · Mes 6+

Inteligencia operacional con IA

Detección locales en riesgo · sugerencias checklists · asistente IA

04 · Sistema de Tickets · Módulo Faltante

Hoy todo se maneja por WhatsApp/email sin registro ni SLA. La plataforma no tiene módulo de soporte estructurado.

⚠️ Cómo se gestionan hoy

Operario avisa por WhatsApp
Sin registro de qué pasó ni cuándo
Sin responsable ni fecha resolución
Supervisor no puede hacer seguimiento
Urgentes y menores se tratan igual
Sin métricas de tiempo de resolución
Problemas se pierden en chats

→

✅ Cómo debería funcionar

Ticket desde la app con foto + descripción
Número único + fecha registrados
Asignación automática + notificación
Estado visible para todos en vivo
SLA por prioridad
Medición de eficiencia soporte
Historial para detectar recurrencias

Tiempos de respuesta SLA por prioridad

🔴

Crítico

1 hora

Plataforma caída · sin acceso · pérdida datos

🟠

Alto

4 horas

Módulo no funciona · checklists sin generar

🟡

Medio

24 horas

Error menor · con solución alternativa

🟢

Bajo

72 horas

Consulta · mejora visual · petición cambio

Flujo de estados del ticket

01NUEVOrecibido

→

02ASIGNADOresponsable definido

→

03EN PROGRESOtrabajando

→

04EN REVISIÓNQA cliente

→

05CERRADOresuelto

Reglas automáticas

• Al crear: asignación según categoría+prioridad · • Al 80% SLA: recordatorio responsable · • Al vencer SLA: escalación supervisor + alerta dashboard · • Sin respuesta cliente 48h: cierre automático

05 · Manual de Usuario · Entregable ausente

No se entregó ninguna guía de uso. Sin manual, cada usuario nuevo requiere capacitación presencial y los errores de operación aumentan soporte.

⚠ Estándar de entrega

En cualquier proyecto profesional, el manual de usuario es entregable obligatorio junto a la primera versión. Créalo debe producirlo como parte del cierre Fase 1.

9 módulos que requieren documentación

🔐 Acceso al sistema Todos

Ingreso por email · abrir link antes que expire · instalar app iOS+Android · qué hacer si no llega correo.

☀️ Mi Día Operario

Ver checklists del día · completar ítem con foto · guardar borrador · enviar al supervisor.

✅ Checklists Operario

Se crean solos 7am · ítem a ítem con cámara · observaciones en problemas · envío al completar.

📊 Dashboard Supervisor

Leer % cumplimiento · identificar locales con alertas · filtrar local/fecha/responsable · ver detalle.

🔎 Revisión Supervisor

Ver pendientes de revisión · aprobar/rechazar con comentario · ver fotos adjuntas · aviso al operario.

📝 Tareas Supervisor

Crear tarea con descripción/plazo/responsable · ver por vencimiento · cambiar estado · notificación.

🏪 Emprendedores Supervisor

Buscar local por nombre/categoría · ver ficha + historial · agregar notas privadas · activar/desactivar.

📈 Reportes Supervisor

Cumplimiento mensual por local · comparar semanas · ítems más incumplidos · export PDF/Excel (Fase 2).

👥 Usuarios Admin

Crear usuario con email/nombre/rol · diferencia Admin/Supervisor/Operario · invitar por correo · desactivar.

📋 Formato recomendado

PDF por módulo con capturas numeradas paso a paso. Disponible además dentro de la app con botón "Ayuda" por pantalla. Prioridad: Mi Día y Checklists (uso diario) → Login/App (usuarios nuevos) → resto.

06 · Mejoras Visuales · 5 cambios concretos

Cambios con alto impacto en UX y poco esfuerzo de implementación.

🔴Dashboard muestra TODO a todos · sin filtrar por rol Prioridad 1 · 3-5 días Urgente

❌ Problema actual· Operario ve métricas de otros locales · Menú con 12 módulos a todos · Operario no sabe qué hacer hoy

✅ Cómo debe quedarOperario: solo sus checklists con estado · Supervisor: 3 KPIs + locales con problemas · lógica por rol del JWT

🔴Pantallas vacías no explican nada · el usuario cree que hay error Prioridad 1 · 1 día Urgente

❌ Problema actualPantalla en blanco o spinner girando · usuario no distingue error técnico de sin datos · genera desconfianza

✅ Cómo debe quedar"No hay checklists pendientes 🎉 Todo al día" · ícono ilustrativo + descripción · componente reutilizable 20 líneas

🟡Botones sin jerarquía · usuario no sabe cuál apretar Prioridad 2 · 2 días Importante

❌ Problema actual"Enviar" + "Guardar borrador" + "Cancelar" mismo tamaño · duda cuál es la acción correcta

✅ Cómo debe quedarPrimaria con fondo color (1 por pantalla) · Secundaria solo borde · Cancelar solo texto (rojo si destructiva)

🟡Sin confirmación visual después de acción Prioridad 2 · 0.5 días Importante

❌ Problema actualAl enviar checklist o aprobar no hay confirmación · usuario presiona varias veces

✅ Cómo debe quedarToast verde "Enviado correctamente" 4s · amarillo "Faltan 3 ítems" · rojo "No se pudo guardar" · Sonner de shadcn/ui

🟡Sin indicador de progreso en checklists largos Prioridad 2 · 0.5 días Importante

❌ Problema actualChecklist con 47 ítems · operario no sabe cuánto le falta · favorece abandono

✅ Cómo debe quedarBarra sticky "14 de 47 completados" · color gris→azul→verde · al 100% "¡Listo! Envía al supervisor"

07 · Auditoría Técnica · Score por área

Evaluación por área de 0 a 100 con hallazgos de QA. Score actual 67 → 88 con correcciones.

Arquitectura

/ 20

Base de datos

/ 20

Seguridad

/ 20

Funcionalidad

/ 20

Documentación

/ 15

UX · Usabilidad

/ 15

Infraestructura

/ 10

Hallazgo por área · qué baja el score

Área	Puntos perdidos	Motivo principal	Cómo recuperarlos
Base de datos	−12 pts	Airtable Free: límite, sin backups, sin transacciones	Migrar a Supabase PostgreSQL · 3-5 días
Documentación	−8 pts	Sin manual, error versión Next.js, sin evidencia pruebas	Manual + corregir versión
Funcionalidad	−8 pts	Sin tickets, sin push, sin export reportes	Fase 2 y 3 del roadmap
Seguridad	−6 pts	Permisos no verificados server-side, sin audit log	Validación server + audit log
UX	−5 pts	Dashboard sin rol, sin estados vacíos, sin feedback	5 cambios Sección 06
Infraestructura	−3 pts	Vercel Hobby sin SLA, sin monitoreo errores	Vercel Pro + Sentry

Pruebas de calidad recomendadas antes de operar

Escenario a probar	Por qué es importante
Operario completa y envía checklist	Flujo principal · un error afecta el trabajo diario
Supervisor aprueba/rechaza revisión	Rechazo sin notificación sería error silencioso
36 checklists se generan a las 7 AM	Si falla cron, día entero sin checklists sin aviso
Operario no ve datos de otro local	Acceso cruzado = riesgo de privacidad más grave
App funciona sin señal y sincroniza al volver	Operarios con mala cobertura necesitan offline
Link email expira en 15 minutos	Link sin expirar = riesgo si correo es comprometido

08 · Plan de Acción · Próximos 30 días

Qué hacer, en qué orden y por qué no puede esperar.

Esta semana · debe resolverse antes de operar

Próximas 2 semanas · alta prioridad

Mes 1 · importante para calidad

1. Confirmar versión real de Next.js · Solicitar package.json a Créalo. "v16.2.4" no existe.

Esta semana · 1h

2. Migrar BD de Airtable a Supabase · 1.000 reg max se agotan en <3 sem. Único punto que puede dejar la app sin funcionar.

Esta semana · 3-5 días

3. Upgrade Vercel Hobby → Pro ($20/mes) · SLA garantizado, sin timeout 10s, soporte incluido. Ruta A.

Esta semana · 30 min

4. Activar backups automáticos de la BD · Tras migración Supabase backups con un clic. Mientras: exportar Airtable manual cada noche.

Esta semana · 1h

5. Separar dashboard por tipo de usuario · Operario solo ve sus checklists. Supervisor ve KPIs + alertas.

2 sem · 3-5 días

6. Instalar Sentry para errores en producción · Free · 1 línea de código · notifica errores automático.

2 sem · 0.5 días

7. Solicitar manual de usuario por módulo · Entregable estándar. Prioridad: Mi Día, Checklists, Login.

2 sem · coordinar

8. Aplicar mejoras visuales P1 y P2 · Estados vacíos, feedback acciones, jerarquía botones, progreso checklists.

Mes 1 · 1 sem

9. Iniciar diseño módulo de tickets · Modelo, flujo y SLA. Reemplaza WhatsApp informal.

Mes 1 · 2-3 sem

⚠ Si Créalo no entrega algo de esta lista

Manual de usuario: solicitarlo por escrito con fecha límite. Entregable contractual estándar. No cerrar Fase 1 sin él.

Migración Airtable: si Créalo no puede o demora, contratar dev externo. Costo menor que riesgo colapso en 3 sem.

Versión Next.js: pedir package.json por email. No firmar cierre Fase 1 sin esa confirmación.

Staging: si no existe, acordar que ningún cambio va a prod sin revisión previa.

Vercel Pro: si Créalo cree que Free es suficiente, mostrar Sección 02 con riesgos documentados.

Conclusión

El código está bien. La infraestructura necesita ajustes. Hay 3 entregables pendientes.

Con 1 semana de fix la plataforma pasa de 67 a 88 puntos y puede operar con confianza.

Una tienda retail que se supervisa sola.

Qué hace el sistema en lenguaje de negocio

Del WhatsApp al dashboard

Supervisión centralizada

Checklists digitales

Roadmap restante

Quién hace qué flujo, en qué orden

Cómo está construido el sistema

Next.js 16 + Airtable + Vercel · stack en producción

Matriz · quién hace qué en cada módulo

Gerencia

Finanzas

Marketing

Comercial

Administración

Inventario

Líderes Tienda

Logística Web

El antes y el después de cada proceso

✗ ANTES · Operación manual

✓ DESPUÉS · Plataforma de supervisión

Reglas de negocio digitalizadas

Calendario fijo de obligaciones

SLAs cross-sistema

Cumplimiento legal Chile

Alertas escaladas en 3 niveles

Trazabilidad de SKU

Cálculo pago emprendedor

Las oportunidades y los números

Pipeline de captación de emprendedores — Kanban 7 etapas

Prospecto

Contacto

Validación

Exclusividad

Cierre

Integración

Activo

Quién aprueba qué, en qué orden, con qué evidencia

Cómo se conversan los actores y los sistemas

El proyecto en cifras

Auditoría SMC · score por área

Drill-down · detalle bajo demanda

Request for Proposal · Bendito Capricho × Créalo SpA

01 🎯 Contexto

02 🔥 Problemas del negocio hoy

03 💡 Hipótesis

04 📊 KPIs · baseline → target

05 ⚠️ Riesgos identificados

06 🛠️ Solución · stack y features

Stack

Features clave

07 🛣️ Roadmap por fases · 6 fases · ~14-18 semanas

Fase 1 · MVP supervisión ✓ LIVE

Fase 2 · Dinero 🔄 PRÓXIMA

Fase 3 · Inventario ⏳ PLAN

Fase 4 · RRHH ⏳ PLAN

Fase 5 · Portal Emprendedores ⏳ PLAN

Fase 6 · Logística Web ⏳ PLAN

Assessment de la Entrega Fase 1 · Créalo SpA

El código está bien.La infraestructura necesita ajustes.

Resumen Ejecutivo

La plataforma funciona correctamente

Riesgo crítico bloqueante

3 entregables ausentes

2 semanas y queda listo

7 secciones del assessment

01 · Scan Tecnológico · Actual vs Recomendado

02 · Arquitectura · Estado actual vs Objetivo

03 · Roadmap · Lo entregado vs Lo esperado

📦 Lo que entregó Créalo

📋 Lo que debería acompañar

Fases recomendadas de aquí en adelante

04 · Sistema de Tickets · Módulo Faltante

⚠️ Cómo se gestionan hoy

✅ Cómo debería funcionar

Tiempos de respuesta SLA por prioridad

Flujo de estados del ticket

05 · Manual de Usuario · Entregable ausente

9 módulos que requieren documentación

🔐 Acceso al sistema Todos

El código está bien.
La infraestructura necesita ajustes.