feat: Add Streamlit dashboard with Blueprint compliance (v2.1.0)

Dashboard Features:
- 8 navigation sections: Overview, Outcomes, Poor CX, FCR, Churn, Agent, Call Explorer, Export
- Beyond Brand Identity styling (colors #6D84E3, Outfit font)
- RCA Sankey diagram (Driver → Outcome → Churn Risk flow)
- Correlation heatmaps (driver co-occurrence, driver-outcome)
- Outcome Deep Dive (root causes, correlation, duration analysis)
- Export functionality (Excel, HTML, JSON)

Blueprint Compliance:
- FCR: 4 categories (Primera Llamada/Rellamada × Sin/Con Riesgo de Fuga)
- Churn: Binary view (Sin Riesgo de Fuga / En Riesgo de Fuga)
- Agent: Talento Para Replicar / Oportunidades de Mejora
- Fixed FCR rate calculation (only FIRST_CALL counts as success)

Technical:
- Streamlit + Plotly for interactive visualizations
- Light theme configuration (.streamlit/config.toml)
- Fixed Plotly colorbar titlefont deprecation

Documentation:
- Updated PROJECT_CONTEXT.md, TODO.md, CHANGELOG.md
- Added 4 new technical decisions (TD-014 to TD-017)
- Created TROUBLESHOOTING.md with 10 common issues

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
sujucu70
2026-01-19 16:27:30 +01:00
commit 75e7b9da3d
110 changed files with 28247 additions and 0 deletions

View File

@@ -0,0 +1,64 @@
FCR
Contexto
Misión
Como auditor experto en el sector del contact center tu misión es identificar, en la transcripción proporcionada, si la llamada es un primer contacto del cliente por ese motivo o si es una rellamada por el mismo motivo. Adicionalmente, cuando la llamada sea un primer contacto, debes identificar las evidencias explícitas e implícitas que puedan justificar una llamada a corto plazo por el mismo motivo. Cuando se trate de una rellamada por el mismo motivo, debes identificar las evidencias explícitas e implícitas que han motivado esa llamada por el mismo motivo.
Alcance y Servicios
Este análisis se aplicará a todas las interacciones telefónicas registradas entre clientes y agentes del servicio de atención al cliente.
Criterios de evaluación clave (KPIs)
Se deben extraer datos que responda a cada uno de los cinco pilares:
FCR
• Objetivo: si la llamada es primera llamada o no.
• Necesidad: identificar, a través de la transcripción de la llamada, si es el primer contacto del cliente por ese motivo o si es una rellamada por el mismo motivo.
Pautas para la salida
Además de la información anterior, cada salida debe adherirse estrictamente a las pautas de output (formato y contenido) que se proporcionarán para cada criterio en los prompts específicos de análisis subsiguientes.
Validación Contextual
1. FCR
Criterio | FRC
Descripción | Propósito: Evaluar de forma exhaustiva la transcripción de llamada e identificar y determinar si la llamada es el primer contacto por el ese motivo o una rellamada por el mismo motivo.
Notas de calidad:
- Revisa la totalidad de la transcripción: tono, ritmo, pesos de la conversación, interrupciones del agente, claridad en los mensajes y si la escucha activa es continua.
- Evita razonamiento interno paso a paso; respeta en lo posible los formatos de salida facilitados.
- Mantén precisión, neutralidad, verifica el desempeño del agente y haz foco en identificar el tipo de llamada en función de si es el primer contacto o no.
Categoría | Primera Llamada Sin Riesgo de Fuga
Descripción | Explica de manera concisa y clara, a alto nivel, qué evidencias has localizado en la transcripción de la llamada que determinan que sea el primer contacto. Además, identifica factores clave que pueden hacer que el cliente vuelva a llamar por el mismo motivo y evidencias concretas que justifiquen que el cliente no dará de baja sus servicios o productos.
Acción | Enumera un máximo de cinco factores clave, identificados en la transcripción de la llamada, que justifiquen una rellamada del cliente por el mismo motivo en el corto plazo. La estructura de salida es:
- Factor Clave 1: etiqueta breve (p. ej., Explicaciones vagas o confusas). Descripción objetiva, basada en la transcripción de la llamada, explicando detalladamente por qué este factor indica que el cliente nos volverá a llamar por el mismo motivo. Incluye además qué pautas concretas tiene que hacer el agente para corregirlo, añadiendo un ejemplo basado en la llamada.
- Factor Clave 2-5: etiqueta y descripción (misma estructura) en orden de relevancia.
- Separa los factores usando: “··· “.
Enumera un máximo de cinco evidencias clave explícitas o implícitas, identificadas en la transcripción de la llamada, que justifiquen que el cliente no dará la baja de sus productos o servicios. La estructura de salida es:
- Evidencia de Permanencia 1: etiqueta breve (p. ej., Feedback positivo de la compañía). Descripción objetiva, basada en la transcripción, explicando con detalle por qué esta evidencia justifica que el cliente no dará de baja sus servicios, extrayendo cualquier feedback dado por el cliente.
- Evidencia de Permanencia 2-5: etiqueta y descripción (misma estructura) en orden de relevancia.
- Separa las evidencias usando: “…”.
Categoría | Primera Llamada Con Riesgo de Fuga
Descripción | Explica de manera concisa y clara, a alto nivel, qué evidencias has localizado en la transcripción de la llamada que determinan que sea el primer contacto. Además, identifica factores clave que pueden hacer que el cliente vuelva a llamar por el mismo motivo y evidencias concretas de que el cliente dará de baja de sus productos o servicios.
Acción | Enumera un máximo de cinco factores clave, identificados en la transcripción de la llamada, que justifiquen una rellamada del cliente por el mismo motivo en el corto plazo. La estructura de salida es:
- Factor Clave 1: etiqueta breve (p. ej., Explicaciones vagas o confusas). Descripción objetiva, basada en la transcripción de la llamada, explicando detalladamente por qué este factor indica que el cliente nos volverá a llamar por el mismo motivo. Incluye además qué pautas concretas tiene que hacer el agente para corregirlo, añadiendo un ejemplo basado en la llamada.
- Factor Clave 2-5: etiqueta y descripción (misma estructura) en orden de relevancia.
- Separa los factores usando: “··· “.
Enumera un máximo de cinco evidencias clave explícitas o implícitas, identificadas en la transcripción de la llamada, que justifiquen que el cliente pueda dar de baja sus productos o servicios. La estructura de salida es:
- Evidencia de Fuga 1: etiqueta breve (p. ej., Está mirando ofertas en la competencia). Descripción objetiva, basada en la transcripción, explicando con detalle por qué justifica que está pensando o valorando dar de baja sus productos o servicios, indicando la causa raíz. Añade fragmento de la transcripción cuando proceda.
- Evidencia de Fuga 2-5: etiqueta y descripción (misma estructura) en orden de relevancia.
- Separa las evidencias usando: “…”.
Categoría | Rellamada Sin Riesgo de Fuga
Descripción | Explica de manera concisa y clara, a alto nivel, qué evidencias concretas has identificado que demuestran que se trata de una rellamada. Además, identifica factores clave que han provocado que el cliente vuelva a llamar por el mismo motivo y evidencias concretas que justifiquen que el cliente no dará de baja de sus productos o servicios.
Acción | Enumera un máximo de cinco factores, identificados en la transcripción de la llamada, que han motivado que el cliente haya vuelto a llamar por el mismo motivo. La estructura de salida es:
- Factor Clave 1: etiqueta breve (por ejemplo: No indicar plazos de resolución). Descripción objetiva, basa en la transcripción, explicando con detalle cómo ese factor ha afectado para que el cliente vuelva a llamar por el mismo motivo, extrayendo el fragmento de la transcripción. Incluye, además, qué pautas concretas se pueden trabajar para mejorar este factor, indicando un ejemplo basado en la llamada.
- Factor Clave 2-5: misma estructura.
- Separa los factores usando: “··· “.
Enumera un máximo de cinco evidencias clave explícitas o implícitas, identificadas en la transcripción de la llamada, que justifiquen que el cliente no dará la baja de sus productos o servicios. La estructura de salida es:
- Evidencia de Permanencia 1: etiqueta breve (p. ej., Feedback positivo de la compañía). Descripción objetiva, basada en la transcripción, explicando con detalle por qué esta evidencia justifica que el cliente no dará de baja sus servicios, extrayendo cualquier feedback dado por el cliente.
- Evidencia de Permanencia 2-5: etiqueta y descripción (misma estructura) en orden de relevancia.
- Separa las evidencias usando: “…”.
Categoría | Rellamada Con Riesgo de Fuga
Descripción | Explica de manera concisa y clara, a alto nivel, qué evidencias concretas has identificado que demuestran que se trata de una rellamada. Además, identifica factores clave que han provocado que el cliente vuelva a llamar por el mismo motivo y evidencias concretas de que el cliente dará de baja de sus productos o servicios.
Acción | Enumera un máximo de cinco factores, identificados en la transcripción de la llamada, que han motivado que el cliente haya vuelto a llamar por el mismo motivo. La estructura de salida es:
- Factor Clave 1: etiqueta breve (por ejemplo: No indicar plazos de resolución). Descripción objetiva, basa en la transcripción, explicando con detalle cómo ese factor ha afectado para que el cliente vuelva a llamar por el mismo motivo, extrayendo el fragmento de la transcripción. Incluye, además, qué pautas concretas se pueden trabajar para mejorar este factor, indicando un ejemplo basado en la llamada.
- Factor Clave 2-5: misma estructura.
- Separa los factores usando: “··· “.
Enumera un máximo de cinco evidencias clave explícitas o implícitas, identificadas en la transcripción de la llamada, que justifiquen que el cliente pueda dar de baja sus productos o servicios. La estructura de salida es:
- Evidencia de Fuga 1: etiqueta breve (p. ej., Está mirando ofertas en la competencia). Descripción objetiva, basada en la transcripción, explicando con detalle por qué justifica que está pensando o valorando dar de baja sus productos o servicios, indicando la causa raíz. Añade fragmento de la transcripción cuando proceda.
- Separa las evidencias usando: “…”.