Manual de uso · Comercial

Paso a paso

Definir una meta de ventas y seguir su cumplimiento

Metas de Ejecutivos es la pantalla donde un Manager escribe, mes a mes, cuánto espera que venda cada Ejecutivo. Es sencilla: un monto por persona, un botón para guardar. Pero antes de que la uses con tu equipo, este manual tiene que decirte dos cosas que la documentación de Marko no dice: hoy no se puede guardar, y aunque se pudiera, ninguna otra pantalla de Marko muestra después si esa meta se cumplió.

Los pasos

1. Entra directamente a la URL /sales-goals — no hay ningún enlace de menú que te lleve ahí.

   

   Qué deberías verCon tu cuenta de Manager abre el grupo Comercial del menú lateral: verás nueve entradas — Mis Clientes, Cotizaciones, Cotizar Compra Ágil, Cotizar Convenio Marco, Post Venta, Oportunidades Compra Ágil, Análisis Mercado, Gestionar Catálogo CM y Contactos de Adquisiciones — y ninguna se llama «Metas». No es que te falte permiso: la pantalla existe y funciona, pero nadie la enlazó desde ningún menú de la aplicación (comprobado en nav.service.ts, revisado entero). La única forma de llegar es escribir /sales-goals en la barra de direcciones, a mano o desde un marcador que guardes tú mismo.
   Tampoco pide un rol concreto La ruta /sales-goals sólo exige estar autenticado (app-routing.module.ts: [AuthenticatedGuard, OnboardingGuard], sin nada de rol). En la práctica, cualquier cuenta de tu empresa —un Ejecutivo, alguien de bodega— puede entrar por la URL y ver los nombres, correos y cargos de todo el equipo comercial, aunque no pueda guardar cambios (ver el paso 7). Trátala como una pantalla de Manager aunque el sistema no la proteja como tal.

2. Ya dentro, revisa la lista: son los Ejecutivos de tu empresa, con su correo y su cargo.

   

   Qué deberías verUn selector Mes con el mes en curso ya elegido, un campo Monto con un botón Asignar al lado, y debajo una tabla con columnas Nombre, Correo, Cargo y un campo numérico por fila, todos en 0 si nunca se guardó nada para este mes.
   Al Ejecutivo Avanzado no lo vas a encontrar aquí La consulta que arma esta tabla (sales-goals.component.ts, método load()) filtra cuentas cuyo rol sea exactamente EXECUTIVE (roles.<tu_empresa> array-contains 'EXECUTIVE'). Un Ejecutivo Avanzado tiene el rol EXECUTIVE_ADVANCED — un valor distinto, nunca los dos a la vez — así que nunca aparece en esta lista, aunque venda y aunque tenga cotizaciones y OC ganadas como cualquier otro ejecutivo. Si tu equipo tiene ejecutivos avanzados, hoy no hay forma de definirles una meta desde esta pantalla.

3. Escribe un monto en el campo numérico de un Ejecutivo, a la derecha de su fila.

   

   Qué deberías verEl número que escribas queda en ese campo, sin validar nada: acepta cualquier valor mientras sea numérico, incluye decimales y no hay tope. Los montos de esta captura son un ejemplo para el manual — ningún dato de venta real.

4. Para poner el mismo monto a todo el equipo de una vez, escríbelo en el campo Monto de la cabecera, junto al botón Asignar.

   

   Qué deberías verNada cambia todavía en la tabla: el campo Monto sólo guarda el valor en memoria hasta que pulses Asignar.

5. Pulsa Asignar y mira la tabla: las cinco filas quedan con el mismo monto.

   

   Qué deberías verAsignar sobrescribe todas las filas con el número que escribiste, sin pedir confirmación — si ya habías escrito montos distintos a mano en el paso 3, se pierden.
   No hay «meta compuesta», ni trimestral, ni por equipo Pese a lo que promete docs/01-ventas/09-metas-ventas.md, lo único que existe hoy es esto: un monto de venta en pesos, por Ejecutivo, por mes calendario. No hay metas de cotizaciones, OC ganadas, clientes nuevos ni ticket promedio; no hay metas de equipo, trimestrales ni anuales; no hay pesos relativos ni «meta compuesta». Todo eso es descripción conceptual del documento, no código.

6. Si un Ejecutivo necesita algo distinto del resto, edita su fila a mano después de la asignación masiva.

   

   Qué deberías verPuedes seguir editando cualquier fila para dejarla distinta: el campo Monto de la cabecera no vuelve a tocarlas a menos que pulses Asignar otra vez.

7. Pulsa Actualizar para guardar.

   

   

   Qué deberías ver, en teoríaEl botón se apaga un momento y, si todo va bien, un aviso verde «Metas actualizadas» (sales-goals.component.ts:108).
   Lo que vimos de verdad, repetidas veces El botón queda apagado 2 a 3 segundos —guarda cada ejecutivo uno por uno, en una vuelta await secuencial— y luego aparece el aviso rojo «No se pudieron actualizar las metas.» (sales-goals.component.ts:106). Recargamos la página después de cada intento — cambio masivo, cambio individual, con y sin ajuste — y siempre volvieron los ejecutivos a $0: nada quedó escrito en la base.
   La causa: la regla de Firestore, no un error de red update() escribe directo contra accounts/<id_del_ejecutivo> (sales-goals.component.ts:100, db.collection('accounts').doc(e.id).update(...)), sin pasar por ninguna Cloud Function. Y firestore.rules:67 dice allow write: if isOwner(userId) || isAdmin(); — sólo el dueño de la cuenta o alguien con el flag de plataforma admin puede escribir ahí. Un Manager de empresa no es ninguna de las dos cosas sobre la cuenta de otra persona, así que Firestore rechaza la escritura para los cinco ejecutivos, uno por uno. La pantalla se construyó para que la usara un Manager y, tal como está escrita hoy, ningún Manager puede guardar nada en ella.

¿Y el seguimiento del cumplimiento?

Suponiendo que el guardado funcionara: no hay ninguna pantalla en Marko, hoy, que muestre cuánto lleva vendido un Ejecutivo frente a la meta que se le puso. Lo buscamos en los tres sitios donde tendría sentido que viviera:

• El Dashboard Comercial (/dashboard) lo tuvo y se lo quitaron. En dashboard.component.ts:157-159 queda el rastro en un comentario: «Se eliminan los cálculos de las propiedades no utilizadas de 'totals': assignedOC, provOCcreated, margin, provOCapproved, salesGoal, remaining, fulfillment, projection». El objeto totals sigue existiendo, pero ninguna de esas cuatro propiedades — meta, saldo pendiente, cumplimiento y proyección — se calcula ni se pinta en ningún lado del dashboard actual.
• Mis Comisiones y Pago de Comisiones tampoco lo usan. Revisamos el servicio de comisiones completo: cero referencias a salesGoals. El cálculo de comisión sale de las OC de Convenio Marco y sus tramos configurados, no de la meta que se le puso a nadie. Para consultar comisiones ganadas, el manual es Consultar tus comisiones ganadas y proyectadas; para aprobarlas y pagarlas, Pago de Comisiones — ninguno de los dos habla de metas.
• No existe una función de servidor que lo calcule. Buscamos salesGoal en todo functions/src: no aparece una sola vez. Nada recalcula avance, nada dispara una alerta al llegar al 70 % ni al superar el 100 %.

Lo que todavía no hace

Contrastado contra docs/01-ventas/09-metas-ventas.md, que describe un módulo mucho más grande que el que existe en el código:

• No guarda. Ver el paso 7: el botón Actualizar falla siempre para un Manager, por una regla de Firestore que nunca se ajustó a este caso de uso.
• No hay seguimiento de cumplimiento en ninguna pantalla, ni gráfico, ni semáforo verde/amarillo/rojo, ni ranking de ejecutivos, ni comparación con el período anterior. Ver la sección anterior.
• No hay proyección de cierre. La fórmula de proyección lineal que describe el documento funcional no está implementada en ninguna parte del repositorio.
• No cubre al Ejecutivo Avanzado. Ver el paso 2: la consulta que arma la tabla excluye ese rol por construcción.
• No hay metas de equipo, regionales ni por línea de producto. Sólo existe el alcance individual, por Ejecutivo.
• No hay más métrica que el monto de venta. Cotizaciones enviadas, OC ganadas, clientes nuevos y ticket promedio son sólo texto del documento funcional.
• No hay «meta compuesta» ni peso relativo entre métricas.
• No hay alertas ni notificaciones — ni de meta próxima a vencer, ni de desvío, ni de meta cumplida o superada.
• No hay reportes ni exportación — ni a PDF, ni a Excel, ni envío programado por correo.
• No hay gamificación — ni badges, ni «Ejecutivo del mes», ni ranking de consistencia.
• No conecta con las comisiones. El campo comisionAsociada del modelo que describe la documentación no existe en el código: las comisiones se calculan aparte, sobre las OC ganadas, sin mirar nunca si hubo una meta ni si se cumplió.
• No valida el monto. Acepta números negativos escritos a mano en el campo (se guardarían como Math.abs(...) si el guardado funcionara) y no tiene tope superior.
• El selector de mes no tiene límite, aunque el componente calcula uno (maxPeriod, un año hacia adelante): la propiedad existe en el código pero no está enlazada a ningún atributo del campo <input type="month">, así que en la práctica puedes elegir cualquier mes, pasado o futuro, sin aviso.

Cuando algo no sale