Blu Coffee Distributors / VGC — bc17 Documentation
This is the documentation site for Blu Coffee Distributors and the Villanueva Group of Companies (VGC) — the Odoo 17 deployment of the bc17 custom application module.
What is bc17?
bc17 is a single Odoo 17 application module that bundles all VGC-specific business logic into one installable unit. Internally it is organized into sub-packages by domain:
| Sub-package | Purpose |
|---|---|
blu_base | Partner extensions (classification, region, schedules), user warehouse access, company config, iFrame wrapper for external reports |
blu_crm_sales | CRM lead extensions (brands, inquiry types), sale-order customizations (mode of payment, force close, validator groups) |
blu_account | Invoice/bill WHT posting, payment receipts, SI number tracking, currency exchange |
blu_purchase | PO signatories (prepared/checked/approved), currency rate sync, iNet report printing |
blu_stock | Delivery receipt CR/DR tracking, weight calculations, compatible parts, scrap orders |
blu_repair | Repair orders, labor tracking, technician management |
blu_portal | Customer self-service: portal users, machine registration, service requests with status workflow |
blu_reports | Sales/purchase analytics, fill rates, delivery rates, low stock alerts, tax reports (Excel export) |
blu_8x8 | 8x8 JaaS SMS/Viber integration, ChatGPT integration |
blu_artin | Industrial machine log CSV parsing with encoding detection |
blu_ecomm | E-commerce warehouse rules and picking type categorization |
blu_dashboard | Dashboard configuration |
frontend/ | React 18 + TypeScript SPA for the customer portal |
What is currently documented
This site currently focuses on the planned Manufacturing (MRP) capability for the Blu Coffee roastery — converting an existing finished good (e.g. Blu Espresso Blend 500g) into a new finished good (e.g. Sugbo Blend 70g) via grinding and repackaging.
Start with MRP Plan Overview.
Key concepts
- Brand: Blu Coffee Distributors operates under multiple product brands (already wired into
blu_crm_sales). - Roastery: Physical area where coffee is opened, ground, and repackaged. Will become a dedicated stock location in Odoo.
- BOM (Bill of Materials): Defines the components and operations needed to produce a manufactured product.
- Work Center: A resource that performs a manufacturing operation (e.g.
Roastery — Grinding). Carries the labor + electricity + equipment cost rate. - MO (Manufacturing Order): A specific instance of producing a finished good against a BOM.
Conventions
- Code blocks are runnable as-is unless marked otherwise
- Menu paths use the format bc17 > Section > Item
- All cost figures are in PHP unless otherwise noted
Repository
- Module source:
/Users/jsalinga/odoo/odoo17/custom/vgc17/bc17/ - Docs source:
/Users/jsalinga/odoo/odoo17/custom/vgc17/blu-docs/
To contribute: edit Markdown files under docs/ and submit changes alongside the Odoo module updates they describe.