# 🔄 MAPA INTEGRAL DE LA APLICACIÓN — AGRIGEST / REPLICANDO

> **Documento Maestro Canónico de Arquitectura, Funcionamiento y Replicación**  
> **Sistema**: Demonio Satélite de Sincronización entre Puestos Locales de Pesaje y Servidor Central  
> **Versión**: 1.0 Legacy &bull; **Fecha de Auditoría**: 2026-10-10  
> **Stack Base**: Delphi XE3 / Delphi 11 Alexandria VCL &bull; ZeosLib 7.x (`TZConnection`, `TZTable`, `TZReadOnlyQuery`) &bull; MySQL Local (localhost:3306) &bull; MySQL Remoto (178.236.112.44)  
> **Módulos**: 1 unidad (`Unit2.pas`) &bull; **Formularios UI**: 1 (`Form2`) &bull; **Tablas BD**: 9 tablas sincronizadas

---

## 📑 Tabla de Contenidos
1. [Visión General y Misión de REPLICANDO](#1-visión-general-y-misión-de-replicando)
2. [Arquitectura del Sistema de Dos Procesos (MESAS + REPLICANDO)](#2-arquitectura-del-sistema-de-dos-procesos-mesas--replicando)
3. [Flujos de Replicación y Ciclos de Datos (Diagramas Mermaid)](#3-flujos-de-replicación-y-ciclos-de-datos-diagramas-mermaid)
   - 3.1. Detección de Conexión y Heartbeat
   - 3.2. Expulsión / Cierre Remoto de Operarias
   - 3.3. Ciclo Push de Turnos y Movimientos de Mesa
   - 3.4. Ciclo Push de Pesadas de Producción
   - 3.5. Ciclo Push de Rendimiento de Limpiadoras y Desbloqueos
   - 3.6. Ciclo Push de Trabajo Diario (Jornadas)
4. [Componentes y Mapeo de Datasets](#4-componentes-y-mapeo-de-datasets)
5. [Diferencias y Brechas entre REPLICANDO y TSyncThread de mesas_v2](#5-diferencias-y-brechas-entre-replicando-y-tsyncthread-de-mesas_v2)
6. [Plan de Integración Definitiva en mesas_v2](#6-plan-de-integración-definitiva-en-mesas_v2)

---

## 1. Visión General y Misión de REPLICANDO

En el despliegue industrial tradicional de AGRIGEST, cada terminal de pesaje corría **dos programas simultáneos**:
1. **`MESAS.exe`**: La aplicación visual táctil de pesaje continuo conectada a la balanza.
2. **`REPLICANDO.exe`**: Un proceso auxiliar ("sidecar") en segundo plano encargado exclusivamente de la comunicación con el servidor central de la empresa.

### ¿Por qué existía este ejecutable separado?
- Si la conexión a Internet o a la red del almacén se interrumpía o sufría latencia, `REPLICANDO.exe` absorbía los tiempos de espera y reintentos.
- `MESAS.exe` escribía a velocidad de vértigo en un servidor MySQL local instalado en el propio terminal (`localhost`), garantizando que la balanza nunca sufriera bloqueos por culpa de la red.
- `REPLICANDO.exe` leía las colas locales (`_local`) y las volcaba al servidor central en `178.236.112.44`.

---

## 2. Arquitectura del Sistema de Dos Procesos (MESAS + REPLICANDO)

```mermaid
graph LR
    subgraph "Terminal Físico de Pesaje (PC Puesto)"
        Balanza["⚖️ Báscula Serie"] --> AppMesas["🖥️ MESAS.exe\n(UI Operaria)"]
        AppMesas -->|Escritura Directa Rápida| DBLocal[("🗄️ MySQL Local\n(localhost:3306)\n- produccion_local\n- movimiento_mesas_local\n- rendimiento_local\n- trabajo_diario_local\n- desbloqueos_local")]
        
        AppRep["🔄 REPLICANDO.exe\n(Timer tsincronizar)\nUnit2.pas"]
        AppRep -->|Lectura Colas| DBLocal
    end

    subgraph "Servidor Central AGRIGEST"
        DBCentral[("🗄️ MySQL Remoto Central\n(178.236.112.44:3306)\n- produccion\n- movimiento_mesas\n- rendimiento\n- trabajo_diario\n- desbloqueos")]
    end

    AppRep -->|TCP 3306 (Internet / LAN)\nPush Colas / Limpieza Local| DBCentral
```

---

## 3. Flujos de Replicación y Ciclos de Datos (Diagramas Mermaid)

El motor de `REPLICANDO` se ejecuta dentro del evento `tsincronizarTimer` con la siguiente secuencia estructurada:

### 3.1. Detección de Conexión y Heartbeat

1. Prueba la conexión remota con `select count(*) from materias_primas`.
2. Si falla la consulta, marca `dbservidor.Connected := false`, colorea el panel `PCONEXION` en rojo (`SIN CONEXION`) y sale del ciclo para esperar al siguiente intervalo.
3. Si ambas bases de datos están conectadas (`dbservidor` y `dbagrigest`), colorea en verde (`CONECTADO`) y procesa las colas.

### 3.2. Expulsión / Cierre Remoto de Operarias

```mermaid
sequenceDiagram
    autonumber
    participant Rep as REPLICANDO.exe
    participant Loc as MySQL Local (localhost)
    participant Srv as MySQL Central (178.236.112.44)

    Rep->>Loc: SELECT id FROM movimiento_mesas_local WHERE estado = 0
    loop Por cada operaria activa local
        Rep->>Srv: SELECT id, salida_real FROM movimiento_mesas WHERE id = :id
        alt ¿salida_real <> '' en el servidor central?
            Rep->>Loc: DELETE FROM movimiento_mesas_local WHERE id = :id
            Note over Loc: Operaria expulsada localmente porque fichó en otra mesa
        end
    end
```

### 3.3. Ciclo Push de Turnos y Movimientos de Mesa

1. **Altas de Turno (`estado = 1`)**:
   - Lee campos completos: `fecha`, `mesa`, `idt`, `trabajador`, `entrada_real`, `salida_real`, `entrada_ajustada`, `salida_ajustada`, `horasreales`, `horasajustadas`, `puesto`, `tipotrabajo`, `articulo`, `parcela`, `num_limpiadora`.
   - Consulta `select max(id)+1 from movimiento_mesas` en el servidor central.
   - Inserta el registro en `movimiento_mesas` remoto.
   - Actualiza el registro local: `update movimiento_mesas_local set estado = 0, id = :id_remoto`.
2. **Bajas / Cierres de Turno (`estado = 2`)**:
   - Ejecuta `update movimiento_mesas set salida_real = ..., salida_ajustada = ..., horasreales = ..., horasajustadas = ... where id = :id`.
   - Marca localmente `estado = -1` y luego purga: `delete from movimiento_mesas_local where estado = -1 and id = :id`.

### 3.4. Ciclo Push de Pesadas de Producción

1. Consulta `select * from produccion_local where estado = 1`.
2. Normaliza números con coma flotante española:
   ```pascal
   tara := stringreplace(tara, ',', '.', [rfReplaceAll]);
   pesoteorico := stringreplace(pesoteorico, ',', '.', [rfReplaceAll]);
   pesoreal := stringreplace(pesoreal, ',', '.', [rfReplaceAll]);
   ```
3. Ejecuta `insert into produccion (fecha, hora, mesa, bascula, idt, embasadora, materia_prima, producto, tara, peso_teorico, peso_real) values (...)`.
4. Actualiza en la base local: `update produccion_local set estado = 0 where id = :id`.

### 3.5. Ciclo Push de Rendimiento de Limpiadoras y Desbloqueos

- **`rendimiento_local`**: Inserta en `rendimiento` remoto (`fecha`, `hora`, `idt`, `trabajador`, `materia_prima`, `peso_bruto`, `tara`, `pesoneto`, `num_limpiadora`) mediante `sv_rendimiento: TZTable`. Actualiza `estado = 0`.
- **`desbloqueos_local`**: Inserta en `desbloqueos` remoto (`fecha`, `hora`, `envasadora`, `mesa`, `bascula`) mediante `sv_desbloqueos: TZTable`. Actualiza `estado = 0`.

### 3.6. Ciclo Push de Trabajo Diario (Jornadas)

- Lee `trabajo_diario_local` con `estado = 1`.
- Obtiene ID con `select max(id)+1 from trabajo_diario`.
- Inserta en `trabajo_diario` (`fecha`, `parcela`, `idt`, `trabajador`, `typework`, `articulo`, `qhoras`, `precio`, `total`, `estado`, `origen`).
- Elimina el registro local: `delete from trabajo_diario_local where id = :id`.

---

## 4. Componentes y Mapeo de Datasets

| Componente | Clase Zeos | Conexión | Tabla / Consulta |
| :--- | :--- | :--- | :--- |
| `DBagrigest` | `TZConnection` | Local (`localhost:3306`) | Base local `agrigest` |
| `dbservidor` | `TZConnection` | Remota (`178.236.112.44`) | Base central `agrigest` |
| `qmovimientos_mesa` | `TZReadOnlyQuery` | `DBagrigest` | Lectura de turnos por estado (0, 1, 2) |
| `qaux3` | `TZReadOnlyQuery` | `DBagrigest` | Lectura de pesadas pendientes (`estado = 1`) |
| `qaux4` | `TZReadOnlyQuery` | `DBagrigest` | Actualización de estado / borrado local |
| `qserv` | `TZReadOnlyQuery` | `dbservidor` | Ejecución de inserciones en servidor central |
| `sv_rendimiento` | `TZTable` | `dbservidor` | Tabla remota `rendimiento` |
| `sv_desbloqueos` | `TZTable` | `dbservidor` | Tabla remota `desbloqueos` |
| `qpesadas` | `TZReadOnlyQuery` | `DBagrigest` | `count(id)` de pesadas del día |
| `tsincronizar` | `TTimer` | — | Temporizador de ciclo de replicación |

---

## 5. Diferencias y Brechas entre REPLICANDO y TSyncThread de mesas_v2

Al diseñar `mesas_v2`, se intentó eliminar la necesidad de un segundo ejecutable (`REPLICANDO.exe`), trasladando su código a un hilo interno en segundo plano: [`sync_thread.pas`](file:///c:/fuentes/proyectos%20delphi/AGRIGEST/mesas_v2/sync_thread.pas) (`TSyncThread`).

Sin embargo, en esa transición se produjeron diferencias críticas que deben corregirse:

| Aspecto | `REPLICANDO` (Legacy) | `TSyncThread` (`mesas_v2`) | Estado y Diagnóstico |
| :--- | :--- | :--- | :--- |
| **Arquitectura de Proceso** | Ejecutable separado (`REPLICANDO.exe`) | **Hilo interno `TThread` integrado** | ✅ Mejor en `mesas_v2` (1 solo ejecutable). |
| **Base de Datos Local** | Requiere MySQL Server local (`mysqld.exe`) | **SQLite embebido (`<ini>_local.db`)** | ✅ Mucho mejor en `mesas_v2` (cero instalación). |
| **Cierre Remoto de Operarias** | Revisa **todas** las operarias activas y **borra** el registro local | Solo revisa **1 operaria** (`LIMIT 1`) y **no borra** el registro local | 🔴 Incompleto en `mesas_v2`. Requiere bucle completo y purga local. |
| **Sincronización de Maestros (PULL)** | No hacía PULL (dependía de réplica MySQL) | **Hace PULL de 9 tablas maestras** | ✅ Gran avance en `mesas_v2`, pero falta transacción. |
| **Formato de Decimales y SQL Injection** | Concatenación de strings con `stringreplace` | **Consultas parametrizadas FireDAC** | ✅ Mucho más limpio y seguro en `mesas_v2`. |
| **Contador de Pesadas Pendientes** | Botón y contador en pantalla (`qpesadas`) | Inexistente en la interfaz visual | 🟡 Pendiente de trasladar a la barra de estado de `mesas_v2`. |
| **Gestión de IDs (`MAX(id)+1`)** | `select max(id)+1` | `select max(id)+1` | 🔴 Heredó el mismo defecto de colisión concurrente. |

---

## 6. Plan de Integración Definitiva en mesas_v2

Para que `mesas_v2` asuma al 100% el trabajo de `REPLICANDO` con máxima robustez:

1. **Robustecer el Logout Remoto en `TSyncThread`**:
   - Reemplazar el `LIMIT 1` por el escaneo de todas las operarias con `salida_real IS NULL` y actualizar/purgar en SQLite local cuando el servidor central indique que han finalizado.
2. **Reemplazar `MAX(id)+1` por Asignación Concurrente Segura**:
   - Configurar las tablas maestras de MySQL con `AUTO_INCREMENT` nativo o recuperar el `LAST_INSERT_ID()`.
3. **Optimizar con Transacciones ACID**:
   - Envolver el PULL de maestros y el PUSH de pesadas en `StartTransaction` / `Commit` de FireDAC para multiplicar la velocidad en SQLite.
4. **Incorporar el Monitor de Pesadas y Estado de Conexión en `Tpprincipal`**:
   - Mostrar el total de pesadas del día y el número de pesadas pendientes de sincronizar en la barra inferior del formulario principal.
