🛡️ NetOps Toolkit v4.0.1 — Lean Architecture Edition

"La Navaja Suiza para Ingenieros de Red"

Suite integral de herramientas de red 100% client-side. Cálculo VLSM, análisis de subredes, DNS lookup, generación de configuraciones y más. Todo ejecutándose en tu navegador con máxima privacidad.

✨ Características Principales

• ✅ 100% Client-Side - Sin backend, máxima privacidad
• ✅ Interfaz Moderna - Diseño Cyberpunk con Tailwind CSS
• ✅ Validación en Tiempo Real - Feedback instantáneo mientras escribes
• ✅ Animaciones Fluidas - Transiciones suaves entre vistas
• ✅ Responsive - Funciona en desktop y móvil
• ✅ PWA Ready - Instalable como aplicación
• ✅ Internationalization - Soporte nativo Español 🇪🇸 / Inglés 🇺🇸
• ✅ Secure - CSP headers, XSS prevention
• ✅ Tested - 34 tests unitarios pasando (Validators + VLSM Logic + Converters + DNS Core)
• ✅ Open Source - MIT License

🎯 Herramientas Disponibles

🌐 Networking

• VLSM Calculator - Calculadora avanzada de subredes con visualización
• Subnet Analyzer - Análisis detallado de direcciones IP
• IPv6 Tools - Expansión, compresión e identificación
• DNS Lookup - Consultas DNS en tiempo real vía DoH
• Public IP Widget - Detección automática de IP pública

🔧 Utilities

• Base Converter - Conversión entre sistemas numéricos (bin/oct/dec/hex)
• Bandwidth Calculator - Cálculo de ancho de banda y throughput
• IP Reference - Referencia rápida de clases IP, rangos y máscaras
• Port Reference - Catálogo de puertos TCP/UDP
• OUI Lookup - Identificación de fabricantes por MAC
• Config Generator - Plantillas Cisco, Mikrotik, Juniper
• Key Generator - Generación segura de claves WPA2/3

🚀 Demo en Vivo

👉 Abrir NetOps Toolkit

💻 Instalación Local

# Clonar repositorio
git clone https://github.com/Medalcode/NetOpsToolkit.git
cd NetOpsToolkit

# Instalar dependencias
npm install

# Ejecutar en desarrollo
npm run dev

# Ejecutar tests
npm test

# Build para producción
npm run build

🏗️ Arquitectura del Proyecto (Lean Design)

El proyecto ha sido reestructurado para maximizar la densidad de valor y eliminar la fragmentación:

• src/core/: Lógica académica pura desposeída de side-effects. (Subnetting, Conversiones, Validaciones).
• src/platform/: Capa de abstracción para I/O (Fetch, LocalStorage, Clipboard).
• src/ui/: Capa de presentación modular y reactiva.
  • ui/components/: Widgets de herramientas individuales.
  • ui/shared/: Servicios UI comunes (i18n, history, theme).

🛠️ Stack Tecnológico

• Frontend: HTML5, JavaScript ES6+ (Modular)
• Styling: Tailwind CSS v3
• Build: Vite
• Testing: Jest + jsdom (32 tests pasando)
• Deploy: Netlify (Serverless Functions para Geo-IP)

📖 Documentación

• CHANGELOG.md - Historial de cambios
• TODO.md - Tareas pendientes y roadmap
• LICENSE - Licencia MIT
• Docs (agent & skills) - Guía para agentes, catálogo de skills y prácticas de CI/CD

Docs & PR

• Documentación añadida en docs/ — agent.md, skills.md, CONTRIBUTING.md.
• Pull request con estos cambios: #1

Nota: el badge de Netlify es un placeholder; añade NETLIFY_BADGE_ID o actualiza la URL del badge con el ID de tu sitio en Netlify.

🧪 Testing

# Ejecutar todos los tests
npm test

# Modo watch
npm run test:watch

# Coverage report
npm run test:coverage

Estado actual: 4 test suites, 34 tests pasando (añadidos tests de conversión el 2026-05-21)

Cambios Recientes (v4.0.1 - 2026-05-21)

• Widgets de UI Auto-Contenidos: Corregidos fallos de carga en bandwidth.js, base-converter.js, y ip_reference.js que impedían su renderizado al buscar elementos estáticos ausentes.
• Estructura e HTML de Navegación: Corregido el bug de visibilidad persistente de la calculadora al restablecer el contenedor #view-vlsm.
• Testing: Añadido soporte de pruebas unitarias para el módulo de conversiones src/core/convert.js (34 tests pasando en total).

Cambios Recientes (v4.0.0 - 2026-05-17)

• 3 herramientas rescatadas: Base Converter, Bandwidth Calculator e IP Reference estaban huérfanas (registradas en JS pero sin HTML). Se inyecta su HTML al contenedor dinámicamente.
• Geo-IP con datos reales: Reemplazada la función mock por llamadas a la API pública ip-api.com.
• Adiós Bootstrap: Eliminada dependencia de Bootstrap CSS/JS. Todo el estilo usa Tailwind/cyber.
• Refactorización Lean: Eliminación de archivos legados (index_legacy.html, js/ raíz) y consolidación de lógica dispersa.
• Estructura de Capas: Separación clara entre core/, platform/ y ui/.
• Skills Consilidadas: Implementación de Super-Skills paramétricas (identity-service, net-analysis-engine).
• Testing: Actualización de la suite para cubrir las nuevas rutas del core (32 tests pasando).

Para reproducir los cambios localmente:

npm install
npm test
npm run dev

🔒 Seguridad

• Content Security Policy (CSP)
• X-Frame-Options: DENY
• XSS Prevention (no innerHTML)
• Input sanitization
• HTTPS enforcement

🤝 Contribuir

1. Fork el proyecto
2. Crea tu branch (git checkout -b feature/AmazingFeature)
3. Commit (git commit -m 'feat: add amazing feature')
4. Push (git push origin feature/AmazingFeature)
5. Abre un Pull Request

Guías de Contribución

• Seguir Conventional Commits
• Ejecutar npm run lint antes de commit
• Escribir tests para nuevas funcionalidades
• Mantener coverage > 70%

📊 Roadmap

v3.1.0 (Próximo)

• Google Analytics 4 integration
• Export to PDF
• Dark mode toggle
• Tooltips informativos
• Keyboard shortcuts

v3.2.0

• PWA completo con Service Worker
• Offline mode
• LocalStorage history para todas las herramientas
• Visual subnet diagrams

v4.0.0

• Supernetting calculator
• Route aggregation
• IPv6 full support
• Internationalization (i18n)

Ver TODO.md para más detalles.

📄 Licencia

MIT License - Ver LICENSE

---

Desarrollado por MedalCode
Empoderando a ingenieros de red

🌐 Demo • 🐛 Issues • 📝 Changelog