¿Qué es y para qué sirve?

La Auditoría Técnica de Pólizas es una herramienta estructurada que guía al usuario a través de un marco de 9 pasos para revisar sistemáticamente una póliza. En cada paso, el usuario captura datos reales de la póliza, los compara contra umbrales configurables (~140 variables), registra hallazgos (brechas) y obtiene recomendaciones generadas automáticamente.

El resultado es un expediente completo por prospecto que incluye: progreso del trabajo, puntaje de riesgo, matriz visual de brechas y biblioteca de recomendaciones priorizadas.

Acceso y autenticación

El acceso requiere credenciales de xAId (Xperto Authentication Intelligence) y uno de los siguientes roles asignados a tu cuenta:

• auditoria-tecnica — Acceso completo a Dashboard, Prospectos, Auditorías, Matriz y Recomendaciones.
• auditoria-admin — Todo lo anterior + edición de Variables (umbrales).
• admin — Acceso global; incluye Auditoría con privilegios administrativos.

El inicio de sesión soporta correo/contraseña y Google OAuth, ambos delegados a xAId. La sesión persiste por 4 horas en localStorage.

Secciones del panel

Diagrama de flujo de trabajo

Visión general del recorrido del usuario desde el inicio de sesión hasta el cierre de la auditoría. El bucle interno (auto-evaluación → revisar hallazgos → completar paso) se repite por cada uno de los 9 pasos.

Marco de auditoría de 9 pasos

Cada auditoría se estructura en estos 9 pasos secuenciales. El progreso (0–100%) se calcula en función de cuántos pasos están marcados como completados.

1. Levantamiento de Información Básica — datos del riesgo, ubicación geográfica, separación entre edificios, plazos contractuales.
2. Evaluación de Aseguradoras — rating AM Best, calificación de riesgo de la aseguradora.
3. Revisión de Condiciones Generales — coberturas estándar (agua accidental, remoción de escombros, cobertura automática) y límites de indemnización.
4. Evaluación de Límites y Sublímites — sublímites por construcción, robo, hurto, cristales, equipos electrónicos, dinero y valores.
5. Análisis de Deducibles y Coaseguros — deducibles catastrófico/no catastrófico, equipos, infidelidad, y porcentajes de coaseguro.
6. Revisión de Exclusiones — análisis cualitativo de exclusiones; sin inputs numéricos.
7. Evaluación de Sumas Aseguradas — interrupción de negocios, períodos de indemnización, seguros de vida de referencia.
8. Análisis de Responsabilidad Civil — límites RC personas y empresas (básica y total), deducibles RC comercios.
9. Evaluación de Cláusulas Especiales — revisión cualitativa de cláusulas particulares.

Cómo funciona la auto-evaluación

Para cada paso con campos numéricos, el flujo es:

1. El usuario captura los valores reales de la póliza (deducibles, sublímites, porcentajes, etc.).
2. El sistema consulta los umbrales de referencia en auditoriaVariables/config según las categorías mapeadas a ese paso.
3. Cada valor se compara contra su umbral. Cuando hay desviación, se genera un hallazgo automático con título, descripción, categoría de incumplimiento y severidad.
4. El usuario revisa los hallazgos auto-generados, los acepta (se persisten) o los descarta. Puede agregar también hallazgos manuales.

Adicionalmente, cada paso permite cargar un archivo de póliza (PDF, DOCX, TXT) para análisis con IA, que sugiere hallazgos adicionales basados en el contenido del documento.

Hallazgos (brechas detectadas)

Cada hallazgo registra:

• Título y descripción — qué se encontró.
• Categoría de incumplimiento — Cobertura Insuficiente, Exclusión Inapropiada, Deducible Excesivo, Suma Asegurada Inadecuada, Responsabilidad Civil Insuficiente, Coaseguro Inadecuado, Cláusula Faltante, Aseguradora Riesgo, Condición General Desfavorable, Otro.
• Severidad — crítica, alta, media o baja.
• Estado — abierto, asignado, resuelto o descartado.
• Origen — auto-generado o manual.

Cálculo del puntaje de riesgo

El puntaje (0–100, donde mayor = más riesgo) se calcula con una suma ponderada:

crítica × 4 + alta × 3 + media × 2 + baja × 1
─────────────────────────────────────────  × 100
       totalHallazgos × 4 (peso máximo)

Esto normaliza el resultado independientemente de la cantidad total de hallazgos: una auditoría con 2 hallazgos críticos puede tener un puntaje más alto que otra con 10 hallazgos bajos.

Recomendaciones automáticas

A partir de cada hallazgo abierto, el motor genera una recomendación usando plantillas vinculadas a la categoría de incumplimiento. Por ejemplo:

• Deducible Excesivo → "Negociar reducción de deducible" (prioridad media, complejidad simple).
• Responsabilidad Civil Insuficiente → "Incrementar límite de RC" (prioridad urgente, complejidad simple).
• Aseguradora Riesgo → "Evaluar cambio de aseguradora" (prioridad urgente, complejidad compleja).

Cada recomendación incluye razonamiento técnico e impacto esperado, y puede editarse, asignarse o marcarse como implementada desde la pestaña Recomendaciones.

Diagrama del modelo de datos

Las 5 colecciones de Firestore que componen el módulo, sus campos clave y las relaciones entre ellas. Las cardinalidades se indican como 1 y N en los conectores.

Línea continua: relación de datos por FK. Línea discontinua verde: auditoriaVariables alimenta la auto-evaluación de cada paso (no es una FK; es lectura por categoría).

Datos y persistencia

Toda la información se almacena en la base de datos Benefait (Firestore) en 5 colecciones:

• auditoriaProspectos — clientes a auditar.
• auditoriaAuditorias — sesiones de auditoría con sus 9 pasos y notas.
• auditoriaHallazgos — brechas detectadas.
• auditoriaRecomendaciones — recomendaciones generadas.
• auditoriaVariables — umbrales configurables (un solo documento config).

Las lecturas usan caché de 5 minutos; las escrituras invalidan el caché automáticamente.

Flujo de trabajo recomendado

1. Crear el prospecto con datos básicos del cliente.
2. Crear una nueva auditoría asociada al prospecto.
3. Recorrer los 9 pasos capturando datos reales de la póliza.
4. En cada paso, ejecutar Auto-Evaluar y/o subir el PDF de la póliza para análisis con IA.
5. Aceptar o descartar los hallazgos sugeridos; agregar hallazgos manuales si corresponde.
6. Marcar el paso como completado y avanzar.
7. Al terminar, revisar la Matriz de Brechas para visión integral.
8. Consultar las Recomendaciones generadas y priorizar las acciones con el cliente.
9. Marcar la auditoría como completada.