Fase 1 · Mayo 2026

Una tienda retail que se supervisa sola.

Plataforma de supervisión digital para María José Norambuela. Tres miradas: funcional, técnica y cierre.

01 · Visión

Del WhatsApp al dashboard

Bendito Capricho operaba en Word, Excel y WhatsApp. Hoy Fase 1 digitaliza la supervisión: checklists con cron 7am, tareas adhoc trazables y un dashboard tipo semáforo. Los procesos de dinero, inventario y captación quedan para fases 2-3.

Supervisión centralizada

María José y David ven el estado de los 8 departamentos en tiempo real con semáforos verde/amarillo/rojo.

Fase 1 · LIVE

Checklists digitales

36 plantillas se generan automáticamente cada día a las 7 AM. Cada rol completa los suyos desde el celular con foto, texto o check.

Fase 1 · LIVE

Roadmap restante

Cierre caja + pagos a emprendedores (F2), inventario 8 pasos + mermas (F3), asistencia + RRHH (F4), portal emprendedores (F5).

Fases 2-5 · planificadas

02 · Proceso

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

Los 14 flujos verificados de Fase 1 (PDF Créalo) agrupados en 6 escenarios. Selecciona uno para ver el mini-diagrama. Mismo formato que Flujo de aprobación · sin scroll vertical.

Auth + Cron

Ítems [1] [2] · entregado · activo en producción

✓ LIVE

01loginEmail magic linkNextAuth v5

02dashboardRedirige por rolmiddleware JWT

03cron 10utcGenera 36 checklistsCRON_SECRET

04listasVisibles en Mi DíaAirtable

POST /api/auth/[...nextauth] GET /api/v1/cron/generar-checklists 07:00 CL · diario

Checklists · CRUD + revisión

Ítems [3] [4] [6] [7] · 36 plantillas + 172 ítems

✓ LIVE

01usuarioAbre checklistdesde Mi Día

02responde5 tipos de ítemcheck · texto · núm · sel · foto

03comentaMuro chatopcional

04supervisorAprueba/rechazacon observación

05filtraPor depto/tiendascope por rol

/responder /completar /revisar /evidencia

Tareas ad-hoc

Ítem [5] · reemplaza WhatsApp para tareas puntuales

✓ LIVE

01creador+ Nueva tareaDueña/Gerente/Jefe

02defineTítulo + prioridadUrg/Alta/Med/Baja

03asignaA responsableaparece en Mi Día

04completaMarca hechamuro comentarios

POST /api/v1/tareas 4 niveles prioridad

Supervisión · dashboards

Ítems [8] [9] [10] · vista en vivo MJ + David

✓ LIVE

01dashboardSemáforo 8 deptosverde/amarillo/rojo

02reportesComparativa semanal% + ranking

03calendarVista mensualpuntos por estado

/dashboard /reportes /calendario racha 100% cumplim.

Gestión · CRUD básico

Ítems [11] [12] [13] · emprendedores + usuarios + scope

✓ LIVE

01emprend.Crear · editar · estadosin pipeline aún

02usuariosAdmin CRUDDueña + Gerente

03scopeFiltrado por roljefe→depto · líder→tienda

POST /emprendedores GET/POST /usuarios middleware JWT

PWA mobile

Ítem [14] · instalable sin App Store en Android+iOS

✓ LIVE

01androidChrome ⋮ → iniciomanifest detectado

02iphoneSafari ↑ → iniciono en Chrome iOS

03appModo standalonesin barra navegador

service worker activo manifest BCapricho datos requieren conexión

Cierre caja · pagos · pipeline captación (F2) · inventario + mermas (F3) · asistencia (F4) están planificados, no construidos.

06 · 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.

04 · Matriz de roles

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

08 · 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.

03 · Flujos de aprobación

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

Tres procesos donde hay dinero o decisión irreversible: cierre de caja diario (descuadre puede ser robo), pago a emprendedores (movimiento mensual de varios millones de pesos consolidado) y gastos no presupuestados (control de cash flow por departamento).

Cierre de caja diario · cadena de aprobación

5 actores · 5 nodos · evidencia obligatoria: foto arqueo + foto depósito bancario

Diario · 17:00

17:00líderCuenta + completa form5 medios de pago · foto arqueo

→

autosistemaCalcula diferenciasalerta si Δ>$5K

→

<20:00líderDepósito + comprobantefoto bancaria obligatoria

→

~30 minfrancisRevisa + apruebao pide investigación

→

mensualjoel2do filtro · testigocuadratura por medio

auditoría completa · timestamps 2 sucursales · 1 cierre/día c/u bloqueo si no llega antes 20:00 escalada Gerencia si Δ>$50K

Pago a emprendedor · cadena de aprobación

Quincenal · cálculo automático · doble aprobación si monto > umbral · evidencia: transferencia bancaria

Quincenal · días 01 y 15

cierre QsistemaSuma ventas brutasdesde cierres caja del período

→

invinventarioAporta mermassolo atribuibles a producto

f(x)

autosistemaCalcula líquidoventas − comisión − merma − arriendo

→

revisarfrancisValida cálculoestado: calculado → aprobado

→

firmamaría joséAprobación finalsi monto > umbral

ejecutarfrancisTransfiere + sube comprobante + notifica emprendedorestado: Pagado · estado de cuenta actualizado · queda registro en historial

fórmula transparente al emprendedor cálculo en < 1 min doble aprobación si monto>umbral comprobante adjunto obligatorio

Gasto no presupuestado · cadena de aprobación

Umbral $100K · 3 actores · evidencia: boleta/factura SII · cruza con presupuesto del área

Bajo demanda

triggerjefe áreaCrea solicitudconcepto + monto + razón

→

autosistemaCruza presupuesto% ejecutado · semáforo

<$100KfrancisAprueba directoestado: Aprobado

else

>$100KgerenciaEscala a MJ/Davidrevisa caja disponible

→

ejecutaráreaCompra + boletavinculado al presupuesto

control presupuestario por área ~5-10 gastos extra/mes alerta si presupuesto>110% mes archivo SII automático en Drive

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.

09 · Cifras

El proyecto en cifras

Cuatro KPIs clave, un único gráfico de score y un drill-down para detalle. Focused & clean · sin sobrecargar con charts innecesarios.

Score actual SMC

/ 100

C+ · Mejorable · ver Assessment

Score objetivo

/ 100

B+ · con 2 semanas de fix

Flujos en producción

de 14

Fase 1 verificada · PDF Créalo

Inversión adicional

$45

USD/mes

Vercel Pro $20 + Supabase $25

Auditoría SMC · score por área

total 67/100 · target 88/100

Un solo gráfico de barras claras · cada barra es una dimensión auditada · el detalle del fix vive en sección Assessment.

Arquitectura

70%

14/20

Seguridad

70%

14/20

67%

10/15

Funcionalidad

60%

12/20

Documentación

47%

7/15

Base de datos

40%

8/20

Drill-down · detalle bajo demanda

3 grupos · selecciona uno

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

Departamentos

GER FIN MKT COM ADM INV LID LOG

Sucursales

Quilpué · San Antonio

Trabajadores

10 con acceso sistema

Plantillas checklist

172 ítems · 8 roles RBAC

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	—

✓ 5 pasos inmediatos para producción real

1. Lista emails (María José). 2. Google Workspace o correos personales. 3. DNS · CNAME app → cname.vercel-dns.com. 4. Upgrade Airtable Free → Team. 5. Capacitación 1h equipo.

05 · 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).

07 · 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.

08 · Evaluación Técnica Definitiva

Score 49/100 · 5 Agentes SMC OS · Mayo 2026

Análisis exhaustivo por 5 evaluadores independientes: Arquitectura, Backend/Seguridad, Frontend, DevOps y QA. Evaluados con 4,200+ líneas de documentación técnica de Fase 1.

/ 100 · F+

Defectos S1

4–7d

Airtable colapsa

Agentes

75+

Post P0+P1

🚨 ACCIÓN REQUERIDA ANTES DEL 16 DE MAYO

Airtable Free tiene 1,000 registros. Con 182 registros dinámicos/día de uso real, el límite se alcanza en 4–7 días. Tras ese punto todos los usuarios ven error "Base limits reached". Actualizar a Airtable Team ($20/mes) es la única acción que previene un corte total de servicio.

DevOps · Hallazgo #1

4–7 días

Airtable Free colapsa en 4–7 días de uso real. El cálculo correcto: 742 registros disponibles ÷ 182/día = 4.1 días promedio. No 3 semanas como se estimó antes.

Backend · Hallazgo #2

IDOR Confirmado

Los permisos RBAC están implementados solo en la UI, no en las API routes. Cualquier usuario autenticado accede a datos de otros departamentos vía API directa. El roadmap de Créalo lo confirma como "P1 pendiente".

Arquitectura · Hallazgo #3

Mes 7–10

La tabla Respuestas_Checklist alcanza 240,000+ registros en 12 meses, superando el límite Airtable Team (125K). Colapso arquitectónico proyectado mes 7–10 sin migración planificada.

¿Por qué bajó de 74 a 49?

❌ Score 74/100 — contrarespuesta anterior

Evaluación basada en documentación de propuesta
Sin cálculo real de registros/día Airtable
IDOR marcado como "por implementar" sin gravedad
Cron timeout estimado como "en riesgo" sin cálculo exacto
Sin evaluación de QA formal ni cobertura de defectos
Sin evaluación de observabilidad productiva

→

✓ Score 49/100 — evaluación 5 agentes

Evaluación de documentación técnica completa (4,200+ líneas)
Cálculo exacto: 742 disponibles ÷ 182/día = 4.1 días
IDOR clasificado S1 con vectores de ataque concretos
Cron: 36×220ms=7.92s base, 16.2s worst case vs 10s límite
8 defectos S1, 10 S2, 8 S3 documentados
Observabilidad: 10/100 — sistema ciego en producción

02 · Metodología

Cómo se evaluó la plataforma

Cada agente recibió la documentación técnica completa de Fase 1 y evaluó su dimensión de forma independiente. Sin coordinación previa entre ellos.

Agente 1 · Arquitectura

C+

ADRs, escalabilidad, deuda técnica estructural, colapso proyectado DB

Peso: 25%

Evaluador 2 · Backend

D+

OWASP, autenticación, API routes, lógica de negocio, seguridad

Peso: 25%

Evaluador 3 · Frontend

D+

Core Web Vitals, React patterns, UX, PWA, accesibilidad, error states

Peso: 20%

Evaluador 4 · DevOps

CI/CD, observabilidad, infra, runbooks, planes de contingencia

Peso: 15%

Evaluador 5 · QA

F+

Defect classification, cobertura testing, edge cases, flujos críticos

Peso: 15%

Fuentes evaluadas

ENTREGA-FASE1.md (12 módulos, 10 endpoints, 14 flujos verificados) · propuesta-arquitectura.md (1,459 líneas, 18 tablas) · RESPUESTA-STACK-GUILLERMO.md · PROPUESTA-BENDITO-CAPRICHO.md · analisis-finanzas.md · analisis-operaciones-admin.md · analisis-marketing-comercial.md. Total: ~4,200 líneas de documentación técnica.

03 · Score Ponderado

49/100 — Grado F+

La arquitectura conceptual es sólida (69/100) pero la deuda técnica en seguridad, DevOps y QA arrastra el score total a 49. Con P0+P1 resueltos, el score sube a 75+.

Score por dimensión

5 agentes · pesos asignados por criticidad

Arquitectura (25%)

C+

Frontend (20%)

D+

Backend/Seg. (25%)

D+

QA (15%)

F+

DevOps (15%)

TOTAL PONDERADO

F+

Score radial por dimensión

5 evaluadores independientes

Arquitectura

Arq.

Frontend

Front.

Backend

Back.

DevOps

Score Final Ponderado

/ 100 · Grado F+ · anterior 74/100 B−

Arquitectura 69 × 0.25 = 17.25 Backend/Seg. 44 × 0.25 = 11.00 Frontend 48 × 0.20 = 9.60 DevOps 32 × 0.15 = 4.80 QA 43 × 0.15 = 6.45 ──────────────────────────────────────────── TOTAL PONDERADO = 49.10 / 100

04 · Dimensiones

Hallazgos por Dimensión

Crítico

Colapso DB mes 7–10

Respuestas_Checklist: 36 plantillas × 19 usuarios × 365 días × ~10 ítems = 240,000+ registros/año. Límite Airtable Team: 125,000 filas/base. Colapso mes 7–10 sin migración planificada.

Crítico

8 ADRs faltantes

Decisiones arquitectónicas críticas sin documentar: Airtable vs DB relacional, NextAuth beta en prod, Vercel Hobby como hosting de negocio, cron via API route, Airtable Free en producción.

Alto

Lógica financiera sin versionado

Las fórmulas de Airtable (ventas − comisiones − mermas − subarriendo) son lógica de negocio crítica sin control de versiones, sin historial, sin rollback. Un cambio accidental destruye los cálculos de pagos.

Alto

Observabilidad 2/10

No hay Sentry, no hay logging estructurado, no hay métricas de negocio. El sistema es ciego en producción. El primer aviso de falla llega por WhatsApp de un usuario.

Alto

Sin idempotencia en cron

El cron de 7AM genera checklists sin verificar si ya existen. Un retry de Vercel crea duplicados que los usuarios ven como tareas nuevas. Sin mecanismo de deduplicación documentado.

Positivo

Stack apropiado para la escala

Next.js + Airtable + Vercel es la decisión correcta para 15–19 usuarios con el presupuesto disponible. La propuesta de migrar a Supabase + AWS implicaría 3–4 semanas de reescritura sin ganancia funcional real.

IDOR Confirmado — Insecure Direct Object Reference

Los 10 API routes validan autenticación (usuario logueado) pero no validan autorización (qué datos puede ver). Un Trabajador autenticado llama a GET /api/checklists?departamento=finanzas y obtiene datos de Finanzas. El roadmap de Créalo lo confirma como "P1 pendiente" — sabían de la vulnerabilidad y eligieron deployar con ella.

Crítico

Cron timeout 2.25× sobre límite

36 plantillas × 220ms = 7.92s en escenario base. Worst case: 16.2s vs límite Vercel Hobby de 10s. El cron falla silenciosamente sin alerta, sin retry, sin notificación al supervisor.

Crítico

Airtable API v0 Deprecated

La documentación menciona Airtable API v0 como dependencia. Esta versión está deprecated — Airtable puede eliminar el soporte sin aviso. SDK 0.12.2 es estable pero si hay código usando la API REST directamente, es deuda activa.

Alto

NextAuth v5 beta.31 en producción

NextAuth v5 estaba en beta al momento del deploy. Un breaking change en beta.32+ puede invalidar las sesiones de todos los usuarios simultáneamente. La versión estable v5 existe desde diciembre 2024.

Alto

Sin transacciones compensatorias

El flujo Cierre de Caja escribe en múltiples tablas Airtable secuencialmente. Si falla en el paso 3 de 5, las tablas quedan en estado inconsistente. Airtable no soporta transacciones ACID — no hay rollback.

Positivo

RBAC 8 roles implementado

lib/auth/permissions.ts con hasPermission() y getDataScope() cubre los 8 roles. Es un diseño sólido — el problema es que solo está aplicado en la capa UI, no en las API routes.

Positivo

Headers de seguridad en next.config

CSP, X-Frame-Options, X-XSS-Protection configurados en next.config.ts. Es una práctica correcta que Créalo implementó proactivamente.

Crítico

LCP 3.5–4.5s en móvil

Sin skeleton loaders, sin lazy loading declarado, sin optimización de imágenes confirmada. Los líderes de tienda usan la PWA en celulares con conexión variable. Google considera LCP crítico >4s — inutilizable en 3G.

Crítico

Sonner cobertura 20%

Solo 20% de los flujos críticos tienen notificaciones Sonner. El 80% restante (incluyendo cierres de caja y rechazos de checklist) falla silenciosamente — sin confirmación de éxito ni feedback de error.

Crítico

Sin persistencia local de checklists

Los formularios de checklist no guardan progreso en localStorage. Si la sesión expira a la mitad de un checklist de 20 preguntas, el usuario pierde todo el progreso sin posibilidad de recuperación.

Alto

Sin estados de error en formularios críticos

Cierre de Caja, Depósitos y Checklists no tienen estados de error. Si Airtable falla, el usuario no sabe si su data fue guardada — riesgo de enviar el cierre de caja dos veces.

Alto

Tailwind v4 OKLch en producción

OKLch es el default en Tailwind v4, pero el soporte no es uniforme en Android 10–11 (prevalentes en Chile). Los colores semánticos pueden renderizar diferente en los dispositivos de los líderes de tienda.

Positivo

PWA instalable + shadcn/ui v4

Los trabajadores pueden instalar la app sin App Store. shadcn/ui v4 proporciona componentes accesibles y consistentes. El diseño visual es profesional para el contexto del cliente.

Hallazgo más urgente de toda la evaluación

Airtable Free tiene 1,000 registros. Con 258 de seed y 182 registros dinámicos/día (36 instancias + 144 respuestas + 2 cierres), los 742 disponibles se agotan en 4.1 días. El cálculo anterior de "3 semanas" no contaba las respuestas individuales por ítem.

Crítico

Observabilidad 10/100

No hay Sentry, no hay logging estructurado, no hay alertas de infra, no hay métricas de negocio, no hay dashboard de estado. El primer aviso de falla en producción llega por WhatsApp.

Crítico

Sin CI/CD formal

Los deploys son manuales vía git push a Vercel. No hay pipeline que corra tests antes del deploy, no hay preview environments, no hay rollback documentado ante un deploy roto.

Crítico

Sin runbooks

No existe documentación de "qué hacer cuando falla X". Si el cron falla a las 7AM: ¿quién lo detecta? ¿cómo se ejecuta manualmente? ¿quién tiene acceso al panel de Vercel? No hay respuestas documentadas.

Alto

Vercel Hobby sin SLA

Vercel Hobby no tiene SLA. Un incidente puede dejar la plataforma caída horas sin compensación ni soporte prioritario. Para una plataforma que reemplaza WhatsApp en operaciones diarias, este es un riesgo real.

Alto

Sin plan de migración DB

Cuando Airtable Team alcance 125,000 filas (~mes 7–10), no hay plan de migración documentado. Migrar a Supabase o PostgreSQL con datos en producción es un proyecto de 2–4 semanas de riesgo alto.

Positivo

Deploy automático con Vercel

La integración git → Vercel con deploy en 30s es una ventaja real frente a AWS EC2. Para un desarrollador solo manteniendo el proyecto, esto elimina la carga operacional de DevOps tradicional.

S1 Críticos

S2 Altos

S3 Medios

S4 Bajos

Total defectos

Cobertura de pruebas no documentada

La ENTREGA-FASE1.md lista "14 flujos verificados" pero no especifica qué tipo de pruebas se corrieron (unitarias, integración, e2e, manuales). No hay evidencia de un plan de testing formal, suite de tests automatizados, ni criterios de aceptación con resultados de prueba.

Los 8 defectos S1 se detallan en la sección siguiente. Los defectos S2 más relevantes incluyen: sin alertas automáticas de mora para emprendedores, sin validación de montos negativos en cierres de caja, sin modo offline para checklists, y sin estado de confirmación visual en flujo de pago a emprendedores.

05 · Defectos S1

8 Defectos Críticos Bloqueantes

Estos defectos deben resolverse antes de que María José dependa de la plataforma para operaciones financieras críticas o supervisión diaria real.

S1-01CRÍTICOPermisos no validados en API routes — IDOR

Los 10 endpoints API validan autenticación pero no autorización. Un Trabajador accede a datos de Finanzas directamente vía API. El roadmap de Créalo lo confirma como "P1 pendiente" — deploy consciente con vulnerabilidad activa.

Fix: Aplicar hasPermission() y getDataScope() (ya implementados en lib/auth/permissions.ts) en cada uno de los 10 API routes antes de consultar Airtable. Tiempo estimado: 1–2 días.

S1-02CRÍTICOCron 7AM falla silenciosamente — timeout 2.25× sobre límite

36 plantillas × 220ms = 7.92s base · 16.2s worst case. Vercel Hobby cancela a los 10s sin retry. El dashboard muestra 0/0 que los supervisores interpretan como "todo correcto" (falso negativo).

Fix: Migrar a Vercel Pro ($20/mes → 60s timeout) o reestructurar el cron en batches de 5 plantillas con queue. La opción A es más rápida.

S1-03CRÍTICOTimezone UTC vs Chile — cron se dispara a hora incorrecta

Vercel ejecuta crons en UTC. Si está configurado a las 7:00 UTC y Chile está en UTC-3/UTC-4, el cron se dispara a las 10–11 AM hora Chile — 3 horas después del inicio del turno de los trabajadores.

Fix: Configurar el cron a las 10:00 UTC (= 7:00 AM UTC-3). Usar America/Santiago como timezone de referencia en toda la lógica temporal.

S1-04CRÍTICOSin protección doble envío en cierre de caja — datos financieros duplicados

En conexiones lentas (habitual en retail), el usuario presiona "Enviar", no ve respuesta inmediata, y presiona de nuevo. Resultado: dos cierres de caja registrados para el mismo día.

Fix: Deshabilitar el botón submit después del primer click. Deduplicar por (fecha, tienda, turno) en la API route antes de escribir a Airtable.

S1-05CRÍTICOFalla Airtable durante cierre de caja — datos del formulario perdidos

Si Airtable retorna error 503 durante el cierre de caja, el formulario muestra error genérico y los datos se pierden. El líder de tienda no tiene copia de lo que ingresó.

Fix: Guardar el estado del formulario en localStorage antes de enviar. Si falla, mostrar modal de recuperación con los datos guardados. Implementar retry automático con backoff exponencial.

S1-06CRÍTICODashboard muestra 0/0 como correcto cuando el cron falla — falso negativo

Cuando el cron falla, el dashboard de David y María José muestra "0 de 0 completados" sin distinción entre "todos completaron" y "ningún checklist fue generado".

Fix: Agregar indicador de estado del cron como métrica separada. Si no corrió a las 7:15 AM ± 30 min, mostrar alerta visual roja en el dashboard de supervisión.

S1-07CRÍTICOSesión expirada durante checklist — todo el progreso perdido

Si la sesión NextAuth expira mientras el trabajador completa un checklist de 20 preguntas, al presionar "Guardar" es redirigido al login. Todo el progreso se pierde sin posibilidad de recuperación.

Fix: Implementar localStorage para guardar el estado del checklist en tiempo real (debounce 2s). Al re-autenticar, ofrecer "Continuar donde dejaste" con los datos guardados.

S1-08CRÍTICOCambio de rol con sesión activa — permisos no actualizados hasta expiración del token

Si un admin cambia el rol de un usuario en Airtable (ej. Trabajador → Jefe_Departamento), el usuario sigue con permisos del rol anterior hasta que el JWT expire.

Fix: Implementar revocación de sesión al cambiar roles. Usar session: { strategy: 'database' } en NextAuth para invalidar sesiones inmediatamente al cambiar permisos.

06 · ADRs Faltantes

8 Decisiones sin Documentar

Un ADR (Architecture Decision Record) documenta el "por qué" de una decisión técnica. Sin ADRs, cualquier desarrollador nuevo parte de cero sin contexto. Créalo debe documentar estas 8 decisiones — no cambiarlas, documentarlas.

ADR-001

Airtable como base de datos principal vs PostgreSQL/Supabase — justificación de la elección

Alto

ADR-002

NextAuth v5.0.0-beta.31 en producción — decisión de usar beta vs esperar stable

Crítico

ADR-003

Vercel Hobby (10s timeout, sin SLA) como hosting de plataforma de negocio

Crítico

ADR-004

Cron implementado como API route (/api/cron/generate-checklists) — alternativas evaluadas

Alto

ADR-005

Airtable Free en producción con 1,000 registros como límite — plan de upgrade

Crítico

ADR-006

Tailwind CSS v4 con tokens OKLch — compatibilidad en Android 10–11 en Chile

Medio

ADR-007

Airtable SDK 0.12.2 vs API REST v0 (deprecated) — cuál se usa realmente

Alto

ADR-008

PWA sin estrategia de cache offline — decisión de no soportar checklists offline

Alto

Acción: 1 día de trabajo

Documentar estos 8 ADRs es aproximadamente 1 día de trabajo para Sergio Gary (Créalo). No cambia ningún código — solo documenta lo que ya fue decidido. Sin esta documentación, el proyecto es técnicamente insostenible a largo plazo.

07 · Plan de Acción

P0 esta semana · P1 en 2 semanas · P2 en 1 mes · P3 en Q3

P0 — Antes del 16 de mayo (urgente)

Actualizar Airtable Free → Team ($20/mes)

Con 182 registros dinámicos/día, los 742 disponibles se agotan en 4.1 días. Tras ese punto, todos los usuarios ven "Base limits reached". Esta es la única acción que previene un corte total de servicio.

Responsable: Créalo SpA o cliente · Tiempo: 5 min · Costo: $20 USD/mes

Corregir timezone cron (UTC → America/Santiago)

Si el cron está en 7:00 UTC, los checklists se generan a las 10–11 AM Chile. Los trabajadores llegan a las 9 AM sin checklists. Cambiar la expresión cron para compensar el offset UTC-3/UTC-4.

Responsable: Sergio Gary · Tiempo: 30 min · Riesgo: Bajo

Aplicar permisos en todas las API routes (resolver IDOR)

Aplicar hasPermission() y getDataScope() ya implementados en lib/auth/permissions.ts a los 10 API routes. Actualmente la seguridad está solo en la UI.

Responsable: Sergio Gary · Tiempo: 1–2 días · Requiere testing posterior

P1 — Antes del 25 de mayo (alta prioridad)

Instalar Sentry (error tracking gratuito)

Sentry Free se integra con Next.js en 15 minutos. Captura errores con stack trace, contexto de usuario y frecuencia. Sin Sentry, el sistema es ciego en producción — los errores llegan por WhatsApp.

Responsable: Créalo · Tiempo: 2 horas · Costo: $0

Migrar Vercel Hobby → Pro (o reestructurar cron en batches)

El cron falla con 36+ plantillas en Vercel Hobby (10s). Opción A: Vercel Pro da 60s de timeout por $20/mes. Opción B: procesar en batches de 5 plantillas. Opción A es más rápida.

Responsable: Créalo · Tiempo: 1 día · Costo: $20/mes Vercel Pro

Proteger cierre de caja contra doble submit + persistencia localStorage

Agregar protección doble-click en Cierre de Caja y Depósitos. Implementar guardado automático en localStorage para checklists. Estos dos cambios resuelven S1-04, S1-05 y S1-07 simultáneamente.

Responsable: Sergio · Tiempo: 2–3 días

Agregar indicador de estado del cron en dashboard de supervisión

El dashboard debe mostrar si el cron corrió exitosamente hoy. Si no corrió a las 7:15 AM ± 30 min, mostrar alerta roja. Elimina el falso negativo S1-06 donde "0/0" aparece como correcto.

Responsable: Sergio · Tiempo: 1 día

P2 — Antes del 15 de junio

Documentar los 8 ADRs faltantes

No cambia la arquitectura — la documenta. Sin ADRs, cualquier cambio futuro parte de cero. Créalo debe documentar las 8 decisiones técnicas en formato estándar.

Responsable: Sergio (Créalo) · Tiempo: 1 día

Diseñar plan de migración DB para mes 7–10

La tabla Respuestas_Checklist alcanza 125,000 filas (límite Team) en ~8 meses. El plan debe incluir: schema PostgreSQL, script de migración, plan de rollback y ventana de mantenimiento. Diseñarlo ahora, ejecutarlo en Q3.

Responsable: Créalo + SMC · Tiempo: 1 semana de diseño

Completar cobertura Sonner al 80% de flujos críticos

Llevar las notificaciones toast de 20% a 80% de cobertura. Prioritario: cierre de caja exitoso, rechazo de checklist, descuadre detectado, depósito confirmado, pago a emprendedor ejecutado.

Responsable: Sergio · Tiempo: 3–5 días

P3 — Q3 2026 (julio–septiembre)

Ejecutar migración Respuestas_Checklist → Supabase

Implementar la migración diseñada en P2. Opción recomendada: mover solo Respuestas_Checklist a Supabase Free (mantener el resto en Airtable). Más rápida y menos riesgosa que migración completa.

Estimado: julio 2026 · Duración: 2–3 semanas · Riesgo: Medio con plan previo

Implementar CI/CD formal con GitHub Actions

Pipeline mínimo: type-check → lint → tests → preview deploy en PR → prod deploy en merge. Garantiza que no se rompan features existentes con cada deploy.

Estimado: agosto 2026 · Duración: 1 semana

08 · Cifras

El proyecto en números

Score final ponderado

/ 100 · F+ · vs 74 anterior

Defectos S1 críticos

bloqueantes producción

4–7

Días hasta colapso

Airtable Free · 182 reg/día

ADRs faltantes

decisiones sin documentar

Módulos en producción

de 12 planificados Fase 1

75+

Score con P0+P1

objetivo 2 semanas

Score histórico del debate

Evolución de la evaluación

SMC Original

67/100

C+

Créalo reclama

78/100

SMC ajustado

74/100

B−

SMC definitivo

49/100

F+

Con P0+P1 resueltos

75+

Cálculo Airtable Free — días hasta colapso

182 registros dinámicos/día · 742 disponibles

Instancias cron

/día

Respuestas ítems

144

/día

Cierres de caja

/día

Total dinámico

182

/día

Límite Free: 1,000 registros Seed inicial: 258 registros Disponibles: 742 registros ÷ 182/día = 4.1 días → COLAPSO

Estado defectos por severidad

29 defectos totales identificados

S1 Críticos

S2 Altos

S3 Medios

S4 Bajos

Score proyectado por fase

Con resolución progresiva de deuda

Hoy (F+)

Post P0

Post P0+P1

Post P2+P3

86+

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.