Documentación

ResolveCore v1.2.0-beta — Guía de uso de la suite de diagnóstico

Introducción

ResolveCore es una plataforma de soporte técnico remoto para Windows, Linux y Android. Estructura el servicio en 7 fases: solicitud → ticket (MantisBT) → conexión remota (AnyDesk) → diagnóstico (PowerShell / Bash / Python) → resolución → informe .txt → facturación.

Requisitos: Windows 10/11 (PowerShell 5.1, ya incluido), Ubuntu 20.04+ / Debian 11+ (Bash 4+), o Android 10+ con depuración ADB. El escáner de vulnerabilidades necesita Python 3.8+ (solo stdlib, sin pip).

Todo el código es software libre bajo GNU GPL-3.0. Las APIs de vulnerabilidades (NVD, CISA KEV, OSV) son públicas y auditables.

Instalación

No requiere instalación: se clona el repositorio y se lanza el menú interactivo de tu plataforma.

PowerShell — como Administrador

git clone https://github.com/Haplee/ResolveCore.git
cd ResolveCore

# Menu interactivo (diagnostico, optimizacion, vulnerabilidades, informe, servicios)
.\scripts\windows\ResolveCore.ps1

Terminal — Ubuntu / Debian

# Dependencias opcionales (S.M.A.R.T. + JSON)
sudo apt install -y smartmontools jq

git clone https://github.com/Haplee/ResolveCore.git
cd ResolveCore

# Menu interactivo
bash scripts/linux/ResolveCore.sh

Bash — requiere ADB habilitado en el dispositivo

# Verificar dispositivo conectado por ADB
adb devices

git clone https://github.com/Haplee/ResolveCore.git
cd ResolveCore

# Menu interactivo (sobre el dispositivo conectado)
bash scripts/android/ResolveCore.sh

Uso

El launcher abre un menú; también puedes invocar cada script directamente. Con --ticket <N> las salidas se organizan en reparaciones/<NNNNN>/ por número de incidencia de MantisBT.

Diagnóstico

# Windows — genera JSON + imprime un resumen legible
.\scripts\windows\diagnostico.ps1 -Ticket 42

# Linux
bash scripts/linux/diagnostico.sh --ticket 42

Vulnerabilidades

# Escaneo CVE multi-feed (NVD + CISA KEV + OSV). Exporta JSON limpio.
python scripts/common/buscar_vulnerabilidades.py --plataforma windows --salida-json vuln.json
# Tras el escaneo, el launcher ofrece un menu de desinstalacion del software vulnerable.

Optimización

bash scripts/linux/optimizacion.sh --dry-run   # previsualiza, no aplica nada
bash scripts/linux/optimizacion.sh             # aplica y guarda el estado previo
bash scripts/linux/optimizacion.sh --undo      # revierte al estado guardado

Informe técnico

# Genera la plantilla .txt pre-rellenada desde el diagnostico
python scripts/common/generar_informe.py --json diagnostico.json --ticket 42

Las acciones destructivas (desinstalar, limpiar) exigen selección y confirmación explícita. El Spooler de impresión (Windows) y cups (Linux) se reportan pero nunca se tocan.

Módulos

⬡

01 — Diagnóstico

CPU, RAM, discos, servicios críticos, red, S.M.A.R.T., uptime y seguridad. JSON estructurado + resumen en terminal.

◈

02 — Vulnerabilidades

CVE multi-feed (NVD · CISA KEV · OSV). Filtra avisos KEV/CVSS≥7.0 y ofrece menú de desinstalación seguro.

◇

03 — Optimización

Limpieza de temporales y servicios con --dry-run y --undo. Spooler/cups siempre excluidos.

⬡

04 — Informe .txt

Plantilla de texto plano pre-rellenada desde el diagnóstico; el técnico la completa a mano y la sube al ticket.

◈

05 — Servicios

Congelación (Reboot Restore Rx / BTRFS+snapper), clonación con verificación SHA-256 y kit de implantación.

◇

06 — Multiplataforma

Windows, Linux y Android (vía ADB) con paridad funcional. macOS está en el roadmap.

Salida JSON

Cada diagnóstico guarda un JSON con estructura plana. El esquema completo vive en docs/scripting/schema-diagnostico.md. Ejemplo (Windows, recortado):

{
  "_meta":    { "plataforma": "windows", "hostname": "PC-CLIENTE", "version": "2.1" },
  "timestamp": "2026-06-04T12:00:00",
  "sistema":  { "nombre": "Windows 11 Pro", "build": "26100", "uptime_horas": 52.3 },
  "cpu":      { "name": "Intel Core i7-12700H", "cores": 12, "load": 8 },
  "ram":      { "total_gb": 16, "free_gb": 9.3 },
  "discos":   [ { "drive": "C:", "total_gb": 512, "free_gb": 67 } ],
  "servicios_criticos": [ { "nombre": "Spooler", "estado": "Running" } ],
  "seguridad": { "defender_activo": true, "firewall": true, "uac": true },
  "red":      { "ip": "192.0.2.15", "gateway": "192.0.2.1", "puertos_escucha": [135, 445] },
  "actualizaciones": { "pendientes": 7 }
}

Leer el último diagnóstico (Bash)

Bash

REPORT=$(ls -t reparaciones/*/diagnostico.json | head -1)
jq '.servicios_criticos[] | select(.estado != "Running")' "$REPORT"

FAQ

¿ResolveCore es de pago?

El software es libre y gratuito (GPL-3.0). Lo que se factura es la intervención del técnico, gestionada desde MantisBT.

¿Bajo qué licencia está?

GNU General Public License v3.0. El código de diagnóstico y el escáner CVE son auditables.

¿En qué formato entrega el informe?

Una plantilla de texto plano (.txt) que el técnico rellena a mano y sube a tu ticket. No se genera PDF.

¿Dónde reporto un fallo?

Abre un issue en GitHub.