# 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)

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

### Instalación con Datos Demo

```bash
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:

```bash
# 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
