Floreria ERP

Panel de negocio

El módulo apps/dashboard/casa-floral-erp-dashboard es el Dashboard Ejecutivo del ERP y la página de entrada para quien tiene acceso a él (/ERP/ redirige a /ERP/Dashboard/). Consolida indicadores de Pedidos, Finanzas, Inventario/Abastecimiento, Usuarios y WooCommerce mediante el contrato de proveedores de ERP.Core; es de solo lectura y nunca consulta tablas privadas de otros módulos.

Incluye un motor de KPIs con meta, tendencia, variación contra el período anterior y estado visual (verde/ámbar/rojo); un Dashboard Financiero con margen bruto, utilidad operacional y neta estimadas, rentabilidad y flujo de caja estimado, calculados a partir de parámetros configurables (costo semanal de flores, arriendo, sueldos, servicios, comisión Transbank e IVA); gráficos con Chart.js (vendorizado, sin CDN) para facturación diaria/semanal/mensual, ventas por vendedor, canal y categoría; insights automáticos de gestión; y actualización automática cada 5 minutos. El panel financiero y su configuración están restringidos a Administrador de Negocio y Superadministrador.

Versiones publicadas: docs/versiones-vigentes.md. El manifiesto de actualización está en updates/manifest.json.

Floreria — Flores · Café · Experiencias

Monorepo modular para la operación de Floreria, construido como plugins WordPress independientes con identidad, navegación, permisos, diseño y auditoría centralizados.

Módulos vigentes

Ruta	Plugin	Versión	Función
apps/core	ERP.Core	1.21.0	Prerrequisito, instalación inicial de módulos, rutas públicas /ERP (redirige al Dashboard si el usuario tiene acceso), menú de navegación global compacto entre módulos, lector y escritor de planillas .xlsx compartidos, sistema visual, actualizaciones Forgejo, integridad, auditoría y DBA.
apps/usuarios	Usuarios	1.6.0	Alta de integrantes, seis perfiles operativos y módulos habilitados por usuario.
apps/pedidos	Pedidos	1.5.4	Pedidos, producción, pagos, WooCommerce, arriendos y N8N. Sincroniza ventas, abonos, saldos y estados terminales con WooCommerce y Finanzas; agrega ventas por vendedor y categoría para el Dashboard Ejecutivo; importa ventas históricas desde Excel como pedidos reales.
apps/abastecimiento	Abastecimiento	0.13.1	Inventario, Kardex, informes, proveedores mantenibles y exportables, compras, recepciones y cuentas por pagar sincronizadas.
apps/finanzas	Finanzas	0.7.2	Ventas, cobros, cuentas configurables, ajustes auditados, traslados, gastos, obligaciones y conciliación de movimientos de Mercado Pago.
apps/dashboard	Panel de negocio	0.4.4	Dashboard Ejecutivo y Financiero: motor de KPIs, gráficos, panel financiero configurable e insights automáticos, con permisos granulares por perfil.
apps/recursos-humanos	Recursos Humanos	0.11.3	Fichas laborales con modalidad Full Time/Part Time, datos personales, bancarios y de remuneración protegidos, contratos, asistencia, vacaciones, permisos, documentos legales por trabajador, calendario visual de turnos con arrastrar y soltar (con horarios habituales recurrentes y feriados chilenos), y alertas operativas; importación y exportación de trabajadores desde/hacia Excel con coincidencia por RUT.
apps/limpieza	Limpieza	1.3.11	Reinicio independiente por módulo, incluidos datos laborales, traslados y obligaciones, y desinstalación controlada.
apps/reparacion-perfiles	Reparación de Perfiles	1.2.0	Diagnóstico y reparación de los seis perfiles vigentes del ERP.

Tecnologías: WordPress, PHP 7.4+, MySQL/MariaDB, WooCommerce, JavaScript y CSS. Los módulos no acceden directamente a las tablas privadas de otros módulos.

Documentación

Comenzar en el índice documental. Incluye manuales por rol, arquitectura, modelo de datos, APIs, permisos, integraciones, desarrollo, despliegue, rollback, soporte y pruebas.

Desarrollo y pruebas

node --test tests/*.test.js apps/*/tests/*.test.js
.\scripts\validate.ps1
.\apps\core\scripts\build-zip.ps1
.\apps\usuarios\scripts\build-zip.ps1
.\apps\pedidos\scripts\build-zip.ps1
.\apps\abastecimiento\scripts\build-zip.ps1
.\apps\finanzas\scripts\build-zip.ps1
.\apps\dashboard\scripts\build-zip.ps1
.\apps\recursos-humanos\scripts\build-zip.ps1
.\apps\limpieza\scripts\build-zip.ps1
.\apps\reparacion-perfiles\scripts\build-zip.ps1

Orden de instalación: ERP.Core, Usuarios y luego módulos operativos. No guardar secretos, credenciales ni datos productivos en Git. Cada cambio de plugin incrementa versión; cada cambio de datos incrementa además la versión de esquema y debe pasar por la auditoría de ERP.Core.