constec 0.4.0__tar.gz → 0.5.0__tar.gz

{constec-0.4.0 → constec-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: constec
-Version: 0.4.0
+Version: 0.5.0
 Summary: Base library for the Constec ecosystem - shared utilities, models, and namespace foundation
 License: MIT
 Project-URL: Homepage, https://github.com/TpmyCT/constec-python

constec-0.5.0/constec/db/migrations/0005_event.py

@@ -0,0 +1,46 @@
+# Generated manually on 2026-02-02 for automations schema
+
+import uuid
+from django.conf import settings
+from django.db import migrations, models
+import django.db.models.deletion
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('constec_db', '0004_rename_entities_company_cuit_idx_entities_company_e2c50f_idx_and_more'),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='Event',
+            fields=[
+                ('id', models.UUIDField(default=uuid.uuid4, editable=False, primary_key=True, serialize=False)),
+                ('created_at', models.DateTimeField(auto_now_add=True)),
+                ('updated_at', models.DateTimeField(auto_now=True)),
+                ('event_type', models.CharField(choices=[('notification', 'Notification'), ('automation', 'Automation')], max_length=50)),
+                ('title', models.CharField(max_length=255)),
+                ('description', models.TextField(blank=True)),
+                ('status', models.CharField(choices=[('active', 'Active'), ('paused', 'Paused'), ('completed', 'Completed'), ('failed', 'Failed'), ('cancelled', 'Cancelled')], default='active', max_length=20)),
+                ('recurrence_type', models.CharField(choices=[('punctual', 'Punctual'), ('periodic', 'Periodic')], help_text='Tipo de recurrencia: puntual (fechas específicas) o periódico', max_length=20)),
+                ('recurrence_config', models.JSONField(help_text='Configuración de recurrencia en formato JSON')),
+                ('config', models.JSONField(default=dict, help_text='Configuración específica según event_type (mensaje, URL, etc.)')),
+                ('next_execution_at', models.DateTimeField(blank=True, db_index=True, help_text='Próxima fecha/hora de ejecución calculada', null=True)),
+                ('last_executed_at', models.DateTimeField(blank=True, help_text='Última vez que se ejecutó', null=True)),
+                ('execution_count', models.IntegerField(default=0, help_text='Cantidad de veces que se ha ejecutado')),
+                ('company', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='constec_db.company')),
+                ('created_by', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='created_events', to=settings.AUTH_USER_MODEL)),
+            ],
+            options={
+                'db_table': '"automations"."events"',
+                'ordering': ['next_execution_at'],
+                'indexes': [
+                    models.Index(fields=['company', 'event_type'], name='automations_company_ebe85a_idx'),
+                    models.Index(fields=['status', 'next_execution_at'], name='automations_status_a3d45f_idx'),
+                    models.Index(fields=['recurrence_type'], name='automations_recurre_5d8b2c_idx'),
+                ],
+            },
+            bases=(models.Model,),
+        ),
+    ]

constec-0.5.0/constec/db/migrations/0006_automation_trigger_action_executionlog_notificationtemplate.py

@@ -0,0 +1,270 @@
+# Generated manually on 2026-02-03 for automations redesign (Fase 1)
+
+import uuid
+from django.conf import settings
+from django.db import migrations, models
+import django.db.models.deletion
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('constec_db', '0005_event'),
+    ]
+
+    operations = [
+        # Create Automation model
+        migrations.CreateModel(
+            name='Automation',
+            fields=[
+                ('id', models.UUIDField(default=uuid.uuid4, editable=False, primary_key=True, serialize=False)),
+                ('created_at', models.DateTimeField(auto_now_add=True)),
+                ('updated_at', models.DateTimeField(auto_now=True)),
+                ('name', models.CharField(max_length=255)),
+                ('description', models.TextField(blank=True)),
+                ('status', models.CharField(
+                    choices=[('active', 'Active'), ('paused', 'Paused'), ('archived', 'Archived'), ('draft', 'Draft')],
+                    default='draft',
+                    max_length=20
+                )),
+                ('execution_mode', models.CharField(
+                    choices=[('sequential', 'Sequential'), ('parallel', 'Parallel')],
+                    default='sequential',
+                    max_length=20
+                )),
+                ('max_executions', models.IntegerField(
+                    blank=True,
+                    help_text='Máximo número de ejecuciones (null = ilimitado)',
+                    null=True
+                )),
+                ('execution_count', models.IntegerField(default=0)),
+                ('on_error', models.CharField(
+                    choices=[('stop', 'Stop'), ('continue', 'Continue'), ('retry', 'Retry')],
+                    default='stop',
+                    max_length=20
+                )),
+                ('retry_count', models.IntegerField(default=3)),
+                ('retry_delay_seconds', models.IntegerField(default=60)),
+                ('last_executed_at', models.DateTimeField(blank=True, null=True)),
+                ('next_execution_at', models.DateTimeField(blank=True, db_index=True, null=True)),
+                ('tags', models.JSONField(blank=True, default=list)),
+                ('metadata', models.JSONField(blank=True, default=dict)),
+                ('company', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='constec_db.company')),
+                ('created_by', models.ForeignKey(
+                    on_delete=django.db.models.deletion.CASCADE,
+                    related_name='created_automations',
+                    to=settings.AUTH_USER_MODEL
+                )),
+            ],
+            options={
+                'db_table': '"automations"."automations"',
+                'ordering': ['-created_at'],
+                'indexes': [
+                    models.Index(fields=['company', 'status'], name='automations_auto_company_status_idx'),
+                    models.Index(fields=['status', 'next_execution_at'], name='automations_auto_status_next_idx'),
+                ],
+            },
+            bases=(models.Model,),
+        ),
+
+        # Create Trigger model
+        migrations.CreateModel(
+            name='Trigger',
+            fields=[
+                ('id', models.UUIDField(default=uuid.uuid4, editable=False, primary_key=True, serialize=False)),
+                ('created_at', models.DateTimeField(auto_now_add=True)),
+                ('updated_at', models.DateTimeField(auto_now=True)),
+                ('trigger_type', models.CharField(
+                    choices=[('schedule', 'Schedule'), ('webhook', 'Webhook'), ('manual', 'Manual'), ('event', 'Event')],
+                    max_length=20
+                )),
+                ('name', models.CharField(max_length=255)),
+                ('description', models.TextField(blank=True)),
+                ('is_enabled', models.BooleanField(default=True)),
+                ('config', models.JSONField(
+                    default=dict,
+                    help_text='Configuración específica del tipo de trigger (schedule, webhook, etc.)'
+                )),
+                ('last_triggered_at', models.DateTimeField(blank=True, null=True)),
+                ('trigger_count', models.IntegerField(default=0)),
+                ('priority', models.IntegerField(default=50, help_text='0-100, mayor = más prioridad')),
+                ('automation', models.ForeignKey(
+                    on_delete=django.db.models.deletion.CASCADE,
+                    related_name='triggers',
+                    to='constec_db.automation'
+                )),
+            ],
+            options={
+                'db_table': '"automations"."triggers"',
+                'ordering': ['-priority', 'created_at'],
+                'indexes': [
+                    models.Index(fields=['automation', 'is_enabled'], name='automations_trig_automation_enabled_idx'),
+                    models.Index(fields=['trigger_type', 'is_enabled'], name='automations_trig_type_enabled_idx'),
+                ],
+            },
+            bases=(models.Model,),
+        ),
+
+        # Create Action model
+        migrations.CreateModel(
+            name='Action',
+            fields=[
+                ('id', models.UUIDField(default=uuid.uuid4, editable=False, primary_key=True, serialize=False)),
+                ('created_at', models.DateTimeField(auto_now_add=True)),
+                ('updated_at', models.DateTimeField(auto_now=True)),
+                ('action_type', models.CharField(
+                    choices=[('notification', 'Notification'), ('webhook', 'Webhook'), ('batch_task', 'Batch Task'), ('flow_execution', 'Flow Execution')],
+                    max_length=20
+                )),
+                ('name', models.CharField(max_length=255)),
+                ('description', models.TextField(blank=True)),
+                ('is_enabled', models.BooleanField(default=True)),
+                ('order', models.IntegerField(default=0, help_text='Orden de ejecución')),
+                ('config', models.JSONField(
+                    default=dict,
+                    help_text='Configuración específica del tipo de acción'
+                )),
+                ('on_error', models.CharField(
+                    blank=True,
+                    choices=[('stop', 'Stop'), ('continue', 'Continue'), ('retry', 'Retry')],
+                    help_text='Override del on_error de la automation',
+                    max_length=20,
+                    null=True
+                )),
+                ('retry_count', models.IntegerField(
+                    blank=True,
+                    help_text='Override del retry_count de la automation',
+                    null=True
+                )),
+                ('condition', models.JSONField(
+                    blank=True,
+                    help_text='Condición JSONLogic para ejecutar esta acción',
+                    null=True
+                )),
+                ('last_executed_at', models.DateTimeField(blank=True, null=True)),
+                ('execution_count', models.IntegerField(default=0)),
+                ('success_count', models.IntegerField(default=0)),
+                ('failure_count', models.IntegerField(default=0)),
+                ('automation', models.ForeignKey(
+                    on_delete=django.db.models.deletion.CASCADE,
+                    related_name='actions',
+                    to='constec_db.automation'
+                )),
+            ],
+            options={
+                'db_table': '"automations"."actions"',
+                'ordering': ['order', 'created_at'],
+                'indexes': [
+                    models.Index(fields=['automation', 'order'], name='automations_act_automation_order_idx'),
+                    models.Index(fields=['action_type', 'is_enabled'], name='automations_act_type_enabled_idx'),
+                ],
+            },
+            bases=(models.Model,),
+        ),
+
+        # Create ExecutionLog model
+        migrations.CreateModel(
+            name='ExecutionLog',
+            fields=[
+                ('id', models.UUIDField(default=uuid.uuid4, editable=False, primary_key=True, serialize=False)),
+                ('created_at', models.DateTimeField(auto_now_add=True)),
+                ('updated_at', models.DateTimeField(auto_now=True)),
+                ('status', models.CharField(
+                    choices=[('pending', 'Pending'), ('running', 'Running'), ('completed', 'Completed'), ('failed', 'Failed'), ('partial', 'Partial')],
+                    default='pending',
+                    max_length=20
+                )),
+                ('triggered_by', models.CharField(
+                    choices=[('schedule', 'Schedule'), ('webhook', 'Webhook'), ('manual', 'Manual'), ('system', 'System')],
+                    max_length=20
+                )),
+                ('started_at', models.DateTimeField(auto_now_add=True)),
+                ('completed_at', models.DateTimeField(blank=True, null=True)),
+                ('duration_seconds', models.IntegerField(blank=True, null=True)),
+                ('execution_context', models.JSONField(
+                    default=dict,
+                    help_text='Variables y contexto disponible durante la ejecución'
+                )),
+                ('actions_total', models.IntegerField(default=0)),
+                ('actions_succeeded', models.IntegerField(default=0)),
+                ('actions_failed', models.IntegerField(default=0)),
+                ('actions_skipped', models.IntegerField(default=0)),
+                ('action_logs', models.JSONField(
+                    default=list,
+                    help_text='Array de logs detallados de cada acción ejecutada'
+                )),
+                ('error_message', models.TextField(blank=True)),
+                ('error_traceback', models.TextField(blank=True)),
+                ('automation', models.ForeignKey(
+                    on_delete=django.db.models.deletion.CASCADE,
+                    related_name='execution_logs',
+                    to='constec_db.automation'
+                )),
+                ('trigger', models.ForeignKey(
+                    blank=True,
+                    null=True,
+                    on_delete=django.db.models.deletion.SET_NULL,
+                    related_name='execution_logs',
+                    to='constec_db.trigger'
+                )),
+                ('triggered_by_user', models.ForeignKey(
+                    blank=True,
+                    null=True,
+                    on_delete=django.db.models.deletion.SET_NULL,
+                    related_name='triggered_executions',
+                    to=settings.AUTH_USER_MODEL
+                )),
+            ],
+            options={
+                'db_table': '"automations"."execution_logs"',
+                'ordering': ['-started_at'],
+                'indexes': [
+                    models.Index(fields=['automation', 'started_at'], name='automations_exec_automation_started_idx'),
+                    models.Index(fields=['status', 'started_at'], name='automations_exec_status_started_idx'),
+                    models.Index(fields=['triggered_by', 'started_at'], name='automations_exec_triggered_started_idx'),
+                ],
+            },
+            bases=(models.Model,),
+        ),
+
+        # Create NotificationTemplate model
+        migrations.CreateModel(
+            name='NotificationTemplate',
+            fields=[
+                ('id', models.UUIDField(default=uuid.uuid4, editable=False, primary_key=True, serialize=False)),
+                ('created_at', models.DateTimeField(auto_now_add=True)),
+                ('updated_at', models.DateTimeField(auto_now=True)),
+                ('name', models.CharField(max_length=255)),
+                ('description', models.TextField(blank=True)),
+                ('channel', models.CharField(
+                    choices=[('email', 'Email'), ('whatsapp', 'WhatsApp'), ('sms', 'SMS'), ('push', 'Push Notification')],
+                    max_length=20
+                )),
+                ('subject', models.CharField(
+                    blank=True,
+                    help_text='Asunto (solo para email)',
+                    max_length=255
+                )),
+                ('body', models.TextField(help_text='Cuerpo del mensaje con variables {{variable}}')),
+                ('variables', models.JSONField(
+                    default=list,
+                    help_text="Array de nombres de variables esperadas ['customer_name', 'amount']"
+                )),
+                ('is_active', models.BooleanField(default=True)),
+                ('company', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='constec_db.company')),
+                ('created_by', models.ForeignKey(
+                    on_delete=django.db.models.deletion.CASCADE,
+                    related_name='created_templates',
+                    to=settings.AUTH_USER_MODEL
+                )),
+            ],
+            options={
+                'db_table': '"automations"."notification_templates"',
+                'ordering': ['name'],
+                'indexes': [
+                    models.Index(fields=['company', 'channel', 'is_active'], name='automations_tmpl_company_channel_idx'),
+                ],
+            },
+            bases=(models.Model,),
+        ),
+    ]

{constec-0.4.0 → constec-0.5.0}/constec/db/models/__init__.py

@@ -41,6 +41,9 @@ ErpEntity = Entity
 from .flow import FlowTemplate, Flow
 from .session import Session, Message
 
+# Automations models (automations schema)
+from .automation import Event, Automation, Trigger, Action, ExecutionLog, NotificationTemplate
+
 
 __all__ = [
     # Base
@@ -89,4 +92,11 @@ __all__ = [
     'Flow',
     'Session',
     'Message',
+    # Automations (automations schema)
+    'Event',
+    'Automation',
+    'Trigger',
+    'Action',
+    'ExecutionLog',
+    'NotificationTemplate',
 ]

constec-0.5.0/constec/db/models/automation.py

@@ -0,0 +1,467 @@
+"""Automation models for event scheduling and task automation."""
+
+import uuid
+from django.db import models
+from django.core.exceptions import ValidationError
+from .base import UUIDModel
+from .company import Company
+from .user import User
+
+
+class Automation(UUIDModel):
+    """
+    Automatización principal basada en el patrón Trigger-Action.
+
+    Una automatización define un conjunto de acciones que se ejecutan cuando
+    se activan uno o más triggers (disparadores).
+    """
+
+    STATUS_CHOICES = [
+        ('active', 'Active'),
+        ('paused', 'Paused'),
+        ('archived', 'Archived'),
+        ('draft', 'Draft'),
+    ]
+
+    EXECUTION_MODE_CHOICES = [
+        ('sequential', 'Sequential'),
+        ('parallel', 'Parallel'),  # Futuro
+    ]
+
+    ON_ERROR_CHOICES = [
+        ('stop', 'Stop'),
+        ('continue', 'Continue'),
+        ('retry', 'Retry'),
+    ]
+
+    # FKs
+    company = models.ForeignKey(Company, on_delete=models.CASCADE, db_index=True)
+    created_by = models.ForeignKey(
+        User,
+        on_delete=models.CASCADE,
+        related_name='created_automations'
+    )
+
+    # Info básica
+    name = models.CharField(max_length=255)
+    description = models.TextField(blank=True)
+    status = models.CharField(max_length=20, choices=STATUS_CHOICES, default='draft')
+
+    # Configuración de ejecución
+    execution_mode = models.CharField(
+        max_length=20,
+        choices=EXECUTION_MODE_CHOICES,
+        default='sequential'
+    )
+    max_executions = models.IntegerField(
+        null=True,
+        blank=True,
+        help_text="Máximo número de ejecuciones (null = ilimitado)"
+    )
+    execution_count = models.IntegerField(default=0)
+
+    # Manejo de errores
+    on_error = models.CharField(
+        max_length=20,
+        choices=ON_ERROR_CHOICES,
+        default='stop'
+    )
+    retry_count = models.IntegerField(default=3)
+    retry_delay_seconds = models.IntegerField(default=60)
+
+    # Tracking de ejecución
+    last_executed_at = models.DateTimeField(null=True, blank=True)
+    next_execution_at = models.DateTimeField(null=True, blank=True, db_index=True)
+
+    # Metadata
+    tags = models.JSONField(default=list, blank=True)
+    metadata = models.JSONField(default=dict, blank=True)
+
+    class Meta:
+        db_table = '"automations"."automations"'
+        app_label = 'constec_db'
+        indexes = [
+            models.Index(fields=['company', 'status']),
+            models.Index(fields=['status', 'next_execution_at']),
+        ]
+        ordering = ['-created_at']
+
+    def __str__(self):
+        return f"{self.name} ({self.status})"
+
+
+class Trigger(UUIDModel):
+    """
+    Trigger (disparador) que inicia la ejecución de una automatización.
+
+    Tipos soportados:
+    - schedule: Programado por fecha/hora
+    - webhook: Disparado por HTTP POST
+    - manual: Ejecución manual del usuario
+    - event: Disparado por evento del sistema (futuro)
+    """
+
+    TRIGGER_TYPE_CHOICES = [
+        ('schedule', 'Schedule'),
+        ('webhook', 'Webhook'),
+        ('manual', 'Manual'),
+        ('event', 'Event'),
+    ]
+
+    # FKs
+    automation = models.ForeignKey(
+        Automation,
+        on_delete=models.CASCADE,
+        related_name='triggers'
+    )
+
+    # Info básica
+    trigger_type = models.CharField(max_length=20, choices=TRIGGER_TYPE_CHOICES)
+    name = models.CharField(max_length=255)
+    description = models.TextField(blank=True)
+    is_enabled = models.BooleanField(default=True)
+
+    # Configuración tipo-específica
+    config = models.JSONField(
+        default=dict,
+        help_text="Configuración específica del tipo de trigger (schedule, webhook, etc.)"
+    )
+
+    # Tracking
+    last_triggered_at = models.DateTimeField(null=True, blank=True)
+    trigger_count = models.IntegerField(default=0)
+    priority = models.IntegerField(default=50, help_text="0-100, mayor = más prioridad")
+
+    class Meta:
+        db_table = '"automations"."triggers"'
+        app_label = 'constec_db'
+        indexes = [
+            models.Index(fields=['automation', 'is_enabled']),
+            models.Index(fields=['trigger_type', 'is_enabled']),
+        ]
+        ordering = ['-priority', 'created_at']
+
+    def __str__(self):
+        return f"{self.trigger_type}: {self.name}"
+
+
+class Action(UUIDModel):
+    """
+    Acción que se ejecuta como parte de una automatización.
+
+    Tipos soportados:
+    - notification: Enviar notificación (email, SMS, WhatsApp, push)
+    - webhook: Ejecutar HTTP request
+    - batch_task: Ejecutar tarea batch (futuro)
+    - flow_execution: Ejecutar workflow LangGraph (futuro)
+    """
+
+    ACTION_TYPE_CHOICES = [
+        ('notification', 'Notification'),
+        ('webhook', 'Webhook'),
+        ('batch_task', 'Batch Task'),
+        ('flow_execution', 'Flow Execution'),
+    ]
+
+    ON_ERROR_CHOICES = [
+        ('stop', 'Stop'),
+        ('continue', 'Continue'),
+        ('retry', 'Retry'),
+    ]
+
+    # FKs
+    automation = models.ForeignKey(
+        Automation,
+        on_delete=models.CASCADE,
+        related_name='actions'
+    )
+
+    # Info básica
+    action_type = models.CharField(max_length=20, choices=ACTION_TYPE_CHOICES)
+    name = models.CharField(max_length=255)
+    description = models.TextField(blank=True)
+    is_enabled = models.BooleanField(default=True)
+    order = models.IntegerField(default=0, help_text="Orden de ejecución")
+
+    # Configuración tipo-específica
+    config = models.JSONField(
+        default=dict,
+        help_text="Configuración específica del tipo de acción"
+    )
+
+    # Manejo de errores (override de automation)
+    on_error = models.CharField(
+        max_length=20,
+        choices=ON_ERROR_CHOICES,
+        null=True,
+        blank=True,
+        help_text="Override del on_error de la automation"
+    )
+    retry_count = models.IntegerField(
+        null=True,
+        blank=True,
+        help_text="Override del retry_count de la automation"
+    )
+
+    # Ejecución condicional (futuro)
+    condition = models.JSONField(
+        null=True,
+        blank=True,
+        help_text="Condición JSONLogic para ejecutar esta acción"
+    )
+
+    # Tracking
+    last_executed_at = models.DateTimeField(null=True, blank=True)
+    execution_count = models.IntegerField(default=0)
+    success_count = models.IntegerField(default=0)
+    failure_count = models.IntegerField(default=0)
+
+    class Meta:
+        db_table = '"automations"."actions"'
+        app_label = 'constec_db'
+        indexes = [
+            models.Index(fields=['automation', 'order']),
+            models.Index(fields=['action_type', 'is_enabled']),
+        ]
+        ordering = ['order', 'created_at']
+
+    def __str__(self):
+        return f"{self.action_type}: {self.name}"
+
+
+class ExecutionLog(UUIDModel):
+    """
+    Log de ejecución de una automatización.
+
+    Registra cada ejecución con su estado, duración, errores y detalles
+    de cada acción ejecutada.
+    """
+
+    STATUS_CHOICES = [
+        ('pending', 'Pending'),
+        ('running', 'Running'),
+        ('completed', 'Completed'),
+        ('failed', 'Failed'),
+        ('partial', 'Partial'),  # Algunas acciones fallaron
+    ]
+
+    TRIGGERED_BY_CHOICES = [
+        ('schedule', 'Schedule'),
+        ('webhook', 'Webhook'),
+        ('manual', 'Manual'),
+        ('system', 'System'),
+    ]
+
+    # FKs
+    automation = models.ForeignKey(
+        Automation,
+        on_delete=models.CASCADE,
+        related_name='execution_logs'
+    )
+    trigger = models.ForeignKey(
+        Trigger,
+        on_delete=models.SET_NULL,
+        null=True,
+        blank=True,
+        related_name='execution_logs'
+    )
+    triggered_by_user = models.ForeignKey(
+        User,
+        on_delete=models.SET_NULL,
+        null=True,
+        blank=True,
+        related_name='triggered_executions'
+    )
+
+    # Estado
+    status = models.CharField(max_length=20, choices=STATUS_CHOICES, default='pending')
+    triggered_by = models.CharField(max_length=20, choices=TRIGGERED_BY_CHOICES)
+
+    # Timing
+    started_at = models.DateTimeField(auto_now_add=True)
+    completed_at = models.DateTimeField(null=True, blank=True)
+    duration_seconds = models.IntegerField(null=True, blank=True)
+
+    # Contexto de ejecución
+    execution_context = models.JSONField(
+        default=dict,
+        help_text="Variables y contexto disponible durante la ejecución"
+    )
+
+    # Estadísticas de acciones
+    actions_total = models.IntegerField(default=0)
+    actions_succeeded = models.IntegerField(default=0)
+    actions_failed = models.IntegerField(default=0)
+    actions_skipped = models.IntegerField(default=0)
+
+    # Log detallado de cada acción
+    action_logs = models.JSONField(
+        default=list,
+        help_text="Array de logs detallados de cada acción ejecutada"
+    )
+
+    # Errores
+    error_message = models.TextField(blank=True)
+    error_traceback = models.TextField(blank=True)
+
+    class Meta:
+        db_table = '"automations"."execution_logs"'
+        app_label = 'constec_db'
+        indexes = [
+            models.Index(fields=['automation', 'started_at']),
+            models.Index(fields=['status', 'started_at']),
+            models.Index(fields=['triggered_by', 'started_at']),
+        ]
+        ordering = ['-started_at']
+
+    def __str__(self):
+        return f"{self.automation.name} - {self.status} ({self.started_at})"
+
+
+class NotificationTemplate(UUIDModel):
+    """
+    Template para notificaciones reutilizables.
+
+    Soporta variables en formato {{variable_name}} que se reemplazan
+    en tiempo de ejecución.
+    """
+
+    CHANNEL_CHOICES = [
+        ('email', 'Email'),
+        ('whatsapp', 'WhatsApp'),
+        ('sms', 'SMS'),
+        ('push', 'Push Notification'),
+    ]
+
+    # FKs
+    company = models.ForeignKey(Company, on_delete=models.CASCADE, db_index=True)
+    created_by = models.ForeignKey(
+        User,
+        on_delete=models.CASCADE,
+        related_name='created_templates'
+    )
+
+    # Info básica
+    name = models.CharField(max_length=255)
+    description = models.TextField(blank=True)
+    channel = models.CharField(max_length=20, choices=CHANNEL_CHOICES)
+
+    # Contenido
+    subject = models.CharField(
+        max_length=255,
+        blank=True,
+        help_text="Asunto (solo para email)"
+    )
+    body = models.TextField(help_text="Cuerpo del mensaje con variables {{variable}}")
+
+    # Variables esperadas
+    variables = models.JSONField(
+        default=list,
+        help_text="Array de nombres de variables esperadas ['customer_name', 'amount']"
+    )
+
+    # Estado
+    is_active = models.BooleanField(default=True)
+
+    class Meta:
+        db_table = '"automations"."notification_templates"'
+        app_label = 'constec_db'
+        indexes = [
+            models.Index(fields=['company', 'channel', 'is_active']),
+        ]
+        ordering = ['name']
+
+    def __str__(self):
+        return f"{self.channel}: {self.name}"
+
+
+class Event(UUIDModel):
+    """
+    Evento programado con soporte para múltiples tipos y recurrencia flexible.
+
+    Tipos soportados:
+    - notification: Notificaciones programadas
+    - automation: Automatizaciones programadas (acciones HTTP, workflows, etc.)
+    """
+
+    EVENT_TYPE_CHOICES = [
+        ('notification', 'Notification'),
+        ('automation', 'Automation'),
+    ]
+
+    STATUS_CHOICES = [
+        ('active', 'Active'),         # Activo y programado
+        ('paused', 'Paused'),         # Pausado temporalmente
+        ('completed', 'Completed'),   # Completado (para puntuales)
+        ('failed', 'Failed'),         # Falló la última ejecución
+        ('cancelled', 'Cancelled'),   # Cancelado permanentemente
+    ]
+
+    RECURRENCE_TYPE_CHOICES = [
+        ('punctual', 'Punctual'),     # Una o más veces en fechas específicas
+        ('periodic', 'Periodic'),     # Recurrente
+    ]
+
+    # FKs
+    company = models.ForeignKey(Company, on_delete=models.CASCADE, db_index=True)
+
+    # Tipo de evento
+    event_type = models.CharField(max_length=50, choices=EVENT_TYPE_CHOICES)
+
+    # Info básica
+    title = models.CharField(max_length=255)
+    description = models.TextField(blank=True)
+    status = models.CharField(max_length=20, choices=STATUS_CHOICES, default='active')
+
+    # Recurrencia
+    recurrence_type = models.CharField(
+        max_length=20,
+        choices=RECURRENCE_TYPE_CHOICES,
+        help_text="Tipo de recurrencia: puntual (fechas específicas) o periódico"
+    )
+    recurrence_config = models.JSONField(
+        help_text="Configuración de recurrencia en formato JSON"
+    )
+
+    # Configuración específica del tipo de evento
+    config = models.JSONField(
+        default=dict,
+        help_text="Configuración específica según event_type (mensaje, URL, etc.)"
+    )
+
+    # Control de ejecución
+    next_execution_at = models.DateTimeField(
+        null=True,
+        blank=True,
+        db_index=True,
+        help_text="Próxima fecha/hora de ejecución calculada"
+    )
+    last_executed_at = models.DateTimeField(
+        null=True,
+        blank=True,
+        help_text="Última vez que se ejecutó"
+    )
+    execution_count = models.IntegerField(
+        default=0,
+        help_text="Cantidad de veces que se ha ejecutado"
+    )
+
+    # Auditoría
+    created_by = models.ForeignKey(
+        User,
+        on_delete=models.CASCADE,
+        related_name='created_events'
+    )
+
+    class Meta:
+        db_table = '"automations"."events"'
+        app_label = 'constec_db'
+        indexes = [
+            models.Index(fields=['company', 'event_type']),
+            models.Index(fields=['status', 'next_execution_at']),
+            models.Index(fields=['recurrence_type']),
+        ]
+        ordering = ['next_execution_at']
+
+    def __str__(self):
+        return f"{self.event_type}: {self.title}"

{constec-0.4.0 → constec-0.5.0}/constec.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: constec
-Version: 0.4.0
+Version: 0.5.0
 Summary: Base library for the Constec ecosystem - shared utilities, models, and namespace foundation
 License: MIT
 Project-URL: Homepage, https://github.com/TpmyCT/constec-python

{constec-0.4.0 → constec-0.5.0}/constec.egg-info/SOURCES.txt

@@ -13,8 +13,11 @@ constec/db/migrations/0001_initial.py
 constec/db/migrations/0002_module_level.py
 constec/db/migrations/0003_remove_module_level.py
 constec/db/migrations/0004_rename_entities_company_cuit_idx_entities_company_e2c50f_idx_and_more.py
+constec/db/migrations/0005_event.py
+constec/db/migrations/0006_automation_trigger_action_executionlog_notificationtemplate.py
 constec/db/migrations/__init__.py
 constec/db/models/__init__.py
+constec/db/models/automation.py
 constec/db/models/base.py
 constec/db/models/company.py
 constec/db/models/contact.py

{constec-0.4.0 → constec-0.5.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "constec"
-version = "0.4.0"
+version = "0.5.0"
 description = "Base library for the Constec ecosystem - shared utilities, models, and namespace foundation"
 readme = "README.md"
 requires-python = ">=3.9"