Castel LabOps

Suite operativa para administrar laboratorios Windows del Colegio Castel Gandolfo con Veyon, Wake-on-LAN, WinRM y utilidades de soporte en terreno.

Autor: Pablo Elias Avendano Miranda Plataforma principal: Windows / PowerShell Enfoque: automatizacion pragmatica para salas de computacion, PCs de profesor y equipos de curso.

---

Que Resuelve

• Actualiza el directorio de Veyon desde escaneos de red.
• Mantiene nombres logicos aunque cambien las IPs.
• Separa equipos fuera de la sala principal en ubicaciones Veyon propias.
• Enciende equipos por Wake-on-LAN.
• Ejecuta tareas clave por WinRM.
• Mantiene datos reales, respaldos y reportes fuera de Git.

Estructura

VeyonScripts/
|-- apps/                    # GUI y herramientas visuales
|-- deploy/                  # Material de despliegue y operacion remota
|   |-- admin_ssh/           # Sincronizacion por SSH para equipos puntuales
|   |-- admin_winrm/         # Orquestacion remota desde el PC administrador
|   |-- componentes_cliente/ # Payloads que se instalan en los clientes
|   `-- kit_pendrive/        # Kit portable/manual para terreno
|-- docs/                    # Arquitectura, seguridad y operacion
|-- examples/                # Datos de ejemplo sanitizados
|-- launchers/               # Launchers reales invocados desde la raiz
|-- reports/                 # Plantillas o reportes publicables
|-- scripts/                 # Scripts principales, diagnosticos y legacy
|-- tools/                   # Herramientas auxiliares
`-- *.bat                    # Wrappers de compatibilidad para escritorio

Las carpetas data/, config/, memory/, tasks/, backups/, void_env/, _reports/ y archivos .cfg/logs operativos son locales. No deben versionarse.

Uso Rapido

Ejecutar desde PowerShell o con los .bat de la raiz:

.\VEYON_MAESTRO.bat
.\MAPEO_FISICO_ADMIN.bat
.\WINRM_MAESTRO.bat

Los launchers de la raiz llaman a launchers/, y estos ejecutan los scripts reales dentro de scripts/principales/.

Flujo Recomendado

1. Preparar cada PC cliente con deploy/kit_pendrive/.
2. Validar conectividad y credenciales fuera del repo.
3. Mantener inventarios reales en data/ local, nunca en Git.
4. Ejecutar el maestro de Veyon desde el PC administrador.
5. Usar deploy/admin_winrm/ para acciones masivas.
6. Guardar salidas operativas en _reports/ local.

Ubicaciones Veyon Especiales

scripts/principales/VEYON_MAESTRO.py mantiene reglas explicitas para equipos que no pertenecen a SalaComputacion:

Nombre Veyon	Grupo	Ubicacion Veyon
6B	SalasBasica	6B
4MB	SalasMedia	4MB

Estas reglas usan MAC como identificador permanente porque la IP cambia por DHCP, pero las MAC reales viven en config/veyon_topology.local.json, archivo local ignorado por Git. El maestro crea los grupos SalasBasica y SalasMedia, ubica cada sala bajo su grupo y evita que los PCs de curso vuelvan a mezclarse dentro de la sala principal.

Documentacion

• Arquitectura
• Operacion diaria
• Seguridad y datos locales
• Ejemplo de inventario sanitizado
• Ejemplo de topologia Veyon sanitizado
• GUI de mapeo fisico

Politica De Datos

Este repo puede ser publico o privado, pero debe tratarse como codigo fuente. No se suben:

• Inventarios reales de IP/MAC.
• Configuraciones de WakeMeOnLAN.
• Logs o reportes con usuarios/equipos reales.
• Respaldos de drivers, exports o binarios generados.
• Entornos virtuales Python.
• Bases SQLite locales.

Usa examples/ para ejemplos artificiales y docs/ para explicar formatos.

Validacion Basica

python -m py_compile .\scripts\principales\VEYON_MAESTRO.py
git status --short

Para pruebas reales de Veyon se requiere Windows con Veyon instalado y permisos de administrador.