# 🥐 MAPA MAESTRO DEL ECOSISTEMA — RAÚL ASENCIO PASTELERÍAS > **Documento Canónico de Arquitectura, Integración y Aplicaciones** > **Ecosistema**: Plataforma Global Empresarial, Productiva, Comercial y Telemática para Alta Confitería y Panettones > **Directorio Raíz**: `c:\fuentes\proyectos delphi\RAUL_ASENCIO` > **Stack Tecnológico**: Delphi 11 Alexandria VCL • Next.js 16 / React 19 / Tailwind CSS • Node.js Express PWA • MariaDB 10.x (InnoDB utf8mb4) • FireDAC • Balanzas RS-232 / COM • Veri*Factu SHA-256 • EDIFACT EDICOM • IFS Food v8 > **Mapeado por**: Agente [`mapeador`](file:///c:/fuentes/proyectos%20delphi/.agents/agents/mapeador.md) --- ## 1. Visión Global del Ecosistema El ecosistema **Raúl Asencio Pastelerías** constituye una plataforma tecnológica completa y multidisciplinar que conecta en tiempo real todas las fases del negocio: desde la venta online en el portal e-commerce de alta gama, pasando por la gestión administrativa y fiscal centralizada (ERP), el pesaje con balanzas industriales en obrador, el seguimiento de fermentaciones y masas madre, el control de presencia y fichajes, hasta el aseguramiento de la calidad higiénico-sanitaria (normativa internacional IFS Food v8). ```mermaid graph TD subgraph CANAL_ONLINE["Canal Online y Clientes"] WEB["Portal E-Commerce Next.js 16\nweb_raulasencio_es\nCatálogo Panettones y Pedidos Online"] end subgraph NUCLEO_CENTRAL["Núcleo ERP Administrativo y Fiscal"] ERP["ERP Agrigest / Gestión\nGESTION\\Gestion.dpr\nFacturación, Veri*Factu, EDI, Logística Tipsa/Nacex"] TESTS["Test Runner Consola\nGESTION\\Test_CalculosTiempos.dpr\nAuditoría Automatizada Tiempos y Costes"] end subgraph PLANTA_OBRADORES["Planta de Fabricación y Obradores"] FAB["Control Fabricación & Balanzas\nGESTION\\FABRICACION\\Fabricacion.dpr\nPesaje Táctil RS-232 y Fases Amasado"] WEB_OBRADOR["Webapp Táctil Obradores\nGESTION\\OBRADORES\\webapp (Port 3005)\nHoja de Producción Digital Operarios"] WEB_CALIDAD["PWA Calidad IFS Food v8\nGESTION\\WEBAPP_COM\nControl Temperaturas Cámaras y APPCC"] FICHAR["Control Presencia Standalone\nfichar.exe\nTerminal Biométrico de Jornada"] end subgraph DATOS_COMPARTIDOS["Persistencia Central"] BD[("MariaDB 10.x pastelerias\n100 Tablas InnoDB\nTriggers de Auditoría")] end WEB -->|Pedidos Clientes| BD ERP <-->|Lectura/Escritura Central| BD FAB <-->|Sincronización Balanzas| BD WEB_OBRADOR <-->|Consulta Lotes y Estados| BD WEB_CALIDAD <-->|Registros Térmicos y APPCC| BD FICHAR -->|Marcajes Fichajes| BD TESTS -.->|Validación Lógica Negocio| ERP ``` --- ## 2. Inventario de Aplicaciones del Ecosistema El grupo Raúl Asencio se compone de **7 aplicaciones y servicios complementarios**: ### 1. ERP Agrigest / Gestión (Delphi 11 Alexandria) * **Ubicación**: [`RAUL_ASENCIO\GESTION\Gestion.dpr`](file:///c:/fuentes/proyectos%20delphi/RAUL_ASENCIO/GESTION/Gestion.dpr) | [`Gestion.dproj`](file:///c:/fuentes/proyectos%20delphi/RAUL_ASENCIO/GESTION/Gestion.dproj) * **Documentación Canónica Exhaustiva**: Para el detalle minucioso de sus 172 unidades, 145 formularios y modelo de 94 tablas, consultar: 👉 [`c:\fuentes\proyectos delphi\RAUL_ASENCIO\GESTION\MAPA_DE_LA_APLICACION.md`](file:///c:/fuentes/proyectos%20delphi/RAUL_ASENCIO/GESTION/MAPA_DE_LA_APLICACION.md) * **Misión**: Core de gestión comercial, compras, stocks, almacenes de Novelda y Aspe, facturación oficial con **encadenamiento Veri*Factu** (SHA-256), enlace EDIFACT (`INVOIC` y `DESADV` para El Corte Inglés vía EDICOM), expedición con pesaje volumétrico y etiquetas para agencias **Tipsa y Nacex**, y firma biométrica en tablet. --- ### 2. Control de Fabricación y Pesaje Industrial en Planta * **Ubicación**: [`RAUL_ASENCIO\GESTION\FABRICACION\Fabricacion.dpr`](file:///c:/fuentes/proyectos%20delphi/RAUL_ASENCIO/GESTION/FABRICACION/Fabricacion.dpr) | [`Fabricacion.dproj`](file:///c:/fuentes/proyectos%20delphi/RAUL_ASENCIO/GESTION/FABRICACION/Fabricacion.dproj) * **Stack**: Delphi 11 Alexandria VCL táctil • FireDAC • Conexión serie RS-232 / USB COM. * **Componentes Clave**: * [`src\Hardware\uScaleSerial.pas`](file:///c:/fuentes/proyectos%20delphi/RAUL_ASENCIO/GESTION/FABRICACION/src/Hardware/uScaleSerial.pas) / [`uScaleConfig.pas`](file:///c:/fuentes/proyectos%20delphi/RAUL_ASENCIO/GESTION/FABRICACION/src/Hardware/uScaleConfig.pas): Driver de comunicación en tiempo real con balanzas industriales (captura de peso bruto, tara y estabilidad). * [`src\UI\frm_PlantaPesaje.pas`](file:///c:/fuentes/proyectos%20delphi/RAUL_ASENCIO/GESTION/FABRICACION/src/UI/frm_PlantaPesaje.pas): Pantalla táctil de pesaje guiado paso a paso con bandas de tolerancia por ingrediente (harina, mantequilla, yemas, fruta confitada, masa madre). * [`src\UI\frm_PlantaAmasado.pas`](file:///c:/fuentes/proyectos%20delphi/RAUL_ASENCIO/GESTION/FABRICACION/src/UI/frm_PlantaAmasado.pas): Monitorización de tiempos de amasado y fases de reposo/fermentación controlada. * [`src\Sync\uSyncEngine.pas`](file:///c:/fuentes/proyectos%20delphi/RAUL_ASENCIO/GESTION/FABRICACION/src/Sync/uSyncEngine.pas): Motor de sincronización bidireccional local-servidor para garantizar tolerancia a desconexiones de red en planta. --- ### 3. Suite de Pruebas Unitarias de Tiempos y Costes * **Ubicación**: [`RAUL_ASENCIO\GESTION\Test_CalculosTiempos.dpr`](file:///c:/fuentes/proyectos%20delphi/RAUL_ASENCIO/GESTION/Test_CalculosTiempos.dpr) * **Stack**: Delphi 11 Alexandria • Pure Console (`{$APPTYPE CONSOLE}`) • Test Runner sin dependencias externas. * **Misión**: Valida rigurosamente en 4 niveles (Tiers 1 a 4) el motor [`uControlTiemposCalcService.pas`](file:///c:/fuentes/proyectos%20delphi/RAUL_ASENCIO/GESTION/src/Logic/uControlTiemposCalcService.pas): * **Tier 1**: Cobertura funcional de cálculo de duración, tarifas operarias y costes directos. * **Tier 2**: Casos frontera (0 minutos, sub-minuto, turnos de 24 horas, cambio de medianoche, registros contiguos y huérfanos). * **Tier 3**: Escenarios complejos multi-operario y multi-sección simultáneos. * **Tier 4**: Escenario oficial de aceptación de amasado de panettones (5.5h a 88.50 €). --- ### 4. Portal E-Commerce Oficial (Next.js 16) * **Ubicación**: [`RAUL_ASENCIO\web_raulasencio_es`](file:///c:/fuentes/proyectos%20delphi/RAUL_ASENCIO/web_raulasencio_es) * **Stack**: Next.js 16.3.4 (App Router) • React 19.2.8 • Tailwind CSS v4 • TypeScript 5 • Lucide React • Script de despliegue optimizado para hosting Strato (`scripts/make_strato_ready.py`). * **Misión**: Tienda online de alta gama para la venta de panettones artesanales (bombón, milanés, chocolate y naranja, turrón), cestas de navidad y pastelería fina, con pasarelas de pago y generación de órdenes de compra destinadas a preparación y envío logístico. --- ### 5. Webapp Táctil de Obradores (Node.js Express) * **Ubicación**: [`RAUL_ASENCIO\GESTION\OBRADORES\webapp`](file:///c:/fuentes/proyectos%20delphi/RAUL_ASENCIO/GESTION/OBRADORES/webapp) * **Stack**: Node.js • Express • `mysql2/promise` • Frontend Web Táctil (Puerto 3005). * **Misión**: Terminal web ligero accesible desde tablets industriales a pie de horno y mesa de trabajo para que los maestros pasteleros consulten las recetas del día, cantidades escaladas según el lote programado y marquen el avance de cada hornada. --- ### 6. PWA de Calidad e Inocuidad Alimentaria IFS Food v8 (gestigest-calidad) * **Ubicación**: [`RAUL_ASENCIO\GESTION\WEBAPP_COM`](file:///c:/fuentes/proyectos%20delphi/RAUL_ASENCIO/GESTION/WEBAPP_COM) * **Stack**: Progressive Web App (Service Worker `sw.js`, `manifest.json`) • Backend dual Node.js Express / PHP fallback • JWT auth • MySQL. * **Misión**: Digitalización completa de los registros exigidos por la norma **IFS Food v8**: * Control diario y alarmas de termógrafos en cámaras frigoríficas y túneles de congelación. * Registro de higiene, limpieza y desinfección de superficies y maquinaria. * Puntos Críticos de Control (PCC): detección de metales, temperaturas de horneado y enfriamiento invertido de panettones. * Registro fotográfico y apertura de no conformidades inmediatas (CAPA). --- ### 7. Terminal de Control Horario y Fichajes Standalone * **Ubicación**: [`RAUL_ASENCIO\fichar.exe`](file:///c:/fuentes/proyectos%20delphi/RAUL_ASENCIO/fichar.exe) * **Misión**: Terminal independiente de control de accesos y jornada laboral situado en los accesos de personal de Novelda y Aspe, permitiendo el registro mediante PIN, tarjeta de proximidad RFID o código de barras sin necesidad de abrir la interfaz completa del ERP. --- ## 3. Matriz de Integración y Flujo de Información | De | Hacia | Canal / Mecanismo | Datos Transferidos | |:---|:---|:---|:---| | **E-Commerce Web** | **ERP Gestión** | MariaDB `pastelerias` | Pedidos web, direcciones de entrega, pasarelas de pago. | | **ERP Gestión** | **Fabricación** | MariaDB `pastelerias` | Órdenes de producción, lotes planificados, recetas activas. | | **Fabricación** | **ERP Gestión** | `uSyncEngine` / MariaDB | Pesos reales pesados por ingrediente, mermas de masa. | | **Obradores Web** | **ERP Gestión** | Express API / MariaDB | Estado de hornadas, bandejas terminadas, incidencias de obrador. | | **Calidad IFS** | **Auditoría ERP** | PWA WebApp / MariaDB | Registros de temperatura, inspecciones higiénicas, acciones correctivas. | | **ERP Gestión** | **AEAT** | SOAP / XML Veri*Factu | Huellas SHA-256 encadenadas y eventos inmutables. | | **ERP Gestión** | **Tipsa / Nacex** | API REST / WebServices | Expediciones, bultos, pesaje y etiquetas de código de barras. | | **ERP Gestión** | **EDICOM** | EDIFACT (INVOIC / DESADV) | Facturación y albaranes para El Corte Inglés. | --- ## 4. Guía de Referencia Rápida para Desarrolladores 1. **Para modificar el ERP Comercial y de Facturación**: Trabajar en [`RAUL_ASENCIO\GESTION`](file:///c:/fuentes/proyectos%20delphi/RAUL_ASENCIO/GESTION) y consultar [`GESTION\MAPA_DE_LA_APLICACION.md`](file:///c:/fuentes/proyectos%20delphi/RAUL_ASENCIO/GESTION/MAPA_DE_LA_APLICACION.md). 2. **Para ajustar balanzas o pesajes en obrador**: Abrir el proyecto [`RAUL_ASENCIO\GESTION\FABRICACION\Fabricacion.dpr`](file:///c:/fuentes/proyectos%20delphi/RAUL_ASENCIO/GESTION/FABRICACION/Fabricacion.dpr). 3. **Para cambios en la tienda online o diseño de panettones**: Entorno Node/Next en [`RAUL_ASENCIO\web_raulasencio_es`](file:///c:/fuentes/proyectos%20delphi/RAUL_ASENCIO/web_raulasencio_es). 4. **Para registros de higiene o termómetros IFS**: Modificar la PWA en [`RAUL_ASENCIO\GESTION\WEBAPP_COM`](file:///c:/fuentes/proyectos%20delphi/RAUL_ASENCIO/GESTION/WEBAPP_COM). 5. **Para validar cálculos matemáticos de tiempos**: Ejecutar [`RAUL_ASENCIO\GESTION\Test_CalculosTiempos.dpr`](file:///c:/fuentes/proyectos%20delphi/RAUL_ASENCIO/GESTION/Test_CalculosTiempos.dpr).