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>

docs/blueprints/beyondCx_Close The Loop_v1_15012025.txt

@@ -0,0 +1,121 @@
+Close The Loop
+Contexto
+Misión
+El objetivo de este análisis es identificar oportunidades de mejora y generar insights accionables a partir del estudio masivo de llamadas, alineados con los cinco pilares estratégicos del marco "Close the Loop". Es necesario detectar patrones, comportamientos, fricciones y oportunidades que permitan optimizar la experiencia de los clientes, reducir la fuga de los mismos, mejorar la eficiencia operativa, potenciar el valor de los clientes y fomentar el desarrollo del talento interno.
+Alcance y Servicios
+Este análisis se aplicará a todas las interacciones telefónicas registradas entre clientes y agentes tanto en los servicios de atención al cliente como de ventas. Las llamadas serán principalmente entrantes (Inbound) pudiendo abarcar un abanico amplio de tipologías y clientes. El análisis debe ponderar los criterios de Cx y Talento según la naturaleza de la interacción.
+Criterios de evaluación clave (KPI’s)
+Se deben extraer datos que respondan a cada uno de los cinco pilares:
+Mejorar la Experiencia de Cliente (CX) 
+•	Objetivo: Determinar si tuvo una buena experiencia con el servicio. (SI/NO). 
+•	Necesidad: Identificar palancas positivas (acciones/argumentos que ayudaron) y puntos de fricción que deben corregirse (ej. transferencias, repetición de datos, tono). 
+Reducir la Fuga de Clientes (Churn) 
+•	Objetivo: Determinar e identificar cuáles son los riesgos implícitos o explícitos para la fuga o baja del cliente en el servicio.
+•	Necesidad: Identificar motivos específicos que motiven la baja del cliente, identificar puntos de fricción entre el cliente y la compañía y sus servicios que provoquen que el cliente realice la baja de su contrato total o parcialmente. (ej. precio, insatisfacción). 
+Incrementar la Eficiencia Operativa 
+•	Objetivo: Determinar cuáles son las ineficiencias operativas evidenciadas en las transcripciones de las llamadas (ej. uso de múltiples sistemas, errores procesales). 
+•	Necesidad: Identificar las ineficiencias operativas tanto de los procesos, del agente como del lado del cliente y proponer nuevos procesos de gestión o proponer ajustes procedimentales para optimizar la eficiencia del servicio. 
+Potenciar el Valor del Cliente (Customer Value) 
+•	Objetivo: Determinar cuáles son las necesidades reales (explícitas) del cliente capturando la voz del cliente.
+•	Necesidad: Identificar necesidades explícitas y no explícitas, o latentes, del cliente para proponer mejoras para maximizar el valor del cliente para la compañía, aumentando los productos contratados o los servicios de valor añadido. 
+Desarrollar el Talento Interno 
+•	Objetivo: Determinar de manera objetiva todo el valor positivo del agente (actitudes, aptitudes, uso del lenguaje, habilidades técnicas/blandas) para replicar buenas prácticas. 
+•	Necesidad: identificar todas las buenas prácticas de los agentes que ayudan a mejorar la experiencia de cliente y todas las buenas prácticas comerciales que ayudan a vender más productos o servicios al cliente. También, identificar los puntos de fricción, los puntos débiles de todos los agentes para proponer acciones de mejora detalladas que permitan corregirlos.
+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. Mejorar la Experiencia de Cliente (CX)
+2. Reducir la Fuga de Clientes (Churn)
+3. Incrementar la Eficiencia Operativa
+4. Potenciar el Valor del Cliente (Customer Value)
+5. Desarrollar el Talento Interno
+Criterio | 1. Mejorar la Experiencia de Cliente (CX)
+Descripción | Propósito: Evaluar de forma exhaustiva la transcripción de la llamada y determinar si se está ofreciendo una buena experiencia de cliente. 
+Notas de calidad: 
+- Revisa la totalidad de la transcripción: tono, ritmo, pesos de la conversación del agente frente a la del cliente, interrupciones del agente, la claridad en los mensajes del agente y si la escucha activa se mantiene en todo momento, la capacidad de ofrecer soluciones en cualquier solución.
+- Evita razonamiento interno paso a paso; respeta en lo posible los formatos de salida facilitados.
+- Mantén precisión, neutralidad, foco en desempeño y detectar la información implícita.
+Categoría | Buen Cx
+Descripción | Explica de manera concisa y clara, a alto nivel, qué elementos existen en la llamada para que se esté ofreciendo una buena experiencia al cliente, indicando los puntos fuertes del agente y cualquier feedback explícito o implícito por parte del cliente.
+Acción | Enumera un máximo de cinco factores clave que permiten al agente un buen desempeño en este criterio. La estructura de salida es: 
+- Factor Clave 1: etiqueta breve (p. ej., Anticiparse a las posibles dudas del cliente). Descripción objetiva basada en la transcripción indicando por qué ayuda a mejorar la experiencia de cliente; cita breve del fragmento cuando sea necesario.
+- Factor Clave 2-5: etiqueta y descripción (misma estructura) en orden de relevancia.
+Separa los factores usando: “··· “.
+Categoría | Cx Mejorable
+Descripción | Explica de manera concisa y clara, a alto nivel, por qué en la llamada no se ha proporcionado una buena experiencia al cliente, identificando las causas raíz explícitas e implícitas.
+Acción | Enumera un máximo de cinco motivos identificados que han impedido lograr una buena experiencia al cliente. La estructura de salida es: 
+- Oportunidad de Mejora 1: etiqueta breve (por ejemplo: “Interrumpir al cliente constantemente”). Explicación detallada de por qué este motivo empeora la experiencia del cliente y cómo el agente tiene que corregirlo, incluyendo un ejemplo basado en la propia llamada. 
+- Oportunidad de Mejora 2-5: misma estructura. 
+Separa cada oportunidad de mejora usando: “··· “.
+Criterio | 2. Reducir la Fuga de Clientes (Churn)
+Descripción | Propósito: Evaluar de forma exhaustiva la transcripción de llamada para identificar, tanto si la llamada es de consulta como si en la llamada se produce cualquier tipo de venta, evidencias concretas que justifiquen si el cliente dará de baja total o parcialmente sus servicios contratados. 
+Notas de calidad: 
+- Revisa la totalidad de la transcripción: tono, ritmo, interrupciones del agente, la claridad en los mensajes del agente y si la escucha activa se mantiene en todo momento.
+- Evita razonamiento interno paso a paso; respeta en lo posible los formatos de salida facilitados.
+- Mantén precisión, neutralidad y foco en detectar evidencias implícitas o explícitas que justifiquen que el cliente realice la baja de sus servicios.
+Categoría | Sin riesgo de fuga
+Descripción | Explica de manera concisa y clara, a alto nivel, qué evidencias has localizado en la llamada, tanto del lado del agente como del lado del cliente, para categorizar a este cliente como “sin riesgo de fuga”, identificando los factores clave para prevenir ese riesgo.
+Acción | Enumera un máximo de cinco factores clave que han ayudado en esta llamada para minimizar el riesgo de fuga (baja) del cliente. La estructura de salida es: 
+- Factor Clave 1: etiqueta breve (p. ej., Adelantarnos a futuras necesidades). Descripción objetiva basada en la transcripción indicando por qué ayuda a reducir el riesgo de fuga del cliente; cita breve del fragmento cuando sea necesario.
+- Factor Clave 2-5: etiqueta y descripción (misma estructura) en orden de relevancia.
+Separa los factores usando: “ ··· “.
+Categoría | En riesgo de Fuga
+Descripción | Explica de manera concisa y clara, a alto nivel, qué evidencias, tanto explícitas como implícitas, has detectado en la llamada para categorizar al cliente como “en riesgo de fuga”, identificando los factores clave que pueden provocar esa fuga o baja del cliente.
+Acción | Enumera un máximo de cinco motivos que justifican una posible fuga del cliente. La estructura de salida es: 
+- Oportunidad de Mejora 1: etiqueta breve (por ejemplo: “No explicar próximos pasos”). Explicación breve indicando por qué evidencia el riesgo de fuga del cliente, añadiendo la información de la causa raíz y si el origen está en la empresa (sus productos, servicios e imagen), si el origen está en el agente (atención recibida tanto en esta llamada como en otras), o si el origen está en el cliente (sus necesidades, estilo de vida). Además, indica cómo puede corregirlo el agente, añadiendo un ejemplo. 
+- Oportunidad de Mejora 2-5: misma estructura. 
+Separa cada oportunidad de mejora usando: “··· “.
+Criterio | 3. Incrementar la Eficiencia Operativa
+Descripción | Propósito: Evaluar de forma exhaustiva la transcripción de llamada para detectar ineficiencias operativas relativas a los procesos de gestión, al desempeño del agente, a sus habilidades comerciales y de atención al cliente, a los tiempos de gestión o a cualquier otro factor que se pueda identificar en la transcripción tanto explícito como implícito. 
+Notas de calidad: 
+- Revisa la totalidad de la transcripción: tono, ritmo, pesos de la conversación del agente frente a la del cliente, interrupciones del agente, la claridad en los mensajes del agente, si la escucha activa se mantiene en todo momento, los procesos que se evidencien.
+- Evita razonamiento interno paso a paso; respeta en lo posible los formatos de salida facilitados.
+- Mantén precisión, neutralidad, foco en desempeño y en los procesos identificables.
+Categoría | Oportunidades de Eficiencia
+Descripción | Explica de manera concisa y clara, a alto nivel, cuáles son las evidencias identificadas en la llamada que justifican que es posible mejorar la eficacia operativa.
+Acción | Enumera un máximo de cinco factores clave que pueden incrementar la eficiencia operativa del servicio. La estructura de salida es: 
+- Factor Clave 1: etiqueta breve (p. ej., Acortar argumentarios o explicaciones). Descripción objetiva, basada en la transcripción, explicando por qué ayuda a mejorar la eficiencia operativa, indicando si afecta a la gestión del agente o a los procesos establecidos para atender las llamadas. Añade cómo puede el agente corregir su trabajo para mejorar la eficiencia operativa, incluyendo un ejemplo; cita breve del fragmento cuando sea necesario.
+- Factor Clave 2-5: misma estructura en orden de relevancia.
+Separa las ideas usando: “··· “.
+Categoría | Eficiencia Óptima
+Descripción | Explica de manera concisa y clara, a alto nivel, qué factores están presentes en esta llamada que justifiquen que no se evidencien más posibilidades de incrementar la eficiencia operativa.
+Acción | Enumera un máximo de cinco factores clave, basándote en la transcripción de la llamada, que demuestran que la eficiencia operativa en la llamada es óptima. La estructura de salida es: 
+- Factor Clave 1: etiqueta breve (por ejemplo: Autoridad del agente.). Explicación detallada de por qué ayuda a la eficiencia operativa, indicando si es responsabilidad del agente, de los procesos del servicio o de los productos, servicios o imagen de la compañía. Cita breve del fragmento cuando sea necesario. 
+- Idea de Mejora 2-5: misma estructura. 
+Separa cada oportunidad de mejora usando: “··· “.
+Criterio | 4. Potenciar el Valor del Cliente
+Descripción | Propósito: Evaluar de forma exhaustiva la transcripción de llamada para identificar necesidades reales (explícitas) y capturar la voz del cliente para necesidades no explícitas o latentes (oportunidades de ajuste de oferta y propuesta al perfil del cliente). Ten en cuenta que es importante maximizar el valor y número de los productos contratados por cada cliente, basándonos en las necesidades detectadas. 
+Notas de calidad: 
+- Revisa la totalidad de la transcripción: tono, ritmo, pesos de la conversación, interrupciones del agente hacia el cliente, la claridad en los mensajes del agente y si la escucha activa se mantiene en todo momento.
+- Evita razonamiento interno paso a paso; respeta en lo posible los formatos de salida facilitados.
+- Mantén precisión, neutralidad y foco en desempeño y la voz del cliente.
+Categoría | Valor Potenciado
+Descripción | Explica de manera concisa y clara, a alto nivel, qué evidencias has localizado que justifiquen que el agente haya logrado potenciar el valor del cliente, identificando los factores clave que le han ayudado a lograrlo.
+Acción | Enumera un máximo de cinco factores clave que justifican y evidencian que se ha potenciado el valor del cliente. La estructura de salida es: 
+- Factor Clave 1: etiqueta breve (p. ej., Escucha activa). Descripción objetiva, basada en la transcripción, que explique con detalle cómo ese factor ayuda a potenciar el valor del cliente e identifica si es un factor que dependa del agente, de los procesos del servicio o de los productos, servicios e imagen de la compañía; cita breve del fragmento cuando sea necesario.
+- Factor Clave 2-5: etiqueta y descripción (misma estructura) en orden de relevancia.
+Separa los factores usando: “··· “.
+Categoría | Valor No Potenciado
+Descripción | Explica de manera concisa y clara, a alto nivel, qué evidencias has localizado en la llamada que justifican que no se ha potenciado el valor del cliente de manera correcta.
+Acción | Enumera un máximo de cinco factores clave, tanto explícitos como implícitos, que han determinado que en la llamada no se haya potenciado el valor del cliente, identificando claramente la causa raíz. La estructura de salida es: 
+- Factor Clave 1: etiqueta breve (por ejemplo: “Sondeo necesidades inexistente”). Explicación detallada que explique cómo este factor ayuda a potenciar el valor del cliente e indica qué tiene que hacer el agente para corregirlo, añadiendo un ejemplo basado en la propia llamada. 
+- Oportunidad de Mejora 2-5: misma estructura. 
+Separa cada oportunidad de mejora usando: “··· “.
+Criterio | 5. Desarrollar el Talento Interno
+Descripción | Propósito: Evaluar de forma exhaustiva la transcripción de llamada para identificar de forma objetiva todo el valor positivo del agente: actitudes, aptitudes, uso del lenguaje, habilidades técnicas/blandas, entre otras. Es importante identificar también todas las áreas de mejora para el agente, tanto actitudinales, aptitudinales, de locución, de uso del lenguaje, habilidades en técnicas de venta, habilidades blandas, además de cualquier otra que identifiques.
+Notas de calidad: 
+- Revisa la totalidad de la transcripción: tono, ritmo, pesos de la conversación, interrupciones del agente, claridad en los mensajes del agente, escucha activa constante, proactividad, interés sincero.
+- Evita razonamiento interno paso a paso; respeta en lo posible los formatos de salida facilitados.
+- Mantén precisión, neutralidad y foco en desempeño e identificar factores clave para potenciar el talento del agente.
+Categoría | Talento Para Replicar
+Descripción | Explica de manera concisa y clara, a alto nivel, qué factores has identificado en la llamada que pueden categorizarse como óptimos y que sea aconsejable replicar en el resto de agentes del servicio para garantizar los mejores resultados posibles.
+Acción | Enumera un máximo de cinco factores clave del talento del agente, identificados en la llamada, que se puedan replicar en el resto de agentes del servicio. La estructura de salida es: 
+- Factor Clave 1: etiqueta breve (p. ej., Transmite fácil el conocimiento técnico). Descripción objetiva, basada en la transcripción, que explique y justifique con detalle por qué este factor es bueno que sea replicado en el resto de agentes; cita breve del fragmento cuando sea necesario.
+- Factor Clave 2-5: etiqueta y descripción (misma estructura) en orden de relevancia.
+Separa los factores usando: “··· “.
+Categoría | Oportunidades de Mejora
+Descripción | Explica de manera concisa y clara, a alto nivel, qué evidencias has localizado en la llamada que determinan que el agente tiene áreas de mejora, indicando los factores clave y la causa raíz de cada uno de ellos.
+Acción | Enumera un máximo de cinco factores clave identificados en la llamada que evidencias que el agente tiene que mejorar en ellos para lograr mejores resultados en cada una de sus llamadas. La estructura de salida es: 
+- Factor Clave1: etiqueta breve (por ejemplo: “Informar próximos pasos”). Explica con detalle cómo este factor enriquece el talento del agente para lograr que sus resultados sean mejores, incluyendo un ejemplo basado en la llamada. 
+- Factor Clave 2-5: misma estructura. 
+- Separa cada oportunidad de mejora usando: “··· “.