Aplicoop desde el repo de kidekoop
This commit is contained in:
snt
parent
69917d1ec2
commit
7cff89e418
93 changed files with 313992 additions and 0 deletions
295
website_sale_aplicoop/README.md
Normal file
295
website_sale_aplicoop/README.md
Normal file
|
|
@ -0,0 +1,295 @@
|
|||
# Website Sale - Aplicoop
|
||||
|
||||
**Author:** Criptomart
|
||||
**License:** AGPL-3
|
||||
**Maintainer:** Criptomart SL
|
||||
|
||||
## Summary
|
||||
|
||||
Modern replacement for legacy Aplicoop - Cooperative group ordering system with separate carts and multi-language support.
|
||||
|
||||
## Description
|
||||
|
||||
Website Sale Aplicoop provides a complete group ordering system designed for cooperative consumption groups. It replaces the legacy Aplicoop system with a modern, scalable solution where customers organize collaborative orders, manage group memberships, and handle separate shopping carts. Perfect for food cooperatives, buying groups, and collective purchasing organizations.
|
||||
|
||||
## Features
|
||||
|
||||
- ✅ Group order management with full lifecycle (draft → confirmed → completed)
|
||||
- ✅ Separate shopping carts per order group
|
||||
- ✅ Group membership tracking with active/inactive states
|
||||
- ✅ Order collection and cutoff dates with validation
|
||||
- ✅ Pickup day configuration and fulfillment tracking
|
||||
- ✅ Multi-language support (ES, PT, GL, CA, EU, FR, IT)
|
||||
- ✅ Partner location management for group coordination
|
||||
- ✅ Product ecosystem integration (ribbons, pricing, margins)
|
||||
- ✅ Order state transitions with email notifications
|
||||
- ✅ Delivery tracking and group order fulfillment
|
||||
- ✅ Financial tracking per group member
|
||||
- ✅ Automatic translation of UI elements
|
||||
|
||||
## Installation
|
||||
|
||||
1. Place addon in Odoo addons folder: `/addons/website_sale_aplicoop`
|
||||
2. Activate developer mode
|
||||
3. Go to **Apps** → **Update Apps List**
|
||||
4. Search for "Website Sale - Aplicoop"
|
||||
5. Click **Install**
|
||||
|
||||
### Requirements
|
||||
|
||||
- Odoo 18.0+
|
||||
- Website module
|
||||
- Sale module
|
||||
- Product module
|
||||
- Account module
|
||||
|
||||
### Dependencies
|
||||
|
||||
```
|
||||
- base
|
||||
- web
|
||||
- website
|
||||
- sale
|
||||
- product
|
||||
- account
|
||||
```
|
||||
|
||||
## Usage
|
||||
|
||||
### Administrator Setup
|
||||
|
||||
#### 1. Create a Group Order
|
||||
|
||||
1. Go to **Website Sale** → **Group Orders** (or **Coops** → **Órdenes de Grupo**)
|
||||
2. Click **Create**
|
||||
3. Fill in:
|
||||
- **Name**: e.g., "Weekly Cooperative Order #5"
|
||||
- **Group**: Select the cooperative group
|
||||
- **Collection Date**: When orders will be collected
|
||||
- **Cutoff Date**: Last moment to add items
|
||||
- **Pickup Date**: When group members collect their orders
|
||||
4. Save
|
||||
|
||||
#### 2. Configure Pickup Dates
|
||||
|
||||
1. Go to **Settings** → **Website** → **Shop Settings**
|
||||
2. Configure **Pickup Days**: Define which days are available
|
||||
3. Set **Group Settings**: Default locations, delivery partners
|
||||
|
||||
#### 3. Add Group Members
|
||||
|
||||
1. Open a Group Order
|
||||
2. In the **Members** tab, click **Add**
|
||||
3. Select partner(s)
|
||||
4. Set active/inactive status
|
||||
5. Save
|
||||
|
||||
### Customer Experience
|
||||
|
||||
#### For Group Members on Website
|
||||
|
||||
1. **Browse Products**: Members see products with eco-ribbons, pricing, margin info
|
||||
2. **Add to Cart**: Select items (cart is separate per group order)
|
||||
3. **Review Cart**: See order summary before cutoff date
|
||||
4. **Submit Order**: Confirm before cutoff time
|
||||
5. **Receive Notification**: Get email with pickup details
|
||||
6. **Pickup**: Collect order on designated pickup date
|
||||
|
||||
#### Order Workflow
|
||||
|
||||
```
|
||||
Draft → Confirmed → Collected → Invoiced → Completed
|
||||
↓
|
||||
Cancelled (if member opts out)
|
||||
```
|
||||
|
||||
## Configuration
|
||||
|
||||
### Basic Configuration
|
||||
|
||||
**Required:**
|
||||
1. Create group orders with collection/cutoff/pickup dates
|
||||
2. Assign group members to orders
|
||||
3. Set available pickup dates
|
||||
|
||||
**Optional:**
|
||||
1. Configure custom email templates
|
||||
2. Set up product-specific group restrictions
|
||||
3. Customize group order report
|
||||
|
||||
### Multi-Language Setup
|
||||
|
||||
The addon automatically translates:
|
||||
- Interface elements
|
||||
- Form labels
|
||||
- Report headers
|
||||
- Email notifications
|
||||
|
||||
**Supported Languages:** ES, PT, GL, CA, EU, FR, IT
|
||||
|
||||
**Translations are managed in:**
|
||||
- `i18n/[language].po` files
|
||||
- Auto-extracted from templates
|
||||
- See `docs/TRANSLATION_CONVENTIONS.md` for translation patterns
|
||||
|
||||
### Website Customization
|
||||
|
||||
Edit templates in: `views/website_templates.xml`
|
||||
|
||||
Key customizable sections:
|
||||
- `eskaera_page`: Main group order display
|
||||
- `eskaera_details`: Order details view
|
||||
- `member_cart`: Individual member cart interface
|
||||
|
||||
## Technical Details
|
||||
|
||||
### Core Models
|
||||
|
||||
**`group.order`** (Main group order)
|
||||
- `name` (Char): Order identifier
|
||||
- `group_id` (Many2one): Link to group
|
||||
- `state` (Selection): draft/confirmed/collected/invoiced/completed/cancelled
|
||||
- `collection_date` (Date): When group collects
|
||||
- `cutoff_date` (Datetime): Last moment to order
|
||||
- `pickup_date` (Date): Member pickup day
|
||||
- `line_ids` (One2many): Order lines
|
||||
- `member_ids` (One2many): Group members
|
||||
- `active` (Boolean): Soft delete
|
||||
|
||||
**`group.order.line`** (Order items per member)
|
||||
- `order_id` (Many2one): Parent group order
|
||||
- `member_id` (Many2one): Which group member
|
||||
- `product_id` (Many2one): Ordered product
|
||||
- `quantity` (Float): Amount ordered
|
||||
- `unit_price` (Float): Price per unit
|
||||
- `subtotal` (Float): Computed (qty × price)
|
||||
|
||||
**`group.partner`** (Group member tracking)
|
||||
- `partner_id` (Many2one): Odoo partner
|
||||
- `group_id` (Many2one): Which group
|
||||
- `active` (Boolean): Active member status
|
||||
- `role` (Selection): admin/member
|
||||
|
||||
### Extended Models
|
||||
|
||||
**`product.template`**
|
||||
- `group_order_allowed` (Boolean): Can be in group orders
|
||||
- `eco_ribbon_id` (Many2one): Environmental ribbon
|
||||
- `margin_type_id` (Many2one): Pricing margin
|
||||
|
||||
**`sale.order`**
|
||||
- `group_order_id` (Many2one): Parent group order (if applicable)
|
||||
|
||||
### Views & Templates
|
||||
|
||||
**Backend Views:**
|
||||
- `group.order` list/form views
|
||||
- `group.order.line` inline form
|
||||
- `group.partner` configuration view
|
||||
|
||||
**Frontend Templates:**
|
||||
- `eskaera_page`: Main group order display
|
||||
- `eskaera_details`: Order details/summary
|
||||
- `member_cart`: Individual cart interface
|
||||
- `group_members`: Member list view
|
||||
|
||||
## Integration Points
|
||||
|
||||
This addon integrates with:
|
||||
|
||||
- **Product Modules**
|
||||
- `product_eco_ribbon` - Eco-friendly product indicators
|
||||
- `product_margin_type` - Dynamic product pricing
|
||||
- `product_pricing_margins` - Cost management
|
||||
|
||||
- **Website/E-commerce**
|
||||
- `elika_bilbo_website_theme` - Custom website theme
|
||||
- `website_sale` - Core shop functionality
|
||||
- `website_legal_es` - Legal compliance (Spanish)
|
||||
|
||||
- **Sales/Accounting**
|
||||
- `sale` - Sales order generation
|
||||
- `account` - Invoicing
|
||||
|
||||
## Testing
|
||||
|
||||
Run tests with:
|
||||
|
||||
```bash
|
||||
cd /home/snt/Documentos/lab/odoo/kidekoop/odoo-addons
|
||||
python -m pytest website_sale_aplicoop/tests/ -v
|
||||
```
|
||||
|
||||
**Test Coverage:**
|
||||
- ✅ Group order creation/deletion
|
||||
- ✅ Member management
|
||||
- ✅ Order line addition/removal
|
||||
- ✅ State transitions
|
||||
- ✅ Cutoff date validation
|
||||
- ✅ Pickup date assignment
|
||||
- ✅ Translation extraction (7 languages)
|
||||
- ✅ Website template rendering
|
||||
|
||||
## Known Limitations
|
||||
|
||||
- Group orders are company-specific
|
||||
- Cannot change pickup date after order is confirmed
|
||||
- Members cannot modify orders after cutoff
|
||||
- Automatic invoicing must be triggered manually
|
||||
|
||||
## Changelog
|
||||
|
||||
### 18.0.1.2.0 (2026-02-02)
|
||||
- UI Improvements:
|
||||
- Increased cart text size (2x) for better readability
|
||||
- Increased cart icon sizes (1.2rem) with proper button proportions
|
||||
- Enlarged "Save as Draft" button in checkout (2x text and icon)
|
||||
- Date Calculation Fixes:
|
||||
- Fixed pickup_date calculation (was adding extra week incorrectly)
|
||||
- Simplified pickup_date computation logic
|
||||
- Display Enhancements:
|
||||
- Added delivery_date display to all order pages
|
||||
- Improved date field visibility on order cards and product pages
|
||||
|
||||
### 18.0.1.0.0 (2024-12-20)
|
||||
- Initial release
|
||||
- Core group order functionality
|
||||
- Multi-language translation support
|
||||
- Complete member management
|
||||
- Order state machine implementation
|
||||
|
||||
### 18.0.1.1.0 (2025-01-10)
|
||||
- Fixed translation extraction for "Pickup day" and "Cutoff day"
|
||||
- Improved QWeb template for better performance
|
||||
- Added comprehensive documentation
|
||||
|
||||
## Support
|
||||
|
||||
For issues, feature requests, or contributions:
|
||||
- **Repository**: https://git.criptomart.net/KideKoop/kidekoop/odoo-addons
|
||||
- **Main Documentation**: `/docs/` folder (transversal docs)
|
||||
- **Addon Documentation**: This README + `/docs/ODOO18_TRANSLATIONS_LEARNINGS.md`
|
||||
- **Maintainer**: Criptomart SL
|
||||
|
||||
## Documentation References
|
||||
|
||||
- **Translation Patterns**: See `docs/TRANSLATION_CONVENTIONS.md`
|
||||
- **Translation Examples**: See `docs/TRANSLATION_EXAMPLES.md`
|
||||
- **Odoo 18 Translation Guide**: See `docs/ODOO18_TRANSLATIONS_LEARNINGS.md`
|
||||
- **Project Architecture**: See `docs/ARCHITECTURE.md`
|
||||
|
||||
## Related Modules
|
||||
|
||||
- `product_eco_ribbon` - Product environmental classification
|
||||
- `product_margin_type` - Dynamic product pricing
|
||||
- `product_pricing_margins` - Complete pricing system
|
||||
- `elika_bilbo_website_theme` - Custom website theme
|
||||
- `website_legal_es` - Legal compliance
|
||||
|
||||
---
|
||||
|
||||
**Version:** 18.0.1.2.0
|
||||
**Odoo:** 18.0+
|
||||
**License:** AGPL-3
|
||||
**Maintainer:** Criptomart SL
|
||||
**Repository:** https://git.criptomart.net/KideKoop/kidekoop/odoo-addons
|
||||
Loading…
Add table
Add a link
Reference in a new issue