DOCUMENTACIÓN TÉCNICA - NF.ClassLibrary

1. INFORMACIÓN GENERAL DEL PROYECTO

Nombre del proyecto: NF.ClassLibrary

Descripción y propósito: Librería de clases compartida para aplicaciones del ecosistema .NET Framework. Proporciona funcionalidades comunes para manejo de bases de datos, procesamiento de archivos, cotizaciones de seguros, integración con servicios externos (Google Drive, Gmail), procesamiento de documentos PDF/Excel, y servicios de importación/exportación de datos.

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

Tipo de aplicación: Class Library (DLL)

Versión del ensamblado: 1.0.0.0

Fecha de creación original: 2016

Fecha de última modificación: Mayo 2025

Visual Studio: Version 17.5.2.0 (Visual Studio 2022)

2. MAPA DE SITIO / ESTRUCTURA DEL PROYECTO

📁 NF.ClassLibrary/
├── 📁 Abstractos/
│   ├── 📄 FileUploaderRules.cs
│   ├── 📄 NegocioResultado.cs
│   └── 📄 ValidadorExcel.cs
├── 📁 CotizadorAutos/
│   ├── 📄 Cobertura.cs
│   ├── 📄 CoberturasAutos.cs
│   ├── 📄 CoberturaResult.cs
│   ├── 📄 Cotizacion.cs
│   ├── 📄 CotizacionResult.cs
│   ├── 📄 Direccion.cs
│   ├── 📄 KeyValue.cs
│   ├── 📄 PaqueteCoberturas.cs
│   ├── 📄 Persona.cs
│   ├── 📄 Poliza.cs
│   ├── 📄 Prima.cs
│   └── 📄 Vehiculo.cs
├── 📁 Cripto/
│   ├── 📄 Encripcion.cs
│   └── 📄 OpenSSL.cs
├── 📁 Crm/
│   └── 📄 Quote.cs
├── 📁 Database/
│   ├── 📄 AttachmentModel.cs
│   ├── 📄 Database.cs
│   ├── 📄 DataModel.cs
│   ├── 📄 DataQs.cs
│   ├── 📄 DataSort.cs
│   ├── 📄 Excel.cs
│   ├── 📄 Field.cs
│   ├── 📄 Mail.cs
│   ├── 📄 Query.cs
│   ├── 📄 ResponseResult.cs
│   ├── 📄 ReportesIP.cs
│   └── 📄 Token.cs
├── 📁 FileUploader/
│   ├── 📄 FileToSave.cs
│   ├── 📄 FileUploader.cs
│   ├── 📄 FileUploaderApprovals.cs
│   ├── 📄 FileUploaderDetencionPagos.cs
│   ├── 📄 FileUploaderDigitalLibrary.cs
│   ├── 📄 FileUploaderEdoctasMet.cs
│   ├── 📄 FileUploaderFromStream.cs
│   ├── 📄 FileUploaderHelios*.cs (múltiples archivos específicos)
│   ├── 📄 FileUploaderMetHelios*.cs
│   ├── 📄 FileUploaderResult.cs
│   ├── 📄 FileUploaderSaveInSQL.cs
│   ├── 📄 FileUploaderSubirFactura*.cs
│   ├── 📄 FileUploaderTmp.cs
│   ├── 📄 FileUploaderValidarFactura.cs
│   ├── 📄 PortadaComunicados.cs
│   ├── 📄 ReadPdf.cs
│   └── 📄 SplittingPdfFile.cs
├── 📁 Gm/
│   ├── 📄 Cotizacion.cs
│   └── 📄 Plan.cs
├── 📁 Importacion/
│   ├── 📄 ImportacionApprovals.cs
│   ├── 📄 ImportadorDetencionPagos.cs
│   ├── 📄 ImportadorFromExcel.cs
│   ├── 📄 ImportadorHelios*.cs (múltiples archivos específicos)
│   ├── 📄 ImportadorIntegralDeComisiones*.cs
│   ├── 📄 ImportadorMet*.cs
│   ├── 📄 ImportadorResultado.cs
│   ├── 📄 ValidadorExcelResultado.cs
│   ├── 📄 ValidadorMetEdoctas.cs
│   ├── 📄 ValidadorRecibosAplicados.cs
│   └── 📄 ValidadorVacio.cs
├── 📁 Log/
│   └── 📄 Log.cs
├── 📁 Met99/
│   ├── 📄 Cobertura.cs
│   ├── 📄 Cotizacion.cs
│   ├── 📄 Ocupacion.cs
│   └── 📄 proyeccionFinanciera.cs
├── 📁 Services/
│   ├── 📄 CerFile.cs
│   ├── 📄 Constantes.cs
│   ├── 📄 Enumeradores.cs
│   ├── 📄 Helpers.cs
│   ├── 📄 Json.cs
│   ├── 📄 MimeType.cs
│   ├── 📄 Prospecto.cs
│   ├── 📄 ToPdf.cs
│   └── 📄 Usuario.cs
├── 📁 shcp/
│   ├── 📄 cfdi.cs
│   ├── 📄 cfdiAgentes.cs
│   └── 📄 IngresoFacturable.cs
├── 📁 Properties/
│   └── 📄 AssemblyInfo.cs
├── 📄 app.config
├── 📄 packages.config
└── 📄 NF.ClassLibrary.csproj

Organización de Namespaces

El proyecto utiliza un namespace principal: nf.classLibrary

Todos los componentes se organizan bajo este namespace único, con separación lógica por carpetas físicas.

3. INVENTARIO DE LIBRERÍAS Y DEPENDENCIAS

NuGet Packages

Librería	Versión Actual	Propósito	Categoría
BouncyCastle	1.8.9	Criptografía y seguridad (versión legacy)	Seguridad
BouncyCastle.Cryptography	2.5.1	Criptografía moderna	Seguridad
DotNetZip	1.15.0	Compresión y descompresión de archivos ZIP	Utilidades
EPPlus	5.6.3	Creación y lectura de archivos Excel (XLSX)	Documentos
Google.Apis	1.69.0	API base de Google	API Externa
Google.Apis.Auth	1.69.0	Autenticación con servicios Google	API Externa
Google.Apis.Core	1.69.0	Funcionalidades core de Google APIs	API Externa
Google.Apis.Drive.v3	1.69.0.3740	Integración con Google Drive	API Externa
Google.Apis.Gmail.v1	1.69.0.3742	Integración con Gmail	API Externa
iTextSharp	5.5.13.2	Generación y manipulación de PDF	Documentos
itextsharp.xmlworker	5.5.13.2	Procesamiento XML para PDFs	Documentos
MailKit	4.12.0	Cliente moderno de correo electrónico	Email
Microsoft.AspNet.Mvc	5.2.7	ASP.NET MVC Framework	Web
Microsoft.AspNet.Razor	3.2.7	Motor de vistas Razor	Web
Microsoft.AspNet.WebApi.Client	5.2.7	Cliente HTTP para Web API	Web
Microsoft.AspNet.WebPages	3.2.7	Sistema de páginas web	Web
Microsoft.IO.RecyclableMemoryStream	1.4.1	Gestión eficiente de memoria para streams	Performance
MimeKit	4.12.0	Procesamiento de mensajes MIME	Email
Newtonsoft.Json	13.0.3	Serialización/deserialización JSON	Serialización
System.Buffers	4.6.0	Gestión de buffers de memoria	Performance
System.Formats.Asn1	8.0.2	Formato ASN.1 para criptografía	Seguridad
System.Memory	4.6.0	Tipos de memoria modernos	Performance
System.Runtime.CompilerServices.Unsafe	6.1.2	Operaciones de bajo nivel	Performance
System.Threading.Tasks.Extensions	4.6.3	Extensiones para programación asíncrona	Async
System.ValueTuple	4.5.0	Soporte para tuplas	Utilidades

Referencias del Sistema

System.Data (Acceso a datos ADO.NET)

System.Configuration (Configuración de aplicaciones)

System.Drawing (Procesamiento de imágenes)

System.IO.Compression (Compresión)

System.Management (Gestión del sistema)

System.Net.Http (Cliente HTTP)

System.Security (Seguridad)

System.ServiceModel (WCF)

System.Transactions (Transacciones distribuidas)

System.Web (Funcionalidades web)

System.Xml (Procesamiento XML)

PresentationCore (WPF Core)

WindowsBase (Base de Windows)

4. ARQUITECTURA DEL PROYECTO

4.1 Patrón Arquitectónico

N-Layer Architecture (Arquitectura en Capas) con enfoque en Utility Library Pattern

El proyecto implementa una arquitectura de librería compartida organizada en capas funcionales:

Capa de Abstracción: Clases base y contratos (Abstractos)

Capa de Datos: Acceso a base de datos y modelos (Database)

Capa de Negocio: Lógica de negocio específica (CotizadorAutos, Met99, Gm, Crm)

Capa de Servicios: Servicios transversales (Services, Cripto, Log)

Capa de Procesamiento: Importación y carga de archivos (FileUploader, Importacion)

Capa de Integración Fiscal: Funcionalidades SHCP y facturación (shcp)

4.2 Diagrama de Arquitectura (Mermaid)

4.3 Componentes Principales

Capa de Abstracción (Abstractos)

Define contratos base y clases abstractas para validación de archivos Excel, reglas de carga de archivos y resultados de operaciones de negocio.

Clases principales:

NegocioResultado: Clase resultado estándar con propiedades success, total, message, data y dataTable

ValidadorExcel: Base para validación de archivos Excel

FileUploaderRules: Reglas de negocio para carga de archivos

Capa de Datos (Database)

Maneja toda la comunicación con SQL Server, ejecución de stored procedures, consultas dinámicas y operaciones CRUD.

Características:

Clase DataBase con patrón IDisposable

Soporte para múltiples bases de datos configurables

Manejo de connection strings por entorno (RunTimeMode)

Clase Mail para envío de correos con SMTP/MailKit

Modelos de datos (DataModel, Token, Field)

Sistema de consultas dinámicas (Query, DataQs)

Capa de Negocio

CotizadorAutos:
Sistema completo de cotización de seguros de autos con modelos para coberturas, pólizas, vehículos, personas y cálculo de primas.

Met99:
Módulo de cotización de seguros con coberturas, ocupaciones y proyecciones financieras.

Gm:
Módulo de planes y cotizaciones específicas.

Crm:
Integración con sistemas CRM (Quote).

Capa de Servicios (Services)

Servicios transversales reutilizables:

Helpers: Métodos de extensión y utilidades generales

Json: Serialización/deserialización

ToPdf: Conversión de documentos a PDF

CerFile: Manejo de certificados digitales (.cer)

MimeType: Detección de tipos MIME

Constantes y Enumeradores: Valores constantes del sistema

Usuario y Prospecto: Modelos de dominio

Capa de Procesamiento de Archivos (FileUploader/Importacion)

FileUploader:
Sistema especializado en carga y procesamiento de archivos:

Validación de facturas XML/PDF

Procesamiento de archivos Helios (sistema de pólizas)

Procesamiento de archivos Qualitas (aseguradora)

Integración con biblioteca digital

Procesamiento de estados de cuenta y cobranza

División de archivos PDF

Lectura de PDF estructurados

Importacion:
Sistema de importación masiva desde Excel:

Importadores específicos por tipo de archivo (Helios, Ana, Qualitas, Met)

Validadores de integridad de datos

Procesamiento de detención de pagos

Importación de catálogos (oficinas, centros de costos, monedas)

Cálculo de ingresos facturables

Capa de Criptografía (Cripto)

Encripcion: Hash de passwords con SHA1

OpenSSL: Integración con OpenSSL para operaciones criptográficas

Capa de Logging (Log)

Sistema de registro de eventos y auditoría.

Capa de Integración Fiscal (shcp)

cfdi: Procesamiento de Comprobantes Fiscales Digitales

cfdiAgentes: CFDIs específicos para agentes

IngresoFacturable: Cálculo de ingresos facturables para SHCP

Servicios Externos

Google Drive API: Almacenamiento y gestión de documentos

Gmail API: Envío y recepción de correos

SMTP/MailKit: Envío de correos tradicional

4.4 Flujo de Datos

Flujo de Importación de Archivos

5. ASPECTOS MÁS RELEVANTES

5.1 Funcionalidades Principales

Sistema de Cotización de Seguros Automotrices

Cotización multi-aseguradora (Qualitas, ANA, etc.)

Cálculo de primas y coberturas

Generación de propuestas y paquetes

Gestión de pólizas y vehículos

Procesamiento Masivo de Archivos

Importación de archivos Excel con validación robusta

Procesamiento de archivos de aseguradoras (Helios, Qualitas, ANA)

Carga de estados de cuenta y reportes de cobranza

Validación y almacenamiento de facturas electrónicas

Integración con Servicios de Google

Almacenamiento automático en Google Drive

Envío de correos mediante Gmail API

Gestión de archivos adjuntos

Gestión Documental

Generación de PDFs desde HTML (iTextSharp)

División y procesamiento de archivos PDF

Lectura estructurada de PDFs

Conversión de documentos

Sistema de Facturación Electrónica (CFDI)

Procesamiento de CFDIs (XML)

Validación de certificados digitales (.cer)

Cálculo de ingresos facturables para SHCP

Gestión de facturas de agentes

Acceso a Datos Empresarial

Conexión dinámica a múltiples bases de datos

Ejecución de stored procedures

Consultas parametrizadas y seguras

Manejo de transacciones

Sistema de Envío de Correos

SMTP tradicional y MailKit moderno

Soporte para adjuntos múltiples

Configuración flexible de servidores

Manejo de Archivos Excel Avanzado

Lectura y escritura con EPPlus

Validación de estructuras

Exportación de reportes

Criptografía y Seguridad

Encriptación de contraseñas (SHA1)

Integración con OpenSSL

Manejo de certificados digitales

10.

Sistema de Logging y Auditoría

Registro de operaciones críticas

Trazabilidad de procesos

5.2 Configuraciones Críticas

Connection Strings

El sistema utiliza un patrón de configuración por entorno:

<connectionStrings>
  <add name="Prometeo_[RunTimeMode]" connectionString="..." />
</connectionStrings>

Donde RunTimeMode se obtiene de:

<appSettings>
  <add key="RunTimeMode" value="Dev|Test|Prod" />
</appSettings>

Bases de datos soportadas:

Prometeo (principal)

Otras configurables dinámicamente

Configuración de Seguridad

Assembly Binding Redirects:
Configurados en app.config para resolver conflictos de versiones:

Newtonsoft.Json → 13.0.0.0

iTextSharp → 5.5.13.2

BouncyCastle.Crypto → 1.8.9.0

System.Runtime.CompilerServices.Unsafe → 6.0.3.0

System.Memory → 4.0.2.0

System.Buffers → 4.0.4.0

Configuración de Logging

Implementado a través de la clase Log en el namespace nf.classLibrary.

Variables de Entorno

RunTimeMode: Define el entorno de ejecución (Dev/Test/Prod)

Credenciales de servicios Google (configuradas por código)

Configuración SMTP para envío de correos

5.3 Patrones de Diseño Implementados

Repository Pattern (Implícito)

Clase DataBase actúa como repositorio genérico

Abstracción del acceso a datos

Factory Pattern

Construcción dinámica de importadores específicos

FileUploaders especializados por tipo

Template Method Pattern

Clase abstracta ValidadorExcel define flujo de validación

Implementaciones concretas en ValidadorMetEdoctas, etc.

Strategy Pattern

Diferentes estrategias de importación (ImportadorHelios, ImportadorFromExcel)

Validadores intercambiables

Disposable Pattern

Implementación de IDisposable en clase DataBase

Gestión correcta de recursos (SqlConnection)

Result Pattern

Clases ResponseResult, NegocioResultado, ImportadorResultado

Encapsulación de resultados con success/error

Helper/Utility Pattern

Clase estática Helpers con métodos de extensión

Servicios utilitarios (Json, MimeType, ToPdf)

5.4 Seguridad

Autenticación

No implementada directamente (librería de utilidades)

Hash de passwords con SHA1CryptoServiceProvider

⚠️ ADVERTENCIA: SHA1 es obsoleto para passwords, se recomienda migrar a bcrypt o Argon2

Autorización

No aplica (librería sin lógica de autorización)

Se delega a las aplicaciones consumidoras

Protecciones Implementadas

✅ Protecciones existentes:

Consultas parametrizadas: Uso de SqlParameter para prevenir SQL Injection

IDisposable Pattern: Liberación correcta de recursos de base de datos

Validación de archivos: Validadores específicos para archivos de entrada

Manejo de excepciones: Try-catch en operaciones críticas

Connection String por configuración: No hardcodeadas en código

⚠️ Vulnerabilidades potenciales identificadas:

SHA1 para passwords: Algoritmo obsoleto y vulnerable

Falta de validación de entrada: No se observa sanitización exhaustiva

Posible exposición de información: Mensajes de error pueden exponer detalles internos

Sin rate limiting: No hay protección contra ataques de fuerza bruta

Certificados SSL/TLS: Configuración SMTP con enableSsl pero sin validación de certificados

Nivel de seguridad general: 🟡 MEDIO

Protecciones básicas implementadas

Requiere mejoras críticas en criptografía

Falta defensa en profundidad

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: Vinculado al ciclo de vida de Windows

Estado: ✅ Soportado (Soporte extendido hasta que Windows 10/11 estén soportados)

Notas importantes:

.NET Framework 4.8 es la última versión de .NET Framework

Microsoft recomienda migrar a .NET 6/8 para nuevos desarrollos

.NET Framework 4.8 recibirá solo correcciones de seguridad críticas

Compatibilidad C#

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

Características modernas NO disponibles:

Nullable Reference Types (C# 8)

Pattern Matching avanzado (C# 9+)

Records (C# 9)

Global usings (C# 10)

Required members (C# 11)

Compatibilidad de Plataforma

Windows: ✅ Completamente compatible

Linux: ❌ No soportado (requiere .NET Core/.NET 6+)

macOS: ❌ No soportado (requiere .NET Core/.NET 6+)

7. RECOMENDACIONES DE ACTUALIZACIÓN

7.1 Prioridad Alta 🔴

Librería/Framework	Versión Actual	Versión Recomendada	Motivo	Esfuerzo
Algoritmo de Hash	SHA1	SHA256/bcrypt/Argon2	Seguridad Crítica - SHA1 es vulnerable	Bajo
iTextSharp	5.5.13.2	iText7 u alternativa	EOL - Versión obsoleta sin soporte	Alto
BouncyCastle (dual)	1.8.9 + 2.5.1	2.5.1 (consolidar)	Eliminar versión legacy 1.8.9	Medio
.NET Framework	4.8	.NET 8 LTS	Modernización y cross-platform	Muy Alto

Detalle crítico - SHA1:

7.2 Prioridad Media 🟡

Librería	Versión Actual	Versión Recomendada	Beneficio	Esfuerzo
EPPlus	5.6.3	7.5+	Nuevas características Excel, mejor performance	Medio
Google.Apis.*	1.69.0	Última estable	Nuevas APIs y correcciones	Bajo
Newtonsoft.Json	13.0.3	System.Text.Json (migrar)	Performance y nativo en .NET moderno	Alto
MailKit	4.12.0	Última estable	Mejoras de seguridad SMTP	Bajo
Microsoft.AspNet.Mvc	5.2.7	ASP.NET Core 8	Modernización (requiere .NET 8)	Muy Alto

7.3 Prioridad Baja 🟢

Librería	Versión Actual	Versión Recomendada	Beneficio	Esfuerzo
DotNetZip	1.15.0	System.IO.Compression	Nativo, sin dependencia externa	Bajo
System.Memory	4.6.0	Integrado en .NET 8	Eliminación de NuGet innecesario	Bajo (.NET 8)
System.Buffers	4.6.0	Integrado en .NET 8	Eliminación de NuGet innecesario	Bajo (.NET 8)

7.4 Framework .NET - Roadmap de Migración

7.5 Plan de Migración a .NET 8

Fase 1: Preparación (2 meses)

Inventariar dependencias incompatibles

Identificar código dependiente de .NET Framework específico

Crear proyecto paralelo en .NET 8

Configurar multi-targeting temporal

Fase 2: Migración Gradual (3 meses)

Migrar módulos independientes primero (Services, Cripto)

Actualizar librerías incompatibles

Refactorizar código System.Web dependiente

Implementar inyección de dependencias donde corresponda

Fase 3: Consolidación (2 meses)

Migración completa del proyecto

Pruebas exhaustivas

Actualización de aplicaciones consumidoras

Deployment gradual

Beneficios de migrar a .NET 8:

✅ Cross-platform (Windows, Linux, macOS)

✅ Mejor performance (2-3x más rápido)

✅ Soporte LTS hasta noviembre 2026

✅ Características modernas de C# 12

✅ Mejor seguridad nativa

✅ Menor consumo de memoria

✅ Contenedorización nativa

8. MÉTRICAS DEL PROYECTO

Distribución de Archivos

Estadísticas del Proyecto

Total de archivos .cs: ~120+ archivos

Módulos principales: 11 carpetas funcionales

Dependencias NuGet: 25+ paquetes

Líneas de código estimadas: 15,000 - 20,000 LOC

Complejidad: Media-Alta (dominio asegurador especializado)

Cobertura de Dependencias

Detalle:

🟢 Actualizadas (40%): MailKit, MimeKit, Newtonsoft.Json, Google APIs, EPPlus

🟡 Desactualizadas menores (35%): Librerías System., Microsoft.AspNet.

🔴 Críticas (25%): iTextSharp (EOL), SHA1 (vulnerable), .NET Framework 4.8 (legacy)

9. DEUDA TÉCNICA IDENTIFICADA

Issues Críticos 🔴

Vulnerabilidad de seguridad: Migrar SHA1 a algoritmo moderno (bcrypt/Argon2/PBKDF2)

Librería obsoleta: iTextSharp 5.x sin soporte, migrar a iText7 o alternativa (QuestPDF, PdfSharp)

Doble dependencia BouncyCastle: Versiones 1.8.9 y 2.5.1 coexisten, consolidar en 2.5.1

.NET Framework EOL: Framework legacy sin futuro, planificar migración a .NET 8

Issues Importantes 🟡

Falta de inyección de dependencias: Código acoplado con new directo

Sin manejo centralizado de excepciones: Lógica dispersa en try-catch

Falta de logging estructurado: Implementar Serilog o NLog

Sin pruebas unitarias: No se identificaron proyectos de testing

Código System.Web: Dependencias web en librería de clase (acoplamiento innecesario)

Connection strings hardcoded: Patrón de configuración poco flexible

Falta de validación de entrada: No se observa sanitización exhaustiva de datos externos

Sin documentación XML: Falta XML comments en clases públicas

Mejoras Recomendadas 🟢

Implementar patrón Unit of Work: Para gestión de transacciones complejas

Agregar validación con FluentValidation: Validación declarativa y reutilizable

Implementar AutoMapper: Para mapeo de entidades/DTOs

Migrar a Async/Await: Operaciones I/O síncronas bloqueantes

Implementar Circuit Breaker: Para llamadas a servicios externos (Polly)

Agregar health checks: Monitoreo de dependencias externas

Containerización: Preparar para Docker/Kubernetes

Documentación técnica: README, diagramas de arquitectura actualizados

Implementar CQRS: Separación de comandos y consultas en módulos complejos

Cache distribuido: Redis/MemoryCache para optimización

Telemetría: Application Insights u OpenTelemetry

Versionado semántico: Gestión de versiones de la librería

Refactoring Sugerido

Alta prioridad:

Extraer lógica de negocio de clases de datos (Single Responsibility)

Crear interfaces para clases principales (Database, Mail, FileUploader)

Separar configuración de código (Options Pattern)

Eliminar dependencias System.Web innecesarias

Media prioridad:

Normalizar nombres de archivos (convención PascalCase consistente)

Consolidar clases utilitarias dispersas

Crear DTOs explícitos en lugar de Dictionary<string, object>

Implementar Validators específicos por entidad

10. GLOSARIO TÉCNICO

Término	Descripción
ANA	Aseguradora (Seguros ANA) - Una de las aseguradoras integradas en el sistema
CFDI	Comprobante Fiscal Digital por Internet - Factura electrónica SAT México
Coberturas	Protecciones incluidas en una póliza de seguro
Deducible	Cantidad que el asegurado debe pagar antes de que la aseguradora cubra un siniestro
Edocta	Estado de Cuenta - Reporte financiero de pólizas y pagos
EPPlus	Librería .NET para manipulación de archivos Excel sin Office instalado
Helios	Sistema de gestión de pólizas de seguros (aparentemente sistema interno/legacy)
iTextSharp	Librería para creación y manipulación de archivos PDF
L.U.C.	Límite Único Combinado - Tipo de cobertura en seguros
MailKit	Cliente de correo moderno para .NET (SMTP, IMAP, POP3)
Met99/Met	Sistema o aseguradora específica (Metlife posiblemente)
Prima	Costo de la póliza de seguro
Prometeo	Nombre de la base de datos principal del sistema
Qualitas	Aseguradora Qualitas - Una de las aseguradoras principales del sistema
RunTimeMode	Configuración de entorno (Dev/Test/Prod)
SHCP	Secretaría de Hacienda y Crédito Público - Institución fiscal de México
SP (Stored Procedure)	Procedimiento almacenado en SQL Server
Suma Asegurada	Valor máximo que paga la aseguradora en caso de siniestro

11. NOTAS ADICIONALES

Observaciones Importantes

Dominio Altamente Especializado: El proyecto está profundamente ligado al sector asegurador mexicano con integración a sistemas específicos (Helios, Qualitas, ANA) y normativas fiscales (SAT/SHCP).

Dependencia de SQL Server: Todo el acceso a datos está centralizado en SQL Server con uso intensivo de stored procedures. No hay abstracción para otros motores de BD.

Arquitectura Monolítica: Librería única con múltiples responsabilidades. En una arquitectura moderna se separaría en:

NF.Core (abstracciones, interfaces)

NF.Data (acceso a datos)

NF.Insurance (lógica de seguros)

NF.FileProcessing (procesamiento de archivos)

NF.Integration (Google, Email, SHCP)

NF.Common (utilidades transversales)

Patrón de Configuración Legacy: Uso de ConfigurationManager y app.config en lugar de IConfiguration moderno.

Sin Contenedorización: No preparado para Docker/Kubernetes (dependencias Windows).

Posible Código Duplicado: Múltiples clases Cotizacion.cs y Cobertura.cs en diferentes namespaces (CotizadorAutos, Met99, Gm) sugieren duplicación de lógica.

Fortalezas del Proyecto

✅ Separación clara de responsabilidades por carpetas
✅ Uso de patrones Result para manejo de errores
✅ Implementación de IDisposable para recursos
✅ Validación de archivos antes de procesamiento
✅ Integración con servicios modernos (Google APIs, MailKit)
✅ Soporte para múltiples bases de datos y entornos
✅ Funcionalidad completa y especializada del dominio

Debilidades del Proyecto

❌ Framework obsoleto (.NET Framework 4.8)
❌ Algoritmo de hash vulnerable (SHA1)
❌ Falta de pruebas unitarias
❌ Sin inyección de dependencias
❌ Dependencias legacy (iTextSharp, ASP.NET MVC)
❌ Acoplamiento a Windows
❌ Sin documentación de código (XML comments)
❌ Falta de async/await en operaciones I/O

Próximos Pasos Recomendados

Inmediatos (1-2 meses):

Migrar SHA1 a bcrypt (seguridad crítica)

Implementar suite de pruebas unitarias básicas

Documentar clases públicas con XML comments

Actualizar BouncyCastle y consolidar versión

Corto plazo (3-6 meses):

Migrar operaciones síncronas a async/await

Implementar inyección de dependencias

Actualizar Google APIs y MailKit

Crear interfaces para clases principales

Mediano plazo (6-12 meses):

Planificar migración a .NET 8 LTS

Migrar iTextSharp a alternativa moderna

Implementar logging estructurado

Separar librería en módulos más pequeños

Largo plazo (12+ meses):

Completar migración a .NET 8

Implementar arquitectura modular (NuGet packages separados)

Containerización y CI/CD

Migrar Newtonsoft.Json a System.Text.Json

12. INFORMACIÓN DE SOPORTE

Contacto Técnico

Repositorio Git: Configurado (branch: master)

Sistema de control de versiones: Git

Entornos

Entorno	RunTimeMode	Estado
Desarrollo	Dev	✅ Activo
Pruebas	Test	✅ Activo
Producción	Prod	✅ Activo

Aplicaciones que Consumen esta Librería

Basado en las referencias a proyectos externos en paths de NuGet:

Fb_Cotizador - Sistema de cotización front-end

front_back - Aplicación web principal

Documentación generada: 2025-12-13
Analizado por: Claude AI (Sonnet 4.5)
Versión del documento: 1.0
Framework analizado: .NET Framework 4.8
Proyecto: NF.ClassLibrary v1.0.0.0

ClassLibrary

DOCUMENTACIÓN TÉCNICA - NF.ClassLibrary#

1. INFORMACIÓN GENERAL DEL PROYECTO#

2. MAPA DE SITIO / ESTRUCTURA DEL PROYECTO#

Organización de Namespaces#

3. INVENTARIO DE LIBRERÍAS Y DEPENDENCIAS#

NuGet Packages#

Referencias del Sistema#

4. ARQUITECTURA DEL PROYECTO#

4.1 Patrón Arquitectónico#

4.2 Diagrama de Arquitectura (Mermaid)#

4.3 Componentes Principales#

Capa de Abstracción (Abstractos)#

Capa de Datos (Database)#

Capa de Negocio#

Capa de Servicios (Services)#

Capa de Procesamiento de Archivos (FileUploader/Importacion)#

Capa de Criptografía (Cripto)#

Capa de Logging (Log)#

Capa de Integración Fiscal (shcp)#

Servicios Externos#

4.4 Flujo de Datos#

Flujo de Importación de Archivos#

5. ASPECTOS MÁS RELEVANTES#

5.1 Funcionalidades Principales#

5.2 Configuraciones Críticas#

Connection Strings#

Configuración de Seguridad#

Configuración de Logging#

Variables de Entorno#

5.3 Patrones de Diseño Implementados#

5.4 Seguridad#

Autenticación#

Autorización#

Protecciones Implementadas#

6. ANÁLISIS DE VERSIONES Y COMPATIBILIDAD#

Framework .NET#

Compatibilidad C##

Compatibilidad de Plataforma#

7. RECOMENDACIONES DE ACTUALIZACIÓN#

7.1 Prioridad Alta 🔴#

7.2 Prioridad Media 🟡#

7.3 Prioridad Baja 🟢#

7.4 Framework .NET - Roadmap de Migración#

7.5 Plan de Migración a .NET 8#

8. MÉTRICAS DEL PROYECTO#

Distribución de Archivos#

Estadísticas del Proyecto#

Cobertura de Dependencias#

9. DEUDA TÉCNICA IDENTIFICADA#

Issues Críticos 🔴#

Issues Importantes 🟡#

Mejoras Recomendadas 🟢#

Refactoring Sugerido#

10. GLOSARIO TÉCNICO#

11. NOTAS ADICIONALES#

Observaciones Importantes#

Fortalezas del Proyecto#

Debilidades del Proyecto#

Próximos Pasos Recomendados#

12. INFORMACIÓN DE SOPORTE#

Contacto Técnico#

Entornos#

Aplicaciones que Consumen esta Librería#