SmartERP Documentation An Ashewa Technology Solutions Platform

Digital Equb Lottery Draw & Winner Payout

Execute provably fair digital lottery draws, verify winner collateral and co-signers, and disburse jackpot payouts.

1. Overview & Business Value#

This comprehensive operational guide details the architecture, business workflows, configuration parameters, and execution steps for Digital Equb Lottery Draw & Winner Payout within SmartERP.

SACCO membership on-boarding, share capital subscription, savings accumulation, and patronage dividend distribution.
SACCO member capital formation, savings operations, and annual patronage dividend lifecycle.

Execute provably fair digital lottery draws, verify winner collateral and co-signers, and disburse jackpot payouts.

2. Prerequisites & Security Access Groups#

  • Required Modules: smarterp_sacco_core, smarterp_equb, smarterp_loan_management
  • Security Groups:
    • SACCO Loan Officer (Technical ID: smarterp_sacco.group_sacco_officer)
    • SACCO Credit Committee Member (Technical ID: smarterp_sacco.group_sacco_committee)
    • SACCO General Manager (Technical ID: smarterp_sacco.group_sacco_manager)
  • Master Data Dependencies: Member KYC profiles, share capital registers, savings product tiers, loan products with reducing-balance schedules, and Equb rotational pool configurations.

3. Step-by-Step Configuration & Execution#

Step 1: Navigating to the Interface#

  1. Log into your SmartERP instance at https://smarterp.et/odoo.
  2. Open the main App Switcher (grid icon in the top-left corner).
  3. Navigate to SACCO Core → Member Accounts; Loans → Active Loans.

Step 2: Operational Data Parameters & Controls#

Ensure all mandatory parameters comply with enterprise operational standards:

  • Authorized Operator: Action executed under assigned RBAC permissions (SACCO General Manager, Loan Appraisal Officer, Cashier).
  • Relational Integrity: Linked to upstream master records, approval requests, or transactional ledgers.
  • Statutory & Quality Controls: Verified against Ethiopian statutory regulations and corporate governance standards.

Step 3: Operational Execution & State Progression#

  • State Progression Gate: Advance record from Draft through Audited to Confirmed / Certified.
  • Integrated System Impact: Automatically updates real-time operational states and posts financial/inventory journal moves.
  • Audit Verification: System registers tamper-evident audit records logging user ID, timestamp, and cryptographic transaction digests.

Provably Fair Cryptographic Lottery Draws#

Traditional physical paper draws risk favoritism and manual manipulation. SmartERP employs a Provably Fair Pseudo-Random Number Generator (PRNG) verified by the cooperative supervisory committee:

  1. Open SACCO > Equb > Active Pools and select the current round.
  2. Verify that total round contributions have reached 100% collection threshold.
  3. The draw screen displays all eligible active members who have not yet won a round.
  4. The committee clicks Initiate Digital Lottery Draw:
    • The system utilizes the SHA-256 cryptographic hash of the current server timestamp combined with the unspent transaction hash as the random seed.
  5. The digital wheel spins on the branch monitor, selecting the winning member:
    • Selected Winner: Ato Girma Wolde (Share No. 18).
  6. The cryptographic seed and winner selection proof are recorded permanently in the audit trail.

Collateral & Co-Signer Verification Gate#

Before disbursing the jackpot to the winner, the cooperative must secure remaining future contributions:

  • If Winner wins in Round 10 of 50, the winner still owes 40 remaining weekly contributions ($40 \times 5,000 = 200,000\, \text{ETB}$).
  • The system enforces the Equb Guarantor Gate:
    • The winner must provide two active SACCO members as co-signers or pledge physical collateral (vehicle title, land holding certificate, blocked term deposit).
    • Co-signers sign digital guarantee agreements locking their savings balances.

Disbursing the Jackpot Payout#

Once collateral clears:

  1. Click Disburse Equb Jackpot.
  2. Select payout method: Telebirr corporate payout or CBE direct account transfer.
  3. Post the transaction:
    • Debit: Equb Pool Liability Account (205100)
    • Credit: Bank / Mobile Money Clearing (101200)
    • Credit: SACCO Equb Commission Income (410500)
  4. The winning member's status updates to Winner (Paid) for the remainder of the 50-week cycle.

4. Advanced Configuration Points#

  • Automated Actions & Scheduled Tasks (Crons):
    • SACCO: Accrue monthly member savings interest (smarterp_sacco.ir_cron_savings_interest): Runs on the final day of each calendar month to credit interest
    • Loan: Evaluate 5-tier NBE delinquency classification (smarterp_sacco.ir_cron_loan_delinquency): Runs nightly to compute loan loss provisions per NBE directives
    • Equb: Execute scheduled lottery draw (smarterp_sacco.ir_cron_equb_draw): Runs on defined pool cycle dates using provably fair random selection
  • Custom Print Templates & Reports:
    • Member Savings Passbook & Transaction Ledger
    • Loan Amortization Schedule (Reducing Balance)
    • NBE 5-Tier Delinquency & Loan Loss Provisioning Statement
    • Annual Patronage Dividend Distribution Schedule
  • Multi-Company Rules: Record-level security isolation under Company 1 (Ashewa Technology Solutions S.C.), preventing cross-company ledger leakage across parent and subsidiary legal entities.

5. Comprehensive Troubleshooting Matrix#

Error Symptom / ExceptionProbable Root CauseCorrective Action / Resolution
Loan Blocked: Exceeds 3x savings ceilingRequested loan principal exceeds 300% of member unencumbered savings balance.Increase compulsory savings deposit or provide authorized co-signers with sufficient collateral.
Equb Draw Blocked: Participant arrears detectedSelected Equb member has unpaid rotational dues in current or prior cycles.Collect outstanding contribution payment before executing lottery draw.
Share Capital Limit Error: Member exceeds 10% ceilingSubscribed shares exceed statutory maximum under Proclamation No. 985/2016.Restrict share allocation to maximum allowable 10% total cooperative equity threshold.
Last updated: 2026-11-15