Initial commit: Hybrid polling, interactive log modal and 3-second hard reset

2026-08-19 00:46:37 +00:00 · 2026-07-24 15:31:56 +00:00
commit 7808501bf4
16 changed files with 34739 additions and 0 deletions
@@ -0,0 +1,76 @@
+# Guía de Ubicación, Actualización y Despliegue del Proyecto
+
+Esta guía documenta la estructura de directorios del proyecto, el flujo de sincronización y los comandos necesarios para iniciar, reiniciar y monitorear el servicio en la máquina virtual Linux por SSH.
+
+---
+
+## 1. Ubicaciones del Código
+
+El proyecto reside en tres entornos clave:
+
+1. **Copia de Desarrollo (Windows Local):** 
+   `E:\Software\TotalConnect\`
+   *Uso:* Compilación del ejecutable standalone `totalconnect.exe` para Windows usando PyInstaller.
+2. **Copia Compartida (Samba Share):** 
+   `Z:\data2\Software\Bot-WhatsApp\TotalConnect\`
+   *Uso:* Compartido en la red que la VM Linux monta de forma nativa. Cualquier cambio guardado en `Z:\` se refleja de forma instantánea en la VM.
+3. **Entorno de Producción (Linux VM - `192.168.100.50`):** 
+   `/mnt/data2/Software/Bot-WhatsApp/TotalConnect/`
+   *Uso:* Directorio donde se ejecuta el demonio de polling de forma continua.
+
+---
+
+## 2. Flujo de Actualización de Cambios
+
+Cada vez que se modifica el código (ej: en `index.py`), se debe seguir el siguiente orden para sincronizar los entornos:
+
+1. Modificar el archivo principal en la red compartida:
+   `Z:\data2\Software\Bot-WhatsApp\TotalConnect\index.py`
+2. Copiar los cambios a la ruta de desarrollo local en Windows:
+   ```powershell
+   Copy-Item "Z:\data2\Software\Bot-WhatsApp\TotalConnect\index.py" "E:\Software\TotalConnect\index.py" -Force
+   ```
+3. Si el cambio requiere actualizar el ejecutable de Windows `totalconnect.exe`, ejecutar en Windows:
+   ```powershell
+   cd E:\Software\TotalConnect\
+   python -m PyInstaller --clean totalconnect.spec
+   Copy-Item "E:\Software\TotalConnect\dist\totalconnect.exe" "E:\Software\TotalConnect\totalconnect.exe" -Force
+   ```
+4. Reiniciar el demonio en la VM (ver comandos en sección 3) para que lea las modificaciones de `index.py`.
+
+---
+
+## 3. Ejecución del Servicio en la VM por SSH
+
+El demonio de polling corre en la máquina virtual Linux en segundo plano. Para interactuar con él, conéctate por SSH:
+
+```powershell
+ssh -i "C:\Users\JAGU\.gemini\antigravity-ide\brain\d979a063-dd63-47a8-8ec1-785abc40b475\scratch\id_ed25519_win" -o StrictHostKeyChecking=no root@192.168.100.50
+```
+
+### Comandos de Control en la VM:
+
+* **Detener el demonio activo:**
+  ```bash
+  pkill -f 'python3 index.py'
+  ```
+* **Iniciar el demonio en segundo plano (Recomendado):**
+  ```bash
+  cd /mnt/data2/Software/Bot-WhatsApp/TotalConnect
+  nohup ./venv/bin/python3 index.py >> server.log 2>&1 &
+  ```
+* **Reiniciar el demonio (Detener e Iniciar en una línea):**
+  ```bash
+  pkill -f 'python3 index.py'; sleep 2; cd /mnt/data2/Software/Bot-WhatsApp/TotalConnect && nohup ./venv/bin/python3 index.py >> server.log 2>&1 &
+  ```
+
+### Comandos de Monitoreo:
+
+* **Comprobar si el proceso de Python está activo:**
+  ```bash
+  ps aux | grep 'python3 index.py' | grep -v grep
+  ```
+* **Visualizar los logs de actividad en tiempo real:**
+  ```bash
+  tail -f /mnt/data2/Software/Bot-WhatsApp/TotalConnect/server.log
+  ```