DOCUMENTACIÓN ARQUITECTURA - PROYECTO PROMETEO

1. INFORMACIÓN GENERAL DEL PROYECTO

Nombre del proyecto: PROMETEO

Descripción y propósito: Sistema empresarial integral para la gestión de seguros del Grupo KC. Plataforma multi-módulo que incluye gestión de pólizas, siniestros, bonos, portales de agentes, inteligencia de negocios y herramientas de generación de código.

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

Tipo de aplicación: Aplicación Web Híbrida (ASP.NET MVC 5 + Web API 2 + SPA)

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

Empresa: Grupo KC (KC Insurance Group)

Estado del framework: ✅ Soportado hasta 2038

2. MAPA DE SITIO / ESTRUCTURA DEL PROYECTO

2.1 Estructura de la Solución

📁 E:\Prod\Prometeo/
├── 📁 .git/                        # Control de versiones
├── 📁 .vs/                         # Visual Studio settings
├── 📁 .vscode/                     # VS Code settings
├── 📁 Archivos/                    # Documentación y archivos varios
│   ├── 📁 Cfdi33/
│   ├── 📁 Cratos/
│   └── 📁 Kraken/
├── 📁 Bi/                          # Business Intelligence
│   └── 📄 Kraken.pbix             # Power BI Reports
├── 📁 bower_components/            # Frontend dependencies
├── 📁 packages/                    # NuGet packages cache
├── 📁 Solicitudes/
├── 📁 SQL/                         # Scripts SQL principales
│   ├── 📁 Facturacion Liq 2/
│   ├── 📁 Fecha_Vencimiento/
│   ├── 📁 PFV/
│   └── 📁 Titan/
├── 📁 Web/                         # ⭐ PROYECTO PRINCIPAL (ver detalle abajo)
├── 📄 Prometeo.sln                # Solución Visual Studio
├── 📄 .gitignore
└── 📄 README.md

2.2 Estructura del Proyecto Web (Principal)

📁 Web/
│
├── 📁 api/                         # Endpoints API adicionales
│
├── 📁 App_Data/                    # Datos de aplicación
│
├── 📁 App_Start/                   # ⚙️ Configuración de inicio
│   ├── 📄 BundleConfig.cs         # Bundling y minificación
│   ├── 📄 FilterConfig.cs         # Filtros globales MVC
│   ├── 📄 IdentityConfig.cs       # Configuración de identidad
│   ├── 📄 RouteConfig.cs          # Rutas MVC
│   ├── 📄 Startup.Auth.cs         # Configuración OAuth/Auth
│   └── 📄 WebApiConfig.cs         # Configuración Web API
│
├── 📁 app_kc/                      # 🅰️ Aplicación AngularJS
│   ├── 📁 controllers/
│   ├── 📁 directives/
│   ├── 📁 modules/
│   ├── 📁 services/
│   ├── 📁 views/
│   ├── 📄 index.js
│   └── 📄 routes.js
│
├── 📁 app_segunet/                 # 🎯 APLICACIÓN PRINCIPAL (ExtJS)
│   │                               # Sistema de gestión de seguros SEGUNET
│   ├── 📁 abstract/               # Framework personalizado
│   │   ├── 📁 components/         # Componentes reutilizables
│   │   │   ├── 📄 ColumnTree.js
│   │   │   ├── 📄 ComboGeneral.js
│   │   │   ├── 📄 DatepickerGeneral.js
│   │   │   ├── 📄 Form.js
│   │   │   ├── 📄 Grid.js
│   │   │   ├── 📄 Panel.js
│   │   │   ├── 📄 PanelFile.js
│   │   │   └── 📄 Window.js
│   │   ├── 📁 data/               # Controladores de datos
│   │   │   ├── 📄 Controller.js   # Controlador base CRUD
│   │   │   ├── 📄 Model.js        # Modelo base
│   │   │   └── 📄 Store.js        # Store base
│   │   ├── 📁 scripts/            # Utilidades JavaScript
│   │   │   ├── 📄 Events.js
│   │   │   ├── 📄 Functions.js
│   │   │   └── 📄 Notificaciones.js
│   │   └── 📁 security/           # Seguridad y autenticación
│   │       ├── 📄 Menu.js
│   │       └── 📄 Login.js
│   │
│   ├── 📁 controllers/             # Controladores ExtJS
│   │
│   ├── 📁 models/                  # 📊 ~1,255 modelos de datos
│   │   ├── 📁 administracion/
│   │   ├── 📁 bonos/
│   │   ├── 📁 clientes/
│   │   ├── 📁 polizas/
│   │   ├── 📁 siniestros/
│   │   └── 📄 [1,255+ archivos .js]
│   │
│   ├── 📁 services/                # Servicios Frontend (nuevo)
│   │
│   ├── 📁 store/                   # Stores de datos ExtJS
│   │
│   ├── 📁 views/                   # 🎨 ~1,056 módulos de vistas
│   │   ├── 📁 dm_bonos_resultados_gm_kc/
│   │   ├── 📁 dm_bonos_resultados_vida_kc/
│   │   ├── 📁 liquidacion_agente_bonos/
│   │   │   ├── 📄 GridView*.js
│   │   │   └── 📄 WindowDetalle.js
│   │   ├── 📁 tickets_mesa_siniestros/
│   │   ├── 📁 usuarios_whatsapptelefonos/
│   │   └── 📄 [1,056+ carpetas de vistas]
│   │
│   ├── 📄 Direccion.js            # Controlador principal de rutas
│   └── 📄 Templates.js            # Templates HTML
│
├── 📁 Areas/                       # Áreas MVC
│   └── 📁 HelpPage/               # Documentación automática API
│
├── 📁 bonos/                       # Módulo de bonos
│
├── 📁 bower_components/            # Dependencias frontend
│   ├── 📁 polymer/
│   ├── 📁 iron-elements/
│   ├── 📁 paper-elements/
│   ├── 📁 gold-elements/
│   ├── 📁 firebase-element/
│   └── 📁 material-design-lite/
│
├── 📁 Content/                     # Recursos estáticos CSS
│
├── 📁 Controllers/                 # 🎮 CONTROLADORES .NET
│   ├── 📁 Case/                   # Generador de código (CaseTool)
│   ├── 📁 Eventos/
│   ├── 📁 i/                      # Portal agentes independientes
│   ├── 📁 Kc/
│   ├── 📁 Nf/                     # ⭐ FRAMEWORK NÚCLEO
│   │   ├── 📄 Nf_CaseController.cs    # Generación de código
│   │   ├── 📄 Nf_DataController.cs    # CRUD genérico
│   │   ├── 📄 Nf_FileController.cs    # Gestión de archivos
│   │   └── 📄 Nf_FrontBack.cs         # Integración FrontBack
│   ├── 📁 Universidad/
│   ├── 📄 AccountController.cs    # Autenticación
│   ├── 📄 HomeController.cs       # Página principal
│   ├── 📄 PowerBiController.cs    # Reportes Power BI
│   ├── 📄 HeliosController.cs     # Portal Helios
│   ├── 📄 HeliosAutosController.cs
│   ├── 📄 HeliosComercialController.cs
│   ├── 📄 HeliosIpController.cs
│   ├── 📄 CrmController.cs
│   ├── 📄 EventosController.cs
│   ├── 📄 IController.cs          # Portal agentes independientes
│   ├── 📄 InteligenciaNegocioController.cs
│   ├── 📄 KcController.cs
│   ├── 📄 KCCoinsController.cs
│   ├── 📄 SiniestrosController.cs
│   └── 📄 [~30 controladores más]
│
├── 📁 css/                         # Estilos personalizados
│
├── 📁 d3/                          # Visualización de datos D3.js
│
├── 📁 extjs/                       # Framework ExtJS
│
├── 📁 fine-uploader/               # Subida de archivos
│
├── 📁 gojs/                        # Diagramas GoJS
│
├── 📁 img/                         # Imágenes
│
├── 📁 js/                          # Scripts JavaScript generales
│
├── 📁 Models/                      # 📋 Modelos .NET
│   ├── 📄 AccountBindingModels.cs
│   ├── 📄 AccountViewModels.cs
│   ├── 📄 EmbedConfig.cs          # Config Power BI
│   └── 📄 IdentityModels.cs       # Modelos de identidad
│
├── 📁 Providers/                   # Proveedores de servicios
│   └── 📄 ApplicationOAuthProvider.cs
│
├── 📁 Properties/                  # Propiedades del proyecto
│   └── 📄 AssemblyInfo.cs
│
├── 📁 Scripts/                     # Scripts third-party
│   ├── 📄 jquery-*.js
│   ├── 📄 bootstrap.js
│   └── 📄 [librerías varias]
│
├── 📁 sql/                         # 🗄️ Scripts SQL del proyecto
│   └── 📁 CaseTool/
│       ├── 📄 p_DM_Bonos_Resultados_GM_KC_delete.sql
│       ├── 📄 p_DM_Bonos_Resultados_GM_KC_get.sql
│       ├── 📄 p_DM_Bonos_Resultados_GM_KC_insert.sql
│       ├── 📄 p_DM_Bonos_Resultados_GM_KC_update.sql
│       └── 📄 v_GridViewDM_Bonos_Resultados_GM_KC.sql
│
├── 📁 ux/                          # ExtJS UX extensions
│
├── 📁 Views/                       # 🖼️ Vistas Razor MVC (~129 archivos)
│   ├── 📁 Case/                   # CaseTool views
│   ├── 📁 Crm/
│   ├── 📁 DxN/
│   ├── 📁 Eventos/
│   ├── 📁 Helios/
│   ├── 📁 HeliosAutos/
│   ├── 📁 HeliosComercial/
│   ├── 📁 HeliosIp/
│   ├── 📁 Hey/
│   ├── 📁 Home/
│   ├── 📁 i/                      # Portal agentes independientes
│   ├── 📁 InteligenciaNegocio/
│   ├── 📁 Kc/
│   ├── 📁 KCCoins/
│   ├── 📁 PowerBi/
│   ├── 📁 Shared/                 # Vistas compartidas (_Layout.cshtml)
│   ├── 📁 Siniestros/
│   └── 📄 [más carpetas...]
│
├── 📄 Global.asax                 # Punto de entrada de la aplicación
├── 📄 Startup.cs                  # OWIN Startup
├── 📄 Web.config                  # ⚙️ Configuración principal
├── 📄 bower.json                  # Dependencias Bower
├── 📄 packages.config             # Paquetes NuGet
└── 📄 Prometeo.csproj             # Archivo de proyecto (11,215 líneas)

2.3 Proyectos dentro de la Solución

La solución contiene 2 proyectos principales:

Prometeo (Web)

Ruta: Web\Prometeo.csproj

GUID: {DEBD77E2-CDCD-4964-B68F-06445D0C7AAF}

Namespace: Front

Assembly: Front.dll

Tipo: ASP.NET Web Application

NF.ClassLibrary

Ruta: ..\ClassLibrary\NF.ClassLibrary\NF.ClassLibrary.csproj

GUID: {3C0AC671-CF96-4894-AEFC-EB1663292E4C}

Namespace: nf.classLibrary

Tipo: Class Library (Framework/Core compartido)

2.4 Organización de Namespaces

Front/                              # Namespace principal
├── Front.Controllers/              # Controladores MVC/API
│   ├── Front.Controllers.Case/
│   ├── Front.Controllers.Eventos/
│   ├── Front.Controllers.IP/       # Portal independiente
│   ├── Front.Controllers.Kc/
│   ├── Front.Controllers.Nf/       # Framework core
│   └── Front.Controllers.Universidad/
├── Front.Models/                   # Modelos .NET
└── Front.Providers/                # OAuth providers

nf.classLibrary/                    # Framework compartido
├── nf.classLibrary.DataBase       # Acceso a datos
├── nf.classLibrary.ResponseResult  # Patrón de respuesta
├── nf.classLibrary.Helpers        # Extension methods
└── nf.classLibrary.Mail           # Servicios de correo

2.5 Relaciones entre Proyectos/Módulos

3. INVENTARIO DE LIBRERÍAS Y DEPENDENCIAS

3.1 NuGet Packages

Librería	Versión	Propósito	Categoría
EntityFramework	6.4.4	ORM para acceso a datos SQL Server	ORM/Data
Microsoft.AspNet.Mvc	5.2.7	Framework MVC para vistas Razor	Framework
Microsoft.AspNet.WebApi	5.2.7	Web API RESTful services	API
Microsoft.AspNet.WebApi.Core	5.2.7	Core Web API	API
Microsoft.AspNet.WebApi.Cors	5.2.7	CORS support para API	API
Newtonsoft.Json	12.0.3	Serialización/deserialización JSON	Utilidades
Microsoft.Owin	4.1.1	OWIN middleware pipeline	Framework
Microsoft.Owin.Host.SystemWeb	4.1.1	OWIN IIS integration	Framework
Microsoft.Owin.Security	4.1.1	Middleware de seguridad	Seguridad
Microsoft.Owin.Security.OAuth	4.0.1	OAuth 2.0 authentication	Seguridad
Microsoft.Owin.Security.Cookies	4.1.1	Cookie authentication	Seguridad
Microsoft.AspNet.Identity.Core	2.2.3	Sistema de identidad (usuarios/roles)	Seguridad
Microsoft.AspNet.Identity.EntityFramework	2.2.3	Identity con EF	Seguridad
Microsoft.AspNet.Identity.Owin	2.2.3	Identity con OWIN	Seguridad
System.IdentityModel.Tokens.Jwt	5.5.0	JWT token handling	Seguridad
Microsoft.IdentityModel.Tokens	6.8.0	Token validation	Seguridad
BouncyCastle	1.8.9	Librería criptográfica	Seguridad
EPPlus	5.8.2	Generación de archivos Excel	Reportes/Export
iTextSharp	5.5.13	Generación de archivos PDF	Reportes/Export
Microsoft.PowerBI.Api	2.9.0	Power BI API integration	Business Intelligence
Microsoft.PowerBI.AspNet.Mvc	1.1.11	Power BI embed en MVC	Business Intelligence
DotNetZip	1.15.0	Compresión de archivos ZIP	Utilidades
MailKit	4.12.0	Envío y recepción de correos SMTP/IMAP	Comunicación
MimeKit	4.12.0	MIME message parsing (usado por MailKit)	Comunicación
Google.Apis.Core	1.69.0	Google APIs core library	Integración
Google.Apis.Auth	1.69.0	Google authentication	Integración
Google.Apis.Drive.v3	1.69.0	Google Drive API	Integración/Storage
Google.Apis.Gmail.v1	1.69.0	Gmail API	Comunicación
Antlr	3.5.0.2	Parser generator (usado por Web API)	Framework
WebGrease	1.6.0	JavaScript/CSS optimization	Optimización
Cors.ConfigProfiles	5.1.3	CORS profile configuration	API
Microsoft.CodeDom.Providers.DotNetCompilerPlatform	2.0.1	Roslyn compiler	Framework
Microsoft.Net.Compilers	3.6.0	C# and VB compilers	Framework
Microsoft.AspNet.Web.Optimization	1.1.3	Bundling and minification	Optimización
Microsoft.AspNet.WebPages	3.2.7	Razor pages engine	Framework
Microsoft.Web.Infrastructure	1.0.0	Web infrastructure	Framework
Respond	1.4.2	IE8 responsive CSS support	UI/Compatibilidad
Modernizr	2.8.3	Feature detection	UI/Compatibilidad

Total de paquetes NuGet: ~40+

3.2 Frontend Dependencies (Bower)

Librería	Versión	Propósito	Categoría
polymer	^1.4.0	Web Components framework	Framework
iron-elements	^1.0.9	Polymer core elements	UI Components
paper-elements	^1.0.7	Material Design components	UI Components
gold-elements	^1.0.1	Ecommerce components (credit card)	UI Components
neon-elements	^1.0.0	Animation components	UI Components
platinum-elements	^1.2.0	Offline/push/bluetooth	UI Components
app-storage	^0.9.3	Local storage components	Storage
material-design-lite	^1.1.3	Material Design Lite	UI Framework
firebase-element	^1.0.12	Firebase integration	Backend Services
polymerfire	^0.9.2	Firebase for Polymer	Backend Services
google-youtube	PolymerElements/google-youtube#^1.2.0	YouTube embed	Media
google-castable-video	GoogleChrome/google-castable-video#^1.0.3	Chromecast video	Media

3.3 JavaScript Libraries (Otros)

Librería	Propósito	Categoría
ExtJS	Framework principal SPA (SEGUNET)	Framework
AngularJS 1.x	Framework SPA secundario (KC)	Framework
jQuery	3.x - DOM manipulation	Utilidades
Bootstrap	4.x - CSS framework	UI Framework
D3.js	Visualización de datos	Data Visualization
GoJS	Diagramas y flowcharts	Diagramas
Fine Uploader	Carga de archivos	File Upload
UI-Router	AngularJS routing	Routing

3.4 Categorización de Dependencias

ORM/Data Access (2)

EntityFramework 6.4.4

ADO.NET (nativo)

Framework Core (12)

ASP.NET MVC 5.2.7

ASP.NET Web API 5.2.7

Microsoft.Owin 4.1.1

Microsoft.AspNet.WebPages 3.2.7

etc.

Seguridad (9)

Microsoft.Owin.Security.OAuth

Microsoft.AspNet.Identity

System.IdentityModel.Tokens.Jwt

BouncyCastle

etc.

Business Intelligence (2)

Microsoft.PowerBI.Api

Microsoft.PowerBI.AspNet.Mvc

Reportes/Export (3)

EPPlus (Excel)

iTextSharp (PDF)

DotNetZip (ZIP)

Comunicación (4)

MailKit

MimeKit

Google.Apis.Gmail

SMTP native

Integración Externa (5)

Google.Apis.Drive

Google.Apis.Core

Firebase (frontend)

FrontBack API

Power BI

UI/Frontend (15+)

ExtJS, AngularJS, Polymer

Material Design, Bootstrap

D3.js, GoJS

jQuery, etc.

4. ARQUITECTURA DEL PROYECTO

4.1 Patrón Arquitectónico Principal

Arquitectura Híbrida Multi-Capa con SPA

El proyecto implementa una arquitectura compleja que combina múltiples patrones:

ASP.NET MVC 5 - Para vistas Razor y controladores del lado servidor

Web API 2 RESTful - Para servicios API consumidos por el frontend

Single Page Application (SPA) - ExtJS como aplicación principal

Micro-frontends - Múltiples aplicaciones frontend (ExtJS, AngularJS, Polymer)

N-Layer Architecture - Separación clara de responsabilidades

Service-Oriented Architecture (SOA) - Integración con múltiples servicios

4.2 Diagrama de Arquitectura General

4.3 Componentes Principales

4.3.1 Capa de Presentación

ExtJS SPA (app_segunet) - Aplicación Principal

Propósito: Sistema de gestión integral de seguros SEGUNET

Tecnología: Sencha ExtJS (JavaScript)

Componentes:

1,056 módulos de vistas

1,255 modelos de datos

Framework abstracto personalizado con componentes reutilizables

Controladores MVC del lado cliente

Stores para gestión de datos

Patrón: MVC Client-side

Características:

Grid components personalizados

Formularios dinámicos

Combo boxes genéricos

Gestión de archivos con drag & drop

Windows modales reutilizables

Notificaciones en tiempo real

AngularJS App (app_kc)

Propósito: Portal KC, módulos específicos

Tecnología: AngularJS 1.x + UI-Router

Componentes:

Controllers

Directives personalizadas

Services (factories, providers)

Views con routing dinámico

Integración: Firebase para notificaciones

Polymer Web Components

Propósito: Componentes de UI modernos reutilizables

Tecnología: Polymer 1.4.0

Elementos:

Material Design components (paper-*)

Core elements (iron-*)

Gold elements (validación de tarjetas)

Firebase integration

Storage components

Vistas Razor MVC

Propósito: Páginas del lado servidor, layouts

Tecnología: ASP.NET MVC 5 Razor

Archivos: 129 vistas .cshtml

Módulos:

Home, Account

Helios (Autos, Comercial, IP)

Power BI

CRM, Eventos

Siniestros

Universidad KC

KC Coins

4.3.2 Capa de Controladores

Controladores MVC

HomeController - Página principal

AccountController - Autenticación y registro

PowerBiController - Embeds de Power BI

HeliosController, HeliosAutosController, etc.

IController - Portal de agentes independientes

EventosController, CrmController, SiniestrosController, etc.

Controladores Web API

RESTful services para frontend SPA

Retornan JSON para consumo de ExtJS/Angular

NF Framework Controllers (Núcleo)

Nf_DataController - CRUD genérico

ExecuteForCRUD() - Operaciones CRUD automáticas

GetCombo() - Combos dinámicos

GetSettings() - Configuraciones

Nf_CaseController - Generador de código (CaseTool)

CreateStoresProcedures() - Genera SPs automáticamente

PublishSqlChanges() - Publica cambios a BD

Generación de vistas ExtJS

Generación de modelos

Nf_FileController - Gestión de archivos

Upload de archivos

Download de archivos

Gestión de almacenamiento (E:\Archivos)

Nf_FrontBackController - Integración con FrontBack API

4.3.3 Capa de Lógica de Negocio

NF.ClassLibrary - Framework Personalizado

Namespace: nf.classLibrary

Propósito: Framework core compartido para toda la aplicación

Componentes:

DataBase Helper Class

Gestión de conexiones múltiples

Ejecución de stored procedures

Manejo de transacciones

ResponseResult Pattern

Wrapper estandarizado de respuestas

Manejo de errores consistente

Metadata de respuestas

Extension Methods

.ToResponseResultFromStoreProcedure()

Extensiones para tipos comunes

Helpers de conversión

Mail Service

Envío de correos con templates

Integración con Gmail API

Queue de correos

File Management

Gestión de archivos del sistema

Azure Blob storage integration

CDN integration

Business Services

Lógica de negocio específica del dominio

Validaciones

Cálculos de bonos, comisiones

Procesamiento de pólizas

4.3.4 Capa de Datos

Entity Framework 6.4.4

ORM principal

Code-first approach para algunos módulos

Database-first para bases existentes

Migrations

ADO.NET Direct

Acceso directo para operaciones de alto rendimiento

Ejecución de stored procedures complejos

Bulk operations

Stored Procedures

CRUD operations: p_[Entity]_get, p_[Entity]_insert, p_[Entity]_update, p_[Entity]_delete

Views: v_GridView[Entity]

Lógica de negocio en SQL Server

Generados automáticamente por CaseTool

4.3.5 Bases de Datos (SQL Server)

El sistema integra 10+ bases de datos:

Prometeo - Base de datos principal

PegasusDB - [Módulo específico]

Fortuna - [Módulo específico]

Bonos - Sistema de bonos y comisiones

Autonet - Seguros de autos

iOpenData - [Datos abiertos/integración]

GrupoKCBI - Business Intelligence

Cotizadores - Cotizaciones de seguros

Olympus - [Módulo específico]

10.

FrontBack - Base de datos compartida

Configuración de conexiones:

Ambientes: QA y Producción

Server: sql.prod

Failover y redundancia configurados

4.3.6 Servicios Externos

Power BI

Embeds de reportes en la aplicación

Dashboards interactivos

Integración con workspace

Authentication con Azure AD

Firebase

Notificaciones push

Real-time database

Authentication backup

FrontBack API

Servicios compartidos entre aplicaciones del Grupo KC

API de integración

Sincronización de datos

Azure CDN

Content Delivery Network

Archivos estáticos

Optimización de carga

Gmail API & SMTP

Envío de correos transaccionales

Configuración: prometeo@grupokc.lat

Templates de correo

Google Drive API

Almacenamiento de documentos

Integración de archivos

Report Server

SQL Server Reporting Services

Reportes legacy

Integración con Power BI

4.4 Flujo de Datos (Secuencia de Operación CRUD)

4.5 Flujo de Generación de Código (CaseTool)

5. ASPECTOS MÁS RELEVANTES

5.1 Funcionalidades Principales

Gestión de Pólizas de Seguros (SEGUNET)

Alta, baja, modificación de pólizas

Múltiples ramos: Autos, Vida, Daños, Comercial

Renovaciones automáticas

Cotización y emisión

Sistema de Bonos y Comisiones

Cálculo de bonos para agentes

Liquidación de comisiones

Reportes de resultados por GM y Vida

Integración con API de FrontBack para actualización de periodos

Gestión de Siniestros

Mesa de siniestros con tickets

Workflow de aprobación

Documentación digital

Seguimiento en tiempo real

Portales Multi-Usuario

Helios: Portal para diferentes líneas de negocio (Autos, Comercial, Agentes Independientes)

Portal KC: Aplicación AngularJS para gestión interna

Portal de Agentes Independientes (i/): Acceso limitado para agentes externos

Business Intelligence y Reportes

Power BI embebido en la aplicación

Dashboards interactivos

Reportes personalizables

Archivo Kraken.pbix con métricas estratégicas

CaseTool - Generador de Código

Generación automática de stored procedures (CRUD)

Generación de vistas SQL

Generación de modelos ExtJS

Generación de vistas ExtJS (Grids, Windows, Forms)

Publicación automática a base de datos

Reduce tiempo de desarrollo de días a minutos

Sistema de Gestión de Clientes (CRM)

Seguimiento de leads

Historial de interacciones

Gestión de contactos

Universidad KC

Sistema de capacitación

Cursos y certificaciones

Gestión de contenido educativo

KC Coins

Sistema de recompensas

Gamificación

Canje de puntos

10.

Gestión Documental

Upload de archivos con Fine Uploader

Almacenamiento en filesystem (E:\Archivos)

Integración con Google Drive

Versionado de documentos

5.2 Configuraciones Críticas

Connection Strings (Web.config)

<!-- Base de datos principal -->
<add name="Prometeo_Prod"
     connectionString="Data Source=sql.prod;Initial Catalog=Prometeo;..." />

<!-- Múltiples bases de datos especializadas -->
<add name="PegasusDB_Prod" ... />
<add name="Fortuna_Prod" ... />
<add name="Bonos_Prod" ... />
<add name="Autonet_Prod" ... />
<add name="iOpenData_Prod" ... />
<add name="GrupoKCBI_Prod" ... />
<add name="Cotizadores_Prod" ... />
<add name="FrontBack" ... />
<add name="Olympus_Op_Pr_Prod" ... />

<!-- Cada una tiene versión QA y Producción -->

AppSettings Críticos

<!-- Ambiente de ejecución -->
<add key="RunTimeMode" value="Prod" />  <!-- Prod | Qa -->
<add key="DefaultDataBase" value="Prometeo" />
<add key="Empresa" value="kc" />

<!-- Paths de archivos -->
<add key="PathFiles" value="E:\Archivos" />

<!-- CDN -->
<add key="CDN_Prod" value="https://grupokccdn.azureedge.net" />
<add key="CDN_Qa" value="https://grupokccdnqa.azureedge.net" />

<!-- FrontBack Integration -->
<add key="FrontBack_ServerName" value="[server]" />
<add key="FrontBack_BdName" value="FrontBack" />
<add key="FrontBack_User" value="[user]" />
<add key="FrontBack_Pass" value="[encrypted]" />

<!-- Power BI -->
<add key="powerbi:ApplicationId" value="[guid]" />
<add key="powerbi:WorkspaceId" value="[guid]" />
<add key="powerbi:Username" value="[email]" />
<add key="powerbi:Password" value="[encrypted]" />

<!-- SMTP/Email -->
<add key="Email_Server" value="smtp.gmail.com" />
<add key="Email_Port" value="587" />
<add key="Email_Username" value="prometeo@grupokc.lat" />
<add key="Email_Password" value="[encrypted]" />
<add key="Email_EnableSSL" value="true" />

<!-- Report Server -->
<add key="ReportServer_Url" value="http://[server]/ReportServer" />
<add key="ReportServer_Username" value="[user]" />
<add key="ReportServer_Password" value="[encrypted]" />

<!-- App Identity -->
<add key="NombreApp" value="PROMETEO" />

Configuración de Seguridad

OAuth 2.0 (OWIN)

ASP.NET Identity

Password requirements configurables

Role-based authorization

Claims-based authorization

Cookie authentication con sliding expiration

CORS

Configuración de Logging

Custom error pages habilitadas

Redirect mode: ResponseRewrite

Default redirect: ~/Error

Logs probablemente en Event Log o archivo (verificar en código)

5.3 Patrones de Diseño Implementados

Repository Pattern (Implícito)

Encapsulado en NF.ClassLibrary

Abstracción del acceso a datos

Unit of Work Pattern

Entity Framework DbContext como UoW

Transacciones en stored procedures

Factory Pattern

Creación de componentes ExtJS

Ext.create() para instanciación dinámica

Singleton Pattern

Services en AngularJS

Configuraciones globales

Observer Pattern

Eventos ExtJS (listeners, on)

AngularJS

sco p e .

watch

Template Method Pattern

Controladores base abstractos en ExtJS

app_segunet.abstract.data.Controller

Strategy Pattern

Múltiples providers de autenticación

Diferentes estrategias de acceso a datos

Decorator Pattern

Extension methods en C#

Wrappers de componentes ExtJS

Facade Pattern

NF_DataController como fachada de CRUD

Simplifica operaciones complejas

10.

Builder Pattern

Construcción de queries dinámicas

Generación de código en CaseTool

11.

Dependency Injection

OWIN pipeline

Web API dependency resolver

12.

Response Wrapper Pattern

ResponseResult personalizado

Estandarización de respuestas API

13.

MVC Pattern

ASP.NET MVC (server-side)

ExtJS MVC (client-side)

AngularJS MVC

5.4 Seguridad

Autenticación

OAuth 2.0 Bearer Token

Implementación: Microsoft.Owin.Security.OAuth

Endpoint: /Token

Grant types: Password, Refresh Token

Token expiration: 14 días

Provider personalizado: ApplicationOAuthProvider

ASP.NET Identity 2.2.3

User management

Password hashing (PBKDF2)

Security stamps

Two-factor authentication capability

JWT Tokens

System.IdentityModel.Tokens.Jwt

Token validation

Claims-based identity

Cookie Authentication

Fallback para vistas MVC

Sliding expiration

Secure cookies en producción

Autorización

Role-Based Authorization

Roles configurables en base de datos

[Authorize(Roles = "Admin")]

Claims-Based Authorization

Claims personalizados

Granularidad fina de permisos

Políticas de Acceso

Diferentes niveles de acceso por portal

Portal de agentes independientes con permisos limitados

Protecciones Implementadas

HTTPS Enforcement

AllowInsecureHttp = false en producción

Redirects automáticos a HTTPS

CORS Configurado

Dominios específicos permitidos

Headers controlados

Anti-CSRF Tokens

@Html.AntiForgeryToken() en vistas

Validación en POST requests

SQL Injection Prevention

Uso exclusivo de stored procedures parametrizados

Entity Framework con LINQ

Nunca concatenación de SQL directo

XSS Prevention

Razor encoding automático

ExtJS sanitization

Content Security Policy (CSP) headers recomendados

Password Security

Hashing con PBKDF2

Salt automático

Requisitos de complejidad configurables

Encrypted Configuration

Passwords en web.config protegidos

Connection strings encriptadas en producción

Session Management

Timeout configurado

Sliding expiration

Secure session cookies

Recomendaciones de Seguridad Adicionales

⚠️ Pendientes de verificar:

Implementar Content Security Policy (CSP) headers

Rate limiting en API endpoints

Logging de intentos de acceso fallidos

Audit trail de operaciones críticas

Actualizar a ASP.NET Identity Core (versión moderna)

Implementar OWASP security headers

6. ANÁLISIS DE VERSIONES Y COMPATIBILIDAD

6.1 Framework .NET

Versión actual: .NET Framework 4.8

Fecha de lanzamiento: Abril 2019

Fecha de fin de soporte: 2038 (soporte extendido)

Estado: ✅ Soportado y estable

Ciclo de vida: Framework .NET 4.8 es la última versión de .NET Framework y tendrá soporte mientras exista Windows

Análisis:

✅ Versión moderna y estable de .NET Framework

✅ Soporte a largo plazo garantizado

⚠️ No es la plataforma más reciente (existe .NET 8+)

⚠️ No es cross-platform (solo Windows)

6.2 Compatibilidad C#

Versión del lenguaje: C# 7.3

Versión compatible: Hasta C# 7.3 (limitado por .NET Framework 4.8)

Características modernas utilizadas:

Expresiones throw

Async/await

Pattern matching básico

Tuplas

Local functions

Expression-bodied members

String interpolation

Características NO disponibles (requieren .NET Core/.NET 5+):

Records (C# 9)

Init-only properties (C# 9)

Top-level statements (C# 9)

Global usings (C# 10)

File-scoped namespaces (C# 10)

Required members (C# 11)

6.3 Versiones de Dependencias Principales

Componente	Versión Actual	Última Disponible	Estado
.NET Framework	4.8	4.8	✅ Actualizado
C#	7.3	12.0 (.NET 8)	⚠️ Limitado por framework
ASP.NET MVC	5.2.7	5.2.9	⚠️ Actualización menor disponible
Entity Framework	6.4.4	6.5.1	⚠️ Actualización menor disponible
Newtonsoft.Json	12.0.3	13.0.3	⚠️ Actualización disponible
jQuery	3.x	3.7.1	⚠️ Verificar versión exacta
Bootstrap	4.x	5.3.x	⚠️ Upgrade mayor disponible
ExtJS	N/D	7.x	⚠️ Verificar versión y licencia
AngularJS	1.x	1.8.3 (EOL)	❌ Framework obsoleto
Polymer	1.4.0	3.5.1	❌ Versión muy antigua

6.4 Estado de Frameworks Frontend

Framework	Versión Proyecto	Estado	Soporte
ExtJS	N/D	✅ Activo	Comercial (Sencha)
AngularJS	1.x	❌ EOL	Terminó Dic 2021
Polymer	1.4.0	⚠️ Legacy	Migrado a Lit
Material Design Lite	1.1.3	❌ EOL	Descontinuado

Análisis crítico:

🔴 AngularJS 1.x: Oficialmente EOL desde enero 2022, sin actualizaciones de seguridad

🟡 Polymer 1.4.0: Versión muy antigua, el proyecto migró a Lit

🟡 Material Design Lite: Proyecto descontinuado, usar Material Components Web

7. RECOMENDACIONES DE ACTUALIZACIÓN

7.1 Prioridad Alta 🔴 (Seguridad / EOL)

Librería/Componente	Versión Actual	Versión Recomendada	Motivo	Esfuerzo
AngularJS	1.x	Migrar a Angular 17+ o React	Framework EOL, sin soporte de seguridad	Alto
Polymer	1.4.0	Migrar a Lit 3.x o Web Components nativos	Versión obsoleta, migrado a Lit	Alto
Material Design Lite	1.1.3	Material Components Web o Material UI	Proyecto descontinuado	Medio
ASP.NET Identity	2.2.3	Migrar a ASP.NET Core Identity	Versión antigua, considerar modernización	Alto
BouncyCastle	1.8.9	2.x	Actualizaciones de seguridad	Bajo

Justificación:

AngularJS sin soporte desde 2022 = riesgo de seguridad

Polymer 1.x no recibe actualizaciones ni parches

Material Design Lite descontinuado oficialmente

7.2 Prioridad Media 🟡 (Mejoras y Features)

Librería	Versión Actual	Versión Recomendada	Beneficio	Esfuerzo
Entity Framework	6.4.4	6.5.1	Bug fixes y mejoras de rendimiento	Bajo
Newtonsoft.Json	12.0.3	13.0.3	Mejoras de rendimiento	Bajo
ASP.NET MVC	5.2.7	5.2.9	Bug fixes	Bajo
Bootstrap	4.x	5.3.x	Nuevos componentes, mejor rendimiento	Medio
jQuery	3.x	3.7.1	Seguridad y compatibilidad	Bajo
Microsoft.PowerBI.Api	2.9.0	4.x	Nuevas features de Power BI	Medio
EPPlus	5.8.2	7.x	Nuevas funcionalidades de Excel	Bajo

Beneficios:

Mejoras incrementales de rendimiento

Corrección de bugs conocidos

Nuevas características no críticas

7.3 Prioridad Baja 🟢 (Optimización)

Componente	Acción Recomendada	Beneficio	Esfuerzo
ExtJS	Revisar licencia y actualizar a versión más reciente	Soporte y features modernos	Medio
Google APIs	Actualizar a versiones más recientes	Nuevas funcionalidades	Bajo
MailKit	Mantener actualizado	Soporte SMTP moderno	Bajo
iTextSharp	Considerar migrar a iText 7+ o alternativa	Licencia y features	Alto

7.4 Modernización del Framework .NET

Opción 1: Mantener .NET Framework 4.8 (Conservador)

✅ Menor riesgo

✅ Menor esfuerzo

❌ No cross-platform

❌ Sin nuevas features de C#

❌ Limitaciones de rendimiento

Opción 2: Migrar a .NET 8 (LTS) (Recomendado a mediano plazo)

✅ Cross-platform (Windows, Linux, Docker)

✅ Mejor rendimiento (hasta 10x en algunas operaciones)

✅ C# 12 con features modernas

✅ Soporte hasta noviembre 2026 (LTS)

✅ Mejor integración con servicios cloud

❌ Esfuerzo alto de migración

❌ Requiere refactorización de código

❌ System.Web no existe (cambios en HTTP pipeline)

Ruta de Migración Sugerida:

Plan Alternativo (Híbrido):

Mantener .NET Framework 4.8 para el core

Crear nuevos módulos en .NET 8 como microservicios

Migración gradual módulo por módulo

Comunicación vía API entre sistemas

7.5 Recomendaciones de Frontend

Estrategia recomendada:

Consolidar en ExtJS (Corto plazo)

Mantener ExtJS como framework principal

Migrar módulos AngularJS a ExtJS

Actualizar ExtJS a versión más reciente

Esfuerzo: Medio

Beneficio: Consistencia, menor complejidad

Modernizar a React/Vue (Mediano plazo)

Migración gradual a framework moderno

Mejor ecosistema y comunidad

Mejor rendimiento

Esfuerzo: Alto

Beneficio: Tecnología moderna, mejor DX

Mantener Web Components nativos

Migrar Polymer a Lit o Web Components nativos

Standard web sin dependencias

Esfuerzo: Bajo-Medio

Beneficio: Futuro-proof

8. MÉTRICAS DEL PROYECTO

8.1 Distribución por Tipo de Archivo

8.2 Líneas de Código Estimadas

Tipo	Archivos	Líneas Estimadas
JavaScript (ExtJS + Angular)	6,378	~500,000
C# (Backend)	79	~25,000
Razor Views	129	~10,000
SQL	50+	~15,000
CSS/Styling	~100	~20,000
Total aproximado	6,736+	~570,000

8.3 Complejidad del Proyecto

Métrica	Valor
Módulos ExtJS	1,056
Modelos ExtJS	1,255
Controladores .NET	~30
Bases de Datos	10+
Servicios Externos	7+
Frameworks Frontend	3 (ExtJS, Angular, Polymer)
Líneas .csproj	11,215

8.4 Cobertura de Dependencias

8.5 Deuda Técnica Estimada

Score de Deuda Técnica: 7/10 (Alta)

Factores:

🔴 Múltiples frameworks frontend (3)

🔴 AngularJS en EOL

🔴 Polymer muy desactualizado

🟡 .NET Framework (no .NET Core)

🟡 Algunas librerías desactualizadas

🟢 Arquitectura backend bien estructurada

🟢 Base de datos organizada

9. DEUDA TÉCNICA IDENTIFICADA

9.1 Issues Críticos 🔴

[CRÍTICO] AngularJS 1.x en End-of-Life

Impacto: Alto - Riesgo de seguridad

Afectación: Módulo app_kc

Solución: Migrar a Angular moderno, React, o consolidar en ExtJS

Esfuerzo: Alto (3-4 meses)

Prioridad: Urgente

[CRÍTICO] Polymer 1.4.0 obsoleto

Impacto: Medio-Alto - Sin actualizaciones

Afectación: Web Components en bower_components

Solución: Migrar a Lit 3.x o Web Components nativos

Esfuerzo: Medio (2-3 meses)

Prioridad: Alta

[CRÍTICO] Material Design Lite descontinuado

Impacto: Medio - Sin soporte

Afectación: Componentes UI

Solución: Migrar a Material Components Web o framework moderno

Esfuerzo: Medio (1-2 meses)

Prioridad: Media-Alta

[ALTO] Múltiples frameworks frontend

Impacto: Alto - Complejidad de mantenimiento

Afectación: Toda la aplicación

Solución: Consolidar en un solo framework (ExtJS o migrar a React/Vue)

Esfuerzo: Muy Alto (6-12 meses)

Prioridad: Media

[ALTO] Falta de pruebas automatizadas

Impacto: Alto - Riesgo de regresiones

Afectación: Todo el proyecto

Solución: Implementar testing: Unit, Integration, E2E

Esfuerzo: Alto (continuo)

Prioridad: Alta

9.2 Issues Importantes 🟡

Actualizar librerías NuGet desactualizadas

Entity Framework 6.4.4 → 6.5.1

Newtonsoft.Json 12.0.3 → 13.0.3

ASP.NET MVC 5.2.7 → 5.2.9

Esfuerzo: Bajo (1 semana)

Revisar y actualizar ExtJS

Verificar versión actual

Actualizar a última versión estable

Revisar licencia

Esfuerzo: Medio (2-3 semanas)

Implementar logging estructurado

Implementar Serilog o NLog

Centralizar logs (ELK stack, Application Insights)

Esfuerzo: Medio (2-3 semanas)

Mejorar seguridad de configuración

Mover secrets a Azure Key Vault o similar

Implementar configuración por ambiente

Esfuerzo: Bajo-Medio (1-2 semanas)

Implementar CI/CD

Azure DevOps pipelines

Automated testing

Deployment automation

Esfuerzo: Medio (1 mes)

9.3 Mejoras Recomendadas 🟢

Migrar a .NET 8 LTS (Proyecto a largo plazo)

Cross-platform

Mejor rendimiento

C# moderno

Esfuerzo: Muy Alto (6-12 meses)

Implementar API Gateway

Centralizar acceso a APIs

Rate limiting, caching

Esfuerzo: Medio (1-2 meses)

Containerización con Docker

Facilitar deployment

Consistencia de ambientes

Esfuerzo: Medio (1-2 meses)

Implementar cache distribuido

Redis para sesiones y cache

Mejorar rendimiento

Esfuerzo: Medio (2-3 semanas)

Refactorizar a Clean Architecture

Separar concerns claramente

Mejor testabilidad

Esfuerzo: Alto (3-6 meses)

Implementar Event Sourcing para auditoría

Trazabilidad completa

Historial de cambios

Esfuerzo: Alto (2-3 meses)

Modernizar UI/UX

Design system consistente

Responsive design mejorado

Accesibilidad (WCAG 2.1)

Esfuerzo: Alto (3-6 meses)

Documentación API con Swagger/OpenAPI

Ya existe HelpPage, mejorar con Swagger

Documentación interactiva

Esfuerzo: Bajo (1 semana)

Implementar monitoreo y APM

Application Performance Monitoring

Application Insights o similar

Esfuerzo: Bajo-Medio (2 semanas)

Code Quality Tools

SonarQube para análisis estático

Code coverage reports

Esfuerzo: Bajo (1-2 semanas)

9.4 Priorización de Issues

10. GLOSARIO TÉCNICO

Términos del Dominio

Término	Descripción
SEGUNET	Sistema principal de gestión de seguros basado en ExtJS. Núcleo de la aplicación.
Helios	Portal multi-propósito para diferentes líneas de negocio (Autos, Comercial, Agentes Independientes).
Kraken	Sistema de objetivos estratégicos y KPIs del Grupo KC. Incluye Power BI.
CaseTool	Herramienta de generación automática de código (CRUD, vistas, modelos, stored procedures).
FrontBack	API de integración compartida entre aplicaciones del Grupo KC.
Bonos/Comisiones	Sistema de cálculo y liquidación de bonos para agentes de seguros.
Portal i/	Portal de agentes independientes con acceso limitado.
Universidad KC	Sistema de capacitación y certificación interna.
KC Coins	Sistema de recompensas y gamificación.
Mesa de Siniestros	Módulo de gestión de reclamaciones y siniestros con sistema de tickets.
DM (Data Mart)	Tablas de datos procesados para reportes (ej: DM_Bonos_Resultados).
GM	Gerente de Mercadotecnia o Gastos Médicos (contexto dependiente).

Términos Técnicos del Proyecto

Término	Descripción
NF Framework	Framework personalizado (NF.ClassLibrary) que provee funcionalidad core: CRUD genérico, acceso a datos, helpers.
Nf_DataController	Controlador Web API que expone operaciones CRUD genéricas (`ExecuteForCRUD`).
Nf_CaseController	Controlador que maneja la generación automática de código del CaseTool.
ResponseResult	Patrón de respuesta estandarizado usado en todas las APIs. Incluye success, data, message.
GridView	Vista ExtJS de tipo Grid para mostrar datos tabulares con paginación, filtros, sorting.
WindowDetalle	Ventana modal de ExtJS para CRUD de registros individuales (formulario).
Store	En ExtJS, contenedor de datos que se comunica con el servidor vía proxy.
Model	En ExtJS, definición de estructura de datos (fields, validations, associations).
Abstract Components	Componentes base reutilizables de ExtJS en `app_segunet/abstract/`.
p_[Entity]_[operation]	Convención de nombres para stored procedures (ej: `p_Bonos_get`, `p_Bonos_insert`).
v_GridView[Entity]	Convención de nombres para vistas SQL que alimentan grids (ej: `v_GridViewBonos`).
RunTimeMode	Configuración que define ambiente de ejecución: Prod o Qa.
DefaultDataBase	Setting que indica qué connection string usar por defecto.
CDN_Prod / CDN_Qa	Azure CDN para servir assets estáticos según ambiente.

Acrónimos y Abreviaciones

Acrónimo	Significado
KC	Grupo KC (empresa de seguros)
SP	Stored Procedure
EF	Entity Framework
MVC	Model-View-Controller
SPA	Single Page Application
CRUD	Create, Read, Update, Delete
API	Application Programming Interface
BI	Business Intelligence
CRM	Customer Relationship Management
OWIN	Open Web Interface for .NET
CORS	Cross-Origin Resource Sharing
JWT	JSON Web Token
CDN	Content Delivery Network
EOL	End of Life
LTS	Long Term Support
QA	Quality Assurance (ambiente de pruebas)
Prod	Production (ambiente productivo)
NF	Nombre del framework personalizado (significado original desconocido)

11. MÓDULOS PRINCIPALES DEL SISTEMA

11.1 Módulos por Funcionalidad

Módulo	Descripción	Tecnología Principal
SEGUNET	Sistema core de gestión de pólizas	ExtJS
Bonos	Cálculo y liquidación de comisiones	ExtJS + SQL Server
Siniestros	Mesa de gestión de reclamaciones	ExtJS + Tickets
Helios	Portal multi-propósito	ASP.NET MVC + ExtJS
Helios Autos	Portal específico para seguros de autos	ASP.NET MVC
Helios Comercial	Portal para seguros comerciales	ASP.NET MVC
Helios IP	Portal agentes independientes	ASP.NET MVC
CRM	Gestión de clientes y leads	ExtJS
Universidad KC	Capacitación interna	ASP.NET MVC
KC Coins	Sistema de recompensas	ASP.NET MVC + AngularJS
Power BI	Reportes y dashboards embebidos	Power BI Embedded
CaseTool	Generador de código	ASP.NET MVC + Razor
Eventos	Gestión de eventos corporativos	ASP.NET MVC
Inteligencia de Negocio	Análisis y reportes	Power BI + SQL Server
DxN	[Diagnóstico/Módulo específico]	ExtJS

11.2 Bases de Datos por Módulo

Base de Datos	Módulos Asociados	Propósito
Prometeo	SEGUNET, Core	Base de datos principal
Bonos	Bonos, Liquidaciones	Comisiones y bonos
Autonet	Helios Autos	Seguros de autos
GrupoKCBI	Inteligencia de Negocio, Power BI	Business Intelligence
Cotizadores	Helios, SEGUNET	Cotizaciones de seguros
Fortuna	[Módulo específico]	[Datos específicos]
PegasusDB	[Módulo específico]	[Datos específicos]
iOpenData	Integración	Datos abiertos/APIs
FrontBack	Integración	Servicios compartidos
Olympus	[Operaciones]	[Datos operacionales]

12. NOTAS ADICIONALES

12.1 Fortalezas del Proyecto

✅ CaseTool - Generador de Código

Innovación interna que acelera desarrollo significativamente

Genera CRUD completo en minutos

Reduce código boilerplate y errores humanos

✅ Arquitectura de Datos Sólida

Stored procedures bien organizados

Convenciones claras de nomenclatura

Separación por responsabilidades en múltiples DBs

✅ Framework NF Personalizado

Abstracción reutilizable

Patrones consistentes

Facilita mantenimiento

✅ Integración Completa

Power BI embebido

Múltiples servicios externos

APIs bien estructuradas

✅ Modularidad

Módulos bien separados

Componentes reutilizables en ExtJS

Portales independientes

12.2 Desafíos Identificados

⚠️ Complejidad del Stack Tecnológico

3 frameworks frontend diferentes

Curva de aprendizamiento alta para nuevos desarrolladores

Mantenimiento costoso

⚠️ Dependencia de Tecnologías Legacy

AngularJS en EOL

Polymer obsoleto

.NET Framework (no cross-platform)

⚠️ Posible Falta de Testing

No se observan carpetas de tests

Riesgo de regresiones

Dificulta refactorización

⚠️ Documentación

Falta documentación técnica detallada

Dependencia del conocimiento tribal

Onboarding complejo

12.3 Ventajas Competitivas

🎯 CaseTool

Herramienta propia de generación de código

Reduce time-to-market dramáticamente

Podría comercializarse como producto

🎯 Integración Vertical

Sistema completo end-to-end

No dependencia de software externo core

Control total del stack

🎯 Multi-Portal

Diferentes interfaces para diferentes usuarios

Personalización por rol

Mejor UX por segmento

12.4 Riesgos Técnicos

🔴 Riesgo de Seguridad

AngularJS sin parches de seguridad

Dependencias desactualizadas

Recomendación: Auditoría de seguridad

🟡 Riesgo de Mantenibilidad

Complejidad alta

Múltiples tecnologías

Recomendación: Consolidación gradual

🟡 Riesgo de Escalabilidad

.NET Framework monolítico

Posibles cuellos de botella

Recomendación: Evaluar microservicios

12.5 Próximos Pasos Recomendados

Inmediato (1-3 meses):

✅ Auditoría de seguridad completa

✅ Actualizar NuGet packages críticos

✅ Implementar logging centralizado

✅ Establecer CI/CD pipeline

Corto Plazo (3-6 meses):

🔄 Migrar AngularJS a ExtJS o framework moderno

🔄 Actualizar Polymer a Lit

🔄 Implementar testing automatizado

🔄 Revisar y actualizar ExtJS

Mediano Plazo (6-12 meses):

🔮 Evaluar migración a .NET 8

🔮 Consolidar stack frontend

🔮 Implementar monitoreo APM

🔮 Refactorización arquitectónica gradual

Largo Plazo (1-2 años):

🎯 Migración completa a .NET 8+

🎯 Arquitectura de microservicios

🎯 Containerización con Docker/Kubernetes

🎯 Cloud-native (Azure)

12.6 Estimación de Costo de Migración

Escenario	Esfuerzo	Costo Estimado	Timeline
Actualización Conservadora	6 persona-mes	Bajo-Medio	6 meses
Modernización Frontend	12 persona-mes	Medio	12 meses
Migración .NET 8 Completa	24-36 persona-mes	Alto	18-24 meses
Refactoring Total + Cloud	48+ persona-mes	Muy Alto	24-36 meses

12.7 Recomendación Final

Estrategia Híbrida Gradual:

Fase de Estabilización (0-6 meses)

Resolver issues críticos de seguridad

Actualizar dependencias

Implementar CI/CD y testing

Fase de Consolidación (6-12 meses)

Migrar AngularJS a ExtJS

Actualizar frontend components

Mejorar observabilidad

Fase de Modernización (12-24 meses)

Evaluar y planear migración .NET 8

Refactoring arquitectónico

Implementar nuevos módulos en stack moderno

Fase de Transformación (24+ meses)

Migración completa a .NET moderno

Cloud-native architecture

Microservicios cuando tenga sentido

Esta estrategia permite:

✅ Mantener el sistema operativo

✅ Reducir deuda técnica progresivamente

✅ Modernizar sin big-bang rewrite

✅ ROI continuo

✅ Menor riesgo

ANEXOS

Anexo A: Estructura de Archivos ExtJS Generados por CaseTool

Convención de archivos generados:

app_segunet/
├── models/
│   └── [Entity].js                              # Modelo ExtJS
├── views/
│   └── [entity_snake_case]/
│       ├── GridView[Entity]_[timestamp].js      # Grid principal
│       └── WindowDetalle.js                     # Ventana de edición
└── store/
    └── Store[Entity].js                         # Store de datos

Ejemplo:

app_segunet/
├── models/
│   └── Liquidacion_Agente_Bonos.js
└── views/
    └── liquidacion_agente_bonos/
        ├── GridViewLiquidacion_Agente_Bonos_638980525698235151.js
        └── WindowDetalle.js

Anexo B: Convención de Stored Procedures

Patrón estándar:

Anexo C: Connection Strings por Ambiente

Producción:

Server: sql.prod

Databases: Prometeo, Bonos, Autonet, etc.

QA:

Server: (Probablemente el mismo con DBs separadas)

Databases: Prometeo_Qa, Bonos_Qa, etc.

Configuración:

Controlado por RunTimeMode AppSetting

Sufijos _Prod y _Qa en connection string names

Anexo D: URLs del Sistema

Producción:

CDN: https://grupokccdn.azureedge.net

Email: prometeo@grupokc.lat

QA:

CDN: https://grupokccdnqa.azureedge.net

Documentación generada: 2025-12-13
Analizado por: Claude Code (Sonnet 4.5)
Versión del documento: 1.0
Proyecto: PROMETEO - Grupo KC
Framework: .NET Framework 4.8
Estado: Producción

INFORMACIÓN DE CONTACTO Y SOPORTE

Para consultas sobre esta documentación o el proyecto Prometeo:

Repositorio: Git local (E:\Prod\Prometeo)

Solución: Prometeo.sln

Rama principal: master

Este documento fue generado automáticamente mediante análisis del código fuente y configuraciones del proyecto. Se recomienda validar la información con el equipo de desarrollo y actualizar periódicamente.

Prometeo

DOCUMENTACIÓN ARQUITECTURA - PROYECTO PROMETEO#

1. INFORMACIÓN GENERAL DEL PROYECTO#

2. MAPA DE SITIO / ESTRUCTURA DEL PROYECTO#

2.1 Estructura de la Solución#

2.2 Estructura del Proyecto Web (Principal)#

2.3 Proyectos dentro de la Solución#

2.4 Organización de Namespaces#

2.5 Relaciones entre Proyectos/Módulos#

3. INVENTARIO DE LIBRERÍAS Y DEPENDENCIAS#

3.1 NuGet Packages#

3.2 Frontend Dependencies (Bower)#

3.3 JavaScript Libraries (Otros)#

3.4 Categorización de Dependencias#

ORM/Data Access (2)#

Framework Core (12)#

Seguridad (9)#

Business Intelligence (2)#

Reportes/Export (3)#

Comunicación (4)#

Integración Externa (5)#

UI/Frontend (15+)#

4. ARQUITECTURA DEL PROYECTO#

4.1 Patrón Arquitectónico Principal#

4.2 Diagrama de Arquitectura General#

4.3 Componentes Principales#

4.3.1 Capa de Presentación#

4.3.2 Capa de Controladores#

4.3.3 Capa de Lógica de Negocio#

4.3.4 Capa de Datos#

4.3.5 Bases de Datos (SQL Server)#

4.3.6 Servicios Externos#

4.4 Flujo de Datos (Secuencia de Operación CRUD)#

4.5 Flujo de Generación de Código (CaseTool)#

5. ASPECTOS MÁS RELEVANTES#

5.1 Funcionalidades Principales#

5.2 Configuraciones Críticas#

Connection Strings (Web.config)#

AppSettings Críticos#

Configuración de Seguridad#

Configuración de Logging#

5.3 Patrones de Diseño Implementados#

5.4 Seguridad#

Autenticación#

Autorización#

Protecciones Implementadas#

Recomendaciones de Seguridad Adicionales#

6. ANÁLISIS DE VERSIONES Y COMPATIBILIDAD#

6.1 Framework .NET#

6.2 Compatibilidad C##

6.3 Versiones de Dependencias Principales#

6.4 Estado de Frameworks Frontend#

7. RECOMENDACIONES DE ACTUALIZACIÓN#

7.1 Prioridad Alta 🔴 (Seguridad / EOL)#

7.2 Prioridad Media 🟡 (Mejoras y Features)#

7.3 Prioridad Baja 🟢 (Optimización)#

7.4 Modernización del Framework .NET#

7.5 Recomendaciones de Frontend#

8. MÉTRICAS DEL PROYECTO#

8.1 Distribución por Tipo de Archivo#

8.2 Líneas de Código Estimadas#

8.3 Complejidad del Proyecto#

8.4 Cobertura de Dependencias#

8.5 Deuda Técnica Estimada#

9. DEUDA TÉCNICA IDENTIFICADA#

9.1 Issues Críticos 🔴#

9.2 Issues Importantes 🟡#

9.3 Mejoras Recomendadas 🟢#

9.4 Priorización de Issues#

10. GLOSARIO TÉCNICO#

Términos del Dominio#

Términos Técnicos del Proyecto#

Acrónimos y Abreviaciones#

11. MÓDULOS PRINCIPALES DEL SISTEMA#

11.1 Módulos por Funcionalidad#

11.2 Bases de Datos por Módulo#

12. NOTAS ADICIONALES#

12.1 Fortalezas del Proyecto#

12.2 Desafíos Identificados#

12.3 Ventajas Competitivas#

DOCUMENTACIÓN ARQUITECTURA - PROYECTO PROMETEO

1. INFORMACIÓN GENERAL DEL PROYECTO

2. MAPA DE SITIO / ESTRUCTURA DEL PROYECTO

2.1 Estructura de la Solución

2.2 Estructura del Proyecto Web (Principal)

2.3 Proyectos dentro de la Solución

2.4 Organización de Namespaces

2.5 Relaciones entre Proyectos/Módulos

3. INVENTARIO DE LIBRERÍAS Y DEPENDENCIAS

3.1 NuGet Packages

3.2 Frontend Dependencies (Bower)

3.3 JavaScript Libraries (Otros)

3.4 Categorización de Dependencias

ORM/Data Access (2)

Framework Core (12)

Seguridad (9)

Business Intelligence (2)

Reportes/Export (3)

Comunicación (4)

Integración Externa (5)

UI/Frontend (15+)

4. ARQUITECTURA DEL PROYECTO

4.1 Patrón Arquitectónico Principal

4.2 Diagrama de Arquitectura General

4.3 Componentes Principales

4.3.1 Capa de Presentación

4.3.2 Capa de Controladores

4.3.3 Capa de Lógica de Negocio

4.3.4 Capa de Datos

4.3.5 Bases de Datos (SQL Server)

4.3.6 Servicios Externos

4.4 Flujo de Datos (Secuencia de Operación CRUD)

4.5 Flujo de Generación de Código (CaseTool)

5. ASPECTOS MÁS RELEVANTES

5.1 Funcionalidades Principales

5.2 Configuraciones Críticas

Connection Strings (Web.config)

AppSettings Críticos

Configuración de Seguridad

Configuración de Logging

5.3 Patrones de Diseño Implementados

5.4 Seguridad

Autenticación

Autorización

Protecciones Implementadas

Recomendaciones de Seguridad Adicionales

6. ANÁLISIS DE VERSIONES Y COMPATIBILIDAD

6.1 Framework .NET

6.2 Compatibilidad C#

6.3 Versiones de Dependencias Principales

6.4 Estado de Frameworks Frontend

7. RECOMENDACIONES DE ACTUALIZACIÓN

7.1 Prioridad Alta 🔴 (Seguridad / EOL)

7.2 Prioridad Media 🟡 (Mejoras y Features)

7.3 Prioridad Baja 🟢 (Optimización)

7.4 Modernización del Framework .NET

7.5 Recomendaciones de Frontend

8. MÉTRICAS DEL PROYECTO

8.1 Distribución por Tipo de Archivo

8.2 Líneas de Código Estimadas

8.3 Complejidad del Proyecto

8.4 Cobertura de Dependencias

8.5 Deuda Técnica Estimada

9. DEUDA TÉCNICA IDENTIFICADA

9.1 Issues Críticos 🔴

9.2 Issues Importantes 🟡

9.3 Mejoras Recomendadas 🟢

9.4 Priorización de Issues

10. GLOSARIO TÉCNICO

Términos del Dominio

Términos Técnicos del Proyecto

Acrónimos y Abreviaciones

11. MÓDULOS PRINCIPALES DEL SISTEMA

11.1 Módulos por Funcionalidad

11.2 Bases de Datos por Módulo

12. NOTAS ADICIONALES

12.1 Fortalezas del Proyecto

12.2 Desafíos Identificados

12.3 Ventajas Competitivas

12.4 Riesgos Técnicos