24 de abril de 2026

Reportes e indicadores

Manual detallado para leer los paneles de Ballista: indicadores financieros, clientes, ventas, operaciones, fórmulas, riesgos, acciones y mejoras recomendadas.

La pantalla Reportes de Ballista debe leerse como un tablero de decisiones, no como una colección de números. Su trabajo es ayudar a responder preguntas concretas: qué está vendiendo el negocio, qué clientes vuelven, qué pedidos se pagan, qué inventario se está consumiendo, dónde hay conflictos y qué acciones debe tomar el equipo.

Un indicador es una medida cuantificable conectada con un objetivo de negocio. No todo número merece estar al frente del tablero. En Ballista esto importa porque la pantalla mezcla indicadores de primer nivel, métricas diagnósticas y descargas de soporte. Si todo se interpreta como igual de importante, el panel deja de guiar y empieza a hacer ruido.

Rutas y vistas del flujo

Ruta/vista	Qué muestra	Para qué se usa
`/reports`	Página principal de reportes.	Alterna entre resumen operativo y indicadores de crecimiento.
Resumen operativo	Reportes operativos, indicadores financieros básicos, ventas por día, productos, materiales, clientes frecuentes y descargas.	Revisar qué pasó en el periodo y exportar evidencia.
Crecimiento de clientes	Panel de indicadores por categorías: ingresos, clientes, eficiencia comercial, salud financiera y concentración.	Leer salud del negocio y comparar periodo actual contra periodo anterior.
Panel dentro del resumen	Vista visual de reportes.	Revisar indicadores, listas y barras rápidas.
Descargas de Excel	Botones de descarga.	Sacar CSV/PDF para contabilidad, auditoría, compras o análisis externo.

Marco de lectura

Ballista mezcla cuatro familias de indicadores:

Familia	Indicadores en la app	Pregunta de negocio
Finanzas	Ventas del periodo, costos del periodo, utilidad neta, crecimiento de ventas, crecimiento de margen, flujo de caja y cuentas por cobrar.	¿Estoy vendiendo, ganando y cobrando bien?
Clientes	Clientes activos, recompra, valor de vida del cliente, pérdida de clientes, clientes inactivos, clientes nuevos frente a perdidos, ingreso por cliente y concentración de clientes.	¿La base de clientes está creciendo, reteniendo y diversificada?
Comercial	Pedidos pagados, tasa de conversión, pedidos por cliente, frecuencia de compra, ventas por día, productos más vendidos y clientes frecuentes.	¿Las oportunidades se convierten en pedidos útiles y repetibles?
Operaciones	Pedidos completados, conflictos de inventario, materiales más usados, operaciones de factura electrónica y descargas de inventario/costos.	¿La operación puede sostener lo que ventas promete?

La lectura correcta no es mirar cada tarjeta aislada. La lectura correcta es conectar tensiones. Si ingresos sube pero los conflictos de inventario también suben, el negocio puede estar vendiendo más de lo que puede cumplir. Si los pedidos pagados suben pero cuentas por cobrar también sube, puede haber ventas sin cobro. Si los clientes activos suben pero la recompra baja, puede haber adquisición sin retención.

Base conceptual

La lógica de la página se parece a un Balanced Scorecard: no mirar solo finanzas, sino también clientes, procesos internos y capacidad de mejora. Un número se vuelve útil cuando tiene cuatro piezas:

Pieza	Pregunta
Objetivo	¿Qué queremos mejorar?
Medida	¿Cómo lo vamos a medir?
Meta	¿Qué valor esperamos?
Iniciativa	¿Qué haremos si se desvía?

Por eso el panel no debe terminar en "mira el número". Debería terminar en una acción: llamar clientes, cobrar facturas, revisar inventario, cambiar precios, planear compras, corregir estados de orden o investigar un producto.

Cómo funciona la pantalla `Reportes`

La página de reportes tiene dos pestañas principales.

Pestaña	Componente	Qué consulta
Resumen operativo	`ReportsOverviewPanel`	Resumen financiero, estados de pedidos, panel mínimo, ventas por periodo, materiales más usados, productos más vendidos y clientes frecuentes.
Crecimiento de clientes	`KpiDashboardPanel`	Calcula 18 indicadores usando el rango actual y un periodo anterior de igual duración.

Ambas vistas tienen filtros de fecha. El rango se envía al servidor como fechaInicio y fechaFin. En crecimiento de clientes, si el usuario elige del 1 al 15 de abril, el servidor compara contra un periodo anterior de la misma longitud: del 16 al 31 de marzo, aproximadamente según el cálculo de fechas.

Resumen operativo

Esta vista responde: "qué pasó operativamente en este rango?".

Filtros de fecha

Campo	Uso
`Start date`	Inicio del periodo a analizar.
`End date`	Fin del periodo a analizar.

Cambiar fechas afecta todos los queries de la vista: ventas, costos, pedidos por estado, panel mínimo, productos, materiales y clientes.

Botones de exportación

Botón	Qué exporta	Para qué sirve
`Export CSV`	Clientes frecuentes filtrados en la tabla.	Compartir clientes, contacto, pedidos y total comprado.
`CSV Inventario (range)`	Inventario con lotes desde servidor.	Revisar inventario disponible/lotes en una hoja externa.
`CSV Raw material costs`	Costos de materia prima por rango.	Analisis de costos, compras o margen.
`CSV Monthly orders`	Pedidos del mes del servidor.	Cierre mensual o conciliación.
`CSV Raw materials`	Catálogo/export de materias primas.	Auditoría o revisión de catálogo.
`CSV Daily inventory`	Inventario al día.	Corte operativo de existencias.
`Export PDF`	Imprime la vista actual.	Compartir una versión visual del reporte.

Estos botones no son indicadores. Son mecanismos de soporte para auditoría, análisis externo o conciliación.

indicadores de Resumen operativo

Ventas del periodo

Punto	Explicación
Qué mide	Ventas/ingresos del rango seleccionado.
Fuente app	`getFinancialSummary`, campo `income` o `ingresos`.
Tipo	indicador financiero de resultado.
Lectura buena	Sube junto con margen, cobro y pedidos sanos.
Riesgo	Si sube sin cobro o sin margen, puede ser crecimiento frágil.
Acción	Comparar con `Costos del periodo`, `Utilidad neta`, `pedidos pagados`, `Flujo de caja` y `Cuentas por cobrar`.

Este indicador responde "cuánto vendí?". No responde "si vendi bien". Para eso necesita el resto del tablero.

Costos del periodo

Punto	Explicación
Qué mide	Costos asociados al periodo, según el resumen financiero del servidor.
Fuente app	`getFinancialSummary`, campo `costs` o `costos`.
Tipo	indicador/metric financiera de costo directo.
Lectura buena	Crece más lento que ventas o se mantiene controlado.
Riesgo	Si representa principalmente materia prima, no debe confundirse con todos los gastos contables.
Acción	Revisar `Materiales más usados`, `CSV Raw material costs` y margen.

En la app hay una señal importante: existen descargas específicos de Raw material costs. Eso sugiere que parte del costo está muy ligado a materia prima/costo directo. Si no incluye gastos operativos, salarios, alquiler, impuestos y gastos financieros, no debe interpretarse como costo total contable.

Utilidad neta

Punto	Explicación
Qué mide	`income - costs` según el resumen financiero.
Fuente app	`getFinancialSummary`, campo `profit` o `ganancia`.
Tipo	Resultado financiero, pero con advertencia semántica.
Lectura buena	Sube porque ingresos sube y costos están controlados.
Riesgo	El nombre "Utilidad neta" puede ser demasiado fuerte si no descuenta todos los gastos.
Acción	Si la fórmula solo descuenta costos directos, renombrar a `Gross profit` o `Contribution margen`.

Esta es una observación clave: "net profit" en contabilidad normalmente significa utilidad neta después de costos, gastos operativos, financieros e impuestos. Si Ballista solo resta costos directos de materia prima o costos estimados de orden, entonces la métrica es útil, pero el nombre debería ser más honesto.

pedidos pagados

Punto	Explicación
Qué mide	Pedidos en estado `pagado` sobre pedidos analizados del periodo.
Fuente app	`getOrdersByStatus`; interfaz suma todos los estados y cuenta los `pagado`.
Tipo	indicador comercial-financiero.
Lectura buena	Alta proporción de pedidos pagados sobre pedidos creados.
Riesgo	`pagado` no siempre significa entregado, facturado o completado.
Acción	Comparar con `Pedidos completados`, `tasa de conversión`, `Flujo de caja` y `operaciones de factura electrónica`.

Si aparece 100/304, significa que 100 pedidos del conjunto analizado están pagados y 304 es el total de pedidos por estado. No significa necesariamente que 100 pedidos estén completos.

Intentos de inicio de sesión

Punto	Explicación
Qué mide	Intentos de login registrados en el panel mínimo.
Fuente app	`getMinimalDashboard`, bloque `login.total`.
Tipo	Métrica diagnóstica de soporte/seguridad, no indicador de negocio central.
Lectura buena	Estable y coherente con actividad esperada.
Riesgo	Tratarlo como indicador de negocio cuando solo mide uso/acceso.
Acción	Usarlo para seguridad, soporte o adopción, no para evaluar ventas.

Solo sería indicador de primer nivel si el objetivo estratégico fuera adopción, seguridad o disponibilidad de usuarios.

Pedidos completados

Punto	Explicación
Qué mide	Operaciones de pedido completo registradas por panel mínimo.
Fuente app	`getMinimalDashboard`, bloque `completeOrder.total`.
Tipo	Métrica operacional.
Lectura buena	Aumenta cuando el flujo de orden completa se usa correctamente.
Riesgo	Puede medir intentos/operaciones, no necesariamente pedidos entregados.
Acción	Comparar con `pedidos pagados`, `tasa de conversión` y estados reales de Pedidos.

No confundas este contador con completedOrders del panel de crecimiento, que viene de estados de sales_orders (done, completado, delivered, entregado).

Conflictos de inventario

Punto	Explicación
Qué mide	Conflictos de inventario registrados en el periodo.
Fuente app	`getMinimalDashboard`, bloque `inventoryConflicts.total`.
Tipo	indicador operativo si la promesa de entrega depende de inventario.
Lectura buena	Bajo o descendente.
Riesgo	Si sube junto con ventas, el crecimiento está generando fricción operativa.
Acción	Revisar lotes, productos compuestos, materiales principales y órdenes fallidas por inventario disponible.

Este puede ser uno de los indicadores más importantes de Ballista porque conecta demanda con capacidad real. Una venta que no puede prepararse no es solo venta: es atraso, soporte, retrabajo y posible pérdida de confianza.

operaciones de factura electrónica

Punto	Explicación
Qué mide	Operaciones relacionadas con factura electrónica.
Fuente app	`getMinimalDashboard`, bloque `electronicInvoice.total`.
Tipo	Métrica de soporte/control fiscal; puede ser indicador si facturación electrónica es crítica.
Lectura buena	Coherente con pedidos que deben facturarse y con historial de facturación.
Riesgo	Un número alto no dice si las facturas fueron aceptadas, rechazadas o pendientes.
Acción	Comparar con `historial de facturación`, estados FE y órdenes `sin facturar`.

No basta contar operaciones FE. Para tomar decisiones fiscales se necesita separar emitidas, aceptadas, rechazadas, pendientes y fallidas.

Analisis visual de Resumen operativo

ventas por día

Punto	Explicación
Qué muestra	Ventas agrupadas por día: cantidad de pedidos y total vendido.
Fuente app	`getSalesByPeriod`.
Uso	Detectar picos, caidas, estacionalidad o días anormales.
Mejor visual	Barras o línea si la tarea es comparar/tendencia.
Acción	Abrir pedidos del día si hay pico raro o caida.

Esta vista funciona como diagnóstico. Si un día vende demasiado, pregunta que cliente/producto lo explica. Si un día cae a cero, pregunta si hubo cierre, falta de inventario disponible, problema de sistema o baja demanda.

productos más vendidos

Punto	Explicación
Qué muestra	Productos compuestos más vendidos y veces vendido.
Fuente app	`getTopProducts`.
Uso	Entender demanda y priorizar producción/inventario disponible.
Riesgo	Cuenta veces vendido, no necesariamente margen o ingresos.
Acción	Comparar con materiales principales, inventario y margen.

Un producto puede ser el más vendido y aun asi no ser el más rentable. Este indicador debe convivir con costos y materiales usados.

Materiales más usados

Punto	Explicación
Qué muestra	Materias primas más usadas, cantidad y costo total usado.
Fuente app	`getMostUsedMaterials`.
Uso	Identificar insumos criticos y presion de costos.
Riesgo	Si el costo sube, puede venir de precio unitario, volumen o ambos.
Acción	Revisar compras, lotes, proveedores, fórmulas y precios de venta.

Este indicador conecta reportes con inventario. Si un material es top por costo y también genera faltantes, probablemente merece regla de reposicion o alerta.

clientes frecuentes

Punto	Explicación
Qué muestra	Clientes con pedidos, contacto y total comprado.
Fuente app	`getTopClientes`.
Uso	Revisar clientes relevantes para venta, retención o cobranza.
Riesgo	Puede ocultar clientes nuevos prometedores si solo mira histórico del periodo.
Acción	Buscar cliente, exportar CSV o cruzar con concentration risk.

La tabla es mejor que una tarjeta cuando se necesita precisión: nombre, contacto, cantidad y total.

Crecimiento de clientes

Esta vista responde: "que tan sano está el motor comercial y financiero?". Usa categorias y tarjetas. Cada tarjeta tiene ayuda, fórmula visible y meta editable guardada en localStorage con la llave ballista-kpi-targets.

Categorias

Categoria	indicadores
`Ingresos y crecimiento`	Crecimiento de ventas, Crecimiento de margen, Crecimiento mensual de ventas, Ingresos del periodo.
`Salud de clientes`	Tasa de recompra, Clientes inactivos, Clientes activos, Ingreso por cliente, Valor de vida del cliente, Pérdida de clientes, Pérdida de ingresos, Clientes nuevos frente a perdidos.
`Eficiencia comercial`	tasa de conversión, Pedidos por cliente, frecuencia de compra.
`Salud financiera`	Flujo de caja, Cuentas por cobrar.
`Concentration risk`	Top customer concentration y tabla de top 5 clientes.

indicadores de Ingresos y crecimiento

Crecimiento de ventas

Punto	Explicación
Qué mide	Variacion porcentual de ingresos actual vs periodo anterior de igual duracion.
Fórmula visible	`(Current sales - Previous sales) / Previous sales x 100`.
Fuente servidor	`currentRevenue`, `previousRevenue`, `salesGrowthPct`.
Tipo	indicador de crecimiento.
Lectura buena	Positivo cuando el crecimiento viene con margen, cobro y operación sana.
Riesgo	Si el periodo anterior es 0, matemáticamente el porcentaje no está definido.
Acción	Si aparece crecimiento con base cero, leerlo como "sin base comparable" y mirar cambio absoluto.

Comportamiento actual de la app: el servidor usa growthPct(cur, prev) y si prev es 0 pero cur es mayor que 0 devuelve 100. Eso es fácil de entender visualmente, pero matemáticamente no es correcto como porcentaje. La recomendación es mostrar N/A, new / sin base comparable o delta absoluto en CRC.

Crecimiento de margen

Punto	Explicación
Qué mide	Variacion del margen actual contra margen anterior.
Fórmula visible	`(Current margen - Previous margen) / Previous margen x 100`.
Fuente servidor	`currentMargin = currentRevenue - currentCost`; `previousMargin = previousRevenue - previousCost`.
Tipo	indicador de calidad del crecimiento.
Lectura buena	Sube cuando el negocio no solo vende más, sino que conserva margen.
Riesgo	Si `cost` no incluye todos los costos, el margen es operativo/directo, no neto contable.
Acción	Investigar materiales principales y precios si ingresos sube pero margen growth cae.

Este indicador contesta "estamos ganando más o solo facturando más?". Es más ejecutivo que ingresos solo.

Crecimiento mensual de ventas

Punto	Explicación
Qué mide	En la interfaz usa el mismo valor que `salesGrowthPct`.
Fuente app	`getValue: d.salesGrowthPct`.
Tipo	indicador de crecimiento, pero el nombre puede confundir.
Lectura buena	Solo debería llamarse MoM si el rango realmente es mensual.
Riesgo	Si el usuario selecciona 10 días, "MoM" no es exactamente mes contra mes.
Acción	Renombrar a `Period growth` o calcular MoM real por mes calendario.

Esta es una mejora semántica importante: si la fórmula compara rangos elegidos por usuario, el nombre más preciso es Period sales growth.

Ingresos del periodo

Punto	Explicación
Qué mide	Ingreso total de pedidos en el rango seleccionado.
Fórmula visible	`SUM(order totals in period)`.
Fuente servidor	`currentRevenue`.
Tipo	indicador financiero de resultado.
Lectura buena	Sube de forma consistente con margen, flujo de caja y repeat rate.
Riesgo	Puede incluir pedidos no pagados si el total viene de órdenes, no de cobros.
Acción	Comparar contra `Flujo de caja` y `Cuentas por cobrar`.

Vender no es cobrar. Por eso Ingresos del periodo debe leerse junto a salud financiera.

indicadores de Salud de clientes

Tasa de recompra

Punto	Explicación
Qué mide	Porcentaje de clientes históricos con más de una orden.
Fórmula visible	`Clientes with >1 order / Total customers x 100`.
Fuente servidor	`repeatClientes / totalClientes`.
Tipo	indicador de retención.
Lectura buena	Sube cuando la base vuelve a comprar.
Riesgo	Es histórico; puede moverse lento y no reflejar deterioro reciente.
Acción	Comparar con frecuencia de compra, active customers y churn.

Si ingresos sube pero repeat rate cae, el crecimiento puede venir de clientes nuevos o ventas puntuales, no de relacion sostenida.

Clientes inactivos

Punto	Explicación
Qué mide	Clientes históricos que no compraron en el periodo actual.
Fórmula visible	`Clientes totales - clientes activos en el periodo`.
Fuente servidor	Clientes en `customer_orders` sin registro en `period_customers`.
Tipo	indicador de alerta comercial.
Lectura buena	Bajo o descendente.
Riesgo	Puede subir naturalmente si el periodo elegido es muy corto.
Acción	Crear campanas de reactivacion o revisar clientes de alto valor inactivos.

Este indicador depende mucho del rango. Un periodo de 7 días puede hacer ver inactivos a clientes que compran mensualmente.

Clientes activos

Punto	Explicación
Qué mide	Clientes unicos con al menos una orden en el periodo.
Fórmula visible	`COUNT(DISTINCT customers with order in period)`.
Fuente servidor	`period_customers`.
Tipo	indicador de actividad comercial.
Lectura buena	Sube sin destruir repeat rate ni margen.
Riesgo	No dice cuanto compro cada cliente.
Acción	Comparar con ingresos per customer y new vs lost.

Clientes activos separa crecimiento por volumen de clientes del crecimiento por ticket o frecuencia.

Ingreso por cliente

Punto	Explicación
Qué mide	Ingresos del periodo dividido entre clientes activos del periodo.
Fórmula visible	`Ingresos del periodo / clientes activos en el periodo`.
Fuente servidor	`revenue_per_customer`.
Tipo	indicador de monetizacion.
Lectura buena	Sube cuando el negocio vende más por cliente sin perder retención.
Riesgo	Puede subir porque se perdieron clientes pequenos y quedaron pocos grandes.
Acción	Comparar con active customers, churn y concentración principal.

Si ingresos per customer sube y concentración principal sube, quizas el negocio depende cada vez más de pocos clientes.

Valor de vida del cliente

Punto	Explicación
Qué mide en la app	Promedio histórico de total gastado por cliente.
Fórmula visible	`AVG(Total spent per customer across all history)`.
Fuente servidor	`avg_lifetime_value`.
Tipo	Métrica histórica de valor del cliente.
Riesgo	El nombre CLV normalmente implica valor futuro esperado, no solo histórico.
Acción	Renombrar a `Historical customer value` o construir CLV predictivo.

Este es otro punto de precisión importante. En marketing analytics, CLV suele estimar valor presente de flujos futuros. Lo que Ballista calcula hoy es útil, pero es histórico. Si se mantiene la fórmula, el nombre recomendado es Average customer historical ingresos.

Pérdida de clientes

Punto	Explicación
Qué mide	Clientes perdidos como porcentaje de clientes totales históricos.
Fórmula visible	`Lost customers / Total customers x 100`.
Fuente servidor	`lostClientes / totalClientes`.
Tipo	indicador de pérdida de clientes.
Lectura buena	Bajo o descendente.
Riesgo	La fórmula visible dice clientes que compraron antes y no ahora, pero divide por total histórico.
Acción	Revisar clientes perdidos, frecuencia y razones de no recompra.

Una alternativa más clasica sería dividir lost customers entre clientes activos/previos del periodo anterior. La fórmula actual es estable, pero puede diluir churn si hay muchos clientes históricos.

Pérdida de ingresos

Punto	Explicación
Qué mide	Caída de ingresos desde periodo anterior como porcentaje del periodo anterior.
Fórmula visible	`MAX(Previous ingresos - Current ingresos, 0) / Previous ingresos x 100`.
Fuente servidor	`revenueChurnPct`.
Tipo	indicador de pérdida de ingresos.
Lectura buena	Bajo o cero.
Riesgo	No separa pérdida por clientes perdidos de pérdida por menor ticket.
Acción	Cruzar con lost customers, top customers y sales by day.

Pérdida de ingresos ayuda a ver deterioro aunque el número de clientes no cambie.

Clientes nuevos frente a perdidos

Punto	Explicación
Qué mide	Clientes nuevos menos clientes perdidos contra el periodo anterior.
Fórmula visible	`New customers - Lost customers`.
Fuente servidor	`newClientes`, `lostClientes`.
Tipo	indicador de balance de base de clientes.
Lectura buena	Positivo y sostenido.
Riesgo	No mide calidad ni valor de esos clientes.
Acción	Comparar con ingresos per customer y concentration.

La tarjeta también muestra +new / -lost, lo cual ayuda a entender si el neto viene de muchos nuevos, pocos perdidos o ambos.

indicadores de Eficiencia comercial

tasa de conversión

Punto	Explicación
Qué mide	Pedidos completados/entregados sobre total de pedidos del periodo.
Fórmula visible	`Pedidos completados / pedidos totales x 100`.
Fuente servidor	Estados `done`, `completado`, `delivered`, `entregado`.
Tipo	indicador de eficiencia comercial-operativa.
Lectura buena	Alto, siempre que los estados se usen bien.
Riesgo	Si el equipo no actualiza estados, la indicador queda falsa.
Acción	Auditar estados de Pedidos y entrenar flujo de cierre.

Esta indicador no es lo mismo que pedidos pagados. Un pedido puede estar pagado pero no entregado, o entregado pero no marcado como pagado.

Pedidos por cliente

Punto	Explicación
Qué mide	Promedio histórico de órdenes por cliente.
Fórmula visible	`AVG(orders per customer)`.
Fuente servidor	`avg_orders_per_customer` de `customer_orders`.
Tipo	indicador de recurrencia comercial.
Lectura buena	Sube cuando clientes repiten compras.
Riesgo	Histórico; puede ocultar cambios recientes.
Acción	Comparar con repeat customer rate y frecuencia de compra.

Este indicador distingue "muchos clientes de una compra" de "clientes que vuelven".

frecuencia de compra

Punto	Explicación
Qué mide	Promedio de días entre compras consecutivas del mismo cliente.
Fórmula visible	`AVG(days between consecutive orders)`.
Fuente servidor	`order_gaps` usando `LAG` por cliente.
Tipo	indicador de cadencia de compra.
Lectura buena	Menor puede indicar mejor retención/frecuencia.
Riesgo	No todos los negocios tienen ciclos de compra cortos.
Acción	Segmentar por tipo de producto o cliente antes de juzgar.

Si baja demasiado, puede ser bueno por recompra, o malo si son reclamos/retrabajos. Necesita contexto.

indicadores de Salud financiera

Flujo de caja

Punto	Explicación
Qué mide	Total de órdenes marcadas como `paid` o `pagado` en el periodo.
Fórmula visible	`SUM(paid order totals in period)`.
Fuente servidor	Query de `cashFlow`.
Tipo	indicador de caja operativa.
Lectura buena	Sube y se acerca a ingresos.
Riesgo	Depende de que el estado `pagado` se actualice correctamente.
Acción	Comparar contra period ingresos y cuentas por cobrar.

Este indicador responde "entro plata?". Es más cercano a supervivencia que ingresos.

Cuentas por cobrar

Punto	Explicación
Qué mide	Total de órdenes no pagadas en el periodo.
Fórmula visible	`SUM(unpaid order totals in period)`.
Fuente servidor	`total_receivable`, estados distintos de `paid`/`pagado`.
Tipo	indicador financiero de riesgo de cobro.
Lectura buena	Bajo o controlado según politica de credito.
Riesgo	Puede incluir órdenes legitimas aun no vencidas si no hay vencimiento de pago.
Acción	Separar por antigüedad, cliente y estado de factura.

Vender sin cobrar no sostiene caja. Este indicador debería tener drill-down por cliente y antigüedad.

indicadores de Concentration risk

Top customer concentration

Punto	Explicación
Qué mide	Porcentaje del ingresos del periodo que viene del cliente #1.
Fórmula visible	`ingresos del cliente principal / ingresos totales x 100`.
Fuente servidor	Tabla top 5 por ingresos y `topClienteConcentrationPct`.
Tipo	indicador de riesgo estructural.
Lectura buena	No demasiado alto para el tipo de negocio.
Riesgo	Un ingresos alto puede ser frágil si depende de un solo cliente.
Acción	Diversificar clientes, cuidar cuentas clave y monitorear churn de top customers.

La tabla de top 5 clientes ayuda a ver si el riesgo está concentrado en uno o distribuido entre varios.

indicadores principales vs métricas diagnósticas

No todos los indicadores deben estar en la cabecera ejecutiva.

Nivel	Indicadores recomendados	Por qué
indicador principal	Ingresos del periodo, margen/contribution margen, flujo de caja, cuentas por cobrar, repeat customer rate, conversión rate, conflictos de inventario.	Conectan resultado, cobro, retención y capacidad operativa.
indicador secundario	Clientes activos, ingresos per customer, frecuencia de compra, concentración principal, pedidos pagados.	Explican dinamicas importantes y riesgos.
Diagnóstico	Intentos de inicio de sesión, operaciones FE, descargas, materiales principales, productos principales.	Ayudan a investigar, pero no siempre son "key" estrategicos.

La excepción: una métrica diagnóstica puede volverse indicador principal si el objetivo del periodo lo justifica. Por ejemplo, operaciones de factura electrónica puede ser indicador principal durante una migración fiscal o una crisis de rechazos de Hacienda.

Riesgos de lectura

Crecimiento con base cero

Problema	Explicación
Formula	`(actual - previo) / previo x 100`.
Error	Si `previo = 0`, la division no está definida.
Comportamiento actual	El servidor devuelve `100` si actual > 0 y previo = 0.
Mejor opcion	Mostrar `N/A`, `sin base comparable` o delta absoluto.

Este cambio evitaría lecturas ejecutivas falsas cómo "+100%" cuando en realidad no había base previa.

Utilidad neta mal rotulado

Si profit = income - costs y costs solo cubre costos directos o materia prima, el nombre correcto no es Utilidad neta. Puede ser:

Nombre	Cuando usarlo
`Gross profit`	Si descuenta costo de ventas directo.
`Contribution margen`	Si descuenta costos variables relacionados con la orden/producto.
`Utilidad neta`	Solo si descuenta costos, gastos operativos, financieros, impuestos y demas.

CLV histórico vs predictivo

La app calcula AVG(total spent per customer across all history). Eso es valor histórico promedio, no CLV predictivo completo. La mejora es renombrar o cambiar fórmula.

Opcion	Ventaja
Renombrar a `Historical customer value`.	Honesto y rápido.
Crear CLV predictivo.	Más potente, pero requiere modelo de frecuencia, margen, retención y descuento.

Goodhart's Law

Cuando una métrica se vuelve objetivo de premio/castigo, la gente puede optimizar la métrica y danar el sistema. Ejemplos:

Incentivo mal usado	Riesgo
Premiar solo órdenes cerradas.	Cerrar órdenes sin calidad o sin cobro.
Premiar solo ticket alto.	Forzar ventas con descuento, credito riesgoso o baja retención.
Premiar solo inventario bajo.	Generar faltantes y conflictos.
Premiar solo rapidez de facturación.	Emitir documentos con datos fiscales incorrectos.

Un indicador debe orientar, no reemplazar juicio.

Cómo ayudan estos indicadores al negocio

1. Acortan el ciclo de decisión

Sin panel, el equipo espera cierres contables, hojas externas o intuiciones. Con panel, ve temprano:

Senal	Acción posible
Cuentas por cobrar sube.	Cobranza por cliente o revisión de credito.
Conflictos de inventario sube.	Revisar lotes, compras, fórmulas y promesas de entrega.
Tasa de recompra baja.	Campana de retención o investigacion de calidad.
Crecimiento de margen cae.	Revisar costos, precios, descuentos y materiales.

2. Alinean equipos

Ventas, operaciones, inventario, facturación y gerencia dejan de discutir con sensaciones distintas. Discuten sobre el mismo dato y la misma definición.

Equipo	indicador que le importa
Ventas	Ingresos, conversión, repeat rate, top customers.
Operaciones	Pedidos completados, conflictos de inventario, materiales principales.
Finanzas	Flujo de caja, cuentas por cobrar, margen.
Facturación	operaciones de factura electrónica, orders not invoiced, historial de facturación.
Gerencia	Concentration risk, growth, churn, profitability.

3. Mejoran rendicion de cuentas

El tablero permite decir: este número está fuera de rango, está es la causa probable y está es la acción. Eso transforma reportes en gestion.

4. Separan resultado de causa

Ingresos es resultado. Tasa de recompra, frecuencia de compra, conflictos de inventario y conversión son impulsores. Un buen panel necesita ambos: el marcador y las palancas.

Mejoras recomendadas para Ballista

Mejora	Motivo	Impacto
Corregir crecimiento con base cero.	Evita porcentajes matemáticamente falsos.	Mejor lectura ejecutiva.
Renombrar `Utilidad neta` si no es neto contable.	Evita decisiones financieras equivocadas.	Más confianza en reportes.
Renombrar `Valor de vida del cliente` si es histórico.	Distingue histórico de predictivo.	Más rigor comercial.
Agregar aging de cuentas por cobrar.	Saber cuanto está vencido, no solo cuanto falta cobrar.	Mejor cobranza.
Separar FE por estado.	Operaciones FE no basta; importa aceptada/rechazada/pendiente.	Mejor control fiscal.
Drill-down por cliente/producto/material.	De indicador a causa.	Menos trabajo manual.
Umbrales visuales.	Colores y alertas por metas.	Decisión más rápida.
indicador de fill rate o stockout rate.	Completa la perspectiva operacional.	Mejor promesa de entrega.
indicador de tiempo de cobro.	Completa salud financiera.	Mejor caja.

Cómo leer una reunion semanal con este tablero

Elegir rango de fechas.
Revisar Ingresos del periodo, Flujo de caja y Cuentas por cobrar.
Revisar Crecimiento de margen y Costos del periodo.
Revisar Clientes activos, Tasa de recompra y New vs lost.
Revisar tasa de conversión, pedidos pagados y Pedidos completados.
Revisar Conflictos de inventario, productos más vendidos y Materiales más usados.
Revisar Top customer concentration.
Abrir descargas solo si hace falta evidencia o análisis externo.
Convertir hallazgos en tareas: cobrar, comprar, corregir precios, revisar facturas, llamar clientes o ajustar inventario.

Para soporte

Cuando reportes un problema de indicadores, incluye:

ruta exacta: /reports, tab Resumen operativo o Crecimiento de clientes;
rango de fechas usado;
indicador afectado;
valor esperado y valor visible;
si el problema está en tarjeta, tabla, gráfico o export;
pedido, cliente, producto o material de ejemplo;
si el dato origen existe en Pedidos, Inventario, Facturación o Tareas;
captura del tooltip/fórmula si el problema es semántico.

Cómo se conecta

Reportes conecta con Pedidos y ventas, porque los pedidos son base para ingresos, estados, conversión, flujo de caja y cuentas por cobrar. Conecta con Tareas, porque las acciones correctivas deberían convertirse en trabajo asignado. Conecta con Inventario y producción, porque materiales, lotes y conflictos explican capacidad operativa. Conecta con Facturación y control, porque vender y cobrar también exige documentos fiscales correctos.

Referencias para estudiar

Estas referencias ayudan a entender por qué un panel no es solo visualización:

Tema	Referencia
Balanced Scorecard	Robert S. Kaplan y David P. Norton: objetivos, medidas, metas e iniciativas.
Decisiónes basadas en datos	Estudios sobre toma de decisiones con datos y productividad empresarial.
Uso de paneles	Literatura sobre monitoreo, resolución de problemas, racionalización y comunicación.
Visualización y cognición	Procesamiento preatencional, carga cognitiva y ajuste cognitivo.
Riesgo de incentivos	Goodhart's Law: cuando la medida se vuelve objetivo, puede dejar de medir bien.
Valor de vida del cliente	Analítica de mercadeo sobre valor histórico y predictivo del cliente.

Resumen

El panel de Ballista ya mezcla finanzas, clientes, ventas y operaciones. Lo importante ahora es leer cada número con definición clara: qué mide, cómo se calcula, qué decisión habilita y qué riesgo tiene. Ingresos del periodo, flujo de caja, cuentas por cobrar, recompra, conversión, crecimiento de margen y conflictos de inventario son candidatos fuertes a indicadores principales. Los intentos de inicio de sesión, las descargas y algunas operaciones de factura electrónica son más diagnósticas salvo que el objetivo del negocio las vuelva críticas.