n8n-nodes-aivencerealtycrm 2.1.0 → 2.3.0

package/README.md

@@ -1,56 +1,69 @@
-# n8n-nodes-aivence-realty
+# n8n-nodes-aivencerealtycrm
 
-**Nodo n8n para AivenceRealty CRM (Laravel).**
+**Nodo comunitario n8n para AivenceRealty CRM inmobiliario.**
 
-Este paquete añade nodos para interactuar con el CRM inmobiliario AivenceRealty. Permite operaciones completas sobre Properties, Leads, Maintenance Orders, Contractors, y más.
+Este paquete añade nodos para interactuar con el CRM inmobiliario AivenceRealty. Permite operaciones completas sobre propiedades, leads, inquilinos, órdenes de mantenimiento, contratistas, pagos, políticas de aprobación y más.
+
+[![npm version](https://badge.fury.io/js/n8n-nodes-aivencerealtycrm.svg)](https://www.npmjs.com/package/n8n-nodes-aivencerealtycrm)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 ## 📦 Instalación
 
 ```bash
-npm install n8n-nodes-aivence-realty
+npm install n8n-nodes-aivencerealtycrm
 ```
 
-O desde la interfaz de n8n: **Community Nodes → Install** y escribir `n8n-nodes-aivence-realty`.
+O desde la interfaz de n8n: **Community Nodes → Install** y escribir `n8n-nodes-aivencerealtycrm`.
 
 ## 🔐 Configuración
 
 1. Obtén un **Bearer Token** desde tu panel de AivenceRealty
 2. En n8n, ve a **Credentials** y crea credenciales de tipo **AivenceRealty API**
 3. Introduce:
-   - **URL Base**: `https://realty.aivence.com` (o tu dominio)
+   - **URL Base**: La URL de tu instancia de AivenceRealty (ej: `https://tu-dominio.com`)
    - **Bearer Token**: Tu token de API
 4. Guarda las credenciales
 
-## 📋 Recursos Disponibles
-
-### 1. **Property** (Propiedades)
-- `list` - Listar todas las propiedades
-- `getSimilar` - Obtener propiedades similares
-- `getStatistics` - Estadísticas de propiedades
-
-### 2. **Lead** (Leads)
-- `list` - Listar leads
-- `create` - Crear nuevo lead (campos: nombre, telefono, mensaje)
-
-### 3. **Tenant** (Inquilinos)
-- `list` - Listar inquilinos
-
-### 4. **Maintenance Order** (Órdenes de Mantenimiento)
-- `checkDuplicate` - Verificar si existe orden duplicada
-- `create` - Crear nueva orden
-- `get` - Obtener orden por ID
-- `update` - Actualizar orden
-- `list` - Listar órdenes
-
-### 5. **Contractor** (Contratistas)
-- `findByCategory` - Buscar por categoría (fontanería, electricidad, etc.)
-- `findAlternatives` - Buscar contratistas alternativos
-
-### 6. **Monthly Cost** (Costos Mensuales)
-- `track` - Registrar costo mensual
-
-### 7. **WhatsApp**
-- `sendMessage` - Enviar mensaje por WhatsApp (Evolution API)
+## 📋 Recursos y Operaciones Disponibles
+
+### Tabla Completa de Operaciones (v2.3.0)
+
+| Recurso | Operación | Descripción | Método | Endpoint |
+|---------|-----------|-------------|--------|----------|
+| **Property** | list | Listar todas las propiedades | GET | `/api/v1/properties` |
+| | getSimilar | Obtener propiedades similares | POST | `/api/v1/properties/similar` |
+| | getStatistics | Estadísticas de propiedades | GET | `/api/v1/properties/statistics` |
+| **Lead** | list | Listar leads | GET | `/api/v1/leads` |
+| | create | Crear nuevo lead | POST | `/api/v1/leads` |
+| **Tenant** | list | Listar inquilinos | GET | `/api/v1/tenants` |
+| | get | Obtener inquilino por ID | GET | `/api/v1/tenants/{id}` |
+| | **validateExists** ⭐ | Validar si inquilino existe | GET | `/api/v1/tenants/{id}/exists` |
+| **Maintenance Request** | checkDuplicate | Verificar orden duplicada | POST | `/api/v1/maintenance-requests/check-duplicate` |
+| | create | Crear nueva orden | POST | `/api/v1/maintenance-requests` |
+| | get | Obtener orden por ID | GET | `/api/v1/maintenance-requests/{id}` |
+| | update | Actualizar orden | PUT | `/api/v1/maintenance-requests/{id}` |
+| | list | Listar órdenes | GET | `/api/v1/maintenance-requests` |
+| **Contractor** | findByCategory | Buscar por categoría | GET | `/api/v1/contractors/category/{category}` |
+| | findAlternatives | Buscar contratistas alternativos | POST | `/api/v1/contractors/alternatives` |
+| **Email** | send | Enviar email | POST | `/api/v1/emails/send` |
+| **Appointment** | create | Crear cita | POST | `/api/v1/appointments` |
+| | list | Listar citas | GET | `/api/v1/appointments` |
+| | get | Obtener cita por ID | GET | `/api/v1/appointments/{id}` |
+| | update | Actualizar cita | PUT | `/api/v1/appointments/{id}` |
+| **Calculator** | calculate | Calcular hipoteca/gastos | POST | `/api/v1/calculator` |
+| **Agent** | list | Listar agentes | GET | `/api/v1/agents` |
+| | get | Obtener agente por ID | GET | `/api/v1/agents/{id}` |
+| **Owner Expense** | create | Crear gasto de propietario | POST | `/api/v1/owner-expenses` |
+| | list | Listar gastos | GET | `/api/v1/owner-expenses` |
+| **Contractor Invoice** | create | Crear factura de contratista | POST | `/api/v1/contractor-invoices` |
+| | list | Listar facturas | GET | `/api/v1/contractor-invoices` |
+| | process | Procesar factura con OCR | POST | `/api/v1/contractor-invoices/process` |
+| **Payment Proof** ⭐ | **process** ⭐ | Procesar comprobante de pago | POST | `/api/v1/payments/verify-proof` |
+| **Automation** ⭐ | **logExecution** ⭐ | Registrar ejecución de workflow | POST | `/api/v1/automation/log` |
+| **Policy** ⭐ | **evaluate** ⭐ | Evaluar política de aprobación | POST | `/api/v1/policies/evaluate` |
+| **Notification** ⭐ | **send** ⭐ | Enviar notificación multi-canal | POST | `/api/v1/notifications/send` |
+
+⭐ = **Nuevas operaciones en v2.3.0**
 
 ## 🎯 Ejemplos de Uso
 
@@ -62,6 +75,7 @@ O desde la interfaz de n8n: **Community Nodes → Install** y escribir `n8n-node
   "operation": "create",
   "nombre": "Juan Pérez",
   "telefono": "5491112345678",
+  "email": "juan@example.com",
   "mensaje": "Busco departamento 2 ambientes en Palermo"
 }
 ```
@@ -70,7 +84,7 @@ O desde la interfaz de n8n: **Community Nodes → Install** y escribir `n8n-node
 
 ```json
 {
-  "resource": "maintenanceOrder",
+  "resource": "maintenanceRequest",
   "operation": "create",
   "clienteId": 123,
   "propiedadId": 456,
@@ -78,10 +92,102 @@ O desde la interfaz de n8n: **Community Nodes → Install** y escribir `n8n-node
   "categoria": "fontanería",
   "urgencia": "alta",
   "descripcionCorta": "Fuga de agua",
-  "descripcionDetallada": "Fuga en baño principal..."
+  "descripcionDetallada": "Fuga en baño principal que requiere atención inmediata"
+}
+```
+
+### Validar Existencia de Inquilino (v2.3.0)
+
+```json
+{
+  "resource": "tenant",
+  "operation": "validateExists",
+  "tenantId": "123"
+}
+```
+
+### Procesar Comprobante de Pago (v2.3.0)
+
+```json
+{
+  "resource": "paymentProof",
+  "operation": "process",
+  "ppTenantId": "123",
+  "ppOcrData": {
+    "amount": 45000,
+    "date": "2026-01-26",
+    "reference": "REF123"
+  },
+  "ppFileUrl": "https://storage.ejemplo.com/comprobante.pdf"
+}
+```
+
+### Registrar Ejecución de Workflow (v2.3.0)
+
+```json
+{
+  "resource": "automation",
+  "operation": "logExecution",
+  "autoWorkflowName": "ProcessPaymentProof",
+  "autoExecutionId": "exec_123456",
+  "autoStatus": "success",
+  "autoDocumentType": "payment_proof",
+  "autoMetadata": {
+    "tenant_id": 123,
+    "amount": 45000,
+    "processing_time_ms": 1523
+  }
+}
+```
+
+### Evaluar Política de Aprobación (v2.3.0)
+
+```json
+{
+  "resource": "policy",
+  "operation": "evaluate",
+  "policyType": "payment_proof",
+  "policyAmount": 45000,
+  "policyDocumentData": {
+    "amount": 45000,
+    "date": "2026-01-26",
+    "tenant_id": 123,
+    "lease_amount": 50000
+  }
+}
+```
+
+Respuesta de ejemplo:
+```json
+{
+  "approved": true,
+  "auto_approve": false,
+  "requires_review": true,
+  "reason": "Monto mayor a 50% del alquiler",
+  "approval_level": "manager"
 }
 ```
 
+### Enviar Notificación Multi-Canal (v2.3.0)
+
+```json
+{
+  "resource": "notification",
+  "operation": "send",
+  "notifRecipientType": "tenant",
+  "notifRecipientId": "123",
+  "notifChannel": "whatsapp",
+  "notifTemplateKey": "payment_received",
+  "notifVariables": {
+    "amount": 45000,
+    "property_address": "Av. Corrientes 1234",
+    "payment_date": "26/01/2026"
+  }
+}
+```
+
+Canales disponibles: `database` (in-app), `whatsapp`, `email`
+
 ## 🔧 Desarrollo Local
 
 ```bash
@@ -92,13 +198,13 @@ cd n8n-nodes-aivence-realty
 # Instalar dependencias
 npm install
 
-# Compilar
+# Compilar TypeScript
 npm run build
 
-# Vincular localmente
+# Vincular localmente para testing
 npm link
-cd ~/.n8n
-npm link n8n-nodes-aivence-realty
+cd ~/.n8n/custom
+npm link n8n-nodes-aivencerealtycrm
 
 # Iniciar n8n
 n8n start
@@ -106,22 +212,80 @@ n8n start
 
 ## 📝 Changelog
 
+### v2.3.0 (2026-01-26) - Automation & Policies
+- ⭐ **NUEVO:** Recurso `Payment Proof` con operación `process` para procesamiento automatizado de comprobantes de pago con OCR
+- ⭐ **NUEVO:** Recurso `Automation` con operación `logExecution` para registro centralizado de ejecuciones de workflows
+- ⭐ **NUEVO:** Recurso `Policy` con operación `evaluate` para evaluación automática de políticas de aprobación
+- ⭐ **NUEVO:** Recurso `Notification` con operación `send` para notificaciones multi-canal (database/whatsapp/email)
+- ⭐ **NUEVO:** Operación `validateExists` en recurso `Tenant` para validación rápida de existencia
+- ✅ 16 recursos totales
+- ✅ 40+ operaciones totales
+- ✅ Soporte completo para flujos de automatización con IA
+
+### v2.2.0 (2026-01-20)
+- ✅ Agregados recursos: Agent, Appointment, Calculator, OwnerExpense, ContractorInvoice
+- ✅ Operaciones de procesamiento de facturas con OCR
+- ✅ Sistema de cálculos hipotecarios
+
+### v2.1.0 (2025-12-15)
+- ✅ Agregado recurso Email
+- ✅ Mejoras en MaintenanceRequest
+- ✅ Validación mejorada de campos
+
+### v2.0.0 (2025-11-10)
+- ✅ Refactorización completa de la arquitectura
+- ✅ Mejoras de performance
+- ✅ Tipos TypeScript mejorados
+
 ### v0.1.0 (2025-10-09)
 - 🎉 Versión inicial
 - ✅ 7 recursos implementados
 - ✅ 15 operaciones totales
 - ✅ Integración completa con API Laravel
 
+## 🎓 Características Destacadas de v2.3.0
+
+### 🤖 Automatización Inteligente
+- **Procesamiento OCR:** Extrae datos de comprobantes de pago y facturas automáticamente
+- **Políticas Configurables:** Evalúa reglas de negocio sin código hardcoded
+- **Logging Centralizado:** Rastrea todas las ejecuciones de workflows desde N8N
+
+### 🔔 Notificaciones Multi-Canal
+- **Database:** Notificaciones in-app para el CRM
+- **WhatsApp:** Mensajes instantáneos vía Evolution API
+- **Email:** Notificaciones por correo electrónico
+- **Templates Dinámicos:** Variables reemplazables por template
+
+### 🛡️ Validación y Seguridad
+- Validación de existencia de entidades antes de operar
+- Políticas de aprobación automáticas por tipo de documento y monto
+- Trazabilidad completa de operaciones automatizadas
+
+## 🔗 Workflows N8N Recomendados
+
+Los siguientes workflows están optimizados para usar el nodo comunitario:
+
+1. **ProcessPaymentProof** - Procesamiento de comprobantes de pago con OCR → Policy → Notification
+2. **ProcessContractorInvoice** - Procesamiento de facturas de contratistas con OCR → Policy → Automation Log
+3. **ProcessOwnerExpense** - Procesamiento de gastos de propietarios → Policy → Notification
+4. **Router Central** - Routing inteligente de documentos según tipo detectado por IA
+
 ## 📄 Licencia
 
 MIT
 
 ## 👨‍💻 Autor
 
-**Federico Aivence** - [federico@aivence.com](mailto:federico@aivence.com)
+**Federico Aivence**
 
 ## 🔗 Links
 
-- [AivenceRealty CRM](https://realty.aivence.com)
 - [Repositorio GitHub](https://github.com/aivence/n8n-nodes-aivence-realty)
+- [npm Package](https://www.npmjs.com/package/n8n-nodes-aivencerealtycrm)
 - [Reportar Issues](https://github.com/aivence/n8n-nodes-aivence-realty/issues)
+
+## 🆘 Soporte
+
+Para soporte técnico o consultas:
+- 🐛 Issues: [GitHub Issues](https://github.com/aivence/n8n-nodes-aivence-realty/issues)
+- 📖 Documentación: Ver ejemplos en este README