Casa Floral Order Manager

Plugin WordPress para gestionar pedidos programados de Casa Floral con integracion WooCommerce. Permite crear, listar, editar, consultar, pagar parcialmente, anular con trazabilidad y analizar pedidos internos con delivery o retiro en tienda.

Estado del proyecto

Version actual del plugin: 0.1.2

Build actual: 2026072401

Version de base de datos: 0.1.1

Funcionalidades disponibles:

• Plugin instalable desde casa-floral-order-manager.zip.
• Verificacion visual cuando WooCommerce no esta activo.
• Creacion de tablas propias con prefijo WordPress mas cfom_.
• Roles cfom_seller y cfom_manager.
• Capabilities propias para acceso, creacion, visualizacion, edicion, pagos, anulacion, dashboard, usuarios y configuracion.
• Entrada operativa principal en /pedidos, sin depender de /wp-admin para vendedores.
• Login propio del plugin con personalizacion visual basica desde configuracion.
• Rutas frontend protegidas para dashboard, nuevo pedido, listado, detalle, edicion, impresion, usuarios y configuracion.
• Menu administrativo Casa Floral disponible para administradores como respaldo operativo.
• Entrada por defecto al dashboard para administradores y al listado para vendedores.
• Interfaz interna tipo aplicacion, separada visualmente del escritorio WordPress.
• Ocultamiento de barra superior WordPress dentro de /pedidos y ocultamiento opcional de chrome admin para vendedores en pantallas cfom*.
• Creacion real de pedidos programados desde Nuevo pedido.
• Busqueda de productos WooCommerce activos por nombre, SKU o ID.
• Creacion opcional de pedidos WooCommerce reales desde el flujo interno.
• Referencia cruzada wc_order_id y metadata _cfom_* en pedidos WooCommerce.
• Reintento manual para crear pedido WooCommerce desde la ficha interna.
• Registro de un item principal por pedido.
• Registro de abono inicial cuando corresponde.
• Calculo de total, abono, total pagado, saldo y estado de pago.
• Listado operativo de pedidos con busqueda y filtros.
• Cambio rapido de estado operativo segun permisos.
• Vista completa de detalle del pedido.
• Ficha imprimible protegida para operacion interna.
• Edicion completa de datos operativos del pedido.
• Registro de pagos adicionales.
• Anulacion segura con motivo obligatorio, nota interna y auditoria.
• Dashboard con metricas reales y estructura local preparada para graficos.
• Gestion funcional de usuarios existentes de WordPress para asignar o quitar roles Casa Floral.
• Auditoria de creacion, edicion, pagos, cambios de estado y anulaciones.
• Documentacion funcional y tecnica en docs/.

No implementado todavia:

• Sincronizacion posterior de cambios entre pedidos internos y pedidos WooCommerce ya creados.
• Multiples productos por pedido.
• Exportacion CSV funcional.
• Configuracion avanzada editable de horarios, zonas, estados y medios de pago.
• Graficos avanzados con libreria local incluida.
• Pruebas automatizadas.

Requisitos

• WordPress 6.0 o superior.
• PHP 7.4 o superior.
• WooCommerce 7.0 o superior activo para busqueda y seleccion de productos.
• Base de datos MySQL o MariaDB compatible con WordPress.
• Usuario con permisos de administrador para instalar, activar y configurar.

Instalacion rapida

1. Descarga o clona este repositorio.
2. Usa el archivo casa-floral-order-manager.zip.
3. En WordPress, entra a Plugins > Anadir nuevo > Subir plugin.
4. Sube el ZIP.
5. Activa el plugin.
6. Verifica que WooCommerce este activo.
7. Visita /pedidos.
8. Ingresa con un usuario WordPress autorizado como Vendedor Casa Floral o Administrador Casa Floral.

Generar ZIP instalable

Desde la raiz del repositorio:

.\scripts\build-zip.ps1

El script genera casa-floral-order-manager.zip con rutas internas usando slash /, requisito importante para instalacion correcta en WordPress.

Documentacion

• Guia de usuario final
• Guia tecnica para desarrolladores
• Arquitectura del plugin
• Base de datos
• Seguridad y permisos
• Instalacion, despliegue y desinstalacion
• Plan de pruebas recomendado
• Roadmap tecnico

Acceso operativo

La URL principal del sistema es:

/pedidos

Rutas disponibles:

/pedidos
/pedidos/nuevo
/pedidos/listado
/pedidos/detalle/{id}
/pedidos/editar/{id}
/pedidos/imprimir/{id}
/pedidos/dashboard
/pedidos/usuarios
/pedidos/configuracion

Si el usuario no esta autenticado, /pedidos muestra el login propio del plugin y autentica con wp_signon(). El logout vuelve a /pedidos usando URL con nonce. Los vendedores Casa Floral que intentan entrar a /wp-admin son redirigidos a /pedidos/listado, salvo llamadas AJAX.

Integracion WooCommerce

La opcion cfom_create_wc_orders controla si al crear un pedido interno se crea tambien un pedido WooCommerce real.

• no: solo se crea el pedido interno.
• yes: se crea el pedido interno y luego se intenta crear el pedido WooCommerce.

Si WooCommerce falla, el pedido interno se conserva, se registra nota/auditoria y se puede reintentar desde la ficha del pedido con el boton Crear pedido WooCommerce.

La referencia cruzada se guarda en:

• cfom_orders.wc_order_id.
• Metadata del pedido WooCommerce: _cfom_order_id, _cfom_order_number, _cfom_source, _cfom_created_by, _cfom_delivery_type, _cfom_scheduled_date, _cfom_scheduled_time, datos de pago y saldo.

Estructura principal

casa-floral-order-manager/
|-- casa-floral-order-manager.php
|-- uninstall.php
|-- readme.txt
|-- includes/
|-- admin/
|-- assets/
`-- templates/
docs/
scripts/
README.md
casa-floral-order-manager.zip

Reglas importantes

• No modificar tablas nativas de WordPress ni WooCommerce.
• Usar APIs oficiales de WordPress y WooCommerce cuando corresponda.
• Mantener datos operativos en tablas propias cfom_.
• No borrar datos al desactivar.
• Borrar datos al desinstalar solo si cfom_delete_data_on_uninstall = yes.
• Validar nonce y capability en toda accion sensible.
• Sanitizar entradas y escapar salidas.
• No usar textos o branding ajenos a Casa Floral.

Repositorio

https://git.florerialaverbena.cl/ffortuno/CasaFloral.Pedidos