120 lines
3.6 KiB
Markdown
120 lines
3.6 KiB
Markdown
# Migración de Base de Datos - Sistema de Márgenes Inteligentes
|
|
|
|
## 📝 Resumen
|
|
|
|
Se agregan tres campos nuevos a la base de datos:
|
|
|
|
1. `res_partner.supplier_type` → Selection (5 opciones)
|
|
2. `product_category.margin_percent` → Float (default: 20.0)
|
|
3. `product_template.default_supplier_id` → Many2one a res.partner
|
|
|
|
## 🗃️ Scripts de Migración
|
|
|
|
### Opción 1: Migración Automática (Recomendado)
|
|
|
|
Odoo genera automáticamente las columnas al actualizar el módulo:
|
|
|
|
```bash
|
|
cd /home/snt/Documentos/lab/odoo/kidekoop/odoo-addons
|
|
python -m odoo -d odoo -u website_sale_aplicoop
|
|
```
|
|
|
|
### Opción 2: Migración Manual (para producción)
|
|
|
|
```sql
|
|
-- Agregamos columna supplier_type a res_partner
|
|
ALTER TABLE res_partner
|
|
ADD COLUMN IF NOT EXISTS supplier_type VARCHAR(50)
|
|
DEFAULT 'non_supplier';
|
|
|
|
-- Agregamos columna margin_percent a product_category
|
|
ALTER TABLE product_category
|
|
ADD COLUMN IF NOT EXISTS margin_percent NUMERIC(5,2)
|
|
DEFAULT 20.0;
|
|
|
|
-- Agregamos columna default_supplier_id a product_template
|
|
ALTER TABLE product_template
|
|
ADD COLUMN IF NOT EXISTS default_supplier_id INTEGER REFERENCES res_partner(id);
|
|
|
|
-- Crear índice para búsquedas rápidas
|
|
CREATE INDEX IF NOT EXISTS idx_res_partner_supplier_type
|
|
ON res_partner(supplier_type);
|
|
```
|
|
|
|
## ✅ Validación Post-Migración
|
|
|
|
```sql
|
|
-- Verificar que las columnas existan
|
|
SELECT column_name, data_type, column_default
|
|
FROM information_schema.columns
|
|
WHERE table_name = 'res_partner'
|
|
AND column_name = 'supplier_type';
|
|
|
|
SELECT column_name, data_type, column_default
|
|
FROM information_schema.columns
|
|
WHERE table_name = 'product_category'
|
|
AND column_name = 'margin_percent';
|
|
|
|
SELECT column_name, data_type, column_default
|
|
FROM information_schema.columns
|
|
WHERE table_name = 'product_template'
|
|
AND column_name = 'default_supplier_id';
|
|
```
|
|
|
|
## 🔄 Compatibilidad Backward
|
|
|
|
- **Sin pérdida de datos**: Solo se agregan campos nuevos
|
|
- **Valores por defecto**: Todos tienen valores por defecto
|
|
- **No requiere desinstalación**: Se puede actualizar sobre instalación existente
|
|
- **Reversible**: Los campos se pueden eliminar sin afectar otros
|
|
|
|
## 📊 Impacto en Base de Datos
|
|
|
|
| Tabla | Cambios | Tamaño (aprox.) |
|
|
|-------|---------|-----------------|
|
|
| res_partner | +1 columna VARCHAR(50) | +50 bytes por fila |
|
|
| product_category | +1 columna NUMERIC(5,2) | +8 bytes por fila |
|
|
| product_template | +1 columna INTEGER (FK) | +8 bytes por fila |
|
|
|
|
**Total**: ~66 bytes por producto existente (negligible)
|
|
|
|
## 🚀 Procedimiento de Actualización
|
|
|
|
```bash
|
|
# 1. Backup de la BD
|
|
pg_dump odoo > backup_2025_12_16.sql
|
|
|
|
# 2. Actualizar código
|
|
cd /home/snt/Documentos/lab/odoo/kidekoop/odoo-addons
|
|
git add -A
|
|
git commit -m "feat: add supplier pricing system with margins"
|
|
|
|
# 3. Actualizar módulo
|
|
python -m odoo -d odoo -u website_sale_aplicoop --stop-after-init
|
|
|
|
# 4. Ejecutar tests
|
|
python -m pytest website_sale_aplicoop/tests/test_supplier_pricing.py -v
|
|
|
|
# 5. Validar en UI (opcional)
|
|
python -m odoo -d odoo -p 8069 --xmlrpc
|
|
# Ir a http://localhost:8069
|
|
# Contactos → ver supplier_type
|
|
# Productos → Categorías → ver margin_percent
|
|
```
|
|
|
|
## ⚠️ Notas Importantes
|
|
|
|
1. **Margen mínimo**: Se valida en Python, no en BD
|
|
2. **Compatibilidad**: Los campos son opcionales (valores por defecto)
|
|
3. **Performance**: El campo supplier_type es indexed para búsquedas rápidas
|
|
4. **Extensibilidad**: Se pueden agregar más tipos de proveedor sin modificar BD
|
|
|
|
## 📋 Checklist Post-Migración
|
|
|
|
- [ ] Campos creados correctamente
|
|
- [ ] Valores por defecto aplicados
|
|
- [ ] Índices creados
|
|
- [ ] Tests pasen
|
|
- [ ] UI muestra campos nuevos
|
|
- [ ] Datos existentes intactos
|
|
- [ ] Backup realizado
|