247 lines
8.6 KiB
Markdown
247 lines
8.6 KiB
Markdown
# 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
|