# 🚜 MAPA DE LA APLICACIÓN — AGRIGEST 2.0 (Modernización Delphi 11)

> **Documento Canónico de Arquitectura y Migración**  
> **Sistema**: Evolución a Delphi 11 Alexandria del ERP Agrícola y Cooperativo  
> **Directorio**: `c:\fuentes\proyectos delphi\AGRIGEST _2_0`  
> **Entorno**: Delphi 11 Alexandria • FireDAC • MariaDB InnoDB • FastReport • VCL Auto-escalada  
> **Mapeado por**: Agente [`mapeador`](file:///c:/fuentes/proyectos%20delphi/.agents/agents/mapeador.md)  

---

## 1. Misión de la Versión 2.0

AGRIGEST 2.0 representa la refactorización integral del ERP AGRIGEST original, adaptando su arquitectura a los estándares modernos de desarrollo:
1. **Migración de Motor de Datos**: Sustitución progresiva de componentes ZeosLib por **FireDAC** (`TFDConnection`, `TFDQuery`).
2. **Interfaces Fluidas y Auto-escaladas**: Adopción de la herencia de `TfrmBase` y el escalador líquido `uUIAutoScaler.pas` para soporte en pantallas 2K/4K y tablets táctiles de almacén.
3. **Mapeo Dinámico de Datos**: Eliminación total de campos persistentes en los archivos DFM para evitar roturas por alteración de esquema en base de datos.
4. **Resiliencia Operativa**: Manejo automático de reconexiones ante pérdidas temporales de red y soporte UTF-8 estricto (`ftWideString`).

---

## 2. Inventario de Aplicaciones y Módulos

```mermaid
graph TD
    A2_MAIN[AGRIGEST 2.0 GESTIÓN\nagrigest_2.0.dpr\nERP Central Modernizado]
    A2_BASC[AGRIGEST 2.0 BÁSCULAS\nBASCULAS.dpr\nPesaje Táctil]
    A2_FICH[AGRIGEST 2.0 FICHADOS\nfichar.dpr / fichas.dpr\nPresencia]
    A2_MESAS[AGRIGEST 2.0 MESAS\nMESAS.dpr\nConfección de Fruta]

    A2_BASC --> A2_MAIN
    A2_FICH --> A2_MAIN
    A2_MESAS --> A2_MAIN
```

### A. AGRIGEST 2.0 GESTIÓN
* **Proyectos**: [`AGRIGEST _2_0\GESTION\agrigest_2.0.dpr`](file:///c:/fuentes/proyectos%20delphi/AGRIGEST%20_2_0/GESTION/agrigest_2.0.dpr) | [`agrigest_2_0.dpr`](file:///c:/fuentes/proyectos%20delphi/AGRIGEST%20_2_0/GESTION/agrigest_2_0.dpr)
* **Volumen**: 119 unidades Pascal, 110 formularios visuales.
* **Componentes Clave**:
  - `frm_Main.pas`: Nueva interfaz principal multi-pestaña orientada a flujos de trabajo.
  - `frm_baselist.pas`: Formulario base genérico para mantenimientos y listados con paginación, filtros automáticos y exportación.
  - `frm_lotescreator.pas`: Asistente de creación de lotes con codificación GS1 y código QR.
  - `frm_importarfactusol.pas`: Pasarela de sincronización e importación bidireccional con Factusol.
  - `udberrorhandler.pas` / `frm_dberrordialog.pas`: Captura interceptora de errores de base de datos con mensajes amigables para el usuario.

### B. Módulos Satélite
* **Básculas**: [`AGRIGEST _2_0\BASCULAS\BASCULAS.dpr`](file:///c:/fuentes/proyectos%20delphi/AGRIGEST%20_2_0/BASCULAS/BASCULAS.dpr) (8 unidades).
* **Fichajes**: [`AGRIGEST _2_0\FICHADOS\fichar.dpr`](file:///c:/fuentes/proyectos%20delphi/AGRIGEST%20_2_0/FICHADOS/fichar.dpr) (6 unidades).
* **Mesas de Envasado**: [`AGRIGEST _2_0\MESAS\MESAS.dpr`](file:///c:/fuentes/proyectos%20delphi/AGRIGEST%20_2_0/MESAS/MESAS.dpr) y [`MESASx2`](file:///c:/fuentes/proyectos%20delphi/AGRIGEST%20_2_0/MESASx2).