Business Observer KPI And Goals Audit 001 - APV

Fecha: 2026-06-04

Estado: AUDITORIA FUNCIONAL Y DE GOBIERNO

Scope: tenant

tenant_id: alpuntodeventa

Owner auditoria: Codex / apoyo documental

Fuente de verdad: docs/tenants/alpuntodeventa/business-observer/BUSINESS-OBSERVER-KPI-AND-GOALS-AUDIT-001.md

1. Objetivo

Esta auditoria revisa de forma integral los KPIs, objetivos, metas y cumplimiento del Business Observer del tenant alpuntodeventa antes de abrir cualquier nuevo caso de uso.

Busca responder:

• que KPIs ejecutivos necesita realmente APV
• que metas comerciales deberia poder definir
• que objetivos deberian ser medibles
• si Objetivos y Cumplimiento merece convertirse en caso de uso propio
• que indicadores necesita cada nivel de decision: Direccion Comercial, Supervisores y Vendedores

Restricciones respetadas:

• sin runtime
• sin VPS
• sin Docker
• sin OpenClaw runtime
• sin Portainer
• sin NPM
• sin SQL
• sin APIs
• sin IA
• sin dashboards
• sin tablas
• sin agentes

2. Documentos revisados

Lectura funcional completa realizada sobre:

• docs/tenants/alpuntodeventa/business-observer/README.md
• docs/tenants/alpuntodeventa/business-observer/BUSINESS-OBSERVER.md
• docs/tenants/alpuntodeventa/business-observer/USE-CASES.md
• docs/tenants/alpuntodeventa/business-observer/RULES.md
• docs/tenants/alpuntodeventa/business-observer/DECISIONS.md
• docs/tenants/alpuntodeventa/business-observer/DATA-NEEDS.md
• docs/tenants/alpuntodeventa/business-observer/PROJECT-STATE.md
• docs/tenants/alpuntodeventa/business-observer/ROADMAP.md
• docs/tenants/alpuntodeventa/business-observer/GROWTH-PLACEMENT.md
• docs/tenants/alpuntodeventa/business-observer/GROWTH-PLACEMENT-RULES.md
• docs/tenants/alpuntodeventa/business-observer/IMPACT-AND-LEARNING.md
• docs/tenants/alpuntodeventa/business-observer/UNSERVED-DEMAND.md
• docs/tenants/alpuntodeventa/business-observer/OPERATING-CALENDAR-AND-TIME-INTELLIGENCE.md
• docs/tenants/alpuntodeventa/business-observer/MARKET-PRICING-INTELLIGENCE.md
• docs/tenants/alpuntodeventa/business-observer/PRIORITIZED-COMMERCIAL-RECOMMENDATIONS.md
• docs/tenants/alpuntodeventa/business-observer/ASSORTMENT-AND-MIX-INTELLIGENCE.md
• docs/tenants/alpuntodeventa/business-observer/SUPPLIER-AND-SUPPLY-INTELLIGENCE.md
• docs/tenants/alpuntodeventa/business-observer/BUSINESS-OBSERVER-GAP-AUDIT-001.md
• docs/tenants/alpuntodeventa/business-observer/BUSINESS-OBSERVER-AUDIT-001.md
• docs/tenants/alpuntodeventa/business-observer/PRICING-AUDIT-001.md
• docs/tenants/alpuntodeventa/business-observer/UC006-PRICING-SCOPE-AUDIT.md
• docs/business/OPENCLAW-BUSINESS-OBSERVER.md
• docs/business/use-cases/BUSINESS-OBSERVER-USE-CASE-001-CLIENTES-EN-RIESGO.md
• docs/business/use-cases/BUSINESS-OBSERVER-USE-CASE-001-RULES.md
• docs/business/use-cases/BUSINESS-OBSERVER-USE-CASE-002-CRECIMIENTO-Y-COLOCACION-ESTRATEGICA.md
• docs/PROJECT-STATE.md
• docs/ROADMAP.md

3. Resumen ejecutivo

Veredicto principal:

• APV necesita una capa explicita de KPIs, metas y cumplimiento
• esa capa es muy valiosa, pero no debe nacer primero como microcaso aislado
• hoy su sujeto principal no es una sola senal, sino la consolidacion y el gobierno de senales ya producidas por UC001 a UC009
• por eso, en esta etapa, conviene mantener Objetivos y Cumplimiento como capacidad transversal y no como UC010 inmediato

Motivo:

• UC001 a UC009 ya cubren observacion de riesgo, crecimiento, aprendizaje, demanda perdida, tiempo, pricing, recomendacion, surtido y abastecimiento
• un UC010 abierto demasiado pronto correria el riesgo de duplicar media plataforma documental
• la mayoria de los objetivos de APV dependen de combinar multiples casos, no de crear un sujeto nuevo y puro

Recomendacion formal:

• opcion recomendada hoy: B) Mantener como capacidad transversal
• condicion para reabrir A) Crear UC010 Objetivos y Cumplimiento: cuando APV cierre taxonomias oficiales de metas, owners, ventanas de revision, criterios de desvio y semaforos de cumplimiento

4. Lectura de negocio base

La documentacion vigente muestra que APV no necesita medir por medir.

Necesita medir para:

• proteger clientes
• proteger marcas estrategicas
• crecer con siembra comercial
• evitar faltantes comercialmente costosos
• defender margen sin perder lectura de volumen
• ordenar el trabajo de direccion, supervision y vendedores

Por eso, un buen catalogo de KPIs para APV debe cumplir cinco condiciones:

• ser explicable en lenguaje comercial simple
• conectar con una accion real
• respetar la jerarquia perder cliente > perder marca > perder volumen
• no mezclar evidencia confirmada con estimacion sin aclararlo
• no confundir Core reusable con decision comercial APV

5. Principios de gobierno para KPIs y metas

Principios recomendados:

• no todo lo medible merece ser objetivo
• no todo objetivo merece bajar a todos los roles
• cada KPI debe declarar si es de resultado, proceso, riesgo u oportunidad
• cada KPI debe declarar si es evidencia directa o estimacion
• cada KPI debe tener una frontera clara con su UC de origen
• ningun KPI tenant debe reescribirse como regla Core

Clasificacion recomendada:

• KPI de resultado: muestra negocio logrado o perdido
• KPI de riesgo: muestra negocio bajo amenaza
• KPI de oportunidad: muestra espacio comercial capturable
• KPI de capacidad: muestra si la empresa puede sostener la accion
• KPI de cumplimiento: compara objetivo contra real
• KPI de aprendizaje: muestra si las practicas elegidas funcionan

6. KPIs de empresa

APV necesita un set chico de KPIs empresa para direccion.

KPIs empresa prioritarios:

1. facturacion neta
2. margen bruto estimado
3. rentabilidad comercial estimada
4. clientes activos
5. clientes en riesgo total
6. participacion de marcas estrategicas sobre ventas
7. crecimiento total vs periodo comparable
8. crecimiento por dias trabajados
9. oportunidad economica perdida estimada total
10. demanda no atendida confirmada total
11. cobertura operativa de stock en lineas estrategicas
12. distribucion numerica de marcas estrategicas
13. amplitud promedio de surtido por cliente
14. cumplimiento global de objetivos comerciales
15. productividad comercial por dia trabajado

Lectura:

• empresa no debe mirar solo facturacion
• para APV, riesgo, marca, abastecimiento, surtido y productividad son igual de importantes para explicar calidad del negocio

7. KPIs por marca

KPIs por marca recomendados:

1. ventas por marca
2. margen por marca
3. crecimiento por marca
4. clientes compradores por marca
5. distribucion numerica por marca
6. participacion de la marca en la cartera
7. clientes en riesgo que afectan esa marca
8. clientes que abandonan esa marca
9. colocaciones iniciales por marca
10. recompra posterior por marca
11. huecos de surtido por marca
12. faltantes y dias sin stock por marca
13. oportunidad perdida estimada por marca
14. tension de precio por marca
15. cumplimiento de meta de marca

8. KPIs por proveedor

KPIs por proveedor recomendados:

1. ventas atribuibles al proveedor
2. crecimiento del proveedor
3. margen atribuible al proveedor
4. distribucion lograda para lineas comprometidas
5. faltantes asociados al proveedor
6. quiebres recurrentes asociados al proveedor
7. oportunidad perdida estimada asociada al proveedor
8. productos reclamados asociados al proveedor
9. cobertura operativa promedio del proveedor
10. cumplimiento de compromisos comerciales del proveedor
11. participacion del proveedor en marcas estrategicas
12. cumplimiento de meta del proveedor

9. KPIs por zona

KPIs por zona recomendados:

1. ventas por zona
2. margen por zona
3. clientes activos por zona
4. clientes en riesgo por zona
5. crecimiento por zona
6. distribucion de marcas estrategicas por zona
7. penetracion de SKU prioritarios por zona
8. productividad por dia trabajado por zona
9. tension de precio por zona
10. faltantes y reclamos por zona
11. huecos de surtido por zona
12. cumplimiento de objetivos de zona

10. KPIs por supervisor

KPIs por supervisor recomendados:

1. ventas del equipo
2. margen del equipo
3. clientes en riesgo del equipo
4. tasa de recuperacion del equipo
5. crecimiento por colocacion del equipo
6. distribucion de marcas estrategicas del equipo
7. cumplimiento de metas del equipo
8. productividad por vendedor ajustada por dias trabajados
9. calidad de ejecucion de recomendaciones
10. mix promedio de cartera del equipo
11. faltantes que afectan al equipo
12. aprendizaje replicable del equipo

11. KPIs por vendedor

KPIs por vendedor recomendados:

1. ventas
2. margen
3. clientes activos
4. clientes en riesgo
5. clientes recuperados
6. crecimiento de cartera
7. primeras compras generadas
8. colocaciones consolidadas
9. amplitud de surtido ganada
10. productividad por dia trabajado
11. pedidos no atendidos reportados
12. efectividad de recomendaciones ejecutadas
13. cumplimiento de objetivos
14. participacion de marcas estrategicas en su cartera
15. mix por cliente de su cartera

12. Objetivos posibles

Objetivos comerciales que si merecen existir en APV:

• ventas
• crecimiento
• colocacion
• participacion de marca
• mix
• recuperacion
• abastecimiento
• margen
• rentabilidad
• productividad

Lectura de cada uno:

Ventas

Valido como objetivo.

Debe medirse con cuidado porque vender mas no siempre significa vender mejor.

Crecimiento

Valido como objetivo.

Debe distinguir:

• crecimiento de base actual
• crecimiento por siembra
• crecimiento por ampliacion

Colocacion

Muy valido para APV.

Es uno de los pocos objetivos realmente alineados con su logica de trabajo hormiga.

Participacion

Valido, sobre todo para marcas estrategicas.

Debe evitarse usarlo sin clasificacion oficial de marcas.

Mix

Valido, pero dificil de explicar si no se simplifica.

Debe traducirse en metas concretas de amplitud, profundidad o presencia de SKU prioritarios.

Recuperacion

Muy valido para UC001 y UC003.

Debe medirse como recuperacion de cliente o recuperacion de compra sana, no solo como venta puntual.

Abastecimiento

Valido para direccion y supervision.

No deberia bajar como objetivo principal del vendedor salvo en lo que reporta.

Margen

Valido y necesario.

Debe usarse con cuidado para no castigar crecimiento de siembra o defensa de marca donde el margen puede tensionarse temporalmente.

Rentabilidad

Valida a nivel direccion y marca.

Mas dificil de bajar a vendedor si la explicacion no es buena.

Productividad

Valida si se corrige por dias trabajados y cartera.

Peligrosa si se usa sola y sin contexto.

13. Metas por nivel

Niveles donde APV si deberia poder fijar metas:

Empresa

• ventas totales
• margen total
• clientes activos
• clientes en riesgo maximo tolerado
• distribucion de marcas estrategicas
• oportunidad perdida maxima tolerada
• cumplimiento global de crecimiento

Marca

• ventas por marca
• clientes compradores por marca
• distribucion por marca
• crecimiento por marca
• participacion por marca
• meta de faltantes maximos por marca estrategica

Proveedor

• ventas del proveedor
• distribucion comprometida
• disponibilidad minima
• reclamos maximos tolerados
• cumplimiento de acuerdo comercial

Zona

• ventas
• crecimiento
• clientes activos
• penetracion de marcas estrategicas
• productividad por dia trabajado

Supervisor

• ventas del equipo
• cartera en riesgo
• recuperacion
• crecimiento por colocacion
• cumplimiento del equipo

Vendedor

• ventas
• clientes activos
• recuperaciones
• colocaciones
• amplitud de surtido
• cumplimiento de foco prioritario

Cliente

• frecuencia objetivo
• amplitud de surtido objetivo
• presencia de marcas estrategicas
• recuperacion esperada

SKU

• distribucion
• recompra
• cobertura operativa
• oportunidad perdida maxima tolerada

14. Objetivos que realmente deberian ser medibles

Objetivos que hoy ya tienen sustento funcional para ser medibles:

• clientes activos
• clientes en riesgo por nivel
• clientes recuperados
• dias sin compra
• participacion de marca
• ventas por marca
• primeras compras
• recompra
• demanda no atendida confirmada
• oportunidad perdida estimada
• dias sin stock
• productividad por dia trabajado
• cobertura operativa de stock
• relevamientos de precio comparables
• recomendaciones ejecutadas
• huecos de surtido detectados
• productos reclamados

Objetivos que todavia no deberian tratarse como medibles duros sin mas cierre:

• rentabilidad exacta por vendedor
• elasticidad comercial
• mix ideal total por cliente
• meta final de cliente subdesarrollado
• meta exacta de precio correcto por plaza

Razon:

• la documentacion actual los reconoce como importantes, pero aun no les da definicion funcional suficientemente estable

15. Indicadores por rol

Direccion Comercial

Debe ver:

• facturacion
• margen
• rentabilidad
• clientes activos
• clientes en riesgo
• participacion de marcas estrategicas
• crecimiento por marca
• crecimiento por zona
• oportunidad perdida
• faltantes y quiebres criticos
• cobertura operativa de lineas estrategicas
• cumplimiento de metas globales
• efectividad de recomendaciones
• aprendizaje comercial repetible

Supervisores

Debe ver:

• ventas del equipo
• margen del equipo
• cartera en riesgo por vendedor
• recuperaciones
• colocaciones
• surtido ganado
• productividad por dia trabajado
• recomendaciones pendientes y ejecutadas
• reclamos, faltantes y quiebres que afectan al equipo
• cumplimiento por vendedor y por zona

Vendedores

Debe ver:

• clientes de su cartera en riesgo
• clientes a recuperar
• clientes elegibles para colocacion
• SKU natural siguiente
• oportunidades de cross-selling y up-selling priorizadas
• faltantes que afectan sus cuentas
• recomendaciones accionables
• progreso contra sus metas
• productividad propia por dia trabajado

16. Relacion con UC001 a UC009

UC001 - Clientes en riesgo comercial

Alimenta:

• clientes en riesgo
• clientes que dejaron de comprar
• riesgo acumulado por vendedor
• riesgo acumulado por zona
• clientes que abandonan marcas estrategicas
• participacion de cartera en riesgo
• tasa de recuperacion futura

UC002 - Crecimiento y colocacion estrategica

Alimenta:

• primeras compras
• clientes elegibles
• colocaciones
• crecimiento por siembra
• crecimiento por ampliacion
• distribucion de SKU
• penetracion de marca
• cumplimiento de compromisos de crecimiento

UC003 - Impacto y aprendizaje comercial

Alimenta:

• efectividad de acciones
• repetibilidad de practicas
• tiempo hasta respuesta
• tiempo hasta recompra
• aprendizaje por vendedor
• aprendizaje por supervisor
• calidad de recomendacion futura

UC004 - Demanda no atendida y oportunidad economica perdida

Alimenta:

• demanda no atendida confirmada
• demanda no atendida estimada
• oportunidad economica perdida
• margen no generado estimado
• aceptacion de sustitutos
• productos pedidos y no servidos

UC005 - Calendario operativo e inteligencia temporal

Alimenta:

• ventas por dia trabajado
• productividad por dia trabajado
• forecast sobre dias efectivos
• cobertura operativa
• urgencia temporal
• cumplimiento ajustado por dias efectivos

UC006 - Inteligencia de mercado y pricing

Alimenta:

• tension de precio
• comparabilidad de relevamientos
• brecha precio propio vs mercado
• contexto de margen
• lectura territorial de precio
• vigencia de costo y precio

UC007 - Recomendaciones comerciales priorizadas

Alimenta:

• recomendaciones generadas
• recomendaciones ejecutadas
• recomendaciones escaladas
• trazabilidad recomendado vs ejecutado vs resultado
• foco comercial por actor

UC008 - Inteligencia de surtido y mix

Alimenta:

• huecos de surtido
• clientes subdesarrollados
• amplitud de surtido
• profundidad de surtido
• SKU natural siguiente
• cross-selling
• up-selling

UC009 - Inteligencia de proveedores y abastecimiento

Alimenta:

• quiebres y faltantes por proveedor
• productos reclamados
• SKU criticos
• proveedores criticos
• impacto de abastecimiento
• cobertura de lineas estrategicas

17. Capacidades faltantes alrededor de objetivos y cumplimiento

Faltantes reales detectados:

• taxonomia oficial de objetivos comerciales
• owner formal de cada meta
• ventana oficial de revision de metas
• criterio oficial de desvio aceptable
• regla para distinguir cumplimiento, avance, proyeccion y desvio
• semaforos aprobados por direccion
• priorizacion entre metas conflictivas

Lectura:

• hoy faltan mas reglas de gobierno que un caso de uso nuevo
• el problema principal no es ausencia de sujeto
• el problema principal es ausencia de contrato funcional comun de metas

18. Riesgos principales

Exceso de metricas

Riesgo alto.

Si APV baja demasiados KPIs, el observer puede volverse un catalogo de lecturas sin foco.

Metricas contradictorias

Ejemplos:

• empujar volumen sacrificando margen
• empujar colocacion sin stock
• empujar crecimiento donde el cliente esta en riesgo critico

Objetivos incompatibles

Ejemplos:

• meta agresiva de colocacion con meta agresiva de margen minimo
• meta de disponibilidad alta sin criterio de prioridad de SKU
• meta de productividad diaria sin ajuste por cartera ni dias efectivos

Indicadores dificiles de explicar

Ejemplos:

• rentabilidad exacta por vendedor
• mix ideal total
• elasticidad inferida
• cumplimiento de meta sin explicar base, ventana y contexto

Confusion entre evidencia y estimacion

Ejemplos:

• presentar oportunidad perdida como venta exacta
• presentar precio relevado dudoso como tension confirmada
• presentar hueco de surtido como rechazo real

19. Validacion Core vs Tenant

Debe quedar en Core:

• patron de KPI
• patron de objetivo
• patron de avance vs desvio
• patron de recomendacion explicada
• patron de trazabilidad y auditoria

Debe quedar en APV:

• jerarquia perder cliente > perder marca > perder volumen
• lista de marcas estrategicas
• lista de productos prioritarios
• criterio de cliente estrategico
• criterio de proveedor critico
• ventanas comerciales
• pesos relativos entre metas

Conclusion:

• Objetivos, metas y cumplimiento no son automaticamente Core
• su estructura abstracta puede ser Core
• su contenido concreto debe vivir en APV

20. Duplicaciones y contradicciones revisadas

No se detectaron contradicciones bloqueantes con UC001 a UC009.

Si se detectaron riesgos de duplicacion en:

• mix entre UC001, UC002 y UC008
• proveedor entre UC002, UC003, UC004 y UC009
• margen entre documento Core, UC004, UC006 y metas futuras
• cumplimiento como idea dispersa entre UC002, UC003, UC005 y UC007

Juicio:

• no hay choque documental grave
• si hay necesidad clara de un glosario comun de objetivos y cumplimiento

21. Recomendacion final

Opcion A - Crear UC010 Objetivos y Cumplimiento

Ventajas:

• daria un sujeto formal a metas, desvio y seguimiento
• haria visible el cumplimiento por empresa, zona, supervisor y vendedor
• podria ordenar semaforos, avance y cumplimiento

Desventajas hoy:

• duplicaria lectura ya repartida en UC002, UC003, UC005, UC007 y parcialmente UC008 y UC009
• correria el riesgo de nacer como contenedor de todo lo que no entra en otro lado
• hoy APV todavia no tiene cerradas las taxonomias minimas para gobernarlo

Opcion B - Mantener como capacidad transversal

Ventajas:

• aprovecha las senales ya producidas por UC001 a UC009
• obliga primero a cerrar owners, metas y reglas comunes
• evita abrir un caso artificial antes de cerrar su lenguaje
• permite bajar cumplimiento por rol sin romper fronteras funcionales ya razonables

Desventajas:

• requiere disciplina documental para no dejarlo difuso
• exige un glosario comun y futura consolidacion

Decision recomendada

Recomendacion final:

B) Mantener como capacidad transversal

Justificacion amplia:

• la documentacion vigente muestra que Objetivos y Cumplimiento es una capa de consolidacion, no una capacidad primaria aislada
• sus indicadores se alimentan desde varios UC
• abrirlo ya como UC010 agregaria una frontera artificial antes de cerrar reglas de negocio mas basicas
• APV necesita antes definir:
• catalogo oficial de objetivos
• ventanas de medicion
• owners por nivel
• criterios de conflicto entre metas
• semaforos y tolerancias

Condicion futura para reabrir UC010:

• si APV decide tratar cumplimiento como objeto principal con workflows, rituales de revision y gobierno propio, entonces si merecera transformarse en caso de uso separado

22. Top 50 KPIs mas valiosos para APV

Ranking por impacto comercial esperado:

1. clientes en riesgo critico
2. clientes que dejaron de comprar
3. participacion de marcas estrategicas
4. facturacion neta
5. margen bruto estimado
6. clientes activos
7. crecimiento por marca estrategica
8. oportunidad economica perdida estimada
9. demanda no atendida confirmada
10. cobertura operativa de SKU estrategicos
11. clientes recuperados
12. crecimiento por colocacion
13. primeras compras generadas
14. recompra posterior
15. faltantes recurrentes
16. quiebres criticos
17. huecos de surtido por cliente
18. amplitud de surtido por cliente
19. SKU natural siguiente de alto potencial
20. productividad por dia trabajado
21. ventas por vendedor
22. margen por vendedor
23. ventas por zona
24. margen por zona
25. clientes en riesgo por vendedor
26. clientes en riesgo por zona
27. distribucion numerica por marca estrategica
28. penetracion de SKU prioritarios
29. crecimiento por supervisor
30. cumplimiento de compromisos con proveedores
31. productos reclamados
32. proveedor critico por impacto
33. oportunidad perdida por marca
34. oportunidad perdida por proveedor
35. comparabilidad de relevamientos de precio
36. brecha precio propio vs mercado
37. brecha costo vs precio propio
38. recomendaciones ejecutadas
39. efectividad de recomendaciones
40. recomendado vs ejecutado vs resultado
41. cross-selling efectivo
42. up-selling efectivo
43. clientes subdesarrollados
44. productividad por supervisor
45. venta por dia trabajado
46. forecast de cierre ajustado por dias efectivos
47. dias sin stock comercialmente relevantes
48. tasa de aceptacion de sustitutos
49. aprendizaje comercial repetible
50. cumplimiento global de metas comerciales

23. Impacto sobre PROJECT-STATE y ROADMAP

Resultado de validacion:

• no se detecto inconsistencia real que obligue a modificar docs/PROJECT-STATE.md
• no se detecto inconsistencia real que obligue a modificar docs/ROADMAP.md
• tampoco se detecto contradiccion suficiente para modificar docs/tenants/alpuntodeventa/business-observer/PROJECT-STATE.md o docs/tenants/alpuntodeventa/business-observer/ROADMAP.md

Razon:

• la documentacion actual ya reconoce UC007, UC008 y UC009
• el gap previo ya trataba Objetivos y Cumplimiento como capacidad parcial
• esta auditoria refina el criterio, pero no cambia el estado oficial del roadmap

24. Cierre de auditoria

Confirmaciones:

• no se toco runtime
• no se toco VPS
• no se toco Docker
• no se toco OpenClaw runtime
• no se toco Portainer
• no se toco NPM
• no se diseno SQL
• no se disenaron APIs
• no se diseno IA

Resultado final:

• APV si necesita una capa seria de KPIs, metas y cumplimiento
• esa capa debe construirse sobre UC001 a UC009
• hoy conviene mantenerla transversal
• el proximo paso correcto no es crear mas metrica
• el proximo paso correcto es gobernar pocas metas, muy explicables y ligadas a accion comercial real