search

1. Retail & Wholesale: Operational Manual

BBU1 MASTER MANUAL: RETAIL & WHOLESALE (COMPLETE) Vertical: Retail/Wholesale | Standard Tax: 16.00% (Configurable) | Math Mode: Fully Automated PHASE 1: SYSTEM BIRTH (SIGNUP & HYDRATION) The journey b

hashtag
BBU1 MASTER MANUAL: RETAIL & WHOLESALE (COMPLETE)

Vertical: Retail/Wholesale | Standard Tax: 16.00% (Configurable) | Math Mode: Fully Automated

hashtag
PHASE 1: SYSTEM BIRTH (SIGNUP & HYDRATION)

The journey begins at the BBU1 Portal.

  1. Identity Entry: The user enters their Full Name, Email, and Business Name.

  2. Vertical Selection: The user selects Retail / Wholesale from the "Business Type" dropdown.

  3. Industry Specifics: They select their sector (e.g., General Trade, Boutique, or Supermarket).

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

    • Automation: The system detects the "Retail" code and automatically creates a 16.00% VAT/Sales Tax profile in the tax_configurations table.

    • Security: Every table is immediately locked with 100% Row-Level Security (RLS) using the user's new business_id.

    • Result: The user lands on a dashboard that is already "Retail-Ready."

hashtag
PHASE 2: RE-CONFIGURING THE TAX ENGINE (OPTIONAL)

BBU1 sets a default tax, but the Lead Architect allows for local flexibility.

  1. Navigating to Tax: The user goes to Management > Tax and Compliance Hub.

  2. Override Power: If the business operates in a tax-exempt zone or a different jurisdiction (e.g., 18% or 0%), the user can Delete the 16% default tax.

  3. Creation: The user clicks "Add New Tax," enters the name (e.g., "Standard VAT") and the rate.

  4. The Global Weld: The moment this tax is saved, BBU1's trg_product_tax_auto trigger ensures that every product created from that point forward automatically acquires and calculates based on this specific tax rate. The user never has to type a tax rate on an individual product.

hashtag
PHASE 3: BUILDING THE INVENTORY COMMAND CENTER

Before selling, the user must define what they are selling.

  1. Category Creation: Navigate to Inventory > Categories.

    • The user creates a category (e.g., "Farming," "Electronics").

    • Logic: Categories help BBU1's AI ("Aura") group sales reports later.

  2. Product Creation: Click "Add New Product."

    • The user enters the Product Name (e.g., "Pepsi," "Beans").

    • Automation: The user enters the Base Price. BBU1 automatically calculates the Tax Amount and the Final Selling Price based on the Tax Engine set in Phase 2.

  3. Bulk Management: Inside the Inventory Command Center:

    • Bulk Adjust: The user can select 100 products and change prices or stock levels in one click.

    • Bulk Delete: If a product line is discontinued, it can be wiped from the active view instantly while the "Audit Log" retains the history.

  4. Verification: Once saved, the product appears in the main list with its SKU, Category, and current Stock level.

hashtag
PHASE 4: THE SALES & POS EXPERIENCE

Once products are in the system, the business is "Open."

  1. The POS Interface: Every product added in Phase 3 automatically flows into the Point of Sale (POS).

  2. Processing a Sale: The cashier clicks on a product (or scans a barcode).

    • Real-time Logic: BBU1 checks the inventory table. If "Pepsi" is out of stock, the POS can prevent the sale or flag a warning.

  3. The Checkout: The user selects the payment method (Cash, Mobile Money).

  4. The Sovereign Seal: Upon clicking "Complete Sale":

    • Inventory: Stock is deducted automatically (e.g., Beans 20 -> 19).

    • Finance: A record is posted to the sales and sale_items tables.

    • Invoice/Receipt: BBU1 automatically generates a professional, PDF-ready Receipt for the customer.

    • Ledger: The Accounting Kernel posts a credit to the Revenue account and a debit to the Cash account. The user did zero math.

hashtag
PHASE 5: MANUAL INVOICING (FOR WHOLESALE/CREDIT)

For larger clients who don't pay at the counter:

  1. Creation: Navigate to Invoicing > Create Invoice.

  2. Selection: Select a Customer from the customers database.

  3. Item Entry: Add products. Just like the POS, the 16% tax is applied automatically.

  4. Issuance: The invoice is saved and can be emailed directly. It moves to the "Aged Receivables" report so the owner knows who hasn't paid yet.

hashtag
PHASE 6: ZERO-MATH REPORTING & AUDITING

This is where BBU1 proves its "Enterprise Grade" status. Because every sale was automated, the reports are "Live."

  1. Profit & Loss (P&L): Navigate to Reports Center > Profit & Loss.

    • BBU1 has already subtracted the "Cost of Goods Sold" from the "Sales Revenue." The owner sees their Net Profit instantly.

  2. Tax Liability: Go to the Tax & Compliance dashboard.

    • BBU1 shows a line-by-line breakdown of taxes collected. It shows exactly what is owed to the tax authority (e.g., URA) for that period.

  3. The Audit Trail: Every single action (Creating a category, adjusting stock, deleting a product) is visible in the Audit Trail Report.

    • If an employee tries to "Bulk Delete" stock to hide a theft, the Sovereign Audit Log captures the actor_id and the timestamp. It is impossible to hide.

hashtag
PHASE 7: ASK AURA (THE AI CFO)

The owner doesn't even need to read the reports. They can just ask.

  • Interaction: "Aura, what was our most profitable category today?"

  • Aura's Logic: Aura queries the sale_items and categories tables (behind the RLS wall), performs the calculation, and replies: "The 'Farming' category generated UGX 500,000 in profit today with a 16% tax contribution."

hashtag
SUMMARY OF AUTOMATION (THE ARCHITECT'S PROMISE)

  • User Starts: Signup -> Set Tax -> Add Category -> Add Product.

  • User Ends: Process Sale -> Print Receipt.

  • BBU1 Does: Math, Taxing, Stock Deduction, Ledger Posting, Invoicing, and Audit Logging 100% Automatically.

NextBBU1 MASTER MANUAL VOL 2: SACCO & CO-OPERATIVE

Last updated

Was this helpful?