From c367e20fc502ef3f0f2feb50187d184bc029ee9c Mon Sep 17 00:00:00 2001 From: snt Date: Wed, 25 Feb 2026 17:47:33 +0100 Subject: [PATCH] =?UTF-8?q?[DOC]=20Limpiar=20documentaci=C3=B3n=20temporal?= =?UTF-8?q?=20y=20scripts=20de=20test=20obsoletos?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- DOCUMENTATION.md | 225 ----------- DOCUMENTATION_UPDATE_SUMMARY.md | 273 ------------- README.md | 261 +----------- .../BEFORE_AND_AFTER.md | 370 ------------------ .../ERROR_FIX_REPORT.md | 279 ------------- .../IMPLEMENTACION_RESUMEN.txt | 230 ----------- .../INSTALLATION_COMPLETE.md | 300 -------------- .../INSTALLATION_STATUS.md | 313 --------------- .../QUICK_FIX_REFERENCE.md | 123 ------ .../QUICK_START.sh | 152 ------- .../TEST_REPORT.md | 312 --------------- product_price_category_supplier/VALIDATION.md | 309 --------------- .../install_addon.sh | 69 ---- run_price_tests.sh | 156 -------- test_prices.py | 197 ---------- test_with_docker_run.sh | 224 ----------- 16 files changed, 6 insertions(+), 3787 deletions(-) delete mode 100644 DOCUMENTATION.md delete mode 100644 DOCUMENTATION_UPDATE_SUMMARY.md delete mode 100644 product_price_category_supplier/BEFORE_AND_AFTER.md delete mode 100644 product_price_category_supplier/ERROR_FIX_REPORT.md delete mode 100644 product_price_category_supplier/IMPLEMENTACION_RESUMEN.txt delete mode 100644 product_price_category_supplier/INSTALLATION_COMPLETE.md delete mode 100644 product_price_category_supplier/INSTALLATION_STATUS.md delete mode 100644 product_price_category_supplier/QUICK_FIX_REFERENCE.md delete mode 100644 product_price_category_supplier/QUICK_START.sh delete mode 100644 product_price_category_supplier/TEST_REPORT.md delete mode 100644 product_price_category_supplier/VALIDATION.md delete mode 100644 product_price_category_supplier/install_addon.sh delete mode 100755 run_price_tests.sh delete mode 100644 test_prices.py delete mode 100755 test_with_docker_run.sh diff --git a/DOCUMENTATION.md b/DOCUMENTATION.md deleted file mode 100644 index ad46d50..0000000 --- a/DOCUMENTATION.md +++ /dev/null @@ -1,225 +0,0 @@ -# 📚 Documentación del Proyecto - Índice - -## 🚀 Lazy Loading v18.0.1.3.0 - Documentación Rápida - -¿Buscas información sobre la nueva feature de lazy loading? Empieza aquí: - -### ⚡ Solo tengo 5 minutos -👉 **[docs/LAZY_LOADING_QUICK_START.md](docs/LAZY_LOADING_QUICK_START.md)** - TL;DR y setup rápido - -### 🔧 Necesito instalar / actualizar -👉 **[docs/UPGRADE_INSTRUCTIONS_v18.0.1.3.0.md](docs/UPGRADE_INSTRUCTIONS_v18.0.1.3.0.md)** - Paso a paso con validación y troubleshooting - -### 🎓 Quiero entender la arquitectura -👉 **[docs/LAZY_LOADING.md](docs/LAZY_LOADING.md)** - Detalles técnicos completos - -### 📍 No sé dónde empezar -👉 **[docs/LAZY_LOADING_DOCS_INDEX.md](docs/LAZY_LOADING_DOCS_INDEX.md)** - Índice con guía de selección por rol - ---- - -## 📖 Documentación General del Proyecto - -### Quick Links -| Categoría | Documento | Propósito | -|-----------|-----------|----------| -| **Start** | [README.md](README.md) | Descripción general del proyecto | -| **Development** | [.github/copilot-instructions.md](.github/copilot-instructions.md) | Guía para desarrollo con IA | -| **All Docs** | [docs/README.md](docs/README.md) | Índice completo de documentación técnica | - ---- - -## 📂 Estructura de Documentación - -``` -addons-cm/ -├── README.md # Descripción general del proyecto -│ -├── docs/ # 📚 Documentación técnica -│ ├── README.md # Índice de todos los docs técnicos -│ │ -│ ├── 🚀 LAZY LOADING (v18.0.1.3.0) -│ ├── LAZY_LOADING_QUICK_START.md # ⚡ 5 min - Lo esencial -│ ├── LAZY_LOADING_DOCS_INDEX.md # 📍 Índice con guía por rol -│ ├── LAZY_LOADING.md # 🎓 Detalles técnicos -│ ├── UPGRADE_INSTRUCTIONS_v18.0.1.3.0.md # 🔧 Instalación -│ │ -│ ├── 📋 OTROS DOCS -│ ├── LINTERS_README.md # Herramientas de código -│ ├── TRANSLATIONS.md # Sistema de traducciones -│ ├── INSTALACION_COMPLETA.md # Instalación del proyecto -│ ├── RESUMEN_INSTALACION.md # Resumen de instalación -│ ├── CORRECCION_PRECIOS_IVA.md # Precios e impuestos -│ └── TEST_MANUAL.md # Testing manual -│ -├── website_sale_aplicoop/ # 📦 Addon principal -│ ├── README.md # Features y configuración -│ └── CHANGELOG.md # Historial de versiones -│ -└── DOCUMENTATION_UPDATE_SUMMARY.md # 📋 Resumen de cambios (Este proyecto) -``` - ---- - -## 🎯 Guía Rápida por Tipo de Usuario - -### 👤 Administrador del Sistema -1. **Instalación**: [UPGRADE_INSTRUCTIONS_v18.0.1.3.0.md](docs/UPGRADE_INSTRUCTIONS_v18.0.1.3.0.md) -2. **Configuración**: Settings → Website → Shop Settings -3. **Troubleshooting**: Sección de troubleshooting en UPGRADE_INSTRUCTIONS -4. **Performance**: Sección "Verificación de Rendimiento" - -### 👨‍💻 Desarrollador -1. **Arquitectura**: [docs/LAZY_LOADING.md](docs/LAZY_LOADING.md) -2. **Código**: Sección "Code Changes" en LAZY_LOADING.md -3. **Testing**: Sección "Debugging & Testing" -4. **Mejoras**: "Future Improvements" al final - -### 🎓 Alguien Nuevo en el Proyecto -1. **Start**: [README.md](README.md) -2. **Features**: [website_sale_aplicoop/README.md](website_sale_aplicoop/README.md) -3. **Lazy Loading**: [docs/LAZY_LOADING_DOCS_INDEX.md](docs/LAZY_LOADING_DOCS_INDEX.md) -4. **Detalles Técnicos**: [.github/copilot-instructions.md](.github/copilot-instructions.md) - -### 🚀 Alguien que Solo Quiere Setup Rápido -1. [docs/LAZY_LOADING_QUICK_START.md](docs/LAZY_LOADING_QUICK_START.md) (5 min) -2. Done! ✅ - ---- - -## 📊 Resumen de Documentación - -### Lazy Loading Feature (v18.0.1.3.0) - -**Problema Solucionado**: -- ❌ Antes: Página tarda 10-20 segundos en cargar todos los productos y calcular precios - -**Solución**: -- ✅ Después: Página carga en 500-800ms (20x más rápido) -- ✅ Productos se cargan bajo demanda con botón "Load More" -- ✅ Configurable: Activable/desactivable, items por página ajustable - -**Documentación Incluida**: -- ✅ Quick Start (5 min) -- ✅ Upgrade Instructions (paso a paso) -- ✅ Technical Documentation (detalles completos) -- ✅ Troubleshooting (4 escenarios comunes) -- ✅ Performance Metrics (verificación) - ---- - -## 🔗 Enlaces Directos - -### Lazy Loading -- [⚡ Quick Start](docs/LAZY_LOADING_QUICK_START.md) - Start here (5 min) -- [🔧 Upgrade Instructions](docs/UPGRADE_INSTRUCTIONS_v18.0.1.3.0.md) - Installation & Config -- [🎓 Technical Docs](docs/LAZY_LOADING.md) - Deep dive -- [📍 Documentation Index](docs/LAZY_LOADING_DOCS_INDEX.md) - Navigation guide - -### Proyecto General -- [📋 Project README](README.md) - Descripción general -- [📚 Technical Docs](docs/README.md) - Índice de todos los docs -- [🤖 Copilot Guide](.github/copilot-instructions.md) - Desarrollo con IA -- [🧪 Testing](docs/TEST_MANUAL.md) - Manual testing - -### Addons Específicos -- [🛍️ website_sale_aplicoop](website_sale_aplicoop/README.md) - Sistema eskaera -- [💰 product_sale_price_from_pricelist](product_sale_price_from_pricelist/README.md) - Auto-pricing -- [📦 product_price_category_supplier](product_price_category_supplier/README.md) - Categorías por proveedor -- [🐛 account_invoice_triple_discount_readonly](account_invoice_triple_discount_readonly/README.md) - Fix de descuentos - ---- - -## 📞 ¿Necesitas Ayuda? - -### Selecciona tu situación: - -| Situación | Qué leer | -|-----------|----------| -| "¿Qué es lazy loading?" | [LAZY_LOADING_QUICK_START.md](docs/LAZY_LOADING_QUICK_START.md) | -| "¿Cómo instalo?" | [UPGRADE_INSTRUCTIONS_v18.0.1.3.0.md](docs/UPGRADE_INSTRUCTIONS_v18.0.1.3.0.md) | -| "¿Cómo configuro?" | UPGRADE_INSTRUCTIONS → Configuration | -| "¿Cómo verifico que funciona?" | UPGRADE_INSTRUCTIONS → Performance Verification | -| "Algo no funciona" | UPGRADE_INSTRUCTIONS → Troubleshooting | -| "¿Cómo hago rollback?" | UPGRADE_INSTRUCTIONS → Rollback Instructions | -| "Detalles técnicos completos" | [LAZY_LOADING.md](docs/LAZY_LOADING.md) | -| "¿Qué archivos fueron modificados?" | LAZY_LOADING.md → Code Changes | -| "¿Cómo hago testing?" | LAZY_LOADING.md → Debugging & Testing | - ---- - -## ✅ Estado de Documentación - -- ✅ **Implementación**: Completada (v18.0.1.3.0) -- ✅ **Quick Start**: Disponible (5 min) -- ✅ **Upgrade Guide**: Disponible (paso a paso) -- ✅ **Technical Docs**: Disponible (600+ líneas) -- ✅ **Troubleshooting**: Disponible (4+ escenarios) -- ✅ **Performance Metrics**: Documentadas (20x mejora) -- ✅ **Backward Compatibility**: Confirmada (desactivable) - ---- - -## 🎓 Aprendizaje Rápido - -Para entender rápidamente cómo funciona: - -1. **El Problema** (2 min): Lee intro de [LAZY_LOADING_QUICK_START.md](docs/LAZY_LOADING_QUICK_START.md) -2. **La Solución** (2 min): Lee "Installation" en QUICK_START -3. **Verificación** (1 min): Sigue "Verificación Rápida" en QUICK_START -4. **Listo** ✅ - -Para profundizar → [LAZY_LOADING.md](docs/LAZY_LOADING.md) - ---- - -## 📈 Impacto de Performance - -| Métrica | Antes | Después | Mejora | -|---------|-------|---------|--------| -| Carga inicial | 10-20s | 500-800ms | **20x** 🚀 | -| Carga página 2 | — | 200-400ms | — | -| DOM size | 1000+ elementos | 20 elementos | **50x** | -| Rendimiento | Lento | Rápido | ✅ | - ---- - -## 📝 Cambios Principales - -### Archivos Modificados (5) -1. `/models/res_config_settings.py` - Configuración -2. `/models/group_order.py` - Paginación backend -3. `/controllers/website_sale.py` - Endpoints HTTP -4. `/views/website_templates.xml` - Templates QWeb -5. `/static/src/js/website_sale.js` - AJAX JavaScript - -### Documentación Creada (4) -1. LAZY_LOADING_QUICK_START.md -2. LAZY_LOADING_DOCS_INDEX.md -3. LAZY_LOADING.md -4. UPGRADE_INSTRUCTIONS_v18.0.1.3.0.md - ---- - -## 🚀 Siguientes Pasos - -### Inmediato -- [ ] Lee [LAZY_LOADING_QUICK_START.md](docs/LAZY_LOADING_QUICK_START.md) -- [ ] Actualiza a v18.0.1.3.0 si no lo has hecho - -### Corto Plazo -- [ ] Configura en Settings (si es necesario) -- [ ] Verifica performance (sección "Verificación" en docs) - -### Largo Plazo -- [ ] Monitorea performance en producción -- [ ] Considera mejoras futuras (ver LAZY_LOADING.md) - ---- - -**Última Actualización**: 2026-02-16 -**Versión de Documentación**: 1.0 -**Odoo Version**: 18.0+ -**Lazy Loading Version**: 18.0.1.3.0+ - -Para comenzar, selecciona la sección que más te interese arriba ☝️ diff --git a/DOCUMENTATION_UPDATE_SUMMARY.md b/DOCUMENTATION_UPDATE_SUMMARY.md deleted file mode 100644 index b48219d..0000000 --- a/DOCUMENTATION_UPDATE_SUMMARY.md +++ /dev/null @@ -1,273 +0,0 @@ -# 📋 Resumen de Documentación Creada - Lazy Loading v18.0.1.3.0 - -## ✅ Actualización Completa - -Se ha completado la actualización de toda la documentación del proyecto para reflejar la nueva feature de lazy loading implementada en `website_sale_aplicoop`. - ---- - -## 📄 Archivos Creados y Actualizados - -### 🆕 Nuevos Archivos Creados - -#### 1. [docs/LAZY_LOADING_QUICK_START.md](../docs/LAZY_LOADING_QUICK_START.md) -**Tipo**: Guía Rápida (~100 líneas) -**Contenido**: -- ✅ TL;DR - Lo más importante -- ✅ Qué necesitas hacer (actualizar y listo) -- ✅ Métricas de mejora de performance (20x más rápido) -- ✅ Configuración opcional (enable/disable, items per page) -- ✅ Troubleshooting rápido (5 problemas comunes) -- ✅ Verificación rápida (cómo comprobar que funciona) -- ✅ Rollback instructions -- ✅ Enlaces a documentación completa - -**Audiencia**: Usuarios que quieren "instalar y olvidar" - ---- - -#### 2. [docs/LAZY_LOADING.md](../docs/LAZY_LOADING.md) -**Tipo**: Documentación Técnica Completa (~600 líneas) -**Contenido**: -- ✅ Descripción detallada del problema (carga 10-20s) -- ✅ Solución implementada (lazy loading + configuración) -- ✅ Arquitectura y diseño del sistema -- ✅ Cambios de código por archivo (5 archivos modificados) -- ✅ Configuración en res_config_settings -- ✅ Endpoints HTTP (eskaera_shop, load_eskaera_page) -- ✅ Métricas de rendimiento (20x más rápido) -- ✅ Guía de testing y debugging -- ✅ Troubleshooting avanzado -- ✅ Roadmap de mejoras futuras - -**Audiencia**: Desarrolladores, Administradores Técnicos - ---- - -#### 3. [docs/UPGRADE_INSTRUCTIONS_v18.0.1.3.0.md](../docs/UPGRADE_INSTRUCTIONS_v18.0.1.3.0.md) -**Tipo**: Guía de Actualización e Instalación (~180 líneas) -**Contenido**: -- ✅ Resumen de cambios en v18.0.1.3.0 -- ✅ Pasos de actualización paso a paso -- ✅ Configuración de settings (3 opciones) -- ✅ Valores recomendados y explicaciones -- ✅ Checklist de validación post-instalación (4 pasos) -- ✅ Troubleshooting de problemas comunes (4 escenarios): - - "Load More" button not appearing - - Products not loading on button click - - Spinner never disappears - - Page crashes after loading products -- ✅ Método de verificación de rendimiento -- ✅ Instrucciones de rollback -- ✅ Notas importantes sobre comportamiento - -**Audiencia**: Administradores de Sistema, DevOps - ---- - -#### 3. [docs/LAZY_LOADING_DOCS_INDEX.md](../docs/LAZY_LOADING_DOCS_INDEX.md) -**Tipo**: Índice Centralizado de Documentación -**Contenido**: -- ✅ Overview de la feature -- ✅ Índice de los 4 documentos relacionados -- ✅ Guía de selección (qué leer según tu rol) -- ✅ Resumen de cambios de código -- ✅ Checklist de implementación -- ✅ Notas importantes y limitaciones -- ✅ Enlaces rápidos a todos los docs -- ✅ Información de impacto y performance - -**Audiencia**: Todos (punto de partida recomendado) - ---- - -#### 4. [website_sale_aplicoop/CHANGELOG.md](../website_sale_aplicoop/CHANGELOG.md) -**Tipo**: Registro de Cambios -**Contenido**: -- ✅ v18.0.1.3.0: Lazy loading feature (2 puntos) -- ✅ v18.0.1.2.0: UI improvements (3 puntos) -- ✅ v18.0.1.0.0: Initial release - -**Audiencia**: Todos - ---- - -### 🔄 Archivos Actualizados - -#### 5. [README.md](../README.md) - Proyecto Principal -**Cambios realizados**: -- ✅ Añadido emoji 🚀 a website_sale_aplicoop en tabla de componentes -- ✅ Añadida nota sobre lazy loading en v18.0.1.3.0 con referencia a docs -- ✅ Añadidos dos enlaces nuevos en sección "Documentos Principales": - - 🚀 [Lazy Loading Documentation](docs/LAZY_LOADING.md) - - 📦 [Upgrade Instructions v18.0.1.3.0](docs/UPGRADE_INSTRUCTIONS_v18.0.1.3.0.md) - ---- - -#### 6. [docs/README.md](../docs/README.md) - Índice de Documentación Técnica -**Cambios realizados**: -- ✅ Añadida nueva sección "Performance & Features (Nuevas)" -- ✅ Tres nuevos enlaces: - - [LAZY_LOADING_DOCS_INDEX.md](LAZY_LOADING_DOCS_INDEX.md) - - [LAZY_LOADING.md](LAZY_LOADING.md) - - [UPGRADE_INSTRUCTIONS_v18.0.1.3.0.md](UPGRADE_INSTRUCTIONS_v18.0.1.3.0.md) - ---- - -#### 7. [website_sale_aplicoop/README.md](../website_sale_aplicoop/README.md) - Addon Específico -**Cambios realizados** (realizados en fase anterior): -- ✅ Añadida feature de lazy loading en lista de features -- ✅ Actualizado changelog con v18.0.1.3.0 -- ✅ Descripción detallada de lazy loading en changelog - ---- - -## 🎯 Estructura de Documentación Recomendada - -### Para Administradores/Usuarios: -``` -1. Lee: docs/LAZY_LOADING_DOCS_INDEX.md (orientación) -2. Luego: docs/UPGRADE_INSTRUCTIONS_v18.0.1.3.0.md (instalación) -3. Si hay dudas: Consulta sección de configuración en website_sale_aplicoop/README.md -4. Si hay problemas: Troubleshooting en UPGRADE_INSTRUCTIONS -``` - -### Para Desarrolladores: -``` -1. Lee: docs/LAZY_LOADING_DOCS_INDEX.md (visión general) -2. Luego: docs/LAZY_LOADING.md (arquitectura técnica) -3. Revisa: Cambios de código en LAZY_LOADING.md (sección "Code Changes") -4. Debugging: Sección "Debugging & Testing" en LAZY_LOADING.md -5. Mejoras: "Future Improvements" al final de LAZY_LOADING.md -``` - -### Para Troubleshooting: -``` -1. Primero: docs/UPGRADE_INSTRUCTIONS_v18.0.1.3.0.md (Troubleshooting section) -2. Si persiste: docs/LAZY_LOADING.md (Debugging & Testing) -3. Para rollback: UPGRADE_INSTRUCTIONS_v18.0.1.3.0.md (Rollback Instructions) -``` - ---- - -## 📊 Cobertura de Documentación - -| Tema | Covered | Donde | -|------|---------|-------| -| **Problem Statement** | ✅ | LAZY_LOADING.md, UPGRADE_INSTRUCTIONS | -| **Solution Overview** | ✅ | LAZY_LOADING_DOCS_INDEX.md, LAZY_LOADING.md | -| **Architecture** | ✅ | LAZY_LOADING.md | -| **Code Changes** | ✅ | LAZY_LOADING.md (por archivo) | -| **Configuration** | ✅ | UPGRADE_INSTRUCTIONS, website_sale_aplicoop/README.md | -| **Installation** | ✅ | UPGRADE_INSTRUCTIONS | -| **Testing** | ✅ | LAZY_LOADING.md | -| **Troubleshooting** | ✅ | UPGRADE_INSTRUCTIONS, LAZY_LOADING.md | -| **Performance Metrics** | ✅ | Todos los docs | -| **Rollback** | ✅ | UPGRADE_INSTRUCTIONS | -| **Future Improvements** | ✅ | LAZY_LOADING.md | - ---- - -## 🔗 Matriz de Enlaces - -Todos los documentos están interconectados para facilitar la navegación: - -``` -README.md (principal) -├── docs/LAZY_LOADING_DOCS_INDEX.md (índice) -│ ├── docs/LAZY_LOADING.md (técnico) -│ ├── docs/UPGRADE_INSTRUCTIONS_v18.0.1.3.0.md (instalación) -│ ├── website_sale_aplicoop/README.md (addon) -│ └── website_sale_aplicoop/CHANGELOG.md (historial) -├── docs/README.md (índice de docs) -└── website_sale_aplicoop/README.md (addon directo) -``` - ---- - -## 📈 Métricas de la Documentación - -| Métrica | Valor | -|---------|-------| -| **Archivos nuevos creados** | 4 | -| **Archivos actualizados** | 4 | -| **Líneas de documentación** | ~1,400+ | -| **Secciones documentadas** | 20+ | -| **Ejemplos incluidos** | 15+ | -| **Problemas cubiertos en troubleshooting** | 4 | -| **Mejoras futuras documentadas** | 4 | - ---- - -## ✨ Highlights de la Documentación - -### 📌 Punto de Entrada Único -- **[docs/LAZY_LOADING_DOCS_INDEX.md](../docs/LAZY_LOADING_DOCS_INDEX.md)** - Índice con guía de selección según rol - -### 📌 Documentación Técnica Completa -- **[docs/LAZY_LOADING.md](../docs/LAZY_LOADING.md)** - 600+ líneas de detalles técnicos, cambios de código, testing, debugging - -### 📌 Guía Práctica de Instalación -- **[docs/UPGRADE_INSTRUCTIONS_v18.0.1.3.0.md](../docs/UPGRADE_INSTRUCTIONS_v18.0.1.3.0.md)** - Paso a paso con checklist de validación y troubleshooting - -### 📌 Changelog Detallado -- **[website_sale_aplicoop/CHANGELOG.md](../website_sale_aplicoop/CHANGELOG.md)** - Historial completo de versiones - -### 📌 README Actualizado -- **[README.md](../README.md)** - Referencia al nuevo feature con enlaces - ---- - -## 🚀 Próximos Pasos - -La documentación está completa y lista para: - -1. ✅ **Publicación**: Todos los archivos están listos para ser compartidos -2. ✅ **Integración**: Enlaces cruzados correctamente configurados -3. ✅ **Accesibilidad**: Índice centralizado para encontrar información fácilmente -4. ✅ **Mantenibilidad**: Estructura clara para futuras actualizaciones - -### Sugerencias Futuras: -- Crear video tutorial (5-10 min) demostrando lazy loading en acción -- Agregar métricas en vivo de performance en Settings UI -- Crear tests automatizados para validar configuración - ---- - -## 📞 Preguntas Frecuentes Documentadas - -| Pregunta | Respuesta en | -|----------|-------------| -| ¿Qué es lazy loading? | LAZY_LOADING.md intro | -| ¿Cómo instalo? | UPGRADE_INSTRUCTIONS | -| ¿Cómo configuro? | UPGRADE_INSTRUCTIONS + website_sale_aplicoop/README.md | -| ¿Cómo veo mejora de performance? | UPGRADE_INSTRUCTIONS (Performance Verification) | -| ¿Qué pasa si falla? | UPGRADE_INSTRUCTIONS (Troubleshooting) | -| ¿Puedo deshabilitarlo? | Sí, UPGRADE_INSTRUCTIONS sección Configuration | -| ¿Cómo hago rollback? | UPGRADE_INSTRUCTIONS (Rollback Instructions) | -| ¿Detalles técnicos? | LAZY_LOADING.md | - ---- - -## 🎓 Aprendizaje de Documentación - -Esta documentación demuestra: -- ✅ Documentación técnica completa y detallada -- ✅ Guías prácticas paso a paso -- ✅ Índices centralizados para fácil navegación -- ✅ Troubleshooting proactivo -- ✅ Interconexión de documentos -- ✅ Diferentes niveles de profundidad (overview → técnico) -- ✅ Cobertura completa de usuario y desarrollador - ---- - -**Estado**: ✅ COMPLETADO -**Documentación Creada**: 3 archivos nuevos, 4 actualizados -**Líneas Totales**: 1,200+ -**Fecha**: 2026-02-16 -**Versión Aplicable**: 18.0.1.3.0+ - ---- - -¿Necesitas que ajuste algo en la documentación o que cree documentos adicionales? diff --git a/README.md b/README.md index d064ba6..cb91d3e 100644 --- a/README.md +++ b/README.md @@ -1,259 +1,10 @@ -# Kidekoop - Addons Custom para Odoo 18.0 +# Oddo Addons Criptomart -Sistema de gestión de compras colaborativas (grupo de consumo) basado en Odoo 18.0 con módulos personalizados y modificados. - -## 🎯 Descripción - -Este repositorio contiene los addons personalizados para Kidekoop, un sistema completo de gestión de grupos de consumo que permite: - -- **Gestión de compras colaborativas** (eskaera) -- **Sistema de precios multinivel** con categorías y descuentos múltiples -- **Integración con proveedores** y gestión de precios automática -- **Interfaz web moderna** para pedidos grupales -- **Multiidioma** (ES, EU, CA, GL, PT, FR, IT) - -## 📦 Componentes del Proyecto - -### 1. OCB - Odoo Community Backports -- **Ubicación**: `/ocb` -- **Versión**: 18.0 -- **Descripción**: Base de Odoo Community Edition -- **Repositorio**: https://github.com/OCA/OCB - -### 2. Addons OCA Modificados - -| Addon | Propósito | Repositorio OCA | -|-------|-----------|-----------------| -| [account_invoice_triple_discount](account_invoice_triple_discount/) | Sistema de triple descuento en facturas | account-invoicing | -| [purchase_triple_discount](purchase_triple_discount/) | Sistema de triple descuento en compras | purchase-workflow | -| [product_origin](product_origin/) | Campo de origen del producto | product-attribute | -| [product_get_price_helper](product_get_price_helper/) | Helper para cálculo de precios | product-attribute | -| [product_main_seller](product_main_seller/) | Proveedor principal por producto | purchase-workflow | -| [product_price_category](product_price_category/) | Sistema de categorías de precio | product-attribute | - -### 3. Addons Custom Propios +## Addons | Addon | Propósito | Estado | |-------|-----------|--------| -| [account_invoice_triple_discount_readonly](account_invoice_triple_discount_readonly/) | Fix para bug de descuentos acumulados | ✅ Estable | -| [product_price_category_supplier](product_price_category_supplier/) | Gestión de categorías por proveedor | ✅ Estable | -| [product_sale_price_from_pricelist](product_sale_price_from_pricelist/) | Auto-cálculo precio venta desde compra | ✅ Estable | -| [website_sale_aplicoop](website_sale_aplicoop/) | Sistema completo de eskaera web | ✅ **v18.0.1.3.1** - Estable | - -**✨ Feature v18.0.1.3.0**: `website_sale_aplicoop` incluye **lazy loading configurable** para mejorar el rendimiento de carga de productos (10-20s → 500-800ms). - -**🔧 Fixes v18.0.1.3.1**: Correcciones críticas en cálculo de fechas y refactor de template rendering para evitar errores QWeb. - -Ver [docs/LAZY_LOADING.md](docs/LAZY_LOADING.md) y [docs/FINAL_SOLUTION_SUMMARY.md](docs/FINAL_SOLUTION_SUMMARY.md) para detalles. - -## 🚀 Quick Start - -### Requisitos - -- Docker & Docker Compose -- Python 3.10+ -- PostgreSQL 14+ - -### Instalación - -```bash -# Clonar repositorio -git clone [URL_REPO] -cd addons-cm - -# Iniciar entorno -docker-compose up -d - -# Verificar logs -docker-compose logs -f odoo -``` - -### Instalar un addon - -```bash -docker-compose exec odoo odoo -d odoo -u addon_name --stop-after-init -``` - -## 🛠️ Desarrollo - -### Estructura de Carpetas - -``` -addons-cm/ -├── .github/ # GitHub Copilot instructions -├── ocb/ # Odoo 18.0 base -├── account_invoice_*/ # Addons de facturación -├── purchase_*/ # Addons de compras -├── product_*/ # Addons de productos -├── website_sale_aplicoop/ # Sistema eskaera -├── docker-compose.yml # Configuración Docker -├── requirements.txt # Dependencias Python -├── oca_dependencies.txt # Dependencias OCA -├── Makefile # Comandos útiles -└── .pre-commit-config.yaml # Hooks de pre-commit -``` - -### Herramientas de Calidad - -```bash -# Ejecutar checks de código -make lint - -# Formatear código -make format - -# Ejecutar todos los pre-commit hooks -pre-commit run --all-files - -# Verificar addon específico -./check_addon.sh addon_name -``` - -### Tests - -```bash - -# Ejecutar tests de un addon -docker-compose run odoo odoo -d odoo --test-enable --stop-after-init -u addon_name -# NOTA: Usa `docker-compose run` (no `exec`) para lanzar un contenedor limpio y evitar efectos de caché. Cambia `addon_name` por el módulo a testear. - -# Tests específicos con Python unittest -docker-compose exec odoo python -m pytest addons/addon_name/tests/ -``` - -## 🌍 Sistema de Traducciones - -Todos los addons custom incluyen traducciones completas en: - -- **Español** (es) - Obligatorio -- **Euskera** (eu) - Obligatorio -- **Catalán** (ca) -- **Gallego** (gl) -- **Portugués** (pt) -- **Francés** (fr) -- **Italiano** (it) - -### Actualizar Traducciones - -```bash -# Exportar términos traducibles -docker-compose exec odoo odoo \ - --addons-path=/mnt/extra-addons \ - --i18n-export=/tmp/addon_name.pot \ - --modules=addon_name \ - --db=odoo - -# Actualizar archivos .po -cd addon_name/i18n -msgmerge --update es.po addon_name.pot -msgmerge --update eu.po addon_name.pot -``` - -**Importante**: No usar `_()` en definiciones de campos a nivel de módulo. Solo usar en métodos. - -📖 **[Ver guía completa de traducciones](docs/TRANSLATIONS.md)** - -## 📖 Documentación Adicional - -Cada addon incluye su propio README.md con: -- Arquitectura y diseño -- Detalles de implementación -- Ejemplos de uso -- Casos de prueba - -### Documentos Principales - -- [GitHub Copilot Instructions](.github/copilot-instructions.md) - Guía para desarrollo con AI -- [Documentación Técnica](docs/) - Guías de instalación, linters, y troubleshooting -- **[🚀 Lazy Loading Documentation](docs/LAZY_LOADING.md)** - Guía técnica completa sobre la nueva feature de carga lazy -- **[📦 Upgrade Instructions v18.0.1.3.0](docs/UPGRADE_INSTRUCTIONS_v18.0.1.3.0.md)** - Guía de actualización e instalación de lazy loading -- [Makefile](Makefile) - Comandos disponibles -- [requirements.txt](requirements.txt) - Dependencias Python -- [oca_dependencies.txt](oca_dependencies.txt) - Repositorios OCA necesarios - -## 🔧 Configuración - -### Dependencias OCA - -Este proyecto depende de los siguientes repositorios OCA: - -- **account-invoicing**: Sistema de facturación extendido -- **product-attribute**: Gestión avanzada de productos -- **purchase-workflow**: Flujos de compra personalizados -- **sale-workflow**: Flujos de venta personalizados - -### Configuración de Odoo - -Archivo `odoo.conf` incluye: -- Configuración de addons path -- Parámetros de base de datos -- Configuración de workers y límites - -## 🐛 Issues Conocidos y Soluciones - -### Descuentos Acumulándose en discount1 - -**Problema**: Al usar triple descuento, todos los descuentos se acumulan en el primer campo. - -**Solución**: Instalar `account_invoice_triple_discount_readonly` - -### Precio de Venta No Actualiza - -**Problema**: El precio de venta no se calcula automáticamente desde el precio de compra. - -**Solución**: Configurar `product_sale_price_from_pricelist` correctamente. - -### Warnings de Traducción - -**Problema**: `WARNING: _() called at import time at module...` - -**Solución**: No usar `_()` en definiciones de campos, solo en métodos ejecutables. - -## 🤝 Contribuir - -### Estándares de Código - -- Seguir [OCA Guidelines](https://github.com/OCA/odoo-community.org/blob/master/website/Contribution/CONTRIBUTING.rst) -- Usar **black** para formateo -- Usar **isort** para imports -- Pasar **flake8** y **pylint-odoo** -- Todos los commits deben pasar pre-commit hooks - -### Estructura de Commits - -``` -[TAG] module_name: Brief description - -Detailed explanation if needed - -Tags: [ADD], [FIX], [IMP], [REF], [REM], [I18N], [DOC] -``` - -### Testing - -Todos los nuevos features deben incluir: -- Tests unitarios -- Tests de integración (si aplica) -- Documentación actualizada - -## 📝 License - -AGPL-3.0 or later - -## 👥 Autores - -- **Criptomart** - Development -- **OCA Community** - Base addons - -## 🔗 Enlaces - -- **Odoo Documentation**: https://www.odoo.com/documentation/18.0/ -- **OCA**: https://github.com/OCA -- **OCB**: https://github.com/OCA/OCB -- **OCA Guidelines**: https://github.com/OCA/odoo-community.org - ---- - -**Versión Odoo**: 18.0 -**Python**: 3.10+ -**Última Actualización**: 2026-02-12 +| [account_invoice_triple_discount_readonly](account_invoice_triple_discount_readonly/) | Fix para bug de descuentos acumulados | Alpha | +| [product_price_category_supplier](product_price_category_supplier/) | Gestión de categorías por proveedor | Alpha | +| [product_sale_price_from_pricelist](product_sale_price_from_pricelist/) | Auto-cálculo precio venta desde compra | Alpha | +| [website_sale_aplicoop](website_sale_aplicoop/) | Sistema completo de pedidos para grupos de consumo | Alpha | diff --git a/product_price_category_supplier/BEFORE_AND_AFTER.md b/product_price_category_supplier/BEFORE_AND_AFTER.md deleted file mode 100644 index cc4a1e5..0000000 --- a/product_price_category_supplier/BEFORE_AND_AFTER.md +++ /dev/null @@ -1,370 +0,0 @@ -# BEFORE & AFTER - Error Fixes - -**Document**: Visual comparison of all changes made to fix installation errors -**Date**: 10 de febrero de 2026 -**Status**: ✅ All fixed and working - ---- - -## File 1: views/res_partner_views.xml - -### Error Description -**ParseError**: "Element '' cannot be located in parent view" - -The XPath path was searching for a page that doesn't exist in Odoo 18. - ---- - -### BEFORE ❌ - -```xml - - - - - res.partner.form.price.category - res.partner - - - - ← ❌ WRONG! - - -