BBU1 MASTER MANUAL VOL 4: CONTRACTOR & REMODELING

Vertical Code: contractor | Automated Tax Rate: 16.00% Specialty: Job Costing & Progress Billing | Target Market: General Contractors, Interior Designers, Civil Engineers, Renovation Firms.

PHASE 1: SYSTEM BIRTH (SIGNUP & HYDRATION)

The journey begins by building the "Project Engine."

1. Identity Entry: The user enters the Company Name (e.g., "Sovereign Builders Ltd") and Owner details.

2. Vertical Selection: The user selects Contractor (General, Remodeling) from the dropdown.

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

   • Automation: The system detects the "Contractor" code and automatically sets the Construction/VAT Tax to 16.00% in the tax_configurations table.

   • Module Activation: BBU1 activates projects, work_orders, procurement, job_costs, and change_orders.

   • Security: 100% RLS is applied to the business_id. Your project budgets, material costs, and client lists are mathematically shielded from other contractors on the platform.

---

PHASE 2: PROJECT & CLIENT ONBOARDING

In BBU1, everything revolves around a "Project."

1. Client Entry: Navigate to CRM > Customers. Add the property owner or developer.

2. Project Creation: Navigate to Project Management > Projects.

   • Enter the Project Name (e.g., "Kansanga Mall Renovation").

   • Set the Total Contract Value.

3. The BBU1 Link: BBU1 creates a unique project_id that acts as a "Bucket." Every expense and hour of work from this point forward will be sucked into this bucket automatically.

---

PHASE 3: WORK ORDERS & LABOR ALLOCATION

Contractors need to manage people and tasks.

1. Work Orders: Navigate to Management > Work Orders.

   • Create tasks (e.g., "Electrical Wiring - Phase 1").

2. Assignments: Assign the task to an employee from the employees table.

3. Time Tracking: Employees use the Time & Attendance module to log hours against that specific work_order_id.

   • Automation: BBU1 pulls the employee's hourly rate and automatically posts a "Labor Cost" to the job_costs table. The user did zero math.

---

PHASE 4: PROCUREMENT & REAL-TIME JOB COSTING

This is where BBU1 stops the money leaks.

1. Material Requisition: Navigate to Procurement > Requests.

2. The Project Sync: When ordering materials (e.g., Cement, Paint), the user selects the Project ID.

3. The Sovereign Seal: When the supplier invoice is saved:

   • Automatic 16% VAT: BBU1 calculates the 16% input tax automatically.

   • Job Cost Update: The material cost is instantly added to the job_costs table for that project.

   • Profit Monitoring: BBU1 compares the job_costs (Labor + Materials) against the Project Budget in real-time.

---

PHASE 5: THE "CHANGE ORDER" PROTECTOR

Change orders usually kill a contractor's profit because they aren't billed. BBU1 automates them.

1. Creation: If the client requests a change (e.g., "Use Marble instead of Tiles"), navigate to Management > Change Orders.

2. Impact Math: Enter the new costs.

3. The Trigger: BBU1 executes trg_ledger_sync_changes.

   • Automation: It automatically increases the "Total Contract Value" and updates the invoicing schedule to include the extra work at the 16% tax rate.

---

PHASE 6: AUTOMATED PROGRESS BILLING (INVOICING)

Contractors don't bill all at once; they bill in stages.

1. Invoicing: Navigate to Invoicing > Create Invoice.

2. Progress Selection: Choose "Bill by Project Percentage" or "Bill by Completed Work Orders."

3. The Math: BBU1 looks at the work_orders marked "Completed" and generates an invoice.

   • 16% Tax Logic: It automatically applies the 16% VAT/Sales Tax to the bill.

4. Aged Receivables: The invoice is tracked. If the client doesn't pay, BBU1 flags it in the Aged Payables/Receivables report.

---

PHASE 7: AUTOMATED REPORTING & AUDITING

The contractor now has an "Audit-Ready" business.

1. Project P&L: Navigate to Reports Center > Profit & Loss.

   • Filter by Project. BBU1 shows: Project Revenue - (Materials + Labor + Overheads) = Project Net Profit.

2. Tax Liability: The Tax and Compliance Hub shows exactly how much 16% VAT was collected vs. how much was paid to suppliers (Input vs Output).

3. Audit Trail: The Audit Trail Report shows every single change order and material purchase, preventing "Site Managers" from stealing materials or inflating costs.

---

PHASE 8: ASK AURA (THE PROJECT SUPERVISOR)

Aura acts as the contractor's "Virtual Site Engineer":

• "Aura, are we over budget on the Kansanga Mall project labor costs?"

• "Aura, show me all materials purchased for Project X that haven't been invoiced to the client yet."

• "Aura, what is our projected tax liability for the 16% VAT this month?"

---

SUMMARY OF THE CONTRACTOR ADVANTAGE

• Total Cost Visibility: Labor and Materials are linked to Projects automatically.

• Change Order Control: Never lose money on extra work again.

• Automated 16% Tax: All material purchases and client bills are handled by the BBU1 Sovereign Kernel.