ENGINE ROOM

All inbound WhatsApp messages must be classified by AI (intent, language, vehicle type). Deduplication by whatsapp_message_uid. No duplicate records.

Every inbound message must be matched to an existing Customer record by phone. If no match, create a new Customer with status=Lead.

Classify every message for: intent (Quote/Booking/Question/Complaint), service_type, vehicle_type, risk_flag, needs_photos, should_create_quote.

Auto-generate quotes from AI classification. Use samcoPriceDatabase for pricing. Apply multipliers for complexity. Always show base_cost and final_quote.

AI drafts replies for manual approval. Never auto-send without human review. reply_status must transition: Pending → Approved → Sent.

Repeat question from garages: 'What's the turnaround for a full Mercedes Sprinter front pair retrim?' — AI confidence 0.62. Current rules define capacity hours but not specific per-vehicle turnaround commitments. Suggest adding standard turnaround SLAs to Workshop scheduling rules. our turn round is 10 days or 2 weeks and depending on how busy we are

All uploaded media tagged with origin_source. Vision AI analyses images for damage detection. Reel suitability flagged automatically.

Jobs track full lifecycle: Pending → Scheduled → In Progress → Quality Check → Completed. Every job has job_number, assigned_team, production_stage.

Every system action logged to Phase1BuildLog. Admin-only functions verify user.role==='admin'. All API keys in environment secrets. No hardcoded credentials.

PIN-based clock-in with verification photos. Break tracking with reason codes. Auto-deduct breaks >6hrs. Waive requires admin override.

Weekly payroll from ClockRecords. Cash/bank rate split. Overtime at 1.5x after standard_weekly_hours. Holiday accrual from hours worked.

Stock tracking with reorder alerts. Low stock threshold triggers notifications. Barcode scanning support. Supplier integration.

QA inspections at each production stage. Quality risk scoring. Customer feedback collection. Photo evidence for completed work.

Multi-source lead intake. AI scoring (Hot/Warm/Cold). Enrichment via Hunter.io/Google Places. 6-stage pipeline: New Lead → Booked/Deposit Paid.

Gmail integration for unified inbox. AI auto-tagging and sorting. CRM linking by sender domain. Smart reply drafting.

Multi-step outreach campaigns. A/B testing support. Frequency cap: 30 days between outbound emails. do_not_contact kill switch respected.

PILLAR 16 — TOAST SYSTEM STANDARD: NEVER import toast from 'sonner' in any Samco OS component. The app uses useToast() from @/components/ui/use-toast exclusively. Any 'sonner' import will produce silent failures because there is no SonnerToaster provider mounted. All toast notifications MUST use: import { useToast } from '@/components/ui/use-toast'; then const { toast } = useToast(); then toast({ title: '...', description: '...', variant: 'destructive' | undefined }). This is IMMUTABLE SYSTEM LAW.

Specialised agents: Marketer, HR, Customer Service, Operations. Each agent has defined tools and entity access. Knowledge base per agent.

Shop capacity based on available staff hours. Job categories have standard hours. Overbooking guard prevents scheduling beyond capacity.

All pillars must produce verifiable evidence. Test packs with numbered cases. E2E simulation capability. Phase1BuildLog as audit trail.

Parallel dispatch: Facebook, LinkedIn, TikTok, GMB via Promise.allSettled. Missing tokens don't block other platforms. Atomic partial updates only.

Customer asked: 'Can you retrim my Tesla Model 3 seats in Alcantara with heated seat wiring intact?' — AI confidence 0.55. No existing rule covers Tesla EV seat compatibility or heated element preservation during retrim. Recommend creating Pillar 19 sub-rule for EV-specific retrim procedures.

AI image generation with ukSpecImageGen (RHD enforced). Vision analysis. PR Auditor with caption loops. Brand voice from BrandProfile.

Every AI vehicle image must pass RHD steering wheel audit. 2 consecutive LHD failures = MediaLibrary.create() FORBIDDEN. Logos/graphics bypass audit.

12 curated Facebook groups for manual high-reach distribution. Every click tracked: group_name, post_id, clicked_at. Attribution analytics by business impact.

Use /rest/posts with LinkedIn-Version: 202401. Assets API for media upload. Idempotency: broadcast_request_id blocks duplicates within 60s.

Live Meta Graph API metrics with permission diagnostics (connected|permissions_missing|reauth_required). Revenue Impact = Leads+Quotes within 72hrs of post.

The Engine Room at /EngineRoom is the central brain. All rules stored in EngineRoomLogic with logic_version and updated_at. Bi-directional Google Docs sync via batchUpdate. AI FORBIDDEN from syncing without Alex's [Approve & Sync] click.

Background: #0B1E3D. Surface: #102447. Text: #FFFFFF. All touch targets 48px. Headers 32px Bold Monospace. Backdrop-blur(15px) on all modals/overlays. No borders, box-shadows, or 12px gray text.

SeatLibrary entity stores master DNA specimens. Vision AI generates Spec Sentence: IDENTIFIED: [Year] [Make] [Model] • [Seat Type] • [Material] • TARGET: [Damage]. X-Ray Scanner on all lead/gallery images. 2 consecutive LHD failures = RHD gate block.