guillermo-duran/guibo

appdirs==1.4.3
APScheduler==3.6.3
argon2-cffi==21.3.0
argon2-cffi-bindings==21.2.0
asgiref==3.4.1
astroid==1.6.2
async-generator==1.10       
atomicwrites==1.4.1
attrs==22.2.0
autopep8==1.5.7
backcall==0.1.0
backports.zoneinfo==0.2.1   
bcrypt==3.2.0
bleach==4.1.0
blessings==1.6.1
bpython==0.18
cachetools==4.2.2
certifi==2017.11.5
cffi==1.15.0
chardet==3.0.4
charset-normalizer==2.0.8
click==8.0.4
colorama==0.3.9
contextlib2==21.6.0
contextvars==2.4
croniter==0.3.15
cryptography==36.0.0
curtsies==0.3.0
cycler==0.11.0
Cython==0.27.3
dataclasses==0.8
decorator==4.3.0
defusedxml==0.7.1
dj-database-url==0.5.0
Django==3.2.6
django-braces==1.11.0
django-cors-headers==2.0.2
django-mobile==0.7.0
django-mssql==1.8
django-oauth-toolkit==0.11.0
django-pymssql==1.7.1
djangorestframework==3.5.4
docopt==0.4.0
docx-mailmerge==0.4.0
entrypoints==0.4
et-xmlfile==1.0.1
fabric==3.0.0
fastapi==0.83.0
Flask==2.0.3
gitdb2==2.0.4
GitPython==2.1.11
google-api-python-client==1.6.2
greenlet==0.4.13
gunicorn==20.1.0
h11==0.13.0
http-ece==1.1.0
httplib2==0.10.3
idna==3.10
immutables==0.19
importlib-metadata==4.8.3
importlib-resources==5.4.0
iniconfig==1.1.1
invoke==2.0.0
ipykernel==5.5.6
ipython==7.16.3
ipython-genutils==0.2.0
isort==4.3.4
itsdangerous==2.0.1
jdcal==1.3
jedi==0.12.0
Jinja2==3.0.3
joblib==1.1.1
jsmin==3.0.0
jsonpickle==0.9.6
jsonschema==3.2.0
jupyter-client==7.1.2
jupyter-core==4.9.2
jupyterlab-pygments==0.1.2
kiwisolver==1.3.1
lazy-object-proxy==1.3.1
lxml==3.7.3
mailchimp==2.0.9
mailchimp3==2.0.18
MarkupSafe==2.0.1
matplotlib==3.3.4
mccabe==0.6.1
mistune==0.8.4
mpmath==1.2.1
nbclient==0.5.9
nbconvert==6.0.7
nbformat==5.1.3
nest-asyncio==1.5.6
notebook==6.4.10
numpy==1.19.5
oauth2client==4.0.0
oauthlib==1.1.2
olefile==0.44
openpyxl==2.4.2
packaging==16.8
pandas==1.1.5
pandocfilters==1.5.0
paramiko==2.9.2
parcel==0.2.2
parso==0.2.0
pdfkit==0.6.1
pexpect==4.6.0
pickleshare==0.7.4
Pillow==8.4.0
pluggy==1.0.0
prometheus-client==0.17.0
prompt-toolkit==3.0.36
ptyprocess==0.6.0
py==1.11.0
py-vapid==1.8.2
pyasn1==0.2.2
pyasn1-modules==0.0.8
pyChart.JS==0.3.0
pycodestyle==2.7.0
pycparser==2.21
pydantic==1.9.2
Pygments==2.14.0
pylint==1.8.3
pymssql==2.1.4
PyMySQL==1.0.2
PyNaCl==1.5.0
pyparsing==2.2.0
pyrsistent==0.18.0
pytest==7.0.1
python-dateutil==2.8.2
python-decouple==3.4
python-telegram-bot==13.7
pytz==2021.1
pytz-deprecation-shim==0.1.0.post0
pywebpush==1.10.2
pywin32==305
pywinpty==1.1.6
pyzmq==25.1.0
qrcode==6.0
requests==2.26.0
rsa==3.4.2
scikit-learn==0.24.2
scipy==1.5.4
selenium==3.141.0
Send2Trash==1.8.2
setuptools-git==1.2
simplegeneric==0.8.1
six==1.16.0
sklearn==0.0.post5
smmap2==2.0.4
sniffio==1.2.0
sodapy==2.1.1
sqlparse==0.4.2
sshtunnel==0.4.0
starlette==0.19.1
suds-jurko==0.6
sympy==1.9
terminado==0.12.1
testpath==0.6.0
threadpoolctl==3.1.0
toml==0.10.2
tomli==1.2.3
tornado==6.1
traitlets==4.3.2
typing==3.6.4
typing_extensions==4.1.1
tzdata==2023.3
tzlocal==4.2
Unipath==1.1
uritemplate==3.0.0
urllib3==1.22
uvicorn==0.16.0
wcwidth==0.1.7
webencodings==0.5.1
Werkzeug==2.0.3
whitenoise==5.3.0
wkhtmltopdf==0.2
wrapt==1.10.11
zipp==3.6.0

Rule

Eres un agente de desarrollo backend llamado "GuiBo" que genera código y soluciones para un sistema empresarial basado en Django 3.2.6 usando Python 3.6.4. El entorno está centrado en una estructura modular y extensible, con componentes principales agrupados en carpetas como `core/core_modules`, `base`, `product`, y `ext`. Características clave del entorno: * **Versión de Python**: 3.6.4 * **Framework backend**: Django 3.2.6 * **Bases de datos**:

  * Relacional: Microsoft SQL Server (driver: `django-mssql`, `pymssql`)
  * No relacional: MongoDB (configurado vía `DB_MONGO_*`)
* **ORM**: Django ORM * **Servicios REST**: djangorestframework 3.5.4 * **Autenticación**: OAuth2 con `django-oauth-toolkit` y `rest_framework` * **Websockets**: Django Channels + Redis * **Ruta base del proyecto**: `core2/` * **Rutas personalizadas y carga de apps**: el sistema usa `sys.path.insert()` para registrar rutas como:

  * `core/core_modules/` → módulos principales del sistema
  * `product/<modulo>/modules/` → extensiones de productos
  * `ext/` → personalizaciones externas
* **Internacionalización**: idioma por defecto `es-es`, zona horaria `America/Bogota` * **Templates**: Django Templates, con rutas añadidas por producto y módulo. * **Estructura de carpetas clave**:

  * `core/base/` → configuración principal y lógica base
  * `core/core_modules/` → funcionalidades internas como `analytics`, `audit`, `engine`, `query_manager`, `teams`, `userprofiles`, etc.
  * `core/webservices/` → servicios API personalizados
  * `static_files/`, `templates/` → frontend basado en Django Templates
* **Dependencias adicionales**: `apscheduler`, `argon2`, `cryptography`, `fabric`, `celery`, `channels`, `corsheaders`, etc. * **Rutas configuradas dinámicamente**: usando `INSTALLED_PRODUCTS` y `INSTALLED_APPS` para registrar módulos de forma automatizada en `product/`. ### Personalizaciones del sistema – Carpeta `ext/` El directorio `ext/` contiene las personalizaciones del sistema, organizadas en varios subdirectorios clave: #### `ext/modules/` Aquí se alojan **módulos nuevos o extendidos** del `core` o `product`. * `models.py`: Definición del modelo (solo si el módulo es nuevo) . * `models_extra_fields.py`: Agrega campos a modelos existentes (core o product) . * `meta/relationships.py`: Define relaciones entre módulos (subpaneles) . * `templatetags/[modulo]_filters.py`: Filtros de templates . * `events.py`: Hooks `before_save` y `after_save` (LogicHooks) . * `menu_actions.py`: Rutas del menú (asociado a `base_dictionary.py`) . * `views.py`: Vistas sobrescritas (copiar solo funciones necesarias) . * `models_extra_behavior.py`: Define texto bajo el título de la vista de detalle.  #### `ext/companies/` Contiene personalizaciones específicas por compañía.  * Directorios: Uno por compañía (`ext/companies/[cod_empresa]/`).

  * `language/enums.py`: Listas o enums personalizadas del sistema.
  Ejemplo:
    from django.utils.translation import ugettext as _
    from collections import OrderedDict
    global_enums = {}

    global_enums['tipo_persona_list'] = OrderedDict([
        ('', ''),
        ('juridica', _('Jurídica')),
        ('natural', _('Natural')),
    ])

  * `viewdefs/[modulo]/`: Vistas personalizadas del módulo:

    * `createview.py`, `detailview.py`, `editview.py`, `listview.py`, `inline_createview.py`, `searchdef.py`, `subpanel_listview.py`.

#### `ext/base/`
  * `base_dictionary.py`: En este archivo se registra los diferentes modulos del sistema y sus respectivas propiedades de navegación 

#### `ext/static_files/` Archivos estáticos extendidos: * `ext/static_files/modules/[modulo]/[modulo]_controller_ext.js`: Controladores JS personalizados. ##### Para sobrescribir: * Copiar el controlador original y modificarlo directamente. ##### Para extender: ```javascript core_base_app.controller('cases_controller_ext', function (...) {
  angular.extend(this, $controller('cases_controller', {...}));
  // Lógica extendida aquí
}); ``` * Registrar en `poscore_js_dependencies` en las viewdef correspondientes:
  ```js poscore_js_dependencies = [
    'modules/cases/casesCtrl.js',
    'modules/cases/casesCtrlExt.js'
  ]; 
  angular_controller = 'cases_controller_ext'; ```
#### `ext/templates/` Templates HTML personalizados: * Ruta sugerida: `ext/templates/modules/[modulo]/[nombre_template].html`  * Compatible con:

  * Django Tags: `{% load base_filters %}`
  * Angular: `{$ variable $}`

#### `ext/include/` * `entry_points.py`: Define un diccionario de funciones accesibles desde Angular vía métodos AJAX (POST y GET).  * `registered_cron_jobs.py`: Registra tareas programadas que se ejecutan periódicamente. #### `ext/opal/` * `entryPoints/`: Archivos que contienen funciones invocadas desde `entry_points.py`. Ejemplo: * `ext/opal/entryPoints/modules/CasesEntryPoints.py` * `events/`: Define funciones usadas como LogicHooks (before/after save). Deben llamarse `[nom_modulo]_events.py` o `[nom_modulo]_LogicHooks.py`. Ejemplo:

  * `ext/opal/events/garantias_events.py`

Importante: Adjunto en el sistema encontraras instrucciones con ejemplos para extender un models a traves de un models_extra_fields, vistas y demas. * Como todos los módulos extienden de Base, estos heredan las funciones CRUD  desde la ruta `core/base/views.py`. De esta forma, puedes sobrescribir las funciones CRUD de cualquier módulo si así se requiere, para ello debes crear un archivo en la ruta `ext/modules/[modulo]/views.py`. Si no es necesario ampliar las funciones CRUD, el sistema usarás las funciones CRUD de la ruta `core/base/views.py`. * Tienes acceso a un conjunto de funciones auxiliares del archivo `core.lib.fnutils`, ubicado en el módulo `lib/`. Estas funciones están disponibles para importar en cualquier módulo backend y deben usarse cuando encajen con la tarea a resolver. A continuación se describen las más relevantes: #### Funciones de carga dinámica * `load_lib(path)`: importa dinámicamente un módulo por su ruta . * `load_class(path, class_name)`: carga una clase desde un módulo . * `load_function(path, fun_name)`: carga una función desde un módulo . * `load_member(path, member_name)`: alias de `load_function`. #### Funciones de envío de correo * `sendEmail(...)`: envía un correo electrónico con o sin adjuntos. Usa configuración SMTP dinámica. Internamente puede delegar en `sendEmailLegacy` o `MailSender` . * `sendEmailLegacy(...)`: versión directa y menos desacoplada para envío de correos, usada como fallback. #### PDF / Archivos * `create_file_with_template(base_path, file_name, template, params)`: renderiza un template Django con parámetros y genera un archivo. #### Autenticación y contexto * `setCurrentAuto(pusername, pcia)`: establece el usuario y la compañía actual para el middleware global . * `currentInfo()`: retorna la información actual del usuario logueado, su compañía y roles. #### Utilidades de usuario y ACL * `get_user_list(...)`: retorna un diccionario con usuarios, filtrados por rol o estado . * `get_roles_list()`: retorna una lista ordenada de todos los roles del sistema. #### Configuración dinámica * `get_config_manager(name)`: obtiene un ConfigManager como string o diccionario . * `get_config_param(cfg, key)`: accede a un valor específico dentro de un ConfigManager. #### Operaciones con modelos * `check_duplicates(...)`: verifica duplicados en una tabla . * `check_unique_field(request)`: API para validar unicidad de un campo desde el frontend . * `delete_rel_record(request)`: elimina relaciones many-to-many o one-to-many entre modelos . * `delete_duplicate(request)`: marca un registro como no activo (`alive=False`) . * `force_migrate(...)`: migra un módulo y reinicia el servidor si es necesario . * `setup_module_fields(modules)`: añade campos dinámicos a un módulo . * `add_fields_by_module(module, fields)`: manipula y guarda los campos de un módulo . * `sqlserver_phonetic_search(module, model, column, search_text)`: ejecuta búsqueda fonética sobre un campo con SQL Server. #### Utilidades varias * `save_recent_history(...)`: registra en el historial de acciones recientes del usuario . * `classic_round(number, ndigits)`: redondeo clásico (mitad hacia arriba) . * `get_guid()`: genera un GUID SHA1 random . * `get_menu_actions(module)`: carga acciones disponibles para un módulo . * `reload_server()`: reinicia el servidor desde código (en Windows o Linux) . * `self_request(function, body)`: permite llamar funciones como si fueran endpoints desde código interno. #### Seguridad * `valid_email(email)`: valida una dirección de correo . * `hmac_sign(key, message)`: genera una firma HMAC con clave y mensaje. #### Cliente / Red * `get_client_ip(request)`: obtiene la IP del cliente desde una petición . * `verify_recaptcha(recaptcha_response)`: valida un token de Google reCAPTCHA. #### Otros * `parse_str_dict(dict_str)`: interpreta strings tipo diccionario a objetos . * `strip_accents(text)`: elimina tildes y acentos de un string . * `get_colors()`: devuelve un arreglo de colores predefinidos . * `get_modules()`: devuelve lista ordenada de módulos registrados . * `get_custom_function(path, function)`: busca una función definida en extensiones o productos. Restricciones que debes tener en cuenta: * Toda solución debe ser compatible con **Python 3.6.4** (no uses `f-strings`, `dataclass` solo si está instalada como backport). * Usa solo librerías instaladas (ver `librerias`). * No propongas estructuras modernas como `async/await` si no están soportadas directamente. * El código debe seguir la lógica modular del proyecto y respetar la carga de rutas desde `settings.py`. * La seguridad y compatibilidad con el ORM de Django es prioritaria. * Los servicios REST deben estar autenticados vía OAuth2. * No optimices codigo existente a menos que se indique explícitamente. * No uses características de versiones posteriores de Django o Python que no sean compatibles con las versiones especificadas.

Rule

Regla/Guía para crear o ampliar modelos desde models_extra_fields.py
1. Ubicación del archivo
El archivo debe ubicarse en:
ext/modules/[nombre_modulo]/models_extra_fields.py
Ejemplo:
ext/modules/cases/models_extra_fields.py
2. Nombre de la clase
La clase debe llamarse:
Fields[NombreModeloOriginal]
Por ejemplo, si el modelo original es Garantias, el nombre debe ser:
class FieldsGarantias(models.Model):
3. Contenido obligatorio de la clase
- Los campos deben ser agregados con prefijo ai_ para evitar conflictos con los campos del modelo original. - Usar tipos de campos personalizados si aplica, como SelectField, CurrencyField, MultiSelectField, etc., importados desde core.lib.model_fields. - La clase debe ser abstract usando class Meta.
Ejemplo mínimo:
from django.db import models from django.utils.translation import ugettext as _ from core.lib.model_fields.select import SelectField
class FieldsGarantias(models.Model):
    ai_ciudad = SelectField(verbose_name=_("Ciudad"), blank=True, null=True, max_length=20, list_name="ciudades_list")

    class Meta:
        abstract = True

        
Para modificar atributos como verbose_name de campos existentes, usa el diccionario product_model_change. Ejemplo:
  
product_model_change = {
  'Account': [
        {'field_name': 'owner', 'attr_name': 'verbose_name', 'value': 'Asesor Comercial'},
        {'field_name': 'primary_address_street', 'attr_name': 'verbose_name', 'value': 'Dirección de facturación'},
    ],
}
Para definir qué campos deben auditarse (registrar historial de cambios), usa auditable_fields: Ejemplo: __auditable_fields__ = {
  'Garantias': [
      'description',
      'name',
      'owner',
      'ai_ciudad',
      'ai_observaciones',
  ]
}
Para habilitar búsquedas en campos tipo ForeignKey (solo los del modelo principal, no relacionados), usar _search_rel_fields: Ejemplo: _search_rel_fields = {
    'Garantias': [
        'name',
    ]
}
Ejemplo completo estructurado:
  
from core.lib.model_fields.select import SelectField from core.lib.model_fields.currency import CurrencyField from django.utils.translation import ugettext as _ from django.db import models
class FieldsGarantias(models.Model):
    ai_ciudad = SelectField(verbose_name=_("Ciudad"), blank=True, null=True, max_length=20, list_name="ciudades_list")
    ai_costo_garantia = CurrencyField(verbose_name=_("Costo Garantía"), blank=True, null=True, max_length=100)

    class Meta:
        abstract = True

    def __str__(self):
        return "Garantía extra"

product_model_change = {
    'Account': [
        {'field_name': 'owner', 'attr_name': 'verbose_name', 'value': 'Asesor Comercial'},
    ],
}
__auditable_fields__ = {
    'Garantias': [
        'ai_ciudad',
        'ai_costo_garantia',
    ]
}
_search_rel_fields = {
    'Garantias': ['name']
}

Rule

Regla/Guía para crear nuevos módulos desde models.py

1. Ubicación del archivo

El archivo debe ubicarse en:

ext/modules/[nombre_modulo]/models.py

Ejemplo:

ext/modules/cases/models.py

2. Nombre de la clase
La clase debe llamarse igual al módulo, en singular y capitalizado. Ejemplo: Si el módulo es 'garantias', la clase será 'class Garantia(models.Model):'.

3. Contenido obligatorio de la clase

- Los campos deben ser agregados con prefijo ai_ para evitar conflictos con los campos del modelo original.
- Usar tipos de campos personalizados si aplica, como SelectField, CurrencyField, MultiSelectField, etc., importados desde core.lib.model_fields.
- La clase debe ser abstract usando class Meta.

Ejemplo mínimo:

from django.db import models from django.utils.translation import ugettext as _ from core.lib.model_fields.select import SelectField
class Garantias(models.Model):
    ai_ciudad = SelectField(verbose_name=_("Ciudad"), blank=True, null=True, max_length=20, list_name="ciudades_list")

    class Meta:
        abstract = True

        
Para modificar atributos como verbose_name de campos existentes, usa el diccionario product_model_change.
Ejemplo:
Para definir qué campos deben auditarse (registrar historial de cambios), usa auditable_fields:
Ejemplo:
__auditable_fields__ = {
    'Garantias': [
        'description',
        'name',
        'owner',
        'ai_ciudad',
        'ai_observaciones',
    ]
}

Para habilitar búsquedas en campos tipo ForeignKey (solo los del modelo principal, no relacionados), usar _search_rel_fields:
Ejemplo:
_search_rel_fields = {
    'Garantias': [
        'name',
    ]
}

4. Herencia dinámica
Usar get_extension_class y set_model_override para extender modelos base del sistema.
Esto permite sobrescribir y extender modelos desde ext/modules sin tocar core/base.

Ejemplo completo estructurado:
    from django.db import models
    from core.base.models import Base
    from ext.language.enums import global_enums
    from django.utils.translation import ugettext as _
    from core.lib.fnmodel import get_extension_class, set_model_override
    from core.lib.model_fields.select import SelectField

    extension = get_extension_class('garantias', 'Garantias', Base)
    extension_mvto = get_extension_class('garantias', 'GarantiasMvto', Base)


    class Garantias(*extension):

        # Fields del modelo garantias
        ai_ciudad = SelectField(verbose_name=_("Ciudad"), blank=True, null=True, max_length=20, list_name="ciudades_list")
        class Meta:
            db_table = 'ext_garantias'

    class GarantiasMvto(*extension_mvto):

        ai_item = models.ForeignKey('items_opal.Item', verbose_name=_('Item'))
        ai_tratamiento = models.TextField(blank=True, null=True, verbose_name=_('Tratamiento a Realizar'))
        ai_garantia = models.ForeignKey('garantias.Garantias', verbose_name=_('Garantia'))
            
        class Meta:
            db_table = 'ext_garantias_mvtos'


    set_model_override(Garantias, 'garantias')
    set_model_override(GarantiasMvto, 'garantias')

Rule

En este archivo se registra los diferentes modulos del sistema y sus respectivas propiedades de navegación 
Ejemplo: 
  
from django.utils.translation import ugettext as _


base_dictionary = {

  'garantias': { # Nombre del modulo, importante que sea igual al del pkg_name (Importante)
        'class_name': 'Garantias', # Nombre de la clase del modulo (Importante)
        'pkg_name': 'garantias', # Nombre de la carpeta donde esta el modulo (Importante)
        'label': _('Garantías y Servicio Técnico'), # Titulo que se muestra en el menu de navegación (Importante)
        'secondary_classes': [], # Arreglo de string donde se coloca el nombre de las clases secundarias que pueda tener el modulo
        'icon': 'fa-archive', # Icono que acompaña el titulo en el menu de navegación
        'check_acl': True, # True para permitir que desde el core se manipulen los permisos de roles sobre el módulo
        'navigable': True, # True para que aparesca en el menú de nevagación
        'importable': False, # True para poder importar
        'segmentable': False, # True para permitir la creación de segmentos y o-reports
        'notifications': False,
        'core': False,
        'product': 'ext', # ubicación del modulo (ext, crm, siesa, etc)
        'menu_pos': '001', # posición ordinal que tiene el item en el menú
    },
}

Rule

En nuestro sistema, algunos campos tipo SelectField pueden depender de la selección realizada en otro campo. A esto lo llamamos listas encadenadas o listas enlazadas. El objetivo es que el segundo campo solo muestre las opciones relevantes según la selección del primer campo.

* Supongamos que tenemos los siguientes campos en un modelo:

cstm_proceso = SelectField(list_name="proceso_list")
cstm_tipo_de_proceso = SelectField(
    list_name="descripcion_pqr_list",
    is_chained=True,
    chained_to="cstm_proceso",
    relation_list="proceso_x_descripcion_list"
)

¿Qué significa esto?
    **  is_chained=True: indica que este campo está encadenado a otro.
    **  chained_to="cstm_proceso": define a qué campo depende (en este caso, depende de cstm_proceso).
    * * relation_list: especifica el nombre de la lista que relaciona las opciones entre ambos campos.

* Para establecer una relación de un nivel entre dos listas (lista padre e hija), se necesitan tres listas:

    - Lista padre (por ejemplo, proceso_list)

    - Lista hija (por ejemplo, descripcion_pqr_list)

    - Lista de relación que vincula ambas (por ejemplo, proceso_x_descripcion_list)

Ejemplo de definición de listas:

from collections import OrderedDict
from django.utils.translation import gettext_lazy as _

global_enums = {}

global_enums['proceso_list'] = OrderedDict([
    ('', ''),
    ('peticion', _('PETICIÓN')),
    ('queja', _('QUEJA')),
    ('reclamo', _('RECLAMO')),
    ('felicitacion', _('FELICITACIÓN')),
    ('demanda', _('DEMANDA')),
])

global_enums['descripcion_pqr_list'] = OrderedDict([
    ('', ''),
    ('info_pedido', _('INFORMACIÓN SOBRE EL PEDIDO')),
    ('queja_servicio', _('QUEJA POR SERVICIO')),
    ('reclamo_garantia', _('RECLAMO DE GARANTÍA')),
    ('felicitacion_atencion', _('FELICITACIÓN POR LA ATENCIÓN')),
    ('demanda_devolucion', _('DEMANDA POR DEVOLUCIÓN DE DINERO')),
])

global_enums['proceso_x_descripcion_list'] = OrderedDict([
    ('', ''),
    ('info_pedido', 'peticion'),
    ('queja_servicio', 'queja'),
    ('reclamo_garantia', 'reclamo'),
    ('felicitacion_atencion', 'felicitacion'),
    ('demanda_devolucion', 'demanda'),
])

Comportamiento esperado

Cuando el usuario seleccione una opción en el campo cstm_proceso, el campo cstm_tipo_de_proceso mostrará únicamente las opciones relacionadas según la lista proceso_x_descripcion_list.

Rule

* Las vistas (Formularios) se ubican generalmente es:

ext/companies/[Cod_compañia]/viewdefs/[Nom_modulo] (Personalizado para compañias)

* Puedeb contener las siguientes viewdef:

    - createview.py: Formulario de creación de registros
    - detailview.py: Vista de detalle de registros (Vista informativa)
    - editview.py: Formulario de edición de registros
    - inline_createview.py: Formulario de creación y edición rapida
    - listview.py: Tabla de listado de registros
    - searchdef.py: Filtros usados para los registros de listview.py
    - subpanel_listview.py: Tabla de listado de registros en sub panel.

Ejemplo de una vista sencilla que muestra una pestaña (Datos básicos y dos campo (type,  cstm_consecutivo) seria:

    fields_def = [
        
        (_('Datos básicos'),
                {
                'params':  False,
                'fields': [
                
                    {
                        'name': 'type',
                        'col_dv': 'col-sm-6 col-xs-12 col-md-2',
                        'custom_template': '',
                        'params': False,
                    },
                    {
                        'name': 'cstm_consecutivo',
                        'col_dv': 'col-sm-6 col-xs-6 col-md-2',
                        'custom_template': '',
                        'params': False,
                    },
        ]}),
    ]

* Lógica Angular en viewdef:
A las pestañas se les puede aplicar lógica de programación angular mediante el params. Ej se requiere ocultar una pestaña a partir del valor de un campo status.
(_('Solución'),
	        {
	        'params':  {'ng-show': "formData.status=='solucionado' || formData.status=='Closed'"},
	        'fields': [
	    	
	            {
	                'name': 'solution',
					
        			'col_dv': 'col-sm-6 col-xs-12 col-md-12',
        			'custom_template': '',
        			'params': {'html_params': {'ng-style': "{'height':'34px'}"}},
	            },
	            {
	                'name': 'cstm_fecha_de_cierre',
					
        			'col_dv': 'col-xs-6 col-sm-6 col-md-6',
        			'custom_template': '',
        			'params': False,
	            },
	        ]}),

* Por otro lado se puede aplicar una lógica de programación a los campos mediante el atributo params que trae cada campo. (El params del campo a diferencia del params de la pestaña, se divide en html_params el cual solo afecta los objectos de formulario html; y en div_params que afecta todo el contenedor html del objecto.)

    Ejemplo: Mostrar todo un campo (Campo del formulario, su respectivo label y su posición relativa en el formulario) cuando una variable sea igual 1
                {
	                'name': 'cstm_usuario_sac',
        			'col_dv': 'col-xs-6 col-sm-6 col-md-6',
        			'custom_template': '',
        			'params': {'div_params': {'ng-show': 'control == 1'}},
	            }

    Ejemplo: agregar una función cuando cambie un campo tipo lista de selección multiple
                {
	                'name': 'account',
        			'col_dv': 'col-md-6 col-sm-6 col-xs-12',
        			'custom_template': '',
        			'params': {'directives': ['ui-select-required-rel'], 'html_params': {'ng-change': 'consultarContactos();'}} 
                }
* Los campos también tienen un atributo Label, que permite cambiar el nombre por default un campo. Ej. El campo type deberia salir con la etiqueta Tipo en la vista:
              {
	                'name': 'type',
					'label': 'Tipo'
        			'col_dv': 'col-xs-6 col-sm-6 col-md-6',
        			'custom_template': '',
        			'params': False,
	            },

    Se puede crear un campo vacio, un campo relacionado mediante una clase secundaria o usar un campo del modelo; y agregarles un custom template mediante: custom_template

    De la siguiente forma:
                {
	                'name': 'items_facturas_involucrados',
					'label': '',	
        			'col_dv': 'col-md-12 col-sm-12 col-xs-12',
        			'custom_template': 'modules/cases/facturas_involucradas_angular.html',
        			'params': False,
	            },

    custom_template: busca los archivos desde la ruta ext/templates, por tal motivo la ruta que se deberia colocar es modules/cases/facturas_involucradas_angular.html y no ext/templates/modules/cases/facturas_involucradas_angular.html

* Para que funcione params con funciones JS personalizadas es necesario agregar un controlador (Nuevo o extendido) mediante las directivas: angular_controller y poscore_js_dependencies

    En angular_controller se coloca el nombre del controlador y en poscore_js_dependencies se coloca los archivos .
    angular_controller = 'cases_controller_ext'
    poscore_js_dependencies = ['modules/cases/cases_controllers.js', 'modules/cases/cases_controller_ext.js']



    
* Para agregar css, js y codigo angular usar respectivamente:

    poscore_js_dependencies = ['modules/cases/cases_controllers.js', 'modules/cases/cases_controller_ext.js']
    css_dependencies = ['vendor/angular-google-places-autocomplete/autocomplete.min.css', 'vendor/jquery/jquery.datatables/jquery.dataTables.min.css', 'css/cotizador.css']
    js_dependencies = ['https://maps.googleapis.com/maps/api/js?libraries=places&key=AIzaSyBmExjFv4eoZM971nG6hvMkUCjVAzXvF6s', 'vendor/angular-google-places-autocomplete/autocomplete.min.js', 'vendor/jquery/jquery.datatables/jquery.dataTables.min.js', 'vendor/jquery/jquery.datatables/jquery.dataTables.columnFilter.js', 'vendor/angular/angular.datatables/angular-datatables.js', 'vendor/angular/angular.datatables/angular-datatables.columnfilter.min.js']
    ang_dependencies = ['google.places', 'datatables', 'datatables.columnfilter']

* Para modificar, funcionalidades de botones o agregar nuevos botones se usa custom_attr_buttons (Principalmente en la vista detailview.py)
    custom_attr_buttons = {  
    'fields':[  
        'id',
        'solicitud_creacion_tercero',
        'cliente_enviado',
        'cliente_rechazado',
        'sent_to_unoee'
    ],
    'buttons':[  
        'Edit',
        'Cancel',
        'Delete',
        {  
            'class':[  
                'btn-primary'
            ],
            'label':'Aprobar en ERP',
            'roles':[  
                'CREACION CLIENTES ERP'
            ],
            'params':{  
                'ng-show':'creadorTercero && base_obj_values.solicitud_creacion_tercero && !enviando_tercero && !base_obj_values.cliente_enviado',
                'ng-click':'showVtnApproval(true)'
            }
        },
    ]
    }

    ** En fields se debe colocar los campos que van a servir para calculos con los botónes, es decir, si deseamos enviar el id del registro como parametro en una función al momento de hacer clic, en fields debe ir id.

    ** En buttons se coloca los botónes de las vistas. (Hay botónes inmutable tales como Edit, Cancel, Delete). Los botónes nuevos tienen las propiedades que ya han sido explicadas previamente (tales como class, label, params)  y además tiene la propiedad roles, en la que se puede pasar como parametro los roles que estan autorizados para ver el botón en momento de ejecución.
        'roles':[  
            'CREACION CLIENTES ERP'
         ],

Importante: el parametro (o parametros delimitados por comas) puesto en roles, debe tener el nombre exacto del rol (con posibles espacios y todo), porque de lo contrario no funcionara.
Ejemplo de vista completa:  from django.utils.translation import ugettext as _

fields_def = [
    
        (_('Información básica'),
            {
            'params':  False,
            'fields': [
                {
                    'name': 'respuesta_envio',
                    'label': _(' '),
                    'col_dv': 'table-responsive col-xs-12 col-sm-12 col-md-12',
                    'custom_template': 'modules/leads/response_send_leads.html',
                    'params': False,
                },
                {
                    'name': 'observaciones',
                    'col_dv': 'col-xs-6 col-sm-6 col-md-6',
                    'custom_template': '',
                    'params': False,
                },
            ]}),
]

angular_controller = 'leadsCtrl_ext' poscore_js_dependencies = ['modules/leads/leads_controller.js', 'modules/leads/leads_controller_ext.js'] css_dependencies = [] js_dependencies = [] ang_dependencies = [] hide_menu = False custom_attr_buttons = {   'fields':[  
    'id',
    'solicitud_creacion_tercero',
    'cliente_enviado',
    'cliente_rechazado',
    'sent_to_unoee'
], 'buttons':[  
    'Edit',
    'Cancel',
    'Delete',
    {  
        'class':[  
            'btn-primary'
        ],
        'label':'Solicitar creación cliente',
        'params':{  
            'ng-show':'!base_obj_values.solicitud_creacion_tercero',
            'ng-click':'solicitarCreacionCliente()'
        }
    }
] }

Rule

Directorio ext/static_files

*En este directorio se almacenan los archivos estaticos tales como imagenes, js o controladores de angular, css, etc.

* Los controladores se almacenan en el sub directorio modulo de tal forma que quede asi: ext/static_files/modules/[nom_modulo]/[nom_modulo]_controller.js

    - Ejemplo de controlador: /ext/static_files/modules/garantias/garantias_controller_ext.js

    - Ejemplo de controlador de un modulo nuevo:
    core_base_app.controller('garantiaCtrl_ext', function ($scope, $http, Alertify, $modal, $controller, $location) {
        //Logica de programación
    })

* Por nomenclatura el nombre del controlador debe llevar el [nom_modulo]_ctrl_ext, y el nombre del archivo deberia ser [nom_modulo]_controller_ext.

* Para que la viewdef (forumulario o vista) tome el controlador, se debe agregar el controlador en angular_controller y la ruta del archivo en  poscore_js_dependencies, de la siguiente manera:

    angular_controller = 'garantiaCtrl_ext'
    poscore_js_dependencies = [
        'modules/garantias/garantias_controller_ext.js',
    ]




 

* Sobrescribir un controlador:

    ** Si se desea sobre escribir un controlador existente, es copiar el controlador del producto original y colocarlo exactamente en la misma ruta y reemplazar la lógica.

* Extender un controlador:

    Si por el contrario se desea extender un controlador, se debe hacer de la siguiente forma:

    core_base_app.controller('cases_controller_ext', function ($scope, $http, URL_PREFIX, DTOptionsBuilder,     DTColumnBuilder, Alertify, $filter, $controller, $location, $rootScope) {
    //En las opciones del controlador se debe poner los parametros de entrada que le entran al extendido
    angular.extend(this, $controller('cases_controller', {$scope, $http, URL_PREFIX, DTOptionsBuilder, DTColumnBuilder, $filter}));
        
        //Logica de programación
    })

* Para poder extender el controlador es necesario agregar la ruta del controlador original   y el nuevo controlador en poscore_js_dependencies en las viewdef

    angular_controller = 'cases_controller_ext' //El controlador extendido

    poscore_js_dependencies = [
        'modules/cases/casesCtrl.js', 
        'modules/cases/casesCtrlExt.js', // Ruta de la extención
        ]

* Acceder a campos del formulario desde el controlador:

    Para acceder a la información de los elementos de los formularios de creación y  edición usar $scope.formData.[Campo]; para acceder a la información de los elementos de la vista de detalle, usar $scope.detail_data.[Campo]

Ejemplo: se requiere imprimir en consola el id del registro, en la vista editview.py:

    core_base_app.controller('cases_controller_ext', function ($scope, $http, URL_PREFIX, DTOptionsBuilder, DTColumnBuilder, Alertify, $filter, $controller, $location, $rootScope) {
        angular.extend(this, $controller('cases_controller', {$scope, $http, URL_PREFIX, DTOptionsBuilder, DTColumnBuilder, Alertify, $filter}));
        
        $scope.formData = {}; // Importante siempre inicializar la variable
        $(document).ready(function () {
            console.log($scope.formData.id)
        });
    }

Ejemplo: se requiere imprimir en consola el id del registro, en la vista detailview.py:

    core_base_app.controller('cases_controller_ext', function ($scope, $http, URL_PREFIX, DTOptionsBuilder, DTColumnBuilder, Alertify, $filter, $controller, $location, $rootScope) {
        angular.extend(this, $controller('cases_controller', {$scope, $http, URL_PREFIX, DTOptionsBuilder, DTColumnBuilder, Alertify, $filter}));
        
        $scope.detail_data = {}; // Importante siempre inicializar la variable
        $(document).ready(function () {
            console.log($scope.detail_data.id)
        });
    }



    
* Para ejecutar funciones de python desde el angular usamos Ajax (realizar peticiones al backend) de la siguiente forma:
angular.element(document).ready(function () {
        $http({
            method: 'POST',
            data: {},
            url: '/entry_point/obtener_todos_los_items/', 
            headers: {'Content-type': 'application/x-www-form-urlencoded'}
        }).then(function successCallback(response){
            $scope.items = response.data;
        }, function errorCallback(response){
            console.log("[tareas_obtener_todos][error]: ", response);
        });
}