source: sicp/apps/simulacion/sigesic/models.py @ e79e549

# coding=utf-8
"""
Simulador Integral de Cadenas Productivas (SICP)

Copyleft (@) 2015 CENDITEL nodo Mérida - https://miv.cenditel.gob.ve/simulacion/
"""
## @package apps.simulacion.sigesic.models
#
# Clases y funciones a implementar en los modelos del SIGESIC. Los modelos representados pertenecen al
# Sistema de Gestión para la Industria y el Comercio (SIGESIC)
# @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
# @author <a href='http://www.cenditel.gob.ve'>Centro Nacional de Desarrollo e Investigación en Tecnologías Libres
# (CENDITEL) nodo Mérida - Venezuela</a>
# @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
# @date 02-06-2015
# @version 3.0.0

## Muestra el autor del script cuando es invocado
__author__ = "Ing. Roldan Vargas (rvargas at cenditel.gob.ve)"
## Muestra documentación breve sobre el script
__doc__    = "Clases y funciones a implementar en los modelos del SIGESIC. Los modelos representados pertenecen al " \
             "Sistema de Gestión para la Industria y el Comercio (SIGESIC)"

from django.db import models
from django.utils.translation import ugettext_lazy as _
from apps.comun.models import ModelReadOnly, Pais, Parroquia, CodigoAran, UnidadMedida, CodigoCiiu


class UnidadEconomica(ModelReadOnly):
    """!
    Clase que contiene el modelo de Unidades Económicas, para el acceso de datos registrados en el SIGESIC

    @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
    @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
    @date 03-06-2015
    @version 3.0.0
    """

    ## Número de Registro de Identificación Fiscal (R.I.F.)
    rif = models.CharField(max_length=10,primary_key=True)

    ## Nombre de la Unidad Económica registrado en el SENIAT
    nombre = models.CharField(max_length=255)

    ## Razón social de la Unidad Económica registrado en el SENIAT
    razon_social = models.CharField(max_length=255)

    ## Ciudad en donde se encuentra ubicada la Unidad Económica
    ciudad = models.CharField(max_length=100)

    ## Contiene la clave foránea de la parroquia en la que se encuentra ubicada la Unidad Económica
    parroquia = models.ForeignKey(Parroquia, db_column='parroquia_codigo')

    class Meta(ModelReadOnly.Meta):
        """!
        Metaclase de la clase UnidadEconomica

        @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
        @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
        @date 03-06-2015
        @version 3.0.0
        """

        ## Nombre de la tabla en la base de datos
        db_table = "unidadecon_unidad_economica"


class ActividadCIIU(ModelReadOnly):
    """!
    Clase que contiene el modelo que refiere a la actividad a la cual se dedica con mayor permanencia la empresa y
    que genera mayores ingresos.

    @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
    @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
    @date 19-10-2015
    @version 3.0.0
    """

    ue_rif = models.ForeignKey(UnidadEconomica, db_column='unidad_economica_rif')
    ciiu = models.ForeignKey(CodigoCiiu)
    descripcion = models.CharField(max_length=80)
    activo  = models.BooleanField()
    fecha_insercion = models.DateField()
    principal = models.BooleanField(default=False)


    class Meta:
        db_table = "unidadecon_actividad_ciiu"
        ordering = ["-principal","ciiu"]
        unique_together = (("ciiu", "ue_rif"))

    def __unicode__(self):
        return u'%s' % (self.ciiu)


class TipoSubunidad(ModelReadOnly):
    """!
    Clase que contiene el modelo para los tipos de Sub Unidades Económicas

    @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
    @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
    @date 08-06-2015
    @version 3.0.0
    """

    ## Identificador único del tipo de subunidad
    id = models.CharField(max_length=2, primary_key=True)

    ## Nombre de la Subunidad Económica
    nombre = models.CharField(max_length=35)

    def __unicode__(self):
        """!
        Método que muestra el nombre de la subunidad económica en UNICODE

        @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
        @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
        @date 08-06-2015
        @return Devuelve el nombre del tipo de subunidad económica en UNICODE
        """
        return self.nombre


    class Meta(ModelReadOnly.Meta):
        """!
        Metaclase de la clase TipoSubunidad

        @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
        @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
        @date 08-06-2015
        @version 3.0.0
        """

        ## Nombre de la tabla en la base de datos
        db_table = "unidadecon_tipo_subunidad"


class TipoActividad(ModelReadOnly):
    """!
    Clase que contiene el modelo para los tipos de actividades desempeñadas por las Unidades Económicas

    @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
    @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
    @date 08-06-2015
    @version 3.0.0
    """

    ## Nombre del tipo de actividad de desarrollada por la Subunidad Económica
    nombre = models.CharField(max_length=60)

    def __unicode__(self):
        """!
        Método que muestra el nombre del tipo de actividad en UNICODE

        @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
        @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
        @date 08-06-2015
        @return Devuelve el nombre del tipo de actividad económica en UNICODE
        """
        return self.nombre

    class Meta(ModelReadOnly.Meta):
        """!
        Metaclase de la clase TipoActividad

        @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
        @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
        @date 08-06-2015
        @version 3.0.0
        """

        ## Nombre de la tabla en la base de datos
        db_table = "unidadecon_tipo_actividad"


class TipoSucursal(ModelReadOnly):
    """!
    Clase que contiene el modelo para los tipos de sucursales disponibles en el SIGESIC

    @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
    @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
    @date 08-06-2015
    @version 3.0.0
    """

    ## Nombre del tipo de sucursal
    nombre = models.CharField(max_length=60)

    def __unicode__(self):
        """!
        Método que muestra el nombre del tipo de sucursal en UNICODE

        @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
        @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
        @date 08-06-2015
        @return Devuelve el nombre del tipo de sucursal en UNICODE
        """
        return self.nombre

    class Meta(ModelReadOnly.Meta):
        """!
        Metaclase de la clase TipoSucursal

        @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
        @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
        @date 08-06-2015
        @version 3.0.0
        """

        ## Nombre de la tabla en la base de datos
        db_table = "unidadecon_tipo_sucursal"


class TipoTenencia(ModelReadOnly):
    """!
    Clase que contiene el modelo para los distintos tipos de tenencia de la tierra u ocupación física de la
    Unidad Económica

    @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
    @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
    @date 08-06-2015
    @version 3.0.0
    """

    ## Nombre del tipo de tenencia de la tierra en donde se encuentra ubicada la Subunidad
    nombre = models.CharField(max_length=60)

    def __unicode__(self):
        """!
        Método que muestra el nombre del tipo de tenencia en UNICODE

        @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
        @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
        @date 08-06-2015
        @return Devuelve el nombre del tipo de tenencia en UNICODE
        """
        return self.nombre

    class Meta(ModelReadOnly.Meta):
        """!
        Metaclase de la clase TipoTenencia

        @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
        @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
        @date 08-06-2015
        @version 3.0.0
        """

        ## Nombre de la tabla en la base de datos
        db_table = "unidadecon_tipo_tenencia"


class TipoAmbitoIndustrial(ModelReadOnly):
    """!
    Clase que contiene el modelo para los tipos de Ámbito Industrial registrados en el SIGESIC

    @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
    @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
    @date 08-06-2015
    @version 3.0.0
    """

    ## Nombre del tipo de ámbito industrial de la subunidad económica
    nombre = models.CharField(max_length=60, unique=True)

    def __unicode__(self):
        """!
        Método que muestra el nombre del tipo de ámbito industrial en UNICODE

        @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
        @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
        @date 08-06-2015
        @return Devuelve el nombre del tipo de ámbito industrial en UNICODE
        """
        return self.nombre

    class Meta(ModelReadOnly.Meta):
        """!
        Metaclase de la clase TipoAmbitoIndustrial

        @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
        @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
        @date 08-06-2015
        @version 3.0.0
        """

        ## Nombre de la tabla en la base de datos
        db_table = "unidadecon_tipo_ambito_industrial"


class SubunidadEconomica(ModelReadOnly):
    """!
    Clase que contiene el modelo para las Sub Unidades Económicas de una Unidad Económica, los posibles valores son:
    (Su)cursal, (Se)de y (Pl)anta

    @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
    @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
    @date 08-06-2015
    @version 3.0.0
    """

    ## Establece la relación entre la subunidad económica y la unidad económica a la cual pertenece
    ue_rif = models.ForeignKey(UnidadEconomica, db_column='ue_rif')

    ## Nombre de la subunidad económica
    nombre = models.CharField(max_length=100)

    ## Establece la relación entre el tipo de subunidad y la subunidad económica
    tipo_subunidad = models.ForeignKey(TipoSubunidad, db_column='tipo_subunidad')

    ## Nombre de la ciudad en donde se encuentra ubicada la subunidad económica
    ciudad = models.CharField(max_length=100)

    ## Establece la relación entre la subunidad económica y la parroquia en donde se encuentra ubicada
    parroquia = models.ForeignKey(Parroquia, db_column='parroquia_codigo', related_name='+')

    ## Establece la relación entre la subunidad económica y los tipos de actividades que desempeña
    tipo_actividad = models.ManyToManyField(TipoActividad, db_table='unidadecon_subu_t_actividad')

    ## Establece la relación entre la subunidad económica y el tipo de sucursal
    tipo_sucursal = models.ManyToManyField(TipoSucursal, db_table='unidadecon_sucursal_t_tipo')

    ## Establece la relación entre la subunidad económica y el tipo de tenencia de la tierra en donde
    # se encuentra ubicada
    tipo_tenencia = models.ForeignKey(TipoTenencia)

    ## Datos de otros tipos de tenencia de la tierra
    tenencia_otra = models.CharField(max_length=100, null=True)

    ## Información sobre los metros cuadrados de terreno en donde se encuentra ubicada
    # la subunidad económica
    m2_terreno = models.FloatField()

    ## Información sobre los metros cuadrados de construcción en donde se encuentra ubicada
    # la subunidad económica
    m2_construccion = models.FloatField()

    ## Establece la relación entre la subunidad económica y el tipo de ámbito industrial al que pertenece
    tipo_ambito_industrial = models.ForeignKey(TipoAmbitoIndustrial, null=True)

    ## Información sobre otro tipo de ámbito industrial no especificado en el SIGESIC
    ambito_industrial_otro = models.CharField(max_length=100, null=True)

    ## Información sobre la autonomía electríca de la subunidad económica
    autonomia_electrica = models.BooleanField()

    ## Indica si la subunidad económica se encuentra activa o no
    activo = models.BooleanField()

    ## Información sobre el consumo eléctrico de la subunidad económica
    consumo_electrico = models.DecimalField(max_digits=20, decimal_places=2)

    ## Información sobre el consumo de agua de la subunidad económica
    consumo_agua = models.DecimalField(max_digits=20, decimal_places=2)

    ## Información sobre el consumo de gas de la subunidad económica
    consumo_gas = models.DecimalField(max_digits=20, decimal_places=2)

    def __unicode__(self):
        """!
        Método que muestra el nombre de la subunidad económica en UNICODE

        @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
        @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
        @date 08-06-2015
        @return Devuelve el nombre de la Subunidad Económica en UNICODE
        """
        return self.nombre

    class Meta(ModelReadOnly.Meta):
        """!
        Metaclase de la clase SubunidadEconomica

        @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
        @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
        @date 08-06-2015
        @version 3.0.0
        """

        ## Nombre de la tabla en la base de datos
        db_table = "unidadecon_subunidad_economica"


class Producto(ModelReadOnly):
    """!
    Clase que contiene el modelo para los productos de una Unidad Económica registrada en el SIGESIC

    @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
    @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
    @date 08-06-2015
    @version 3.0.0
    """

    ## Nombre del producto
    nombre = models.CharField(max_length=100, verbose_name=_(u'Nombre'))

    ## Datos sobre la marca del producto
    marca = models.CharField(max_length=100, verbose_name=_(u'Descripción'))

    ## Información sobre las especificaciones técnicas del producto
    esp_tec = models.TextField(verbose_name=_(u'Especificaciones Técnicas'))

    ## Establece la relación del producto con el código arancelario
    codigo_aran = models.ForeignKey(CodigoAran)

    ## Datos sobre el peso del producto
    peso = models.FloatField(_(u"Peso"))

    ## Establece la relación entre el producto y la planta que lo fabrica
    planta_id = models.ForeignKey(SubunidadEconomica)

    ## Establece la relación entre el producto y la unidad de medida
    unidad_medida = models.ForeignKey(UnidadMedida)

    ## Número de consumidores del producto
    n_consumidores = models.IntegerField()

    class Meta(ModelReadOnly.Meta):
        """!
        Metaclase de la clase Producto

        @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
        @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
        @date 08-06-2015
        @version 3.0.0
        """

        ## Nombre de la tabla en la base de datos
        db_table = "produccion_producto"


class ProduccionPreciosR(ModelReadOnly):
    """!
    Clase que contiene el modelo para los precios reales de la producción de un producto

    @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
    @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
    @date 11-06-2015
    @version 3.0.0
    """

    ## Establece la relación entre el producto y los precios del mismo en diferentes años
    producto_id = models.ForeignKey(Producto)

    ## Año de registro del producto
    anho = models.DateField()

    ## Cantidad producida del producto para el año registrado
    cant_producido = models.FloatField(_(u"Cantidad Producida"))

    ## Cantidad vendida del producto para el año registrado
    cant_vendido = models.FloatField(_(u"Cantidad Vendida"))

    ## Precio de venta del producto para el año registrado
    precio_venta = models.FloatField(_(u"Monto Facturado"))

    ## Cantidad del producto con destino nacional
    destino_nac = models.FloatField(_(u"Destino Nacional"))

    class Meta(ModelReadOnly.Meta):
        """!
        Metaclase de la clase ProduccionPreciosR

        @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
        @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
        @date 11-06-2015
        @version 3.0.0
        """

        ## Nombre de la tabla en la base de datos
        db_table = "produccion_produccion_precios_r"


class Insumo(ModelReadOnly):
    """!
    Clase que contiene el modelo para los Insumos necesarios para la producción

    @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
    @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
    @date 25-06-2015
    @version 3.0.0
    """

    ## Contiene el nombre del insumo
    nombre = models.CharField(max_length=100)

    ## Contiene los datos sobre la marca del insumo
    marca = models.CharField(max_length=100)

    ## Contiene los datos sobre las espcificaciones técnicas del insumo
    esp_tec = models.TextField()

    ## Código Arancelario del Insumo
    codigo_aran = models.ForeignKey(CodigoAran)

    ## Contiene el peso del insumo
    peso = models.FloatField()

    ## Referencia a la planta que registra el requerimiento del insumo
    planta_id = models.ForeignKey(SubunidadEconomica)

    ## Unidad de medida del insumo
    unidad_medida = models.ForeignKey(UnidadMedida)

    ## Contiene el número de proveedores que suministra del insumo
    n_proveedores = models.IntegerField()

    class Meta:
        """!
        Metaclase de la clase Insumo

        @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
        @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
        @date 25-06-2015
        @version 3.0.0
        """

        ## Nombre de la tabla en la base de datos
        db_table = "produccion_insumo"


class ConsumoPreciosR(ModelReadOnly):
    """!
    Clase que contiene el modelo para los precios reales de los insumos requeridos para la producción

    @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
    @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
    @date 25-06-2015
    @version 3.0.0
    """

    ## Establece la relación sobre los precios reales de consumo y el correspondiente insumo que lo genera
    insumo_id = models.ForeignKey(Insumo)

    ## Año de compra del insumo
    anho = models.DateField()

    ## Cantidad comprada a nivel nacional
    cant_comp_nac = models.FloatField()

    ## Cantidad comprada a nivel internacional (importada)
    cant_comp_imp = models.FloatField()

    ## Precio de adquisición nacional año concluido
    prec_adq_nac = models.FloatField()

    ## Costo de adquisición año concluido
    cost_adq = models.FloatField()

    class Meta:
        """!
        Metaclase de la clase ConsumoPreciosR

        @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
        @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
        @date 25-06-2015
        @version 3.0.0
        """

        ## Nombre de la tabla en la base de datos
        db_table = "produccion_consumo_precios_r"


class ProductoInsumo(ModelReadOnly):
    """!
    Clase que contiene el modelo para la relación entre los insumos y los productos

    @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
    @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
    @date 25-06-2015
    @version 3.0.0
    """

    ## Establece la relación con el Insumo
    insumo_id = models.ForeignKey(Insumo)

    ## Establece la relación con el producto
    producto_id = models.ForeignKey(Producto)

    ## Año registrado sobre la relación del producto y el insumo
    anho = models.PositiveSmallIntegerField()

    ## Cantidad de insumos de un producto
    cantidad = models.FloatField()

    ## Estatus que indica si el registro sobre la relación de un insumo a un producto se encuentra activo
    activo = models.BooleanField()

    ## Fecha en la que se registro la relación sobre el producto y el insumo
    fecha_insercion = models.DateTimeField()

    class Meta:
        """!
        Metaclase de la clase ProductoInsumo

        @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
        @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
        @date 25-06-2015
        @version 3.0.0
        """

        ## Nombre de la tabla en la base de datos
        db_table = "produccion_producto_t_insumo"


class Proveedor(ModelReadOnly):
    """!
    Clase que contiene el modelo para el registro de proveedores

    @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
    @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
    @date 25-06-2015
    @version 3.0.0
    """

    ## Nombre del proveedor
    nombre = models.CharField(max_length=100)

    ## Número de Registro de Identificación Fiscal (R.I.F.)
    rif = models.CharField(max_length=10)

    ## Relación sobre el pais de origen del proveedor
    pais_origen_id = models.ForeignKey(Pais, db_column='pais_origen_id')

    ## Relación sobre el pais de procedencia del proveedor
    pais_procedencia_id = models.ForeignKey(Pais, db_column='pais_procedencia_id', related_name='+')

    ## Información sobre la nacionalidad del proveedor. Los valores son (E)xtranjero, (N)acional
    nacional = models.CharField(max_length=1)

    ## Establece la relación con la planta que se abastece con los productos del proveedor
    planta_id = models.ForeignKey(SubunidadEconomica)

    def __unicode__(self):
        """!
        Método que muestra el nombre del proveedor en UNICODE

        @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
        @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
        @date 25-06-2015
        @return Devuelve el nombre del proveedor en UNICODE
        """
        return self.nombre

    class Meta:
        """!
        Metaclase de la clase Proveedor

        @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
        @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
        @date 25-06-2015
        @version 3.0.0
        """

        ## Nombre de la tabla en la base de datos
        db_table = 'cmproveedores_proveedor'


class ProveedorInsumo(ModelReadOnly):
    """!
    Clase que contiene el modelo para la relación entre los proveedores y los insumos

    @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
    @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
    @date 25-06-2015
    @version 3.0.0
    """

    ## Establece la relación con el proveedor del insumo
    proveedor_id = models.ForeignKey(Proveedor)

    ## Establece la relación con el insumo
    insumo_id = models.ForeignKey(Insumo)

    ## Información sobre el precio total de la cantidad comprada del insumo al proveedor
    comprado_r = models.DecimalField(max_digits=25, decimal_places=2)

    ## Año de compra del insumo al proveedor
    anho_r = models.IntegerField()

    ## Cantidad comprada del insumo al proveedor
    cantidad_comprada_r = models.DecimalField(max_digits=25, decimal_places=2)

    ## Unidad de medida del insumo comprado al proveedor
    unidad = models.ForeignKey(UnidadMedida)

    def __unicode__(self):
        """!
        Método que muestra el nombre del proveedor en UNICODE

        @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
        @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
        @date 25-06-2015
        @return Devuelve el nombre del proveedor en UNICODE
        """
        return self.Proveedor.__unicode__()

    class Meta:
        """!
        Metaclase de la clase ProveedorInsumo

        @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
        @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
        @date 25-06-2015
        @version 3.0.0
        """

        ## Nombre de la tabla en la base de datos
        db_table = 'cmproveedores_proveedorinsumo'


class TipoPersona(ModelReadOnly):
    """!
    Clase que contiene el modelo para los tipos de persona

    @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
    @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
    @date 22-12-2015
    @version 3.0.0
    """

    ## Nombre del tipo de persona
    nombre = models.CharField(max_length=15, unique=True)

    class Meta:
        """!
        Metaclase de la clase TipoPersona

        @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
        @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
        @date 22-12-2015
        @version 3.0.0
        """

        ## Nombre de la tabla en la base de datos
        db_table = "comun_tipo_persona"

    def __unicode__(self):
        """!
        Método que muestra el nombre del tipo de persona en UNICODE

        @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
        @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
        @date 22-12-2015
        @return Devuelve el nombre del tipo de persona en UNICODE
        """
        return u'%s' % (self.nombre)


class Socio(ModelReadOnly):
    """!
    Clase que contiene el modelo para los socios de una Unidad Economica

    @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
    @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
    @date 22-12-2015
    @version 3.0.0
    """

    ## Numero de RIF o pasaporte en caso de ser extranjero
    rif_pasaporte = models.CharField(max_length=30, null=True)

    ## Numero de RIF de la Unidad Economica
    ue_rif = models.ForeignKey(UnidadEconomica, db_column='unidad_economica_rif')

    ## Nombre de la persona asociada
    nombre = models.CharField(max_length=140)

    ## Nacionalidad de la persona asociada
    nacionalidad = models.CharField(max_length=1)

    ## Tipo de persona (Natural o Juridica)
    tipo_persona = models.ForeignKey(TipoPersona, db_column='tipo_persona_id')

    ## Porcentaje accionario dentro de la Unidad Economica
    porcentaje = models.FloatField()

    class Meta:
        """!
        Metaclase de la clase Socio

        @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
        @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
        @date 22-12-2015
        @version 3.0.0
        """

        ## Nombre de la tabla en la base de datos
        db_table = "unidadecon_socio"

    def __unicode__(self):
        """!
        Método que muestra los datos del socio en UNICODE

        @author Ing. Roldan Vargas (rvargas at cenditel.gob.ve)
        @copyright <a href='http://www.gnu.org/licenses/gpl-2.0.html'>GNU Public License versión 2 (GPLv2)</a>
        @date 22-12-2015
        @return Devuelve los datos del socio en UNICODE
        """
        return u'%s %s %s' % (self.rif_pasaporte,self.nombre,self.nacionalidad)