[DOC] Actualizar documentación a estándares OCA y preparar logo CriptoMart

- Renombrar README.md a README_DEV.md en todos los addons custom
- Crear README.rst siguiendo estructura OCA oficial
- Crear directorios readme/ con fragmentos .rst (DESCRIPTION, INSTALL, CONFIGURE, USAGE, CONTRIBUTORS, CREDITS)
- Actualizar créditos: Criptomart (autor) + Elika Bilbo (financiador)
- Actualizar __manifest__.py con maintainers correctos
- Crear estructura static/description/ para logo en 5 addons
- Agregar documentación de logo (LOGO_INSTRUCTIONS.md, install_logo.sh)
- Actualizar copilot-instructions.md con referencias a OCA_DOCUMENTATION.md
- Crear docs/OCA_DOCUMENTATION.md con guía completa de estructura
- Crear docs/RESUMEN_CAMBIOS_DOCUMENTACION.md con resumen detallado

Addons actualizados:
- website_sale_aplicoop
- product_sale_price_from_pricelist
- product_pricelist_total_margin
- product_price_category_supplier
- account_invoice_triple_discount_readonly
This commit is contained in:
snt 2026-02-21 19:55:57 +01:00
parent b31df7b9d8
commit 4a4639f13a
56 changed files with 1778 additions and 674 deletions

View file

@ -0,0 +1,159 @@
====================================
Product Sale Price from Pricelist
====================================
.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
:target: https://odoo-community.org/page/development-status
:alt: Beta
.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
:target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
:alt: License: AGPL-3
|badge1| |badge2|
This module automatically calculates and updates product sale prices based on the last purchase price and configurable pricelists.
**Key Features:**
* **Automatic Price Calculation**: Set sale prices based on last purchase price and a configured pricelist
* **Flexible Discount Handling**: Choose how to apply discounts to the cost:
* Without discounts
* First discount only
* Double discount
* Triple discount
* Manual update
* **Tax-Aware Pricing**: Automatically includes tax calculations in pricing
* **UoM Conversion**: Handles different purchase and sale units of measure
* **Batch Updates**: Update theoretical prices for multiple products
* **Product Flags**: Mark products for price updates and track status
* **Variant Architecture**: All business logic in product.product for proper pricelist handling
**Table of contents**
.. contents::
:local:
Installation
============
To install this module, you need to:
#. Ensure dependencies are installed (product, purchase, sale)
#. Update the Apps list
#. Search for "Product Sale Price from Pricelist"
#. Click Install
Configuration
=============
To configure this module, you need to:
**Global Configuration:**
#. Go to Settings → Sales → Automatic Price Configuration
#. Select the pricelist for automatic price calculation
#. Save settings
**Per Product Configuration:**
#. Go to Products → Products
#. Open a product form
#. Configure:
* **Last purchase price**: Cost at which the product was last purchased
* **Last purchase price calculation type**: Choose how to apply discounts
* Without Discounts: Uses base purchase price
* First Discount: Applies only the first discount
* Double Discount: Applies first and second discount
* Triple Discount: Applies first, second, and third discount
* Manual Update: Price must be set manually
* **Last purchase price updated**: Mark when prices need review
**Important Notes:**
* Ensure products have taxes configured (required for price calculation)
* Set calculation type to anything except "manual_update" for automatic pricing
Usage
=====
**Automatic Price Updates:**
#. Products are priced automatically when received from purchase orders
#. System updates the **last_purchase_price** field automatically
#. Sale price is calculated from the configured pricelist using the cost price
#. Taxes are automatically applied based on product tax settings
**Manual Price Updates:**
#. Go to Products → Update Theoretical Prices
#. Select products to update
#. System recalculates theoretical prices based on current settings
#. Review and apply changes
**Price Calculation Flow:**
#. Purchase order is received
#. System extracts cost from purchase line (with configured discount handling)
#. Applies configured pricelist rules
#. Calculates taxes
#. Updates theoretical price
#. Optionally auto-updates sale price (list_price)
**Monitoring:**
* Use **Last purchase price updated** flag to track products needing review
* Filter products by calculation type to manage different pricing strategies
* Review **list_price_theoritical** vs **list_price** to see proposed vs actual prices
Bug Tracker
===========
Bugs are tracked on `GitHub Issues <https://github.com/Criptomart/addons-cm/issues>`_.
In case of trouble, please check there if your issue has already been reported.
Credits
=======
Authors
~~~~~~~
* Criptomart
Funding
~~~~~~~
* Elika Bilbo
Contributors
~~~~~~~~~~~~
* `Criptomart <https://criptomart.net>`_:
* Main development and implementation
* Architecture design for product variant handling
Other credits
~~~~~~~~~~~~~
This module integrates with the OCA product ecosystem and follows best practices for:
* Product variant architecture (business logic in product.product)
* Pricelist compatibility
* Tax-aware pricing calculations
* UoM conversions
Maintainers
~~~~~~~~~~~
This module is maintained by Criptomart.
.. image:: https://odoo-community.org/logo.png
:alt: Odoo Community Association
:target: https://odoo-community.org
This module is part of the `Criptomart/addons-cm <https://github.com/Criptomart/addons-cm/tree/18.0/product_sale_price_from_pricelist>`_ project on GitHub.

View file

@ -0,0 +1,29 @@
To configure this module, you need to:
**Global Configuration:**
#. Go to Settings → Sales → Automatic Price Configuration
#. Select the pricelist for automatic price calculation
#. Save settings
**Per Product Configuration:**
#. Go to Products → Products
#. Open a product form
#. Configure:
* **Last purchase price**: Cost at which the product was last purchased
* **Last purchase price calculation type**: Choose how to apply discounts
* Without Discounts: Uses base purchase price
* First Discount: Applies only the first discount
* Double Discount: Applies first and second discount
* Triple Discount: Applies first, second, and third discount
* Manual Update: Price must be set manually
* **Last purchase price updated**: Mark when prices need review
**Important Notes:**
* Ensure products have taxes configured (required for price calculation)
* Set calculation type to anything except "manual_update" for automatic pricing

View file

@ -0,0 +1,4 @@
* `Criptomart <https://criptomart.net>`_:
* Main development and implementation
* Architecture design for product variant handling

View file

@ -0,0 +1,16 @@
**Authors:**
* Criptomart
**Funding:**
* Elika Bilbo
**Other credits:**
This module integrates with the OCA product ecosystem and follows best practices for:
* Product variant architecture (business logic in product.product)
* Pricelist compatibility
* Tax-aware pricing calculations
* UoM conversions

View file

@ -0,0 +1,18 @@
This module automatically calculates and updates product sale prices based on the last purchase price and configurable pricelists.
**Key Features:**
* **Automatic Price Calculation**: Set sale prices based on last purchase price and a configured pricelist
* **Flexible Discount Handling**: Choose how to apply discounts to the cost:
* Without discounts
* First discount only
* Double discount
* Triple discount
* Manual update
* **Tax-Aware Pricing**: Automatically includes tax calculations in pricing
* **UoM Conversion**: Handles different purchase and sale units of measure
* **Batch Updates**: Update theoretical prices for multiple products
* **Product Flags**: Mark products for price updates and track status
* **Variant Architecture**: All business logic in product.product for proper pricelist handling

View file

@ -0,0 +1,6 @@
To install this module, you need to:
#. Ensure dependencies are installed (product, purchase, sale)
#. Update the Apps list
#. Search for "Product Sale Price from Pricelist"
#. Click Install

View file

@ -0,0 +1,28 @@
**Automatic Price Updates:**
#. Products are priced automatically when received from purchase orders
#. System updates the **last_purchase_price** field automatically
#. Sale price is calculated from the configured pricelist using the cost price
#. Taxes are automatically applied based on product tax settings
**Manual Price Updates:**
#. Go to Products → Update Theoretical Prices
#. Select products to update
#. System recalculates theoretical prices based on current settings
#. Review and apply changes
**Price Calculation Flow:**
#. Purchase order is received
#. System extracts cost from purchase line (with configured discount handling)
#. Applies configured pricelist rules
#. Calculates taxes
#. Updates theoretical price
#. Optionally auto-updates sale price (list_price)
**Monitoring:**
* Use **Last purchase price updated** flag to track products needing review
* Filter products by calculation type to manage different pricing strategies
* Review **list_price_theoritical** vs **list_price** to see proposed vs actual prices