BBU1 MASTER MANUAL VOL 3: TELECOM & MOBILE MONEY

Vertical Code: telecom | Automated Tax Rate: 20.00% Compliance Level: Global Telecom Regulations / National Excise Standards Target Market: Mobile Money Agents (MTN, Airtel, M-Pesa), Telecom Aggregato

PHASE 1: SYSTEM BIRTH (SIGNUP & HYDRATION)

The journey begins by building the "Digital Exchange."

1. Identity Entry: The user enters the Telecom Agency Name and Business Registration details.

2. Vertical Selection: The user selects Telecom & Mobile Money 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 "Telecom" code and automatically sets the Excise/Telecom Tax to 20.00% in the tax_configurations table.

   • Module Activation: BBU1 activates the telecom_float_balances, telecom_agent_earnings, telecom_commission_rules, and telecom_transactions modules.

   • Security: RLS is applied to the business_id, physically isolating your float balances and agent lists from competitors.

---

PHASE 2: PROVIDER & SERVICE SETUP

Before processing transactions, the user defines who provides the services.

1. Telecom Providers: Navigate to Telecom > Providers.

   • Add providers like MTN, Airtel, Orange, or Vodafone. BBU1 uses the telecom_providers table to track your relationship with each.

2. Defining Services: Add services such as "Deposit," "Withdrawal," "Airtime," or "Data Bundles."

3. Float Initialization: Navigate to Telecom > Float Balances.

   • Enter the current digital balance for each provider. BBU1 records this in the telecom_float_balances table. This is your "Digital Inventory."

---

PHASE 3: AGENT & BRANCH MANAGEMENT

For businesses with multiple outlets or roaming agents:

1. Agent Onboarding: Navigate to Management > Employees/Agents.

2. Role Assignment: Assign the "Agent" role. BBU1 automatically creates a link in the telecom_agent_floats table for that specific person.

3. Float Allocation: The owner "sends" float from the Main Entity to the Agent.

   • Logic: BBU1 deducts from the Main telecom_float_balances and increases the Agent’s sub-wallet. Total business float remains balanced.

---

PHASE 4: TRANSACTION EXECUTION (THE CORE LOGIC)

This is the daily operation for a Mobile Money teller.

1. New Transaction: Navigate to Telecom > New Transaction.

2. Selection: Select the Service (e.g., "Airtel Cash Withdrawal").

3. Data Entry: Enter the Amount and the Reference ID (External ID from the Telecom).

4. The Sovereign Seal: Upon saving:

   • Float Update: BBU1 automatically adjusts the digital balance in the telecom_float_balances table.

   • Cash Update: The system records a "Cash Inflow" or "Outflow" in the internal cash account.

   • Commission Math: BBU1 calculates the estimated commission and records it in the telecom_agent_earnings table. The user did no math.

---

PHASE 5: AUTOMATED COMMISSION & TAXATION

This is where BBU1 eliminates the need for manual spreadsheets.

1. Commission Rules: Navigate to Telecom > Commission Rules.

   • The user sets the rule (e.g., "Earn 3% on every Airtime sale").

2. The Automation: Every transaction triggered in Phase 4 uses these rules to calculate profit.

3. Tax Logic (20.00%): BBU1 automatically calculates the 20% tax on the Commission earned, not the total amount transacted.

   • Example: On a 1,000 UGX commission, BBU1 automatically marks 200 UGX as "Tax Liability" and 800 UGX as "Net Profit."

4. Sync: This data is pushed to the accounting_tax_returns table instantly.

---

PHASE 6: FLOAT RECONCILIATION & AUDIT

Telecom businesses often "leak" money through unrecorded transactions. BBU1 stops this.

1. Float Sync: Navigate to Telecom > Reconciliation.

   • The user enters the balance shown on their phone. BBU1 compares it to the telecom_float_balances table.

   • Mismatch Alert: If there is a gap, BBU1 flags it and prevents the day from closing until the error is found.

2. Audit Trail: Navigate to Sovereign Control > System Audit Log.

   • The owner can see every time an Agent tried to adjust their float balance or delete a "failed" transaction. Every action is tied to an actor_id and timestamp.

---

PHASE 7: AUTOMATED REPORTING & TAX FILING

1. Daily Sales Report (DSR): Navigate to Sales > Daily Sales Report.

   • BBU1 provides a summary of Cash vs. Float for the day.

2. Revenue Report: Navigate to Reports Center > Profit & Loss.

   • The system shows the "Telecom Revenue" (Total commissions) minus the "Excise Tax (20%)" and operating expenses.

3. Tax Returns: Navigate to Finance > Tax Returns.

   • BBU1 generates a ready-to-file document showing the 20% telecom levy owed for the month.

---

PHASE 8: ASK AURA (TELECOM ANALYTICS)

The owner can ask Aura for deep insights:

• "Aura, which provider (MTN or Airtel) gave us the highest net commission after the 20% tax this week?"

• "Aura, alert me if any agent’s float falls below 100,000 units."

• "Aura, what is the total cash-to-float ratio across all branches today?"

---

SUMMARY OF THE TELECOM ADVANTAGE

• Float Integrity: Digital currency and physical cash are tracked in separate but linked ledgers.

• Commission Accuracy: Every cent of profit is calculated at the moment of transaction.

• Tax Compliance: The 20% telecom tax is handled entirely by the BBU1 Sovereign Kernel.