addons-cm/website_sale_aplicoop/demo/README.md
2026-02-27 13:43:56 +01:00

8.6 KiB

Demo Data - Website Sale Aplicoop

Este directorio contiene datos de demostración completos para el addon website_sale_aplicoop, diseñados para mostrar todas las funcionalidades del sistema de pedidos colaborativos (eskaera) para cooperativas de consumo.

Contenido de los Archivos Demo

1. res_partner_demo.xml - Grupos y Miembros

Grupos de Consumo (3 grupos):

  • Garaialde Kooperatiba (Bilbao)

    • Grupo activo con pedidos semanales
    • 3 miembros activos
  • Lamiakada Kontsumoko Taldea (Donostia)

    • Grupo con pedidos quincenales
    • 2 miembros activos
  • Eko Auzolan (Gasteiz)

    • Grupo con pedidos mensuales
    • 2 miembros activos

Total Miembros: 7 personas distribuidas entre los 3 grupos

2. res_partner_suppliers_demo.xml - Proveedores

6 Proveedores Locales:

  • Baserritarra SL - Productos frescos locales y de temporada
  • Bio Zikloa Kooperatiba - Productos ecológicos certificados
  • Artizarra Esnea - Lácteos artesanales del País Vasco
  • Hiruki Kontserbak - Conservas y productos elaborados artesanales
  • Ekotalde Barazkiak - Verduras eco de km 0
  • Auzoko Okindegia - Pan artesano y repostería tradicional vasca

Todos los proveedores tienen supplier_rank > 0 y pueden ser asignados a group orders.

3. product_demo.xml - Productos y Categorías

Categorías de Producto:

  • Fruta Fresca
  • Verdura Fresca
  • Lácteos
  • Pan y Repostería
  • Conservas

13 Productos Demo:

Código Nombre Categoría Proveedor(es) Precio/€
MANZ-ECO Manzana Ecológica Fruta Baserritarra 2.50/kg
NARA-VAL Naranja Valenciana Fruta Bio Zikloa 2.80/kg
PLAT-CAN Plátano de Canarias Fruta Bio Zikloa 3.20/kg
TOMA-ECO Tomate Ecológico Verdura Baserritarra 3.50/kg
LECH-KM0 Lechuga Km 0 Verdura Ekotalde 1.50/ud
PIMI-VER Pimiento Verde Verdura Ekotalde 4.20/kg
LECH-ENT Leche Entera Artesana Lácteos Artizarra 1.80/L
YOGU-NAT Yogur Natural (Pack 4) Lácteos Artizarra 3.20/ud
QUES-IDI Queso Idiazabal D.O. Lácteos Artizarra 25.00/kg
PAN-INT Pan Integral Artesano Pan/Repostería Auzoko Okindegia 3.50/kg
POST-GOX Goxua (6 unidades) Pan/Repostería Auzoko Okindegia 8.50/ud
CONS-BON Bonito del Norte en Aceite Conservas Hiruki 12.50/ud
CONS-PIQ Pimientos del Piquillo D.O. Conservas Hiruki 5.80/ud

Plus:

  • SRV-DELIV - Servicio de Envío a Domicilio (5.00€/servicio)

Todos los productos incluyen:

  • Configuración de impuestos (IVA 4%, 10% o 21% según corresponda)
  • Información de proveedor (precio, cantidad mínima, plazo de entrega)
  • Unidades de medida apropiadas (kg, L, unidad)

4. group_order_demo.xml - Pedidos de Grupo

8 Group Orders con diferentes configuraciones:

  1. Eskaera Astekaria Garaialde (ACTIVO)

    • Tipo: Regular (weekly)
    • Grupo: Garaialde
    • Pickup: Viernes / Cutoff: Jueves
    • Home delivery: SÍ
    • Proveedores: Baserritarra, Ekotalde, Artizarra, Okindegia
    • Categorías: Frutas, Verduras, Lácteos, Pan
  2. Eskaera Hamabostaldia Lamiakada (ACTIVO)

    • Tipo: Regular (biweekly)
    • Grupo: Lamiakada
    • Pickup: Sábado / Cutoff: Viernes
    • Home delivery: NO
    • Proveedores: Bio Zikloa, Hiruki
    • Categorías: Frutas, Conservas
  3. Eskaera Hilabetekoa Eko Auzolan (ACTIVO)

    • Tipo: Regular (monthly)
    • Grupo: Eko Auzolan
    • Pickup: Lunes / Cutoff: Domingo
    • Home delivery: SÍ
    • Productos específicos: Queso Idiazabal, Bonito, Pimientos Piquillo
  4. Eskaera Berezia - Denboraldia (ACTIVO - Temporal)

    • Tipo: Special (once)
    • Grupos: Garaialde + Lamiakada
    • Duración: 14 días
    • Productos de temporada: Tomate, Pimiento, Lechuga
  5. Eskaera Promozionala - Gabonak (FUTURO)

    • Tipo: Promotional (once)
    • Grupos: Los 3 grupos
    • Inicio: +5 días / Fin: +21 días
    • Productos: Goxua, Queso Idiazabal, Bonito
  6. Eskaera Astekaria (Itxita) (CERRADO - Histórico)

    • Ejemplo de pedido histórico finalizado
    • Útil para testing de históricos
  7. Eskaera Kolektiboa - Ekintza Elkartua (MULTI-GRUPO)

    • Los 3 grupos participan
    • Productos excluidos: Plátano de Canarias (demo de blacklist)
  8. Eskaera Urtekoa - Produktu Iraunkorra (CON EXCLUSIONES)

    • Demo de funcionalidad de blacklist
    • Excluye: Pimientos del Piquillo

5. sale_order_demo.xml - Pedidos de Venta

9 Sale Orders asociados a diferentes group orders y miembros:

Estado CONFIRMED (sale):

  • Ane García: 4 líneas (frutas, verduras, leche, pan) - Pickup en tienda
  • Mikel Lopez: 3 líneas + delivery - Con envío a domicilio ✓
  • Jon Fernández: 3 líneas (conservas, frutas)
  • Unai Sánchez: 3 líneas + delivery - Pedido mensual

Estado DRAFT:

  • Leire Martínez: 2 líneas (naranjas, queso)
  • Amaia Méndez: 1 línea (naranjas)
  • Ainhoa Rodríguez: 1 línea (conservas)
  • Ane García (especial): 3 líneas - Pedido de temporada

Características destacadas:

  • Mezcla de pedidos confirmados y en borrador
  • Algunos con home_delivery=True (incluyen producto de delivery)
  • Diferentes fechas de pickup según el group order
  • Cantidades realistas y variadas

Instalación y Uso

Instalación Básica (Sin Demo)

docker-compose run odoo odoo -d odoo -i website_sale_aplicoop --stop-after-init

Instalación con Datos Demo

docker-compose run odoo odoo -d odoo -i website_sale_aplicoop --load-language=es_ES --load-language=eu_ES --stop-after-init --demo=True

O desde la UI de Odoo:

  1. Apps > Buscar "Website Sale - Aplicoop"
  2. Asegurarse de que la base de datos tiene demo data habilitado
  3. Instalar el módulo

Acceso a los Datos Demo

Backend (Odoo):

  • Ventas > Órdenes > Consumer Group Orders
  • Contactos > Filtrar por "Is a Consumer Group"
  • Productos > Ver productos demo con prefijos MANZ-, NARA-, etc.

Frontend (Website):

  1. Ir a /shop/eskaera
  2. Los group orders estarán visibles según permisos
  3. Hacer login como uno de los miembros demo para probar el flujo completo

Usuarios Demo Recomendados

Para testing, crear usuarios de Odoo asociados a estos partners:

  • ane.garcia@example.com (Garaialde - Pedido semanal)
  • jon.fernandez@example.com (Lamiakada - Pedido quincenal)
  • unai.sanchez@example.com (Eko Auzolan - Pedido mensual)

Casos de Uso Cubiertos

Los datos demo permiten probar:

Flujos básicos:

  • Crear/editar/confirmar pedidos individuales
  • Añadir productos al carrito de eskaera
  • Seleccionar home delivery
  • Ver fechas de pickup y cutoff

Configuraciones variadas:

  • Pedidos semanales, quincenales, mensuales
  • Pedidos especiales (one-time)
  • Pedidos promocionales con fechas futuras
  • Multi-grupo (varios grupos en un pedido)

Filtrado de productos:

  • Por proveedores
  • Por categorías
  • Por productos específicos
  • Con exclusiones (blacklist)

Gestión de grupos:

  • Múltiples grupos de diferentes ciudades
  • Miembros con diferentes patrones de compra
  • Asociaciones grupo-miembro

Reportes y análisis:

  • Pedidos históricos (cerrados)
  • Pedidos activos con diferentes estados
  • Datos para testing de lazy loading
  • Datos para testing de date calculations

Mantenimiento

Para regenerar o actualizar los datos demo:

# Limpiar base de datos
docker-compose run odoo odoo -d odoo --init=website_sale_aplicoop --demo=True --stop-after-init

# O actualizar solo el módulo
docker-compose run odoo odoo -d odoo -u website_sale_aplicoop --stop-after-init

Notas Importantes

  • Los precios incluyen IVA según categoría de producto
  • Las fechas de group orders usan eval con DateTime.today() para ser dinámicas
  • Los supplierinfo están correctamente configurados con precios y MOQ
  • Todos los partners tienen direcciones completas en España (Euskadi)
  • Los códigos de producto siguen un patrón coherente para fácil identificación

Contribuir

Para añadir más datos demo:

  1. Seguir la estructura existente
  2. Usar XML IDs descriptivos (ej: product_nombre_descriptivo)
  3. Mantener coherencia en nombres (euskera + castellano)
  4. Documentar en este README

Versión: 18.0.1.7.0 Última actualización: 2026-02-26 Autor: Criptomart