BBU1 MASTER MANUAL VOL 11: PROFESSIONAL SERVICES

Vertical Code: professional | Automated Tax Rate: 18.00% Specialty: Time-Billing, Records Isolation & Professional Indemnity Target Market: Medical Clinics, Law Firms, Accounting Practices, Consultanc

PHASE 1: SYSTEM BIRTH (SIGNUP & HYDRATION)

The journey begins by building a "Vaulted Environment."

1. Identity Entry: The user enters the Practice/Firm Name (e.g., "Sovereign Medical Group") and professional license number.

2. Vertical Selection: The user selects Professional Services (Accounting, Medical).

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

   • Automation: The system detects the "Professional" code and automatically sets the Professional Service Tax to 18.00% in the tax_configurations table.

   • Module Activation: BBU1 activates time_billing_entries, billing_rates, documents, item_files, and customer_360.

   • The Architect’s Wall: 100% RLS is applied to the business_id. In this vertical, RLS is mission-critical; it ensures that a doctor in Clinic A can never accidentally or intentionally query the patient records of Clinic B.

---

PHASE 2: THE EXPERTISE ARCHITECTURE (BILLING RATES)

Professionals sell expertise. BBU1 defines the value of that time.

1. Setting Rates: Navigate to Professional Services > Billing Rates.

   • Define rates based on staff seniority (e.g., "Senior Consultant" @ 500k/hr, "Junior Associate" @ 100k/hr).

2. Tax Integration: BBU1 automatically prepares the 18% tax calculation for these rates. When a bill is generated, the system will add the tax to the base rate without human intervention.

---

PHASE 3: SECURE ONBOARDING (PATIENT & CLIENT 360)

This is the most sensitive data entry point.

1. Onboarding: Navigate to CRM > Customer 360.

2. Sensitive Profiles: Enter Bio-data, Medical History (for clinics), or Corporate Tax IDs (for accountants).

3. Data Protection: BBU1’s JWT-driven security ensures that only users with the "Provider" or "Manager" role can see the sensitive fields in the profiles table.

---

PHASE 4: SECURE DOCUMENT VAULT (MEDICAL/FINANCIAL FILES)

Professionals manage files (Prescriptions, Lab Results, Audit Evidence).

1. Uploading Files: Use the Documents > Item Files module.

2. Security Logic: Every file uploaded is linked to a tenant_id.

   • Encryption: BBU1 encrypts the file link and stores the metadata behind the RLS wall.

3. Patient Privacy: For Medical Clinics, use the lot_numbers link to track high-value medications or vaccines dispensed during a consultation.

---

PHASE 5: EXECUTION (TIME TRACKING & TIMESHEETS)

This captures the revenue before it is lost.

1. Logging Time: The professional logs into the mobile dashboard and starts a task (e.g., "Patient Consultation" or "Tax Audit").

2. Automation: BBU1 records the start_time and end_time in the time_entries table.

3. Billable Logic: The user marks the time as "Billable." BBU1 automatically matches the employee’s billing_rate to the duration of the task. The professional does zero math.

---

PHASE 6: THE AUTOMATED PROFESSIONAL INVOICE (18%)

Generating the bill is now a one-click process.

1. Generation: Navigate to Invoicing > To Be Issued.

2. Aggregation: BBU1 looks at all time_entries marked as "Billable" for a specific client.

3. The Sovereign Seal: Upon clicking "Issue Invoice":

   • Tax Math: BBU1 adds the 18% Professional Service Tax.

   • Ledger Sync: Revenue is posted to "Professional Fees" and Tax is posted to "VAT Payable" in the sovereign_ledger.

   • Aged Receivables: The invoice is tracked. If the client doesn't pay, BBU1 flags it for the partner/owner.

---

PHASE 7: COMPLIANCE & SOVEREIGN AUDITING

Professional firms must maintain a high standard for external regulators.

1. Audit Trail Report: Navigate to Sovereign Control > Audit Trail Report.

   • Every time a medical record is viewed or a financial ledger entry is edited, BBU1 captures the actor_id. This provides a "Chain of Custody" for all data.

2. Tax Hub: Navigate to the Tax & Compliance Hub.

   • See a real-time summary of the 18% tax liability. Accountants can use this to file their own firm's taxes in seconds.

3. Benchmarking: BBU1 allows the owner to see how much revenue each "Professional Hour" is generating across the firm.

---

PHASE 8: ASK AURA (CLINICAL & FINANCIAL INSIGHTS)

In this vertical, Aura acts as a "Medical/Accounting Research Assistant":

• Clinical Query: "Aura, show me the trend of 'Consultation' services over the last 30 days."

• Financial Query: "Aura, which client has the highest billable hours that have not yet been invoiced?"

• Safety Check: "Aura, show me all access logs for Patient ID: 1029 in the last 24 hours." (Only available to Admins).

---

PHASE 9: GLOBAL DATA RESIDENCY

As a Lead Architect building for the world:

• GDPR/POPIA Ready: The documentation emphasizes that BBU1 stores these sensitive records in an ISO-certified environment (Supabase/AWS) with local data isolation protocols.

---

SUMMARY OF THE PROFESSIONAL ADVANTAGE

• Absolute Privacy: RLS ensures data isolation for the most sensitive medical and financial records.

• Automated Billability: Time is converted to money automatically.

• 18% Tax Precision: The BBU1 Kernel handles the professional service tax logic globally.

---