Mis Clientes
Cartera de clientes del mercado público derivada de las órdenes de compra (OCs) adjudicadas a la empresa, enriquecida con metadata propia (apodos, etiquetas, asignación y notas).
Descripción
El módulo "Mis Clientes" arma automáticamente la cartera de clientes del sector público a partir de las OCs que la empresa recibió en Mercado Público. Los datos se consultan en BigQuery (últimos 12 meses, ordenados por monto adjudicado) y se complementan con metadata editable que vive en Firestore: apodo/alias, etiquetas, ejecutivo asignado y notas.
Cada cliente corresponde a una unidad compradora (organismo + unidad). El usuario puede buscar, abrir el detalle de cada cliente, editar su metadata y analizar sus compras, incluyendo un desglose por proveedor.
⚠️ Requiere que la empresa tenga RUT configurado (en Mi empresa). Si no lo tiene, el módulo muestra el mensaje: "Esta empresa no tiene RUT configurado. Configúralo en Mi empresa."
Características Principales
📋 Listado de clientes
Al abrir el módulo se consulta BigQuery (mensaje de carga "Consultando BigQuery…") y se muestra la lista de clientes de los últimos 12 meses, ordenada por monto adjudicado. El encabezado indica la cantidad de clientes y el texto "últimos 12 meses · ordenado por monto adjudicado".
Columnas de la tabla:
| Columna | Contenido |
|---|---|
| Cliente | Nombre del organismo + nombre de la unidad (o apodo personalizado si existe), con etiquetas (badges). Si hay apodo, el nombre real aparece en gris. |
| RUT | RUT del organismo, formateado (con puntos y guión). |
| OCs | Número de órdenes de compra ganadas a ese cliente. |
| Monto | Monto total adjudicado (CLP). |
| Últ. compra | Fecha de la última compra. |
| Acciones | Menú desplegable (⋮). |
Estados y mensajes posibles:
- Sin datos: "No encontramos OCs en mercado público para tu RUT."
- Sin resultados de búsqueda: "Sin resultados para tu búsqueda."
🔍 Búsqueda en tiempo real
Campo de búsqueda con placeholder "Buscar por nombre, organismo, RUT o código…". Filtra en memoria sobre la lista ya cargada, buscando en nombre, apodo, código de unidad, nombre del organismo y RUT (con y sin formato).
✏️ Metadata editable (por empresa)
Desde el detalle del cliente, en la sección "Mi información", el usuario edita y guarda:
- Apodo / Nombre personalizado (alias para reconocer al cliente).
- Asignado a — ejecutivo responsable (selector con la lista de ejecutivos de la empresa).
- Etiquetas — multi-tag, permite crear nuevas.
- Notas — texto libre.
Los cambios se guardan con el botón "Guardar cambios". Esta metadata es propia de la empresa (no afecta a los datos públicos de ChileCompra) y se aplica de forma reactiva al listado y al detalle.
👤 Detalle del cliente
Al hacer click en una fila (o en "Ver perfil" del menú de acciones) se abre /customers/:id. El detalle tiene un encabezado con datos resumidos (nombre, RUT, código de unidad, comuna/región, actividad del comprador, ejecutivo asignado, etiquetas y KPIs rápidos de Cotizaciones / OCs) y cuatro pestañas:
- Información — datos públicos del organismo (read-only: nombre, RUT, organismo, sector, actividad, dirección, comuna, región) junto a la sección editable "Mi información".
- Contactos — gestión de contactos de la unidad (accesible también desde "Gestión Contactos" en el menú de acciones del listado).
- Estadísticas — análisis de compras del cliente (ver abajo).
- Mis ventas — "OCs que mi empresa le emitió a esta unidad — últimos 12 meses", con KPIs de Total facturado y OCs emitidas, y una tabla con código, estado, fecha, monto y enlace a Mercado Público.
📊 Pestaña Estadísticas
Permite filtrar por ID de licitación (convenio marco; por defecto "Todas las licitaciones"). Muestra dos KPIs principales (Monto total transado y Órdenes de compra del período) y tres tablas:
- Qué compra — top categorías (Categoría / OCs / Monto). Se oculta al filtrar por un convenio marco.
- A quién compra — top proveedores (Proveedor + RUT / OCs / Monto). Cada fila es clickeable y abre el modal de desglose por proveedor.
- Tendencia mensual — Mes / OCs / Monto.
🔎 Modal de desglose por proveedor
Al hacer click en un proveedor de la tabla "A quién compra" se abre un modal con el detalle de cuánto y qué le compra ese cliente a ese proveedor: KPIs de Monto total transado y Órdenes de compra (últimos 12 meses), tabla Qué le compra (top categorías), Tendencia mensual y Últimas órdenes de compra (con enlace a Mercado Público).
Casos de Uso
- Ejecutivo: identifica sus mejores clientes por monto, les asigna apodo y etiquetas, y registra notas de seguimiento.
- Manager: distribuye clientes entre ejecutivos usando el campo Asignado a.
- Analista comercial: estudia qué y a quién le compra una unidad para detectar oportunidades, incluyendo el desglose por proveedor competidor.
Integraciones
- BigQuery — clientes del proveedor, estadísticas por unidad (categorías, proveedores, tendencia mensual), órdenes recientes y desglose por proveedor. Se accede vía Cloud Functions (ventana de 12 meses).
- Firebase Firestore — RUT de la empresa (
companies/{companyId}) y metadata local por unidad (my-units/{companyId}/units/{codigoUnidad}: apodo, etiquetas, notas, asignado a).