BBU1 MASTER MANUAL VOL 5: DISTRIBUTION & WHOLESALE

Vertical Code: distribution | Automated Tax Rate: 16.00% Specialty: Logistics, Van Loading & Route Settlement Target Market: Beverage Distributors, FMCG Wholesalers, Food Suppliers, Cold Chain Logisti

PHASE 1: SYSTEM BIRTH (SIGNUP & HYDRATION)

The journey begins by building the "Logistics Engine."

1. Identity Entry: The user enters the Company Name (e.g., "Sovereign Distributors Ltd") and headquarters details.

2. Vertical Selection: The user selects Distribution / Wholesale Supply from the dropdown.

3. The BBU1 Trigger: Upon clicking "Sign Up," the BBU1 backend executes the hydrate_universal_tenant() function.

   • Automation: The system automatically sets the Standard VAT/Sales Tax to 16.00% in the tax_configurations table.

   • Module Activation: BBU1 activates inventory, van_loads, delivery_routes, cold_chain_logs, and distribution_route_settlements.

   • Security: 100% RLS is applied to the business_id. Your route maps, vehicle costs, and wholesale prices are invisible to other distributors.

---

PHASE 2: MASTER DATA SETUP (FLEET & LOCATIONS)

Distribution requires "Moving Assets."

1. Warehouses: Navigate to Management > Physical Locations.

   • Add your "Main Warehouse" and any "Regional Hubs."

2. Vehicle Registry: Navigate to Fleet Management > Vehicles.

   • Enter details for your trucks/vans. BBU1 creates a link in the fleet_vehicles table.

3. Route Mapping: Navigate to Distribution > Delivery Routes.

   • Define routes (e.g., "Kampala Central Route"). This allows BBU1 to group sales by geography automatically.

---

PHASE 3: INVENTORY PROCUREMENT (BULK STOCKING)

Before you distribute, you must buy in bulk.

1. Bulk Purchase: Navigate to Procurement > Purchase Orders.

2. The Supplier Link: Select a manufacturer (e.g., "Coca-Cola" or "Farmers Co-op").

3. Stock Ingestion: Add items in bulk. BBU1 calculates the 16% Input VAT.

4. The Sovereign Seal: Upon clicking "Receive Goods":

   • Automation: Stock levels increase in the Main Warehouse.

   • Valuation: BBU1 updates the inventory valuation using the fn_sync_variant_valuation logic.

---

PHASE 4: WHOLESALE ORDER MANAGEMENT (CRM)

Distributors sell to retailers, not individual walk-ins.

1. Customer Onboarding: Navigate to CRM > Customers.

   • Add retail shops or supermarkets.

2. Wholesale Pricing: Navigate to Sales > Price Lists & Rules.

   • Set "Bulk Discounts" (e.g., "Buy 50 crates, get 5% off").

3. Order Placement: When a shop calls in an order, navigate to Invoicing > Create Invoice.

   • Logic: Select the items. BBU1 automatically applies the 16% VAT and the wholesale discount rule.

---

PHASE 5: THE VAN LOADING PROCESS (INVENTORY MOVEMENT)

This is the most critical step in BBU1 Distribution.

1. Creation: Navigate to Distribution > Van Loads.

2. Stock Transfer: Select a Vehicle and a Driver.

3. Loading Items: Select products to move from the "Main Warehouse" to the "Van."

4. The BBU1 Trigger: Upon clicking "Seal Van":

   • Inventory Logic: BBU1 deducts stock from the Warehouse and "Increases" stock in the Mobile Van Warehouse via the van_load_items table.

   • Security: The driver is now legally responsible for this stock.

---

PHASE 6: ROUTE EXECUTION & COLD CHAIN

As the van moves, BBU1 monitors quality.

1. Delivery Logging: The driver uses the BBU1 mobile view to mark orders as "Delivered" at each shop.

2. Cold Chain Monitoring: If moving perishables (e.g., Milk, Vaccines), the driver logs temperatures in the distribution_cold_chain_logs.

   • Automation: If temperature exceeds the set limit, BBU1 sends a "Live System Monitor" alert to the owner.

---

PHASE 7: ROUTE SETTLEMENT (CASH RECONCILIATION)

When the van returns, BBU1 closes the loop to prevent theft.

1. Return Entry: Navigate to Distribution > Route Settlements.

2. The Reconciliation Math: BBU1 compares:

   • Items Loaded - Items Delivered = Expected Items Remaining.

   • Value of Items Delivered = Expected Cash to be Collected.

3. Settlement Seal: The user enters the actual cash returned.

   • Automation: BBU1 triggers the fn_sovereign_accounting_kernel. It posts the cash to the Bank account and marks the inventory as "Sold" or "Returned to Warehouse."

---

PHASE 8: AUTOMATED REPORTING & AUDITING

1. Aged Receivables: Navigate to Reports Center > Aged Payables/Receivables.

   • See exactly which retail shops owe the distributor money and for how long.

2. Route Profitability: BBU1 shows which delivery route makes the most money after fuel and 16% tax.

3. System Audit Log: The owner can see every time a van load was "Edited" after it left the warehouse—stopping collusion between drivers and warehouse staff.

---

PHASE 9: ASK AURA (DISTRIBUTION INTELLIGENCE)

The owner can ask Aura for strategic logistics help:

• "Aura, which van driver had the highest cash discrepancy this week?"

• "Aura, based on inventory trends, which route needs more stock tomorrow?"

• "Aura, show me our 16% VAT liability for the Distribution module for Q1."

---

SUMMARY OF THE DISTRIBUTION ADVANTAGE

• Mobile Inventory: Vans are tracked as "Moving Warehouses."

• Zero Leakage: Route Settlement forces every bottle and cent to be accounted for.

• Automated Wholesale: 16% Tax and wholesale discounts are handled by the BBU1 Kernel.

---