{"id":31900989,"url":"https://github.com/felipesanchez-dev/proyecto","last_synced_at":"2025-10-23T18:22:10.690Z","repository":{"id":315147366,"uuid":"1058283575","full_name":"felipesanchez-dev/proyecto","owner":"felipesanchez-dev","description":null,"archived":false,"fork":false,"pushed_at":"2025-09-16T23:20:19.000Z","size":132,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-13T12:53:40.377Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/felipesanchez-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-16T22:07:36.000Z","updated_at":"2025-09-16T23:20:22.000Z","dependencies_parsed_at":"2025-09-17T01:23:31.972Z","dependency_job_id":"d8f321a1-429c-4c82-9451-168b5bc45425","html_url":"https://github.com/felipesanchez-dev/proyecto","commit_stats":null,"previous_names":["felipesanchez-dev/proyecto"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/felipesanchez-dev/proyecto","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felipesanchez-dev%2Fproyecto","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felipesanchez-dev%2Fproyecto/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felipesanchez-dev%2Fproyecto/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felipesanchez-dev%2Fproyecto/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/felipesanchez-dev","download_url":"https://codeload.github.com/felipesanchez-dev/proyecto/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felipesanchez-dev%2Fproyecto/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":280282225,"owners_count":26303860,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-21T02:00:06.614Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-10-13T12:50:36.591Z","updated_at":"2025-10-23T18:22:10.663Z","avatar_url":"https://github.com/felipesanchez-dev.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🖥️ Sistema Scanner Windows\n\n\u003cdiv align=\"center\"\u003e\n\n![Version](https://img.shields.io/badge/version-1.1.0-blue.svg?style=for-the-badge)\n![Python](https://img.shields.io/badge/python-3.7%2B-brightgreen.svg?style=for-the-badge)\n![Windows](https://img.shields.io/badge/platform-Windows%207%2F8%2F10%2F11-lightgrey.svg?style=for-the-badge)\n![License](https://img.shields.io/badge/license-Educational-orange.svg?style=for-the-badge)\n\n**🔍 Herramienta Avanzada de Escaneo y Mantenimiento Automatizado**\n\n_Análisis profundo de hardware, software y configuraciones de seguridad con integración MongoDB_\n\n\u003c/div\u003e\n\n---\n\n## 📋 Descripción\n\nSistema Scanner Windows es una herramienta avanzada de escaneo y mantenimiento automatizado para sistemas Windows. Proporciona análisis profundo de hardware, software y configuraciones de seguridad, con integración a MongoDB para almacenamiento centralizado de datos.\n\n## ✨ Características Principales\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\n\n### 🔍 **Escaneo de Hardware Avanzado**\n\n- 💽 **Discos:** Modelo, marca, tipo (SSD/HDD), particiones, espacio libre/usado\n- 🖼️ **Tarjeta Gráfica:** Nombre, VRAM, versión de driver, temperaturas\n- 🧠 **Memoria RAM:** Capacidad instalada, velocidad, módulos detectados\n- ⚡ **Procesador Detallado:**\n  - 🔢 Núcleos físicos y lógicos\n  - 🧵 Hilos por núcleo (Hyperthreading)\n  - 📊 Uso por núcleo en tiempo real\n  - 🏭 Arquitectura y especificaciones técnicas\n\n### 🖥️ **Información del Sistema**\n\n- 🪟 **Sistema Operativo:** Versión completa, arquitectura (32/64 bits)\n- 🆔 **Identificación:** Hostname, Device ID, Product ID\n- 🔑 **Clave de Producto:** Detección automática (opcional)\n\n\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\n### 🔒 **Análisis de Seguridad Optimizado**\n\n- 🛡️ **Firewall:** Estado por perfil, conteo de reglas\n- 🔌 **Puertos Inteligentes:**\n  - ⚡ **Filtrado crítico** (solo puertos importantes)\n  - 📊 **Resumen optimizado** para MongoDB\n  - 🔍 Conexiones activas con procesos\n- 📦 **Actualizaciones Avanzadas:**\n  - 🆕 **Sistema:** Actualizaciones pendientes de Windows\n  - 🔄 **Drivers:** Detección de drivers obsoletos\n  - ⚠️ **Alertas:** Reinicio requerido, auto-updates\n- 💿 **Software Instalado:** Lista completa optimizada\n- 🔧 **Drivers:** Estado y problemas detectados\n\n### 📈 **Monitoreo en Tiempo Real**\n\n- 📊 Uso de CPU por núcleo\n- 🌡️ Temperaturas de componentes\n- 💾 Estado de memoria en tiempo real\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n### 🔧 Funcionalidades Adicionales\n\n- ⚡ **Activación Windows/Office:** Scripts automatizados con confirmaciones de seguridad\n- 🗃️ **Base de Datos MongoDB:** Almacenamiento centralizado con reintentos automáticos\n- 📝 **Logging Avanzado:** Rotación automática, múltiples niveles, archivos separados\n- 🎨 **Interfaz Rich:** Menús coloridos, barras de progreso, tablas formateadas\n\n---\n\n## 🏗️ Arquitectura del Sistema\n\n### 📊 Flujo de Datos\n\n```mermaid\ngraph TB\n    A[🖥️ Sistema Windows] --\u003e B[🔍 System Scanner]\n    A --\u003e C[🔒 Security Scanner]\n\n    B --\u003e D[💽 Hardware Info]\n    B --\u003e E[🖥️ OS Info]\n    B --\u003e F[🔄 Updates Info]\n\n    C --\u003e G[🛡️ Firewall Status]\n    C --\u003e H[🔌 Critical Ports Only]\n    C --\u003e I[📦 Software Summary]\n\n    D --\u003e J[📊 Data Aggregator]\n    E --\u003e J\n    F --\u003e J\n    G --\u003e J\n    H --\u003e J\n    I --\u003e J\n\n    J --\u003e K[💾 Local Storage]\n    J --\u003e L[🗃️ MongoDB Atlas]\n\n    K --\u003e M[📄 JSON Files]\n    L --\u003e N[📈 Centralized Database]\n\n    style A fill:#e1f5fe\n    style J fill:#f3e5f5\n    style L fill:#e8f5e8\n    style H fill:#fff3e0\n```\n\n### 🧩 Componentes del Sistema\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│                    🖥️ SISTEMA SCANNER WINDOWS                │\n├─────────────────────────────────────────────────────────────┤\n│                                                             │\n│  ┌─────────────────┐  ┌─────────────────┐  ┌─────────────────┐ │\n│  │   🔍 SCANNER    │  │  🔒 SECURITY   │  │  🎨 INTERFACE  │ │\n│  │    MODULE       │  │     MODULE      │  │     MODULE     │ │\n│  │                 │  │                 │  │                │ │\n│  │ • Hardware      │  │ • Firewall     │  │ • Rich Console │ │\n│  │ • CPU Details   │  │ • Critical     │  │ • Progress     │ │\n│  │ • Memory        │  │   Ports Only   │  │ • Tables       │ │\n│  │ • Disks         │  │ • Updates      │  │ • Menus        │ │\n│  │ • GPU           │  │ • Software     │  │                │ │\n│  └─────────────────┘  └─────────────────┘  └─────────────────┘ │\n│                                                             │\n│  ┌─────────────────┐  ┌─────────────────┐  ┌─────────────────┐ │\n│  │  🗃️ DATABASE   │  │  📝 LOGGING    │  │  ⚡ ACTIVATION  │ │\n│  │     MODULE      │  │     MODULE      │  │     MODULE     │ │\n│  │                 │  │                 │  │                │ │\n│  │ • MongoDB       │  │ • Rotation     │  │ • Windows      │ │\n│  │ • Retry Logic   │  │ • Security     │  │ • Office       │ │\n│  │ • Error Handle  │  │ • Operations   │  │ • Safety       │ │\n│  │ • Optimization  │  │ • Debug        │  │   Checks       │ │\n│  └─────────────────┘  └─────────────────┘  └─────────────────┘ │\n│                                                             │\n└─────────────────────────────────────────────────────────────┘\n```\n\n## 📁 Estructura del Proyecto\n\n```\nsistema_scanner/\n├── main.py                    # Punto de entrada principal\n├── requirements.txt           # Dependencias Python\n├── test_system.py            # Script de pruebas\n├── modules/                   # Módulos principales\n│   ├── __init__.py\n│   ├── scanner.py            # Escaneo de hardware\n│   ├── security_scanner.py   # Análisis de seguridad\n│   ├── database.py           # Integración MongoDB\n│   ├── interface.py          # Interfaz Rich\n│   ├── activation.py         # Activación Windows/Office\n│   ├── utils.py              # Utilidades y persistencia\n│   └── logging_setup.py      # Sistema de logging\n├── config/                    # Configuraciones\n│   ├── __init__.py\n│   └── settings.py           # Configuraciones globales\n├── logs/                      # Archivos de log\n├── scans/                     # Escaneos JSON locales\n└── README.md                  # Esta documentación\n```\n\n## 🚀 Instalación\n\n\u003cdiv align=\"center\"\u003e\n\n### 📋 Requisitos del Sistema\n\n| Componente      | Requerimiento | Recomendado   | Estado                                                              |\n| --------------- | ------------- | ------------- | ------------------------------------------------------------------- |\n| 🐍 **Python**   | 3.7+          | 3.9+          | ![Python](https://img.shields.io/badge/python-required-red)         |\n| 🪟 **Windows**  | 7/8/10/11     | 10/11 64-bit  | ![Windows](https://img.shields.io/badge/windows-compatible-green)   |\n| 👑 **Permisos** | Usuario       | Administrador | ![Admin](https://img.shields.io/badge/admin-recommended-orange)     |\n| 💾 **Espacio**  | 50 MB         | 200 MB        | ![Space](https://img.shields.io/badge/space-minimal-blue)           |\n| 🌐 **Red**      | Opcional      | MongoDB Atlas | ![Network](https://img.shields.io/badge/network-optional-lightgrey) |\n\n\u003c/div\u003e\n\n### 📦 Pasos de Instalación\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\n\n#### 🔽 **Paso 1: Obtener el Código**\n\n```bash\n# 🌟 Método recomendado - Git\ngit clone https://github.com/felipesanchez-dev/proyecto.git\ncd proyecto\n\n# 📁 Alternativo - Descargar ZIP\n# Descomprimir en carpeta deseada\n```\n\n#### 🐍 **Paso 2: Dependencias Python**\n\n```bash\n# 🚀 Instalación automática\npip install -r requirements.txt\n\n# 🔧 Manual (si es necesario)\npip install psutil==5.9.6\npip install pymongo==4.6.0\npip install rich==13.7.0\npip install wmi==1.5.1\n```\n\n\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\n#### 🗃️ **Paso 3: MongoDB (Opcional)**\n\n```bash\n# 🌐 Atlas Cloud (Recomendado)\nset MONGO_URI=mongodb+srv://user:pass@cluster.mongodb.net/\n\n# 🏠 Local (Alternativo)\nset MONGO_URI=mongodb://localhost:27017/\n\n# ✅ Verificar conexión\npython main.py --test-mongodb\n```\n\n#### ✅ **Paso 4: Verificación**\n\n```bash\n# 🧪 Ejecutar pruebas completas\npython test_system.py\n\n# 🎯 Prueba rápida\npython main.py --help\n\n# 🔍 Escaneo de prueba\npython main.py --batch --scan-only\n```\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n## 🎮 Uso del Sistema\n\n### Modo Interactivo (Recomendado)\n\n```bash\n# Ejecutar interfaz completa\npython main.py\n```\n\n**Menú Principal:**\n\n1. **Escaneo Profundo del Sistema** - Análisis completo + subida MongoDB\n2. **Activación Windows/Office** - Scripts de activación con advertencias\n3. **Salir** - Cierre seguro del sistema\n\n### Modo Línea de Comandos (Avanzado)\n\n#### Escaneo Básico\n\n```bash\n# Escaneo completo con datos sensibles\npython main.py --batch\n\n# Escaneo sin datos sensibles\npython main.py --batch --no-sensitive\n\n# Solo escaneo local (sin MongoDB)\npython main.py --batch --scan-only\n\n# Guardar en archivo específico\npython main.py --batch --output mi_escaneo.json\n```\n\n#### Configuración y Mantenimiento\n\n```bash\n# Probar conexión MongoDB\npython main.py --test-mongodb\n\n# Configurar URI personalizada\npython main.py --mongo-uri \"mongodb://miservidor:27017/\" --test-mongodb\n\n# Limpiar archivos antiguos\npython main.py --cleanup-logs 30        # Logs \u003e 30 días\npython main.py --cleanup-scans 7        # Escaneos \u003e 7 días\n\n# Listar escaneos guardados\npython main.py --list-scans\n\n# Habilitar logging detallado\npython main.py --log-level DEBUG --batch\n```\n\n#### Opciones de Logging\n\n```bash\n# Sin archivos de log (solo consola)\npython main.py --no-log-file\n\n# Nivel específico de logging\npython main.py --log-level WARNING\n```\n\n### Variables de Entorno Soportadas\n\n| Variable    | Descripción               | Valor por Defecto            |\n| ----------- | ------------------------- | ---------------------------- |\n| `MONGO_URI` | URI de conexión a MongoDB | `mongodb://localhost:27017/` |\n\n---\n\n## 🎬 Demostración Visual\n\n### 🖥️ Interfaz del Sistema\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\n\n#### 🎨 **Menú Principal**\n\n```\n╔══════════════════════════════════════════════════╗\n║            SISTEMA SCANNER WINDOWS               ║\n║         Mantenimiento Automatizado v1.1         ║\n╚══════════════════════════════════════════════════╝\n\n┌─────────── MENÚ PRINCIPAL ────────────────────────┐\n│                                                   │\n│  1. Escaneo Profundo del Sistema y Subida MongoDB │\n│  2. Activación de Windows/Office        ⚠️       │\n│  3. Salir del Sistema                            │\n│                                                   │\n│  Seleccione una opción (1-3):                    │\n└───────────────────────────────────────────────────┘\n```\n\n#### 📊 **Progreso de Escaneo**\n\n```\n🔄 Escaneando hardware...          ████████████ 100%\n🔒 Escaneando seguridad...         ████████████ 100%\n💾 Guardando datos...              ████████████ 100%\n\n✅ Escaneo completado - ID: 0d10a891\n```\n\n\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\n#### 📋 **Resultados del Escaneo**\n\n```\n┌────────── ✓ Escaneo Completado ──────────────────┐\n│ ID de Escaneo: 0d10a891-91e2...                 │\n│ PIN de Acceso: A7X9                             │\n│ Timestamp:     2025-09-16T18:07:42              │\n│ Hostname:      DESKTOP-ABC123                   │\n└──────────────────────────────────────────────────┘\n\n┌────────── Hardware Detectado ────────────────────┐\n│ CPU    │ Intel Core i7 - 6 núcleos, 12 hilos   │\n│        │ (HT habilitado) - Uso: 16.8%           │\n│ RAM    │ 15.89 GB total - 45.2% usado           │\n│ Discos │ 2 discos - 512.0 GB total              │\n│ GPU    │ 1 GPU - Intel Iris Xe Graphics         │\n└──────────────────────────────────────────────────┘\n\n┌────────── Estado de Actualizaciones ─────────────┐\n│ Sistema │ 1 pendientes (Auto habilitado)        │\n│ Drivers │ 129 de 177 obsoletos (Revisar)       │\n└──────────────────────────────────────────────────┘\n```\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n### 🚀 **Comandos de Ejemplo en Acción**\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e💻 Ver Ejemplos de Línea de Comandos\u003c/b\u003e\u003c/summary\u003e\n\n#### Escaneo Básico\n\n```powershell\nPS\u003e python main.py --batch --no-sensitive --output scan.json\n🔄 Ejecutando escaneo en modo batch...\n   📊 Escaneando hardware...\n   🔒 Escaneando seguridad...\n   💾 Guardando escaneo localmente...\n✅ Escaneo completado - ID: 0d10a891-91e2-4108-a6e4-7fe08e224fbd\n```\n\n#### Verificación MongoDB\n\n```powershell\nPS\u003e python main.py --test-mongodb\n🔗 Probando conexión a MongoDB...\n✅ Conexión exitosa a proyectofinal.scans\n📊 Documentos en colección: 15\n✅ MongoDB está funcionando correctamente\n```\n\n#### Limpieza de Archivos\n\n```powershell\nPS\u003e python main.py --cleanup-logs 30 --cleanup-scans 7\n🧹 Limpiando logs antiguos (\u003e30 días)...\n   📁 Eliminados: 5 archivos de log\n🧹 Limpiando escaneos antiguos (\u003e7 días)...\n   📁 Eliminados: 12 archivos JSON\n✅ Limpieza completada\n```\n\n\u003c/details\u003e\n\n## 📊 Formato de Datos y Ejemplos\n\n### 🏗️ Estructura del Escaneo JSON\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e📋 Ver Estructura Completa (Click para expandir)\u003c/b\u003e\u003c/summary\u003e\n\n```json\n{\n  \"identifiers\": {\n    \"scan_id\": \"0d10a891-91e2-4108-a6e4-7fe08e224fbd\",\n    \"access_pin\": \"A7X9\",\n    \"timestamp\": \"2025-09-16T18:07:42.188431\"\n  },\n  \"system_info\": {\n    \"hardware\": {\n      \"cpu\": {\n        \"processor_name\": \"Intel64 Family 6 Model 141 Stepping 1, GenuineIntel\",\n        \"physical_cores\": 6,\n        \"logical_cores\": 12,\n        \"threads_per_core\": 2,\n        \"hyperthreading_enabled\": true,\n        \"cpu_usage_percent\": 16.8,\n        \"per_cpu_usage\": [9.2, 10.9, 18.8, 10.9, 15.6, 4.7]\n      },\n      \"memory\": {\n        \"total_gb\": 15.89,\n        \"used_percent\": 45.2\n      },\n      \"disks\": [...],\n      \"gpu\": [...]\n    },\n    \"operating_system\": {\n      \"system\": \"Windows\",\n      \"release\": \"11\",\n      \"hostname\": \"DESKTOP-ABC123\"\n    },\n    \"updates\": {\n      \"system_updates\": {\n        \"total_pending\": 1,\n        \"reboot_required\": false,\n        \"automatic_updates_enabled\": true\n      },\n      \"driver_updates\": {\n        \"total_drivers\": 177,\n        \"drivers_needing_update\": 129\n      }\n    },\n    \"security\": {\n      \"firewall\": {\n        \"status\": \"fully_enabled\"\n      },\n      \"ports_summary\": {\n        \"total_ports\": 24,\n        \"critical_count\": 5,\n        \"summary\": \"Se encontraron 24 puertos abiertos, 5 son críticos\"\n      }\n    }\n  },\n  \"scan_settings\": {\n    \"include_sensitive\": false,\n    \"scanner_version\": \"1.1.0\"\n  }\n}\n```\n\n\u003c/details\u003e\n\n### 📈 Ejemplos de Salida Real\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\n\n#### 💻 **Información de CPU Detallada**\n\n```json\n{\n  \"physical_cores\": 6,\n  \"logical_cores\": 12,\n  \"threads_per_core\": 2,\n  \"hyperthreading_enabled\": true,\n  \"cpu_usage_percent\": 16.8,\n  \"architecture\": \"AMD64\",\n  \"max_frequency_mhz\": 2688.0\n}\n```\n\n#### 🔌 **Puertos Optimizados**\n\n```json\n{\n  \"total_ports\": 24,\n  \"critical_count\": 5,\n  \"critical_ports\": [\n    {\n      \"protocol\": \"TCP\",\n      \"local_port\": 445,\n      \"process_name\": \"System\"\n    }\n  ],\n  \"summary\": \"24 puertos, 5 críticos\"\n}\n```\n\n\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\n#### 🔄 **Estado de Actualizaciones**\n\n```json\n{\n  \"system_updates\": {\n    \"total_pending\": 1,\n    \"reboot_required\": false,\n    \"automatic_updates_enabled\": true\n  },\n  \"driver_updates\": {\n    \"drivers_needing_update\": 129,\n    \"total_drivers\": 177\n  }\n}\n```\n\n#### 📊 **Resumen de Hardware**\n\n```json\n{\n  \"memory\": {\n    \"total_gb\": 15.89,\n    \"used_percent\": 45.2\n  },\n  \"disks\": 2,\n  \"gpu_count\": 1,\n  \"cpu_cores\": \"6/12\"\n}\n```\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n### Base de Datos MongoDB\n\n- **Base de Datos:** `proyectofinal`\n- **Colección:** `scans`\n- **Índices Recomendados:**\n  - `identifiers.scan_id` (único)\n  - `identifiers.timestamp` (descendente)\n\n## 🔒 Consideraciones de Seguridad\n\n### Datos Sensibles Manejados\n\n- **Clave de Producto Windows** (opcional con `--no-sensitive`)\n- **Números de Serie** del hardware\n- **Información de Red** detallada\n- **Lista Completa de Software** instalado\n\n### Logging de Seguridad\n\nTodos los eventos sensibles se registran en:\n\n- **Archivo:** `logs/security.log`\n- **Eventos:** Acceso a datos, activaciones, comandos externos, operaciones BD\n\n### Recomendaciones\n\n1. **Ejecutar como Administrador** solo cuando sea necesario\n2. **Usar `--no-sensitive`** en entornos de producción\n3. **Configurar MongoDB** con autenticación habilitada\n4. **Revisar logs regularmente** para detectar actividad sospechosa\n5. **Mantener backups** antes de usar funciones de activación\n\n## ⚡ Activación Windows/Office\n\n### ⚠️ ADVERTENCIA CRÍTICA\n\n**Esta funcionalidad ejecuta scripts de terceros que pueden:**\n\n- Modificar configuraciones críticas del sistema\n- Ser detectados por software antivirus\n- Afectar la estabilidad del sistema\n- Violar términos de licencia\n\n### Comandos Utilizados\n\n**Windows 8/10/11:**\n\n```powershell\nirm https://get.activated.win | iex\n```\n\n**Windows 7 y anteriores:**\n\n```powershell\niex ((New-Object Net.WebClient).DownloadString('https://get.activated.win'))\n```\n\n### Proceso de Confirmación\n\n1. **Advertencia de riesgo** con detalles completos\n2. **Confirmación de comprensión** de riesgos\n3. **Revisión del comando** específico a ejecutar\n4. **Confirmación final** antes de ejecución\n\n## 🐛 Solución de Problemas\n\n### 🚨 Errores Comunes y Soluciones\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\n\n#### ❌ **Errores de Dependencias**\n\n```bash\nImportError: No module named 'psutil'\n```\n\n**🔧 Solución:**\n\n```bash\npip install -r requirements.txt\n# O individual:\npip install psutil pymongo rich wmi\n```\n\n#### ❌ **Errores de Conexión MongoDB**\n\n```bash\npymongo.errors.ServerSelectionTimeoutError\n```\n\n**🔧 Solución:**\n\n```bash\n# 1️⃣ Verificar conexión\npython main.py --test-mongodb\n\n# 2️⃣ Configurar URI\nset MONGO_URI=mongodb+srv://user:pass@cluster/\n\n# 3️⃣ Verificar firewall/red\n```\n\n\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\n#### ❌ **Errores de Permisos**\n\n```bash\nAccess Denied (wmic, netsh)\n```\n\n**🔧 Solución:**\n\n```bash\n# Ejecutar como Administrador\n# Clic derecho → \"Ejecutar como administrador\"\n```\n\n#### ❌ **Timeouts del Sistema**\n\n```bash\nsubprocess.TimeoutExpired\n```\n\n**🔧 Solución:**\n\n```bash\n# 1️⃣ Verificar antivirus no bloquee\n# 2️⃣ Ejecutar con más privilegios\n# 3️⃣ Revisar procesos colgados\n```\n\n#### ❌ **Error WMI**\n\n```bash\nwmi.x_wmi: \u003cunknown\u003e\n```\n\n**🔧 Solución:**\n\n```bash\n# Reparar WMI en Windows\nwinmgmt /verifyrepository\nwinmgmt /salvagerepository\n```\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n### 🔍 Diagnóstico Paso a Paso\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e🩺 Guía Completa de Diagnóstico\u003c/b\u003e\u003c/summary\u003e\n\n#### 1️⃣ **Verificación del Sistema**\n\n```powershell\n# Comprobar Python\npython --version\n# Debe mostrar: Python 3.7+\n\n# Comprobar módulos\npython -c \"import psutil, pymongo, rich, wmi; print('✅ Módulos OK')\"\n\n# Ejecutar diagnóstico completo\npython test_system.py\n```\n\n#### 2️⃣ **Verificación de Red y MongoDB**\n\n```powershell\n# Ping a MongoDB Atlas\nping cluster0.abc123.mongodb.net\n\n# Test de conexión específico\npython main.py --test-mongodb --log-level DEBUG\n\n# Verificar variables de entorno\necho $env:MONGO_URI\n```\n\n#### 3️⃣ **Verificación de Permisos**\n\n```powershell\n# Verificar si es administrador\nnet session 2\u003e$null\nif ($?) { \"✅ Administrador\" } else { \"❌ Usuario normal\" }\n\n# Test de comandos del sistema\nwmic computersystem get name\nnetsh advfirewall show currentprofile state\n```\n\n#### 4️⃣ **Logs de Diagnóstico**\n\n```powershell\n# Ver logs recientes de errores\nGet-Content logs\\errors.log -Tail 20\n\n# Ver logs de seguridad\nGet-Content logs\\security.log -Tail 10\n\n# Log completo con debug\npython main.py --log-level DEBUG --batch 2\u003e\u00261 | Tee-Object debug.log\n```\n\n\u003c/details\u003e\n\n### Archivos de Log para Diagnóstico\n\n| Archivo                    | Contenido                         |\n| -------------------------- | --------------------------------- |\n| `logs/sistema_scanner.log` | Log principal con rotación diaria |\n| `logs/errors.log`          | Solo errores críticos             |\n| `logs/security.log`        | Eventos de seguridad              |\n\n### Comandos de Diagnóstico\n\n```bash\n# Verificar sistema completo\npython test_system.py\n\n# Ver logs recientes\ntype logs\\\\sistema_scanner.log | findstr ERROR\ntype logs\\\\errors.log\n\n# Limpiar y reiniciar\npython main.py --cleanup-logs 1 --cleanup-scans 1\n```\n\n## 🔧 Desarrollo y Personalización\n\n### Agregar Nuevos Escáneres\n\n1. Crear clase en `modules/`\n2. Implementar métodos de escaneo\n3. Integrar en `scanner.py` o `security_scanner.py`\n4. Actualizar interfaz si es necesario\n\n### Modificar Base de Datos\n\n1. Editar `config/settings.py` para nuevas configuraciones\n2. Actualizar `modules/database.py` para cambios de esquema\n3. Considerar migración de datos existentes\n\n### Personalizar Interfaz\n\n1. Modificar `modules/interface.py` para nuevos menús\n2. Usar componentes Rich para consistencia visual\n3. Mantener confirmaciones de seguridad\n\n## 📄 Licencia y Responsabilidades\n\n### Uso del Software\n\n- **Propósito:** Educativo y de diagnóstico únicamente\n- **Responsabilidad:** Usuario asume todos los riesgos\n- **Garantía:** Sin garantía expresada o implícita\n\n### Funcionalidades de Activación\n\n- **Riesgo:** Scripts de terceros no auditados\n- **Legalidad:** Usuario responsable del cumplimiento legal\n- **Soporte:** Sin soporte para problemas derivados del uso\n\n## 🤝 Contribución\n\n### Reportar Problemas\n\n1. Ejecutar `python test_system.py`\n2. Incluir logs relevantes\n3. Describir pasos para reproducir\n4. Especificar versión de Windows y Python\n\n### Mejoras Sugeridas\n\n- Nuevos tipos de escaneo\n- Optimizaciones de rendimiento\n- Mejoras en la interfaz\n- Compatibilidad con otros sistemas\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n## 🎯 Estadísticas del Proyecto\n\n![GitHub repo size](https://img.shields.io/github/repo-size/felipesanchez-dev/proyecto?style=for-the-badge)\n![GitHub code size](https://img.shields.io/github/languages/code-size/felipesanchez-dev/proyecto?style=for-the-badge)\n![Lines of code](https://img.shields.io/tokei/lines/github/felipesanchez-dev/proyecto?style=for-the-badge)\n\n### 📊 Características Técnicas\n\n| Métrica               | Valor            | Estado                                                              |\n| --------------------- | ---------------- | ------------------------------------------------------------------- |\n| 🐍 **Versión Python** | 3.7+             | ![Compatible](https://img.shields.io/badge/status-compatible-green) |\n| 📦 **Módulos**        | 7 principales    | ![Modular](https://img.shields.io/badge/design-modular-blue)        |\n| 🗃️ **Base de Datos**  | MongoDB Atlas    | ![Cloud](https://img.shields.io/badge/storage-cloud-orange)         |\n| 🔒 **Seguridad**      | Logging completo | ![Secure](https://img.shields.io/badge/security-enhanced-red)       |\n| 🎨 **Interfaz**       | Rich Console     | ![Modern](https://img.shields.io/badge/ui-modern-purple)            |\n\n### 🚀 Próximas Mejoras (Roadmap)\n\n- [ ] 🌐 **API REST** para integración remota\n- [ ] 📱 **Interfaz web** con dashboard\n- [ ] 🔄 **Escaneo automático** programado\n- [ ] 📧 **Notificaciones** por email/Teams\n- [ ] 🏢 **Modo empresarial** multi-equipo\n- [ ] 🔐 **Autenticación** OAuth2/AD\n\n### 🤝 Contribuir al Proyecto\n\n```bash\n# 1️⃣ Fork del repositorio\ngit fork https://github.com/felipesanchez-dev/proyecto\n\n# 2️⃣ Crear rama de feature\ngit checkout -b feature/nueva-funcionalidad\n\n# 3️⃣ Commit y push\ngit commit -m \"✨ Agregar nueva funcionalidad\"\ngit push origin feature/nueva-funcionalidad\n\n# 4️⃣ Crear Pull Request\n```\n\n---\n\n**© 2025 Sistema Scanner Windows v1.1.0**  \n_🔍 Herramienta avanzada de escaneo y mantenimiento automatizado para Windows_\n\n**Desarrollado por Felipe Sánchez**\n\n[![GitHub](https://img.shields.io/badge/GitHub-felipesanchez--dev-black?style=for-the-badge\u0026logo=github)](https://github.com/felipesanchez-dev)\n[![License](https://img.shields.io/badge/License-Educational-orange?style=for-the-badge)](LICENSE)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffelipesanchez-dev%2Fproyecto","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffelipesanchez-dev%2Fproyecto","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffelipesanchez-dev%2Fproyecto/lists"}