[MIG] stock_currency_valuation: Migration to 19.0

stock_currency_valuation/FUNCIONALIDADES.md

@@ -0,0 +1,140 @@
+# Stock Currency Valuation - Referencia funcional
+
+## Alcance activo (cargado por manifest)
+
+- Modelos activos:
+  - `product.category`: moneda secundaria por categoría.
+  - `product.product` y `product.template`: costo en moneda secundaria y cálculos de valuación.
+  - `stock.move`: valor del movimiento en moneda secundaria.
+  - `stock.picking`: cotización manual para ingresos de compra.
+  - `product.value`: valor histórico en moneda secundaria.
+  - `stock.quant`: valor secundario por quant.
+- Vistas activas:
+  - categoría de producto
+  - picking
+  - quants
+  - producto/template
+  - movimientos de stock
+- Demo activa:
+  - categoría hija de Furniture con valuación en moneda secundaria
+  - producto demo en esa categoría
+
+## Funcionalidades implementadas
+
+### 1) Moneda secundaria por categoría
+
+- Campo `valuation_currency_id` (company_dependent) en categoría.
+- Permite definir la moneda de valuación secundaria para todos los productos de la categoría.
+
+Archivos:
+- `models/product_category.py`
+- `views/product_category.xml`
+
+### 2) Costo y valuación del producto en moneda secundaria
+
+- Campo relacionado `valuation_currency_id` en producto y template.
+- Campo `standard_price_in_currency` con:
+  - compute/inverse/search en template
+  - almacenamiento company_dependent en variante
+- Cálculo de:
+  - `avg_cost_in_currency`
+  - `total_value_in_currency`
+- Soporte por método de costo: `standard`, `average`, `fifo`.
+- Reutiliza contexto de valuación (fecha, company, warehouse).
+
+Archivos:
+- `models/product_product.py`
+- `models/product_template.py`
+- `views/product.xml`
+
+### 3) Integración con reglas de reposición
+
+- Agrega `average_in_currency` a `replenishment_cost_type`.
+- Calcula costo de reposición desde `standard_price_in_currency`, convertido a moneda del producto y luego aplica regla de reposición si corresponde.
+
+Archivo:
+- `models/product_template.py`
+
+### 4) Histórico de valores (`product.value`) en moneda secundaria
+
+- Extiende `product.value` con:
+  - `valuation_currency_id`
+  - `value_in_currency`
+- En `create`, completa por defecto:
+  - `value` desde `standard_price`
+  - `value_in_currency` desde `standard_price_in_currency` (si aplica)
+
+Archivo:
+- `models/product_value.py`
+
+### 5) Movimientos de stock con valor secundario
+
+- Extiende `stock.move` con:
+  - `valuation_currency_id`
+  - `value_in_currency`
+  - `value_manual_in_currency` (compute + inverse)
+- En `_set_value` calcula `value_in_currency` usando:
+  - `picking.currency_rate` si está definido
+  - o conversión de moneda por fecha
+- Muestra `value_in_currency` en vistas de movimientos y valuación.
+
+Archivos:
+- `models/stock_move.py`
+- `views/stock_move_views.xml`
+
+### 6) Picking de compras con cotización manual
+
+- En ingresos de compra:
+  - calcula `valuation_currency_id` desde las categorías de los moves
+  - permite capturar `inverse_currency_rate`
+  - persiste `currency_rate`
+- El rate se usa luego para valuar movimientos en moneda secundaria.
+
+Archivos:
+- `models/stock_picking.py`
+- `views/stock_picking.xml`
+
+### 7) Valor secundario en quants
+
+- Campo `secondary_value` en `stock.quant` para usuarios de stock manager.
+- Cálculo: `quantity * standard_price_in_currency`.
+- Sólo para quants valuables (respeta exclusiones de valuación y ubicaciones no valuadas).
+- Visible en listas de quants (normal y editable), con suma en editable.
+
+Archivos:
+- `models/stock_quant.py`
+- `views/stock_quant_views.xml`
+
+### 8) Datos demo
+
+- Activa EUR (si estaba inactiva).
+- Crea categoría demo bajo Furniture:
+  - método `average`
+  - valuación `real_time`
+  - moneda secundaria `EUR`
+- Crea producto demo asignado a esa categoría.
+
+Archivo:
+- `demo/stock_currency_valuation_demo.xml`
+
+## Implementado pero no activo actualmente
+
+Estas piezas existen en el módulo, pero hoy no se cargan porque están comentadas en imports o en el manifest:
+
+- Landed costs en moneda secundaria.
+- Vista de `product.value` extendida.
+- Vista de `stock.valuation.layer` extendida.
+- Wizard de revaluación con campos y asientos en moneda secundaria.
+
+Archivos:
+- `models/stock_landed_cost.py`
+- `views/stock_landed_cost_views.xml`
+- `views/product_value_views.xml`
+- `views/stock_valuation_layer.xml`
+- `wizard/stock_valuation_layer_revaluation.py`
+- `wizard/stock_valuation_layer_revaluation_views.xml`
+
+Puntos de control:
+- `__init__.py` (wizard comentado)
+- `models/__init__.py` (landed cost comentado)
+- `__manifest__.py` (vistas/wizard comentadas)