eco-back 0.2.4__py3-none-any.whl → 0.2.5__py3-none-any.whl

eco_back/__init__.py

@@ -10,5 +10,6 @@ from . import api
 from . import documento
 from . import registro
 from . import utils
+from . import models
 
-__all__ = ["database", "api", "documento", "registro", "utils", "__version__"]
+__all__ = ["database", "api", "documento", "registro", "utils", "models", "__version__"]

eco_back/models/registro.py

@@ -0,0 +1,256 @@
+"""
+Modelos de registro y trazabilidad del sistema eco-back.
+
+Este módulo contiene los modelos de Django para gestionar registros de solicitudes,
+radicados, estados, trazabilidad y auditoría de procesos en el sistema UNP.
+"""
+from django.db import models
+from django.contrib.contenttypes.models import ContentType
+from django.db import connection
+import uuid
+from django.db.models import Max
+from django.db import transaction
+
+from eco_back.models.static import CanalSolicitud, EstadoEspecifico, FuenteSolicitud, TipoConsulta, TipoCorreccion, TipoEstudio, TipoRuta
+from eco_back.models.usuario import DatosBasicosUsuario
+
+
+#####    MODELOS DE REGISTRO BASE   #######
+
+class Registro(models.Model):
+    """
+    Modelo base para registros de solicitudes.
+    
+    Almacena la información general de un registro que puede ser de diferentes tipos
+    (personas, colectivos, etc.). Contiene los campos que definen la ruta, canal y 
+    tipo de estudio del registro.
+    
+    Attributes:
+        registro: Identificador único autonumérico del registro.
+        objects_id: ID del objeto relacionado (para relaciones genéricas).
+        content_type: Tipo de contenido al que pertenece el registro.
+        ruta: Ruta de atención asignada al registro.
+        canal: Canal por el cual se recibió la solicitud.
+        fuente: Fuente de origen de la solicitud.
+        tipo_estudio: Tipo de estudio o análisis a realizar.
+    
+    Methods:
+        get_next_registro: Obtiene el siguiente número de registro de la secuencia.
+    """
+    registro = models.AutoField(primary_key=True)
+    objects_id = models.CharField(blank=True, null=True, max_length=50)
+    content_type = models.ForeignKey(ContentType, on_delete=models.CASCADE, blank=True, null=True)
+    ruta = models.ForeignKey(TipoRuta, to_field='id_truta', on_delete=models.CASCADE, null=True, blank=True)
+    canal = models.ForeignKey(CanalSolicitud, to_field='id_csolicitud', on_delete=models.CASCADE, null=True, blank=True)
+    fuente = models.ForeignKey(FuenteSolicitud, to_field='id_fsolicitud', on_delete=models.CASCADE)
+    tipo_estudio = models.ForeignKey(TipoEstudio, to_field='id_estudio', on_delete=models.CASCADE, null=True, blank=True)
+
+    class Meta:
+        db_table = 'eco_reg_registro'
+        verbose_name_plural = 'Registro'
+
+    @classmethod
+    def get_next_registro(cls):
+        with connection.cursor() as cursor:
+            cursor.execute("SELECT nextval('eco_reg_registro_id_seq')")
+            row = cursor.fetchone()
+        return row[0]
+
+    def __str__(self):
+        return str(self.registro)
+    
+class Radicado(models.Model):
+    """
+    Modelo para radicados de solicitudes.
+    
+    Almacena el número de radicación de un registro, incluyendo la sede,
+    fecha de asignación y consecutivo para control de orden.
+    
+    Attributes:
+        id_radicado: Identificador único UUID del radicado.
+        registro: Relación con el registro base.
+        fecha_asignacion: Fecha en que se asignó el radicado.
+        numero_radicado: Número de radicación oficial.
+        sede: Sede donde se radicó la solicitud.
+        consecutivo: Número secuencial del radicado.
+    """
+    
+    class Meta:
+        db_table = 'eco_reg_radicado'
+        verbose_name_plural = 'Número de radicado'
+        ordering = ['consecutivo']  # esto asegura que siempre salgan en orden
+
+    def save(self, *args, **kwargs):
+        # Asigna el consecutivo solo si no se ha definido
+        if self.consecutivo is None:
+            ultimo = EstadoRegistro.objects.filter(registro=self.registro).aggregate(Max('consecutivo'))['consecutivo__max']
+            self.consecutivo = (ultimo or 0) + 1
+        super().save(*args, **kwargs)
+
+    def __str__(self):
+        return str(self.id_radicado)
+    
+class FechaTerminos(models.Model):
+    """
+    Modelo para fechas de términos de un registro.
+    
+    Almacena las fechas de inicio y fin de los términos de procesamiento
+    de una solicitud.
+    
+    Attributes:
+        id_fterminos: Identificador único UUID del registro.
+        fecha_inicio: Fecha de inicio de los términos.
+        fecha_fin: Fecha de finalización de los términos.
+        registro: Relación con el registro base.
+    """
+
+    class Meta:
+        db_table = 'eco_reg_fterminos'
+        verbose_name_plural = 'Fecha terminos'
+        ordering = ['-fecha_inicio']  # descendente: más reciente primero
+
+    def __str__(self):
+        return str(self.id_fterminos)
+
+class EstadoRegistro(models.Model):
+    """
+    Modelo para seguimiento de estados de un registro.
+    
+    Mantiene un historial de los estados por los que pasa un registro,
+    con numeración secuencial de los cambios de estado.
+    
+    Attributes:
+        id_estado: Identificador único UUID del estado.
+        estado: Estado específico asignado al registro.
+        registro: Relación con el registro base.
+        consecutivo: Número secuencial del cambio de estado.
+    """
+
+    class Meta:
+        db_table = 'eco_reg_estadoregistro'
+        verbose_name_plural = 'estados del registro'
+        ordering = ['consecutivo']  # esto asegura que siempre salgan en orden
+
+    def save(self, *args, **kwargs):
+        # Asigna el consecutivo solo si no se ha definido
+        if self.consecutivo is None:
+            ultimo = EstadoRegistro.objects.filter(registro=self.registro).aggregate(Max('consecutivo'))['consecutivo__max']
+            self.consecutivo = (ultimo or 0) + 1
+        super().save(*args, **kwargs)
+
+    def __str__(self):
+        return str(self.id_estado)
+
+
+#####    MODELOS DE TRAZABILIDAD Y AUDITORíA   #######
+
+class Trazabilidad(models.Model):
+    """
+    Modelo para trazabilidad de procesamiento de registros.
+    
+    Registra el movimiento y procesamiento de un registro a través del flujo,
+    incluyendo fechas de recepción, finalización, usuario que lo procesa
+    y estado actual.
+    
+    Attributes:
+        id_traza: Identificador único UUID del registro de trazabilidad.
+        fecha_recibido: Fecha y hora en que se recibió el registro.
+        fecha_finalizado: Fecha y hora en que se finalizó el procesamiento.
+        usuario: Usuario que procesó el registro.
+        registro: Relación con el registro base.
+        estado_trazabilidad: Indicador del estado de procesamiento.
+        estado_registro: Estado actual del registro.
+        observacion: Notas u observaciones sobre el procesamiento.
+    """
+    id_traza = models.UUIDField(primary_key=True, default=uuid.uuid4, editable=False)
+    fecha_recibido = models.DateTimeField(blank=True,null=True)
+    fecha_finalizado = models.DateTimeField(blank=True,null=True)
+    usuario = models.ForeignKey(DatosBasicosUsuario, to_field='id_busuario', on_delete=models.CASCADE,null=True,blank=True)
+    registro = models.ForeignKey(Registro, to_field='registro', on_delete=models.CASCADE,null=True,blank=True)
+    estado_trazabilidad = models.BooleanField(default=False)
+    estado_registro =  models.ForeignKey(EstadoEspecifico, to_field='id_eespecifico', on_delete=models.CASCADE,null=True,blank=True)
+    observacion = models.CharField(max_length=500, null=True)
+ 
+    class Meta:
+        db_table = 'eco_reg_trazabilidad'
+        verbose_name_plural = 'trazabilidad'
+        ordering = ['fecha_recibido']  # ascendente
+
+    def __str__(self):
+        return str(self.id_traza)
+
+def crear_trazabilidad_manual(**kwargs):
+    """
+    Función para crear registros de trazabilidad manualmente.
+    
+    Crea un nuevo registro de trazabilidad de forma atómica,
+    asignando automáticamente el próximo ID disponible.
+    
+    Args:
+        **kwargs: Parámetros para inicializar el modelo Trazabilidad.
+    
+    Returns:
+        Trazabilidad: Instancia del registro de trazabilidad creado.
+    """
+    with transaction.atomic():
+        ultimo_id = Trazabilidad.objects.aggregate(max_id=Max('id_traza'))['max_id'] or 0
+        nuevo_id = ultimo_id + 1
+
+        trazabilidad = Trazabilidad(
+            id_traza=nuevo_id,
+            **kwargs
+        )
+        trazabilidad.save()
+        return trazabilidad
+
+
+class CorreccionRegistro(models.Model):
+    """
+    Modelo para correcciones realizadas a registros.
+    
+    Almacena las correcciones que se realizan a un registro durante su
+    procesamiento, incluyendo el tipo de corrección y descripción.
+    
+    Attributes:
+        id_correccion: Identificador único UUID de la corrección.
+        trazabilidad: Relación con el registro de trazabilidad donde se realizó.
+        tipo: Tipo de corrección realizada.
+        descripcion: Descripción detallada de la corrección.
+    """
+
+    class Meta:
+        db_table = 'eco_reg_correccionregistro'
+        verbose_name_plural = 'Correcciones de registro'
+
+    def __str__(self):
+        return str(self.id_correccion)
+
+
+#####    MODELOS DE CONSULTAS   #######
+
+# Creación del modelo para guardar el historial de consultas sigob
+class HistorialConsultaAplicativos(models.Model):
+    """
+    Modelo para historial de consultas a aplicativos externos.
+    
+    Registra todas las consultas realizadas a aplicativos externos como SIGOB,
+    incluyendo fecha, tipo de consulta y usuario que la realizó.
+    
+    Attributes:
+        id_historial: Identificador único UUID del registro.
+        usuario: Usuario que realizó la consulta.
+        codigo_registro: Código o identificador del registro consultado.
+        fecha_consulta: Fecha y hora de la consulta (auto-asignada).
+        tipo_consulta: Tipo de consulta realizada.
+    """
+    id_historial = models.UUIDField(primary_key=True, default=uuid.uuid4, editable=False)
+    usuario = models.ForeignKey(DatosBasicosUsuario, to_field='id_busuario', on_delete=models.CASCADE)
+    codigo_registro = models.CharField(max_length=50)
+    fecha_consulta = models.DateTimeField(auto_now_add=True)
+    tipo_consulta = models.ForeignKey(TipoConsulta, to_field='id_tconsulta', on_delete=models.CASCADE, null=True, blank=True)
+    class Meta:
+        db_table = 'eco_reg_historial_consultas'
+        verbose_name_plural = 'Historial de consultas a SIGOB'
+
+    def __str__(self):
+        return str(self.id_historial)