demo files
This commit is contained in:
snt
parent
6381a2d985
commit
a483925005
10 changed files with 1391 additions and 24 deletions
247
website_sale_aplicoop/demo/README.md
Normal file
247
website_sale_aplicoop/demo/README.md
Normal file
|
|
@ -0,0 +1,247 @@
|
|||
# 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
|
||||
Loading…
Add table
Add a link
Reference in a new issue