Skip to content

Repository files navigation

🛡️ DX License Manager — NOC Pro Edition

Laravel 11
Portal Empresarial de Gestión de Licencias & Auditoría IA
Filosofía Impeccable — Minimalismo funcional de alta densidad para entornos de red.

Version Laravel AI Gemini Engine CSS Modular architecture


📖 Visión General

DX License Manager es un Centro de Operaciones de Red (NOC) de nivel empresarial diseñado para la gestión técnica, auditoría y control de licencias industriales Siemens PLM y Moldex3D.

A través de una interfaz industrial de alta densidad visual y un motor de inteligencia artificial robusto, el portal unifica la gobernanza de activos, predice ciclos de renovación, automatiza auditorías complejas y monitoriza la infraestructura crítica en tiempo real.


🏛️ Pilares Tecnológicos & Arquitectura

La plataforma está construida sobre una arquitectura modular de alta disponibilidad, priorizando la resiliencia operativa y la eficiencia en el procesamiento de datos:

  • Núcleo de Orquestación (Backend): Desarrollado en Laravel 11.x (sobre PHP 8.4). El framework opera con patrones de diseño defensivos, inyección de dependencias estricta y Eloquent ORM altamente optimizado mediante Eager Loading y Query Caching.
  • Motor de Inteligencia Artificial & NLU: Pipeline cognitivo híbrido con Cortocircuito Heurístico (para evasión de gasto innecesario de tokens). Integra Google Gemini de forma nativa para análisis conversacional, composite matching y normalización en tiempo real; y despliega n8n Workflow Engine como orquestador asíncrono impulsando modelos alternativos (DeepSeek R1 / OpenRouter) para las auditorías masivas de FlexLM, asegurando alta disponibilidad.
  • Blindaje y Zero-Trust Security: Arquitectura basada en el principio de mínimo privilegio mediante un sistema RBAC granular. Incorpora mitigación nativa CSRF/XSS, inyección de cabeceras de seguridad estrictas (CSP Nivel 3, HSTS) y verificación criptográfica HMAC asimétrica para la validación de webhooks externos.
  • Micro-Frontend Reactivo: Despliegue de vistas SSR (Server-Side Rendering) a través de Blade, enriquecidas dinámicamente con Alpine.js. Esto elimina la sobrecarga de Virtual DOMs (React/Vue), garantizando una huella de memoria nula en el cliente y latencia ultra-baja (incluyendo sistemas de Onboarding contextual on-the-fly mediante Driver.js).
  • State Management & Colas Distribuidas: Clúster Redis actuando como capa de caché de alta velocidad y Broker de Mensajería. Gestiona colas de trabajos asíncronos para la telemetría, y mantiene un sistema de listas negras (ZSET) para invalidación criptográfica instantánea de tokens JWT revocados.
  • Capa de Persistencia: Base de datos MariaDB con modelado estrictamente normalizado e índices optimizados, diseñada para la trazabilidad inmutable de Machine IDs, Sold-Tos y mapeo de identidades de clientes corporativos.

🎨 Sistema de Diseño & Arquitectura CSS (DX-V2)

El portal implementa una arquitectura CSS modular de 6 capas centralizada en resources/css/ y compilada en dx-v2-main.css. Cuenta con un tema oscuro industrial premium basado en colores HSL adaptativos, transiciones aceleradas por hardware y glassmorphism.

Capa 1: Tokens & Base    ───► dx-v2-tokens.css · dx-v2-reset.css · dx-v2-base.css (Variables HSL, Keyframes)
Capa 2: Layout           ───► Estructural (dx-v2-nav.css · dx-v2-sidebar.css · dx-v2-breadcrumb.css · footer.css)
Capa 3: Atoms UI         ───► Componentes compartidos (cards.css · tables.css · badges.css · modals.css · toast.css)
Capa 4: App Modules      ───► Estilos de vistas (login.css · dashboard.css · clients.css · users.css · logs.css)
Capa 5: Technical Tools  ───► Herramientas de vendors (tools-hub.css · nx.css · star.css · heeds.css · moldex.css)
Capa 6: Special Pages    ───► Vistas independientes (page-herramientas.css · admin.css · page-maintenance.css)

🚀 Módulos Funcionales

1. AI License Auditor

Auditoría y extracción automatizada de metadatos en archivos de licencia FlexLM (.lic) y Moldex (.mac).

  • Normalización Estricta: Detección de Hostnames, COMPOSITE, Machine IDs, deamons (ugslmd, cdlmd, RCTECH, saltd) e incrementos de asientos.
  • Cortocircuito Temporal: Ahorro proactivo de tokens bloqueando la llamada a la IA en licencias temporales de 7 días (aquellas con ANY o YourHostname).
  • Gobernanza de Privacidad: Los archivos .lic subidos por los clientes nunca se guardan físicamente en el servidor (file_path = NULL en base de datos). Solo se persisten los metadatos de auditoría estructurados.

2. Generador de Certificados de Cese (COD)

Asistente avanzado para el cese y migración de servidores de licencias de clientes.

  • Composite Analyzer (AI): Drag & Drop del fichero Composite.txt analizado en vivo mediante Gemini. Identifica interfaces físicas (Ethernet) descartando adaptadores virtuales y VPNs de forma automática.
  • Preview & PDF Engine: Generación fluida con previsualización HTML interactiva y motor de compilación PDF hermético con fuentes autohospedadas.

3. Planificador de Renovaciones & Clientes

Ecosistema administrativo que sincroniza las licencias instaladas reales (Inventario) con los contratos contractuales activos (CSV).

  • Gestor Multi-Site: Identificación consolidada de clientes con múltiples Sold-Tos e instalaciones distribuidas con estética industrial limpia ("Gold Thread watermark").
  • Traffic-Light Alerts: Indicadores semánticos en tiempo real sobre la salud y caducidad de los contratos.

4. System NOC Dashboard & Fleet Monitor

Centro de telemetría e infraestructura para administradores de sistemas y monitorización de consumos.

  • Docker Fleet Monitor: Monitorización en vivo de CPU (Gauges circulares), memoria RAM e interactores de reinicio de la red de contenedores Beta y Prod.
  • AI Hub & Token Economics: Panel financiero que desglosa en tiempo real los tokens consumidos (Gemini/OpenRouter), calculando costes dinámicos por petición y asegurando cuotas máximas.
  • Centro de Logs Unificado: Visor y parser regex estructurado para laravel.log y auditoría de Webhooks bidireccionales de Telegram y n8n.

🛠️ Estructura de Directorios

├── .agent/               # Memoria persistente, instrucciones y workflows del AI Agent
│   ├── memory/           # Logs e historiales (ACTIVE_CONTEXT.md)
│   └── workflows/        # Protocolos operativos (sync, end-session)
├── backend/              # Núcleo del portal (Laravel 11 App)
│   ├── app/              # Controladores, Modelos, Middleware, Servicios de IA
│   ├── config/           # Configuraciones (auth, base de datos, gemini)
│   ├── docs/             # Registro oficial de Auditorías de Seguridad Continuas (OWASP)
│   ├── public/           # Ficheros públicos y hojas modulares compiladas de CSS
│   ├── resources/        # Vistas Blade, traducciones y componentes Alpine.js
│   └── routes/           # Enrutamiento del portal (web, api)
├── infra/                # Archivos de infraestructura (docker-compose, Nginx configs)
├── management/           # Gobernanza de desarrollo (ROADMAP, BACKLOG, CHANGELOG, ERRORS)
└── scripts/              # Herramientas de copias de seguridad de DB MariaDB y automatizaciones

📦 Despliegue Rápido (Beta / Prod)

El portal está completamente empaquetado mediante Docker para asegurar la paridad estricta entre entornos (Beta y Producción están totalmente desacoplados a nivel de red y volúmenes).

Configuración Inicial

  1. Clonar el repositorio y acceder a la carpeta del proyecto.
  2. Sincronizar las variables de entorno:
    cp infra/.env.beta.example infra/.env.beta
    cp backend/.env.example backend/.env

Despliegue del Stack Docker

# Levantar el entorno Beta
docker compose --project-directory . -f infra/docker-compose.beta.yml up -d

# Levantar el entorno de Producción
docker compose --project-directory . -f infra/docker-compose.prod.yml up -d

# Acciones recomendadas tras deploy o actualización
docker exec -it dx-php-beta php artisan optimize:clear
docker exec -it dx-php-beta php artisan migrate --force

🛡️ Protocolo de Desarrollo & Seguridad (AGENTS.md)

Para mantener la calidad y blindaje del código, cualquier interacción de desarrollo sigue directrices estrictas:

  • Modo Estricto: Prohibido realizar cambios o ejecutar scripts sin plan previo aprobado explícitamente por Oskar.
  • Blindaje de Descargas: Las licencias se recuperan de storage/licenses/ mediante IDs abstractos de base de datos (/licenses/download?id=[UUID]). Nunca se pasan rutas directas en las URLs.
  • Auditorías de Seguridad Continuas: Ejecución periódica de peritajes tipo OWASP (laravel-security-audit) registrados históricamente en backend/docs/. Garantizan la ausencia de vulnerabilidades XSS, CSRF, Path Traversal y fugas de datos antes de cada salto de fase mayor.
  • Auditoría IA Privada: El contenido en bruto de las licencias y metadatos sensibles nunca se almacena; se parsea en RAM y se elimina tras el análisis.
  • Gobernanza Git: El desarrollo se realiza en ramas de funcionalidad (feature/, fix/) que nacen y regresan exclusivamente a la rama dev.

Desarrollado con máxima robustez industrial y coherencia visual por el equipo de DX Management.

About

DX License Manager is an internal web portal for centralized management of software licenses from Siemens and Moldex3D.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages