The Mechanics of B-good

B-good is a product of Kitswys Pty Ltd. Explore the data pipeline that turns regular financial transactional activity inside Odoo into audit-ready B-BBEE evidence and automated scorecard points.

1. The Supplier Compliance Register

B-good builds straight onto Odoo's native core `res.partner` architecture, adding specialized compliance properties. Vendor identities are paired with a fully managed certificate register that enforces explicit validation states.

State-Driven Lifecycle Tracking: Monitor certificates effortlessly via automated statuses: Valid, Expiring, Expired, Missing, or Superseded.
Granular Ownership Parameters: Capture critical black ownership, black women ownership, and qualifying enterprise size metrics (EME, QSE, Generic) natively inside vendor profile sheets.
Procurement Alerts: Display prominent visibility banners inside Request for Quotes and Purchase Orders when a supplier has broken compliance rules.

bbbbee_procurement/views/res_partner_view.xml

bbbbee_procurement/models/spend_batch.py

B-good spend lines table showing recognition percentage and evidence status

2. The Spend Snapshot Engine

Instead of running heavy calculations directly on raw ledger balances, B-good isolates data using immutable reporting batches. These batches lock your transactions into specific measurement windows, giving you completely reliable and unchangeable report states.

The core processing engine extracts every line item from posted vendor bills and vendor credit notes falling within specified dates, applying the targeted legislative formulas instantly.

Recognised Spend = Invoice Net Value × Vendor Recognition %

Automated Reconciliations: Vendor credit notes automatically apply negative weight adjustments to keep total recognition structures completely balanced.
Date Boundaries: Strict, built-in system checks stop measurement timelines from overlapping for the same operating entity.

3. Rule Set Governance

The module applies a fixed rule set for each measurement period so the system stays predictable, auditable, and tied to the active B-BBEE threshold.

bbbbee_procurement/config/rule_sets.xml

B-good rule set table with effective and expiry dates

The settings are designed to lock the relevant targets for the active period without changing the underlying accounting data.

System Security Group	Functional Domain Responsibilities & Capabilities
B-BBEE User / Internal User	Accesses the core dashboards and reads live score movement during day-to-day use.
B-BBEE Compliance Officer	Manages active supplier validation registers, inputs certificate data, and resolves missing-evidence alerts.
B-BBEE Finance User	Executes period-specific spend batch extraction from posted accounts payable ledgers.
B-BBEE Manager	Approves completed evaluations, applies final score locks, and freezes historical measurement periods.
B-BBEE Administrator	Maintains core configuration rules, updates weighting sets, and manages system tables.