BBU1 MASTER MANUAL VOL 2: SACCO & CO-OPERATIVE

BBU1 MASTER MANUAL VOL 2: SACCO & CO-OPERATIVE Vertical Code: sacco | Automated Tax Rate: 0.00% Compliance Level: Global Credit Union Standards | Target Market: Investment Clubs, Savings Groups, Emplo

PHASE 1: SYSTEM BIRTH (SIGNUP & HYDRATION)

The journey begins by building the "Bank-in-a-Box."

1. Identity Entry: The user enters the SACCO’s Legal Name and Administrator details.

2. Vertical Selection: The user selects SACCO / Co-operative from the "Business Type" dropdown.

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

   • Automation: The system detects the "SACCO" code and automatically sets the Tax Rate to 0.00% in the tax_configurations table, as SACCO interest is usually tax-exempt or handled differently.

   • Module Activation: BBU1 activates the sacco_members, sacco_loans, sacco_savings, and sacco_share_ledger modules.

   • Security Wall: 100% RLS is applied to the business_id. This ensures that even if two different SACCOs use BBU1, their member lists and balances are physically separated in the database.

---

PHASE 2: SETTING UP THE FINANCIAL PRODUCTS

Before onboarding members, the Admin defines the SACCO’s rules.

1. Savings Products: Navigate to Financials > Savings Products.

   • Create products like "Regular Savings" or "Fixed Deposits." BBU1 uses the sacco_savings_products table to track interest rates offered to members.

2. Share Products: Navigate to Financials > Share Ledger Settings.

   • Define the "Price per Share" (e.g., 1 Share = 50,000 UGX). BBU1’s sacco_share_products table will use this to calculate member equity automatically.

3. Loan Products: Navigate to Lending > Loan Products.

   • Define interest rates (Reducing Balance or Straight Line). Because BBU1 is automated, the user just enters the rate, and the system prepares the fn_sovereign_accounting_kernel to handle the amortization math later.

---

PHASE 3: MEMBER ONBOARDING & KYC

A SACCO is nothing without its members. BBU1 makes onboarding professional.

1. Member Creation: Navigate to Members > New Member.

2. KYC Data: Enter the name, ID number, and contact info. BBU1 records this in the sacco_members table.

3. Next of Kin: The user adds beneficiary details in the sacco_next_of_kin section—this is a legal requirement that BBU1 enforces.

4. Automatic Accounts: The moment the member is saved, BBU1 automatically creates a unique sacco_account_id and links it to a sacco_savings_account and the sacco_share_ledger. The member is now "Financial Ready."

---

PHASE 4: MANAGING CONTRIBUTIONS (SAVINGS & SHARES)

The daily heartbeat of a SACCO is the collection of money.

1. Processing a Deposit: Navigate to Transactions > New Deposit.

2. Selection: Select the member. Choose whether the money is for "Savings" or "Buying Shares."

3. The Sovereign Seal: Upon clicking "Save":

   • Ledger Sync: BBU1 automatically posts a debit to the SACCO's Cash account and a credit to the Member’s Individual Ledger.

   • Shares: If buying shares, BBU1 calculates the number of shares (Total Amount / Price per Share) and updates the sacco_share_ledger instantly.

   • Receipting: A professional digital receipt is generated for the member.

---

PHASE 5: THE AUTOMATED LOAN LIFECYCLE

This is where BBU1 eliminates the need for an accountant.

1. Application: Navigate to Lending > Loan Applications. Enter the amount requested and the term (e.g., 12 months).

2. Collateral & Guarantors: Link assets via the sacco_loan_collateral table and select other members as guarantors via sacco_loan_guarantors.

3. Approval: Once the Admin clicks "Approve":

   • The Math Miracle: BBU1 automatically generates a complete sacco_loan_schedules (Amortization table). It calculates exactly how much Principal and Interest the member must pay every month.

   • Disbursement: The funds are "moved" digitally to the member’s account, and the sovereign_ledger records the Asset (Loan Receivable).

4. Repayment: When a member pays, BBU1 automatically applies the money to the oldest interest first, then the principal, according to the schedule. The user does zero math.

---

PHASE 6: DIVIDEND DISTRIBUTION (ONE-CLICK AUTOMATION)

At the end of the year, BBU1 calculates how to share the profit.

1. Calculation: Navigate to Management > Dividend Center.

2. Automation: BBU1 scans the sacco_share_ledger and calculates the dividend owed to each member based on their shareholding percentage.

3. Distribution: Click "Distribute." BBU1 automatically moves the money from the SACCO’s "Retained Earnings" to every individual member’s sacco_savings_account.

---

PHASE 7: AUDITING & REPORTING (OWNER'S SECURITY)

To prevent fraud (common in SACCOs), BBU1 provides an unchangeable audit trail.

1. Audit Logs: Navigate to Sovereign Control > System Audit Log.

   • Every time a balance is adjusted manually or a loan is deleted, BBU1 captures the actor_id.

2. Financial Statements: Navigate to Reports Center.

   • Trial Balance / Balance Sheet: These are generated in real-time. Because every transaction was sealed by the sovereign_ledger, the reports are always balanced.

3. Member Statements: With one click, generate a full history for any member showing every cent they have ever saved or borrowed.

---

PHASE 8: ASK AURA (THE VIRTUAL MANAGER)

The SACCO Admin can use Aura for high-level decision making:

• "Aura, which 5 members have the highest loan default risk this month?"

• "Aura, what is the total value of shares held by the top 10% of our members?"

• "Aura, show me the total interest earned from the 'Emergency Loan' product this quarter."

---

SUMMARY OF THE SACCO ADVANTAGE

• Zero Math: Loans, Interest, and Dividends are calculated by the BBU1 Kernel.

• Total Transparency: Members can see their balances, and Admins can see every action taken by staff.

• Legal Ready: KYC, Next of Kin, and Amortization schedules are built-in.