INDEX_plugin.md — Plugin.php

Archivo: src/Plugin.php | 672 líneas | Entry point del plugin UCRM

Propósito

Clase orquestadora principal. UCRM la invoca en cada evento (hook). Detecta si viene de HTTP o CLI y delega al handler correspondiente.

Namespace & Dependencias

namespace SmsNotifier
Depende de: PluginNotifierFacade, PluginOxxoNotifierFacade, TwilioNotifierFacade,
            NotificationDataFactory, Logger, OptionsManager, PluginDataValidator, UcrmApi

Propiedades

Propiedad	Tipo	Descripción
`$logger`	Logger	Logger del plugin
`$optionsManager`	OptionsManager	Carga config del plugin
`$pluginDataValidator`	PluginDataValidator	Valida configuración
`$pluginNotifierFacade`	PluginNotifierFacade	Fachada Stripe + Callbell
`$pluginOxxoNotifierFacade`	PluginOxxoNotifierFacade	Fachada OXXO
`$notifierFacade`	TwilioNotifierFacade	Fachada notificaciones base
`$notificationDataFactory`	NotificationDataFactory	Crea objetos NotificationData
`$ucrmApi`	UcrmApi (SDK)	Cliente API UCRM

Métodos

Método	Línea	Descripción
`__construct(...)`	58	Inicializa dependencias + UcrmApi con config
`run(): void`	84	Entry point: detecta SAPI (fpm/cli) y delega
`processCli(): void`	96	CLI: solo valida config
`processHttpRequest(): void`	104	HTTP: procesa payload JSON del webhook

Flujo de `processHttpRequest()` (L.104–670)

Paso 1 — Detectar tipo de payload (L.111–268)

Lee php://input. Si no tiene uuid → es webhook externo (Stripe/OXXO):

`type` en JSON	Línea	Acción
`customer_cash_balance_transaction.created` → `funded`	133	`pluginNotifierFacade->createPaymentIntent()`
`customer_cash_balance_transaction.created` → `applied_to_payment`	139	`pluginNotifierFacade->registerPaymentFromWebhook()`
`customer_cash_balance_transaction.created` → `unapplied_from_payment`	142	Log de transferencia cancelada
`payment_intent.succeeded`	166	`pluginNotifierFacade->registerPaymentFromIntent()`
`oxxo.retrieve`	172	`pluginOxxoNotifierFacade->getOxxoOrderStatus()` → responde JSON
`oxxo.request`	188	Flujo async: `createStripeReference()` → `createOxxoOrder()` → responde → `generateOxxoVoucher()` en background
`payout.failed`	150	Solo log
`payment_intent.partially_funded`	155	Solo log
`cash_balance.funds_available`	163	Solo log

Paso 2 — Payload con `uuid` → Webhook UCRM (L.270–670)

Construye NotificationData via factory, luego switch por eventName:

`eventName`	Línea	Acción
`payment.add`	297	Switch por `methodId` UUID → `notifierFacade->verifyPaymentActionToDo()`
`payment.delete/unmatch/edit`	418	`notifierFacade->verifyClientActionToDo()`
`client.edit`	423	Detecta cambios de tags/datos → `updatePasswordAntenaIfNeeded()`, `createStripeClient()`, `syncStripeCustomerData()`, `verifyClientActionToDo()`
`client.add`	539	Solo log
`service.edit`	542	`notifierFacade->verifyServiceActionToDo()` + `updatePasswordAntenaIfNeeded()`
`service.suspend`	552	`notifierFacade->verifyServiceActionToDo()`
`service.suspend_cancel`	555	`notifierFacade->verifyServiceActionToDo()`
`service.postpone`	558	`notifierFacade->verifyServiceActionToDo()`
`invoice.near_due`	561	`notifierFacade->notifyOverDue()`
`invoice.overdue`	564	`notifierFacade->notifyOverDue()`
`invoice.add`	569	`notifierFacade->verifyInvoiceActionToDo()`
`invoice.edit`	579	`notifierFacade->verifyInvoiceActionToDo()`
`invoice.add_draft`	582	`notifierFacade->verifyInvoiceActionToDo()`
`invoice.draft_approved`	585	`notifierFacade->verifyInvoiceActionToDo()`
`invoice.delete`	588	`notifierFacade->verifyInvoiceActionToDo()`
`job.add`	591	PATCH title en UCRM con prefijo `[NOTIFICACION-PENDIENTE]`
`job.edit`	599	Detecta cambios status/técnico/fecha → `notifierFacade->verifyJobActionToDo()`

UUIDs de Métodos de Pago (L.309–416)

UUID	Método
`11721cdf-...`	Cheque
`6efe0fa8-...`	Efectivo
`4145b5f5-...`	Transferencia bancaria
`78e84000-...`	PayPal
`6da98bb9-...`	Tarjeta de crédito PayPal
`1dd098fa-...`	Stripe Credit Card (detecta sub-tipo por metadata)
`b9e1e9d1-...`	Suscripción Stripe (tarjeta)
`939f7701-...`	Suscripción PayPal
`1c963e35-...`	MercadoPago
`d8c1eae9-...`	Personalizado
`72271b72-...`	Cortesía
`b01c0b35-...`	OXXO Pay
`93814765-...`	Tarjeta de crédito/débito

Tags de Cliente que disparan acciones (L.460–492)

Tag	Acción
`CREAR CLABE STRIPE`	`pluginNotifierFacade->createStripeClient(..., true)`
`CREAR CLIENTE STRIPE`	`pluginNotifierFacade->createStripeClient(..., false)`
`OBTENER PASSWORD ANTENA`	`pluginNotifierFacade->processClientPasswordAntenna()`
`isLead: true→false`	Auto-crea cliente en Stripe

Notas de implementación

job.edit con statusAfter==1 y $isPending en título dispara notificación
El flujo oxxo.request usa fastcgi_finish_request() para responder antes de generar el voucher
client.edit refresca datos del cliente vía UCRM API antes de sincronizar con CallBell

5.3 KiB Executable File Raw Permalink Blame History Unescape Escape