Documentación del Proyecto - Sistema de Cotizaciones de Seguros

1. INFORMACIÓN GENERAL DEL PROYECTO

Nombre del proyecto: FrontBack Cotizador

Descripción y propósito: Sistema web para cotización y emisión de pólizas de seguros automotrices, integrando múltiples aseguradoras (Qualitas, ANA, AXA, Zurich, Mapfre) mediante servicios web SOAP. Permite gestionar cotizaciones, emisiones y generación de reportes PDF.

Versión del framework .NET utilizado: .NET Framework 4.8

Tipo de aplicación: Aplicación Web MVC/Web API Híbrida

Fecha de última modificación del proyecto: 2025-12-13

Namespace raíz: FrontBack

Assembly: FrontBack

2. MAPA DE SITIO / ESTRUCTURA DEL PROYECTO

📁 fb_cotizador/
├── 📁 App_Start/
│   ├── 📄 BundleConfig.cs
│   ├── 📄 FilterConfig.cs
│   ├── 📄 IdentityConfig.cs
│   ├── 📄 RouteConfig.cs
│   ├── 📄 Startup.Auth.cs
│   └── 📄 WebApiConfig.cs
├── 📁 Areas/
│   └── 📁 HelpPage/
│       ├── 📁 Controllers/
│       │   └── 📄 HelpController.cs
│       ├── 📁 Models/
│       ├── 📁 ModelDescriptions/
│       └── 📁 SampleGeneration/
├── 📁 Controllers/
│   ├── 📄 HomeController.cs (MVC)
│   ├── 📄 QualitasController.cs (API)
│   ├── 📄 AnaController.cs (API)
│   ├── 📄 AxaController.cs (API)
│   ├── 📄 ZurichController.cs (API)
│   ├── 📄 MapfreController.cs (API)
│   ├── 📄 AutonetV4Controller.cs (API)
│   ├── 📄 WebReportController.cs (MVC)
│   ├── 📄 NotificacionController.cs (MVC)
│   ├── 📄 Cotizacion.cs
│   ├── 📄 Autos.cs
│   ├── 📄 EducaLifeController.cs
│   ├── 📄 PerfectLifeController.cs
│   ├── 📄 MetaLifeController.cs
│   ├── 📄 Met99Controller.cs
│   ├── 📄 polizaOlympusController.cs
│   ├── 📄 ValuesController.cs
│   ├── 📄 HelpersController.cs
│   └── 📁 Nf/
│       ├── 📄 AccountController.cs
│       ├── 📄 Helpers.cs
│       ├── 📄 NF_IISTaskManager.cs
│       ├── 📄 Nf_CaseController.cs
│       ├── 📄 Nf_DataController.cs
│       ├── 📄 Nf_FileController.cs
│       ├── 📄 Nf_FrontBack.cs
│       └── 📄 Nf_GridViewController.cs
├── 🐀񀐠Library/
│   ├── 📄 CotizadorQualitas.cs
│   ├── 📄 CotizadorAna.cs
│   ├── 📄 CotizadorAxa.cs
│   ├── 📄 CotizadorZurich.cs
│   ├── 📄 CotizacionQualitas.cs
│   ├── 📄 CotizacionAna.cs
│   ├── 📄 CotizacionAxa.cs
│   └── 📄 CotizacionZurich.cs
├── 📁 LibraryPdf/
│   ├── 📄 Aseg.cs
│   ├── 📄 Cotiz.cs
│   ├── 📄 CotizVi.cs
│   ├── 📄 CotizadorGmm.cs
│   ├── 📄 DatosGM.cs
│   └── 📄 GenSubs.cs
├── 📁 Models/
│   ├── 📄 AccountBindingModels.cs
│   ├── 📄 AccountViewModels.cs
│   └── 📄 IdentityModels.cs
├── 📁 Service References/
│   ├── 📁 wsQualitas/
│   ├── 📁 wsQualitasQA/
│   ├── 📁 wsQualitasCatalogo/
│   ├── 📁 wsQualitasImpresion/
│   └── 📁 wsAna/
├── 📁 Views/
│   ├── 📁 Home/
│   │   └── 📄 Index.cshtml
│   ├── 📁 Shared/
│   │   ├── 📄 _Layout.cshtml
│   │   └── 📄 Error.cshtml
│   ├── 📁 WebReport/
│   │   ├── 📄 CotizacionAutoPdf.cshtml
│   │   ├── 📄 CotizacionAutoPdfConAxa.cshtml
│   │   ├── 📄 CotizacionAutoPdf_Mail_Tpl.cshtml
│   │   ├── 📄 CotizacionAutoPdf_Mail_Tpl_Ejecutivo.cshtml
│   │   ├── 📄 CotizacionGMPdf.cshtml
│   │   ├── 📄 CotizacionGMPdf_Mail_Tpl.cshtml
│   │   ├── 📄 CotizacionMet99Pdf.cshtml
│   │   ├── 📄 CotizacionMet99Pdf_Mail_Tpl.cshtml
│   │   ├── 📄 CotizacionMetVidaPdf_Mail_Tpl.cshtml
│   │   ├── 📄 CotizacionRCMedico.cshtml
│   │   ├── 📄 CotizacionCasa.cshtml
│   │   ├── 📄 CotizacionSeguroAuto.cshtml
│   │   ├── 📄 ZCotizacionSeguroAuto.cshtml
│   │   ├── 📄 Cotizacion_Mail_Tpl.cshtml
│   │   └── 📄 wait.cshtml
│   └── 📁 Notificacion/
│       └── 📄 CotizacionAutoPdf.cshtml
├── 📁 xml/
│   ├── 📁 zurich/
│   ├── 📄 Ana_Cotizar_Amplia_VC.xml
│   ├── 📄 Ana_Cotizar_Plus_VC.xml
│   ├── 📄 Ana_Cotizar_Rc_VC.xml
│   ├── 📄 Ana_Cotizar_Limitada_VC.xml
│   ├── 📄 Ana_Emision.xml
│   ├── 📄 Ana_Impresion.xml
│   ├── 📄 Axa_Cotizar.xml
│   ├── 📄 Qualitas_Cotizar.xml
│   ├── 📄 Qualitas_Cotizar_Servicio_Publico.xml
│   ├── 📄 Qualitas_ObtenerCatalogo.xml
│   └── 📄 Qualitas_Emitir.xml
├── 📁 Content/
├── 📁 Scripts/
├── 📁 Providers/
│   └── 📄 ApplicationOAuthProvider.cs
├── 🐀񀐠Results/
│   └── 📄 ChallengeResult.cs
├── 📄 Web.config
├── 📄 Global.asax.cs
└── 📄 Startup.cs

3. INVENTARIO DE LIBRERÍAS Y DEPENDENCIAS

NuGet Packages

Librería	Versión Actual	Propósito	Categoría
EntityFramework	6.2.0	ORM para acceso a datos	ORM
EntityFramework.SqlServer	6.2.0	Proveedor SQL Server para EF	ORM
Microsoft.AspNet.Mvc	5.2.7	Framework MVC	UI/Framework
Microsoft.AspNet.WebApi.Core	5.2.7	Framework Web API	API
Microsoft.AspNet.WebApi.WebHost	5.2.7	Hosting para Web API	API
Microsoft.AspNet.WebApi.Client	5.2.7	Cliente HTTP para Web API	API
Microsoft.AspNet.WebApi.Cors	5.2.7	Soporte CORS para Web API	API
Microsoft.AspNet.WebApi.Owin	5.2.7	Integración OWIN con Web API	API
Microsoft.AspNet.Identity.Core	2.2.2	Sistema de identidad y autenticación	Seguridad
Microsoft.AspNet.Identity.EntityFramework	2.2.2	Implementación EF para Identity	Seguridad
Microsoft.AspNet.Identity.Owin	2.2.2	Integración OWIN con Identity	Seguridad
Microsoft.Owin	4.0.1	Middleware OWIN	Framework
Microsoft.Owin.Host.SystemWeb	4.0.1	Host OWIN para IIS	Framework
Microsoft.Owin.Security	4.0.1	Middleware de seguridad OWIN	Seguridad
Microsoft.Owin.Security.Cookies	4.0.1	Autenticación basada en cookies	Seguridad
Microsoft.Owin.Security.OAuth	4.0.1	Soporte OAuth 2.0	Seguridad
Microsoft.Owin.Security.Facebook	4.0.1	Autenticación con Facebook	Seguridad
Microsoft.Owin.Security.Google	4.0.1	Autenticación con Google	Seguridad
Microsoft.Owin.Security.MicrosoftAccount	4.0.1	Autenticación con Microsoft	Seguridad
Microsoft.Owin.Security.Twitter	4.0.1	Autenticación con Twitter	Seguridad
Newtonsoft.Json	13.0.1	Serialización/deserialización JSON	Utilidades
NLog	4.6.6	Framework de logging	Logging
iTextSharp	5.5.13.2	Generación de documentos PDF	PDF
itextsharp.xmlworker	5.5.13.2	Procesamiento XML/HTML a PDF	PDF
BouncyCastle.Crypto	1.8.9	Criptografía	Seguridad
Common.Logging	3.4.1	Abstracción de logging	Logging
Common.Logging.Core	3.4.1	Núcleo de Common.Logging	Logging
RethinkDb.Driver	2.3.100	Cliente para base de datos RethinkDB	Base de datos
WebGrease	1.6.0	Optimización de recursos web	Optimización
Antlr	3.5.0.2	Parser para bundling/minificación	Optimización
Owin	1.0	Especificación OWIN	Framework
Microsoft.AspNet.Cors	5.2.7	Soporte CORS	API
Microsoft.AspNet.Razor	3.2.7	Motor de vistas Razor	UI
Microsoft.AspNet.WebPages	3.2.7	Páginas web ASP.NET	UI
Microsoft.AspNet.Web.Optimization	1.1.3	Bundling y minificación	Optimización
Microsoft.Web.Infrastructure	1.0.0.0	Infraestructura web compartida	Framework
jQuery	3.4.1	Biblioteca JavaScript	UI
Bootstrap	4.x	Framework CSS/JS	UI
Modernizr	2.8.3	Detección de características HTML5/CSS3	UI
Popper.js	Incluido	Posicionamiento de tooltips/popovers	UI

Referencias DLL Externas (No NuGet)

Librería	Ubicación	Propósito
DynamicPDF	....\dlls\DynamicPDF.dll	Generación dinámica de PDFs
IKVM.Runtime	....\dlls\IKVM.Runtime.dll	Ejecución de código Java en .NET
IKVM.OpenJDK.Core	....\dlls\IKVM.OpenJDK.Core.dll	Bibliotecas core de Java
IKVM.OpenJDK.Security	....\Dll\IKVM.OpenJDK.Security.dll	Seguridad Java
IKVM.OpenJDK.Text	....\Dll\IKVM.OpenJDK.Text.dll	Procesamiento de texto Java
IKVM.OpenJDK.Util	....\Dll\IKVM.OpenJDK.Util.dll	Utilidades Java

Referencias de Proyecto

Proyecto	GUID	Propósito
NF.ClassLibrary	{3c0ac671-cf96-4894-aefc-eb1663292e4c}	Biblioteca de clases compartida (base de datos, modelos)
MetCotizadores	{aceec137-488f-49bb-a8f1-1cf3d5b12333}	Cotizadores de seguros MetLife

4. ARQUITECTURA DEL PROYECTO

4.1 Patrón Arquitectónico

El proyecto implementa una arquitectura híbrida MVC/Web API en N-Capas:

Capa de Presentación: Vistas Razor (MVC) para reportes PDF y páginas web

Capa de Controladores:

Controladores MVC para vistas

Controladores API para integración con aseguradoras

Capa de Lógica de Negocio: Clases Cotizador* en carpeta Library

Capa de Acceso a Datos: Entity Framework + Stored Procedures

Servicios Externos: Web Services SOAP (WCF) de aseguradoras

4.2 Diagrama de Arquitectura

4.3 Componentes Principales

Capa de Presentación

Vistas Razor: Templates para generación de reportes PDF y emails de cotizaciones

HelpPage: Documentación automática de API

Bootstrap 4: Framework UI para interfaces responsivas

Capa de Controladores API

QualitasController: Cotización, emisión y obtención de pólizas Qualitas

AnaController: Cotización y emisión para ANA Seguros

AxaController: Integración con AXA

ZurichController: Integración con Zurich

MapfreController: Integración con Mapfre

AutonetV4Controller: Integración con Autonet

NotificacionController: Envío de notificaciones y reportes

Capa de Lógica de Negocio

CotizadorQualitas: Lógica de cotización Qualitas usando XML

CotizadorAna: Lógica de cotización ANA usando Web Services

CotizadorAxa: Lógica de cotización AXA

CotizadorZurich: Lógica de cotización Zurich

LibraryPdf/: Generadores de PDF para cotizaciones

Capa de Datos

NF.ClassLibrary: Clases de acceso a datos (DataBase, DataModel, ResponseResult, etc.)

Entity Framework 6.2: ORM para modelos de Identity

Stored Procedures: Operaciones de base de datos principales

Múltiples bases de datos:

Prometeo (principal)

PegasusDB

Autonet_V8

iOpenData

Cotizadores

olympus_op_pr

Servicios Externos

wsQualitas: Servicio SOAP de Qualitas (emisión)

wsQualitasQA: Ambiente QA de Qualitas

wsQualitasCatalogo: Catálogos de Qualitas

wsQualitasImpresion: Impresión de pólizas Qualitas

wsAna: Servicio SOAP de ANA Seguros

4.4 Flujo de Datos

5. ASPECTOS MÁS RELEVANTES

5.1 Funcionalidades Principales

Cotización Multi-Aseguradora

Integración simultánea con Qualitas, ANA, AXA, Zurich, Mapfre

Soporte para múltiples paquetes de cobertura (Amplia, Limitada, RC)

Cotización con diferentes formas de pago (Contado, Mensual, Trimestral, etc.)

Configuración de descuentos y bonificaciones por colectividad

Emisión de Pólizas

Emisión directa con aseguradoras vía Web Services

Generación automática de PDF de pólizas

Validaciones de datos antes de emisión

Manejo de ambientes (Producción/QA)

Generación de Reportes PDF

Cotizaciones en PDF con múltiples templates

Templates para email de ejecutivos

Reportes de seguros de autos, casa, gastos médicos

Integración con iTextSharp y DynamicPDF

Gestión de Catálogos

Obtención dinámica de catálogos de aseguradoras

Marcas, modelos, submarcas de vehículos

Códigos postales, estados, municipios

Paquetes de coberturas y deducibles

Sistema de Autenticación

ASP.NET Identity 2.2

OAuth 2.0 para integración con redes sociales

Autorización por colectividades

Gestión de credenciales por aseguradora

Integración con Autonet

Integración con sistema Autonet V4

Sincronización de cotizaciones

Sistema de Notificaciones

Envío de emails con cotizaciones

Templates HTML para correos

Configuración SMTP

Gestión de Colectividades

Configuración de descuentos por colectividad

Credenciales de Web Services por colectividad

Derechos de póliza configurables

Manejo de Ambientes

Configuración para Producción, QA, UAT

Connection strings por ambiente

CDN configurable por ambiente

10.

Logs y Auditoría

NLog para registro de errores

Almacenamiento de Request/Response de Web Services

Trazabilidad de cotizaciones y emisiones

5.2 Configuraciones Críticas

Connection Strings

- Prometeo_Prod: Base de datos principal
- PegasusDB_Prod: Sistema Pegasus
- Autonet_Prod: Integración Autonet V8
- iOpenData_Prod: Datos abiertos
- Cotizadores_Prod: Cotizadores MetLife
- Olympus_DB_Prod: Sistema Olympus

Servidor: sql.prod
Usuario: pegasus_user
Timeout: 30000ms

Configuraciones de Seguridad

Autenticación: None (manejo por OWIN/Identity)

CORS: Habilitado para APIs

Headers permitidos: Content-Type, Authorization, X-Requested-With

Métodos: GET, POST, PUT, DELETE, OPTIONS

Credentials: true

HTTPS Redirect: Comentado (se puede activar)

Custom Errors: Off (modo desarrollo)

Configuraciones de Aseguradoras

Qualitas

Clave_Agente: 31247
Numero_Negocio: 04538
Derechos_poliza: 750
Descuento: 40%

ANA Seguros

Clave_Agente: 59892
Numero_Negocio: 870
Usuario: 03910
Clave: 3Ruwrepr
Bonificacion: 25%

Configuraciones de Email

SMTP Server: smtp.gmail.com
Port: 587
SSL: Enabled
From: autos@riesgosamparados.com

Configuraciones de Logging

RootAppLog: C:\DEBUG
correo_reporte_error: erik.martinez@grupokc.com.mx

CDN

CDN_Prod: https://cdngrupokc.azureedge.net/web/
CDN_QA: https://cdngrupokc.azureedge.net/web/

5.3 Patrones de Diseño Implementados

Repository Pattern: A través de NF.ClassLibrary (DataBase, DataModel)

Factory Pattern: Creación de cotizadores por aseguradora

Strategy Pattern: Diferentes estrategias de cotización por aseguradora

Template Method: Templates XML para cada tipo de cotización

DTO (Data Transfer Objects): CotizacionQualitas, CotizacionAna, CoberturaResult

Dependency Injection: Vía OWIN para Identity y autenticación

Async/Await Pattern: Operaciones asíncronas en controladores API

Service Layer: Capa de cotizadores como servicios de negocio

5.4 Seguridad

Autenticación

ASP.NET Identity 2.2: Gestión de usuarios y roles

OWIN Authentication Middleware: Pipeline de autenticación

OAuth 2.0: Soporte para Facebook, Google, Microsoft, Twitter

Cookie Authentication: Sesiones de usuario

[Authorize] Attribute: Protección de endpoints API (algunos comentados en código)

Autorización

Validación de colectividades

Credenciales por aseguradora almacenadas en BD

Validación de descuentos máximos por colectividad

Protecciones Implementadas

CORS Configurado: Control de orígenes cruzados

TLS 1.2: Forzado para comunicación con servicios externos

SQL Injection Protection: Uso de Stored Procedures y parámetros

Binding Redirect: Prevención de conflictos de versiones

X-Frame-Options: Removido (permitir iframes)

Consideraciones de Seguridad

Credenciales en Web.config (hardcoded) - RIESGO ALTO

Custom Errors: Off - No recomendado para producción

Algunos endpoints API sin [Authorize]

Connection strings con credenciales en texto plano

6. ANÁLISIS DE VERSIONES Y COMPATIBILIDAD

Framework .NET

Versión actual: .NET Framework 4.8

Fecha de lanzamiento: Abril 2019

Fecha de fin de soporte: Indefinido (soportado mientras Windows lo soporte)

Estado: ✅ Completamente Soportado (Última versión de .NET Framework)

Política de soporte: Soportado como parte del sistema operativo Windows

Compatibilidad C#

Versión del lenguaje: C# 7.3 (compatible con .NET Framework 4.8)

Características modernas utilizadas:

Async/Await

LINQ

Extension Methods

Lambda Expressions

Nullable Reference Types (no utilizado)

Pattern Matching (no utilizado)

Compatibilidad de IIS

Versión mínima: IIS 7.0+

Modo Pipeline: Integrated

Runtime Version: v4.0

TypeScript: 3.0

Navegadores Soportados

Basado en Bootstrap 4 y jQuery 3.4.1

IE 10+, Edge, Chrome, Firefox, Safari

7. RECOMENDACIONES DE ACTUALIZACIÓN

7.1 Prioridad Alta 🔴

Componente	Versión Actual	Versión Recomendada	Motivo	Esfuerzo
Framework	.NET Framework 4.8	.NET 8.0+	Modernización, performance, soporte a largo plazo, cloud-ready	Alto
Credenciales	Hardcoded en Web.config	Azure Key Vault / Secrets Manager	Seguridad crítica, exposición de credenciales	Medio
Custom Errors	Off	On con páginas personalizadas	Seguridad, no exponer detalles internos	Bajo
HTTPS	Opcional (comentado)	Obligatorio con HSTS	Seguridad, cifrado de datos sensibles	Bajo
ASP.NET Identity	2.2.2	ASP.NET Core Identity (latest)	Seguridad, características modernas	Alto

7.2 Prioridad Media 🟡

Componente	Versión Actual	Versión Recomendada	Beneficio	Esfuerzo
NLog	4.6.6	5.3+	Mejores features, performance	Bajo
iTextSharp	5.5.13.2	iText 7+ o QuestPDF	Licenciamiento, características modernas	Medio
Newtonsoft.Json	13.0.1	System.Text.Json	Performance, reducción de dependencias	Medio
jQuery	3.4.1	3.7+	Seguridad, bugs corregidos	Bajo
Bootstrap	4.x	5.x	Mejoras UI, mejor accesibilidad	Medio
Entity Framework	6.2.0	EF Core 8+	Performance, características modernas	Alto
Web API	ASP.NET Web API	ASP.NET Core Web API	Performance, cross-platform	Alto
SOAP Services	WCF	gRPC o REST	Modernización, mejor performance	Alto

7.3 Prioridad Baja 🟢

Componente	Versión Actual	Versión Recomendada	Beneficio	Esfuerzo
TypeScript Tools	3.0	Latest	Mejores características TS	Bajo
Modernizr	2.8.3	Eliminar (no necesario en navegadores modernos)	Reducir dependencias	Bajo
RethinkDB.Driver	2.3.100	Latest	Características nuevas	Bajo

7.4 Roadmap de Migración Recomendado

7.5 Estrategia de Migración a .NET 8

Opción 1: Big Bang (No Recomendado)

Migrar todo el proyecto de una vez. Alto riesgo, largo tiempo sin deploys.

Opción 2: Strangler Fig Pattern (Recomendado)

Crear nueva aplicación .NET 8 en paralelo

Migrar endpoints gradualmente de .NET Framework a .NET 8

Usar API Gateway (Azure API Management, Ocelot) para enrutar tráfico

Compartir base de datos durante migración

Migrar usuarios cuando funcionalidad crítica esté migrada

Retirar aplicación legacy cuando todo esté migrado

Ventajas del Strangler Pattern

Deploys continuos sin interrupciones

Rollback fácil si hay problemas

Testing en producción gradual

Menor riesgo de negocio

Aprendizaje incremental del equipo

8. MÉTRICAS DEL PROYECTO

Estadísticas de Código

Total de Controladores: 23+

Total de Vistas Razor: 20+

Servicios Web Integrados: 5 (Qualitas, ANA, AXA, Zurich, Mapfre)

Bases de Datos Conectadas: 7

Templates XML: 15+

Librerías de Negocio: 8 clases principales de cotizadores

Modelos de Datos: 3+ (Identity models)

9. DEUDA TÉCNICA IDENTIFICADA

Issues Críticos 🔴

Credenciales hardcoded en Web.config - ALTO RIESGO DE SEGURIDAD

Migrar a Azure Key Vault o sistema de secrets

Implementar rotación de credenciales

Custom Errors desactivado - Exposición de información sensible

Activar custom errors en producción

Crear páginas de error personalizadas

Endpoints API sin autorización - Algunos endpoints comentaron [Authorize]

Revisar y aplicar [Authorize] donde corresponda

Implementar políticas de autorización granulares

Falta de manejo centralizado de excepciones

Implementar Global Exception Handler

Logging estructurado de excepciones

Connection strings en texto plano

Cifrar connection strings

Usar Always Encrypted de SQL Server

Sin implementación de Circuit Breaker para Web Services

Implementar Polly para resiliencia

Manejo de timeouts y reintentos

Issues Importantes 🟡

Código duplicado en controladores de aseguradoras

Crear clase base abstracta para controladores

Extraer lógica común

Falta de tests unitarios e integración

Implementar xUnit/NUnit

Cobertura mínima 70%

Logging inconsistente

Estandarizar logging con NLog

Implementar correlación de logs

Falta de documentación de APIs

Swagger/OpenAPI está parcialmente configurado (HelpPage)

Completar documentación de endpoints

XML parsing manual con XmlDocument

Migrar a LINQ to XML (XDocument)

Considerar modelos fuertemente tipados con serialización

Uso de Thread.Sleep en código de producción

Eliminar ThreadProc innecesarios

Usar async/await correctamente

Falta de validación de entrada

Implementar Data Annotations

Validar todos los FormDataCollection

Mejoras Recomendadas 🟢

Implementar caching

Redis o In-Memory caching para catálogos

Reducir llamadas a Web Services

Containerizar aplicación

Crear Dockerfile

Kubernetes/AKS deployment

CI/CD Pipeline

Azure DevOps / GitHub Actions

Automated testing y deployment

Monitoreo y observabilidad

Application Insights

Health checks

Métricas de negocio

Refactorizar arquitectura hacia Clean Architecture

Separar Domain, Application, Infrastructure

Dependency Inversion

Implementar MediatR

CQRS pattern para separar lecturas/escrituras

Mejor testabilidad

Versionado de API

Implementar API versioning

Documentar breaking changes

10. GLOSARIO TÉCNICO

Términos de Dominio

Cotización: Proceso de calcular el costo de una póliza de seguro antes de la emisión

Emisión: Generación formal de una póliza de seguro después de la cotización

Paquete de Cobertura: Conjunto de coberturas incluidas en una póliza (Amplia, Limitada, RC)

RC (Responsabilidad Civil): Cobertura básica obligatoria

DM (Daños Materiales): Cobertura para daños al vehículo

GMO (Gastos Médicos Ocupantes): Cobertura médica para ocupantes del vehículo

Deducible: Monto que el asegurado debe pagar antes de que la aseguradora cubra el resto

Suma Asegurada: Monto máximo que la aseguradora pagará por un siniestro

Bonificación/Descuento: Porcentaje de descuento aplicado a la prima

Colectividad: Grupo de clientes con condiciones especiales (empresa, organización)

Clave AMIS: Código estandarizado de vehículo por la Asociación Mexicana de Instituciones de Seguros

Número de Negocio: Identificador del agente/negocio en la aseguradora

Términos Técnicos

SOAP: Protocolo de comunicación basado en XML para Web Services

WCF (Windows Communication Foundation): Framework de Microsoft para servicios web

OWIN (Open Web Interface for .NET): Abstracción entre servidores web y aplicaciones

ORM (Object-Relational Mapping): Entity Framework para mapear objetos a BD

DTO (Data Transfer Object): Objetos para transferir datos entre capas

CORS (Cross-Origin Resource Sharing): Compartir recursos entre diferentes orígenes

HSTS (HTTP Strict Transport Security): Forzar conexiones HTTPS

CDN (Content Delivery Network): Red de distribución de contenido estático

Aseguradoras Integradas

Qualitas: Aseguradora mexicana especializada en seguros de auto

ANA (ABA Seguros): Aseguradora mexicana

AXA: Aseguradora internacional

Zurich: Aseguradora internacional

Mapfre: Aseguradora española con presencia en México

MetLife: Aseguradora de vida

Sistemas Relacionados

Autonet: Sistema de administración de agencias

Pegasus: Sistema interno de gestión

Olympus: Sistema de operaciones

iOpenData: Sistema de datos abiertos

Prometeo: Base de datos principal

NOTAS ADICIONALES

Ambientes de Ejecución

El sistema está configurado para múltiples ambientes:

Producción (Prod): Ambiente productivo

QA: Control de calidad

UAT: User Acceptance Testing

EnQA: Ambiente adicional de QA

La configuración se controla mediante:

<add key="RunTimeMode" value="Prod"/>

Características Notables

Multitenancy por Colectividad: Cada colectividad puede tener diferentes credenciales y descuentos

Templates XML por Operación: Cada operación (cotizar, emitir) tiene su template XML

Generación Dinámica de PDFs: Múltiples templates Razor para diferentes tipos de reportes

Integración con Azure CDN: Recursos estáticos servidos desde Azure CDN

Stored Procedures: La mayoría de operaciones de BD usan SPs

Limitaciones Conocidas

No hay implementación de rate limiting para APIs

No hay implementación de circuit breaker para resiliencia

Falta de health checks para monitoreo

No hay implementación de feature flags

Logging de requests/responses puede impactar performance

No hay compresión de responses configurada

Falta de paginación en algunos endpoints

Oportunidades de Optimización

Caching de catálogos: Los catálogos de vehículos raramente cambian

Async all the way: Algunos métodos síncronos pueden ser async

Bulk operations: Guardar múltiples cotizaciones en una sola operación

Database indexes: Revisar y optimizar índices

Query optimization: Algunos SPs podrían optimizarse

CDN para XMLs: Templates XML podrían servirse desde CDN

Lazy loading: Cargar servicios solo cuando se necesiten

Referencias de Documentación

ASP.NET MVC 5: https://docs.microsoft.com/aspnet/mvc/overview/getting-started/

ASP.NET Web API 2: https://docs.microsoft.com/aspnet/web-api/

Entity Framework 6: https://docs.microsoft.com/ef/ef6/

OWIN: http://owin.org/

iTextSharp: https://itextpdf.com/

Documentación generada: 2025-12-13
Analizado por: Claude AI (Sonnet 4.5)
Versión del documento: 1.0
Proyecto: FrontBack Cotizador
Framework: .NET Framework 4.8

FbCotizador

Documentación del Proyecto - Sistema de Cotizaciones de Seguros#

1. INFORMACIÓN GENERAL DEL PROYECTO#

2. MAPA DE SITIO / ESTRUCTURA DEL PROYECTO#

3. INVENTARIO DE LIBRERÍAS Y DEPENDENCIAS#

NuGet Packages#

Referencias DLL Externas (No NuGet)#

Referencias de Proyecto#

4. ARQUITECTURA DEL PROYECTO#

4.1 Patrón Arquitectónico#

4.2 Diagrama de Arquitectura#

4.3 Componentes Principales#

Capa de Presentación#

Capa de Controladores API#

Capa de Lógica de Negocio#

Capa de Datos#

Servicios Externos#

4.4 Flujo de Datos#

5. ASPECTOS MÁS RELEVANTES#

5.1 Funcionalidades Principales#

5.2 Configuraciones Críticas#

Connection Strings#

Configuraciones de Seguridad#

Configuraciones de Aseguradoras#

Configuraciones de Email#

Configuraciones de Logging#

CDN#

5.3 Patrones de Diseño Implementados#

5.4 Seguridad#

Autenticación#

Autorización#

Protecciones Implementadas#

Consideraciones de Seguridad#

6. ANÁLISIS DE VERSIONES Y COMPATIBILIDAD#

Framework .NET#

Compatibilidad C##

Compatibilidad de IIS#

Navegadores Soportados#

7. RECOMENDACIONES DE ACTUALIZACIÓN#

7.1 Prioridad Alta 🔴#

7.2 Prioridad Media 🟡#

7.3 Prioridad Baja 🟢#

7.4 Roadmap de Migración Recomendado#

7.5 Estrategia de Migración a .NET 8#

Opción 1: Big Bang (No Recomendado)#

Opción 2: Strangler Fig Pattern (Recomendado)#

Ventajas del Strangler Pattern#

8. MÉTRICAS DEL PROYECTO#

Estadísticas de Código#

9. DEUDA TÉCNICA IDENTIFICADA#

Issues Críticos 🔴#

Issues Importantes 🟡#

Mejoras Recomendadas 🟢#

10. GLOSARIO TÉCNICO#

Términos de Dominio#

Términos Técnicos#

Aseguradoras Integradas#

Sistemas Relacionados#

NOTAS ADICIONALES#

Ambientes de Ejecución#

Características Notables#

Limitaciones Conocidas#

Oportunidades de Optimización#

Referencias de Documentación#