======================================
Product Price Category - Supplier
======================================

Extiende ``res.partner`` (proveedores) con un campo de categoría de precio por
defecto y permite actualizar masivamente todos los productos de un proveedor con
esta categoría mediante un wizard.

Funcionalidades
===============

- **Campo en Proveedores**: Añade campo ``default_price_category_id`` en la
  pestaña "Compras" (Purchases) de res.partner
- **Actualización Masiva**: Botón que abre wizard modal para confirmar
  actualización de todos los productos del proveedor
- **Columna Configurable**: Campo oculto en vista tree de partner,
  visible/configurable desde menú de columnas
- **Control de Permisos**: Acceso restringido a
  ``sales_team.group_sale_manager`` (Gestores de Ventas)

Dependencias
============

- ``product_price_category`` (OCA addon base)
- ``product_pricelists_margins_custom`` (Addon del proyecto)
- ``sales_team`` (Odoo core)

Instalación
===========

::

    docker-compose exec -T odoo odoo -d odoo -u product_price_category_supplier --stop-after-init

Flujo de Uso
============

1. Abrir formulario de un **Proveedor** (res.partner)
2. Ir a pestaña **"Compras"** (Purchases)
3. En sección **"Price Category Settings"**, seleccionar **categoría de precio
   por defecto**
4. Hacer clic en botón **"Apply to All Products"**
5. Se abre modal de confirmación mostrando:

   - Nombre del proveedor
   - Categoría de precio a aplicar
   - Cantidad de productos que serán actualizados

6. Hacer clic **"Confirm"** para ejecutar actualización en bulk
7. Notificación de éxito mostrando cantidad de productos actualizados

Campos
======

res.partner - Campos añadidos
------------------------------

- ``default_price_category_id`` (Many2one → product.price.category)

  - Ubicación: Pestaña "Compras", sección "Price Category Settings"
  - Obligatorio: No
  - Ayuda: "Default price category for products from this supplier"
  - Visible en tree: Oculto por defecto (column_invisible=1), configurable vía menú

Modelos
=======

wizard.update.product.category (Transient)
-------------------------------------------

- ``partner_id`` (Many2one → res.partner) - Readonly
- ``partner_name`` (Char, related to partner_id.name) - Readonly
- ``price_category_id`` (Many2one → product.price.category) - Readonly
- ``product_count`` (Integer) - Cantidad de productos a actualizar - Readonly

**Métodos**:

- ``action_confirm()`` - Realiza bulk update de productos y retorna notificación

Vistas
======

res.partner views
-----------------

- **Form**: Campo + botón en pestaña "Compras"
- **Tree**: Campo oculto (column_invisible=1)

wizard.update.product.category views
------------------------------------

- **Form**: Formulario modal con información de confirmación y botones

Seguridad
=========

Acceso al wizard restringido a grupo ``sales_team.group_sale_manager``:

- Lectura: Sí
- Escritura: Sí
- Creación: Sí
- Borrado: Sí

Comportamiento
==============

Actualización de Productos
--------------------------

Cuando el usuario confirma la acción:

1. Se buscan todos los productos (``product.template``) donde:

   - ``default_supplier_id = partner_id`` (este proveedor es su proveedor por
     defecto)

2. Se actualizan en bulk (single SQL UPDATE) con:

   - ``price_category_id = default_price_category_id``

3. Se retorna notificación de éxito:

   - "X products updated with category 'CATEGORY_NAME'."

**Nota**: La actualización SOBRESCRIBE cualquier ``price_category_id``
existente en los productos.

Extensión Futura
================

Para implementar defaults automáticos al crear productos desde un proveedor::

    # En models/product_template.py
    @api.model_create_multi
    def create(self, vals_list):
        # Si se proporciona default_supplier_id sin price_category_id,
        # usar default_price_category_id del proveedor
        for vals in vals_list:
            if vals.get('default_supplier_id') and not vals.get('price_category_id'):
                supplier = self.env['res.partner'].browse(vals['default_supplier_id'])
                if supplier.default_price_category_id:
                    vals['price_category_id'] = supplier.default_price_category_id.id
        return super().create(vals_list)

Traducciones
============

Para añadir/actualizar traducciones::

    # Exportar strings
    docker-compose exec -T odoo odoo -d odoo \
        --addons-path=/mnt/extra-addons/product_price_category_supplier \
        -i product_price_category_supplier \
        --i18n-export=/tmp/product_price_category_supplier.pot \
        --stop-after-init

    # Mergar en archivos .po existentes
    cd product_price_category_supplier/i18n
    for lang in es eu; do
        msgmerge -U ${lang}.po product_price_category_supplier.pot
    done

Testing
=======

Ejecutar tests::

    docker-compose exec -T odoo odoo -d odoo \
        -i product_price_category_supplier \
        --test-enable --stop-after-init

Créditos
========

Autores
-------

* Criptomart

Financiadores
-------------

* Elika Bilbo

Contribuidores
--------------

* `Criptomart <https://criptomart.net>`_:

  * Desarrollo e implementación del módulo
  * Diseño del wizard y lógica de actualización masiva

Otros créditos
--------------

Este módulo extiende el addon OCA ``product_price_category`` para proporcionar
valores por defecto a nivel de proveedor y operaciones masivas que facilitan la
gestión de categorías de precio.

Licencia
--------

AGPL-3.0 or later (http://www.gnu.org/licenses/agpl)
