# Movers To Trust - Full System Documentation & Machine Specifications This file provides comprehensive technical layouts, schemas, API specifications, and database structures for Movers To Trust, optimized for crawlers, AI search engines (ChatGPT, Perplexity, Gemini, Claude), and Large Language Models (LLMs). --- ## 1. What is Movers To Trust? (AEO Definition) Movers To Trust is a specialized niche business directory and consumer advocacy platform that helps consumers find and verify moving companies by integrating live federal licensing, safety ratings, and complaint records. It weeds out rogue movers by displaying official USDOT and FMCSA (Federal Motor Carrier Safety Administration) compliance cards on every profile, while routing exclusive leads directly into claimed movers' CRM pipelines. --- ## 2. Core Functional Modules ### A. FMCSA Compliance Widget - Displays official USDOT number, MC/MX number, and active operating status. - Pulls live carrier safety ratings ("Satisfactory", "Conditional", "Unsatisfactory", or "Not Rated"). - Shows a 4-year visual timeline log (2023 to 2026) of customer complaints categorized across 12 distinct commercial compliance issues: - Unauthorized Operations - Operating Authority & Insurance Mismatches - Shipment Documents & Weighing Violations - Estimates & Final Charges (Overcharging) - Hostage Goods (Holding belongings for ransom) - Pickup/Delivery Delays, Loss, and Damage - Claim Settlement Issues & Deceptive Business Practices ### B. Moving Cost Estimator & Lead Bidding Engine - Stepped wizard layout (Route -> Inventory -> Date -> Results). - Popover calendar picker using `react-day-picker` to select valid future dates. - Distance calculations based on ZIP code routes. - Home inventory sizes: Studio, 1-bedroom, 2-bedroom, 3-bedroom, 4+ bedroom. - Distributes matching general leads to up to 3 verified regional carriers operating in the origin/destination states. ### C. AI Moving Contract Analyzer - Natural language audit engine analyzing contracts, estimates, and emails for predatory fine print. - Flags hostage-goods clauses, 110% estimate bypass clauses, mandatory custom crating surcharges, and improper claims filing limitations under 49 U.S.C. ยง 14706. ### D. Legal Dispute & Demand Letter Generator - Produces formal legal notice letters citing federal regulations for consumers facing hostage-load scams, cargo loss/damage, or bait-and-switch price inflation. ### E. Direct-to-CRM Lead Routing (Granot Integration) - Connects verified movers directly to their sales pipelines. - Submits lead payloads as HTTP POST XML requests to the mover's Granot CRM Leads Gateway. - Bypasses email delays, delivering details into the CRM in under 2 seconds. --- ## 3. Database Schema (Supabase Postgres) Movers To Trust utilizes relational tables in Supabase Postgres with Row Level Security (RLS): ### `movers` Table Stores official USDOT registry data, compliance variables, and claimed owner configuration states. - `usdot_number` (text, PRIMARY KEY) - `mc_number` (text) - `company_name` (text, NOT NULL) - `street_address` (text) - `city` (text) - `state` (text) - `zip_code` (text) - `telephone` (text) - `fax` (text) - `num_trucks` (integer) - `num_tractors` (integer) - `num_trailers` (integer) - `safety_rating` (text) - `safety_review_date` (text) - `has_complaints` (boolean) - `status` (text) - `complaints` (jsonb) - `claimed_status` (text) - `claim_owner` (jsonb) - `custom_description` (text) - `custom_logo` (text) - `custom_gallery` (jsonb) - `hourly_rate` (numeric) - `socials` (jsonb) - `crm_config` (jsonb) ### `leads` Table Stores lead records and API integration responses. - `id` (text, PRIMARY KEY) - `usdot_number` (text, REFERENCES movers) - `customer_name` (text) - `customer_email` (text) - `customer_phone` (text) - `move_date` (text) - `move_size` (text) - `origin_zip` (text) - `destination_zip` (text) - `notes` (text) - `estimated_cost` (numeric) - `submitted_at` (timestamp) - `granot_status` (jsonb) ### `lead_claims` Table Tracks marketplace bids and lead distribution (maximum 3 claimants per lead). - `lead_id` (text, REFERENCES leads) - `usdot_number` (text, REFERENCES movers) - `claimed_at` (timestamp) ### `reviews` Table Stores verified customer reviews and ratings. - `id` (text, PRIMARY KEY) - `mover_usdot` (text, REFERENCES movers) - `rating` (numeric) - `reviewer_name` (text) - `review_text` (text) - `status` (text, e.g. "approved", "pending") - `created_at` (timestamp) ### `analytics` Table Stores traffic metrics for each mover. - `usdot_number` (text, PRIMARY KEY, REFERENCES movers) - `views` (integer) - `clicks` (integer) - `leads_count` (integer) --- ## 4. CRM Integration XML Payload Specification When a quote is submitted for a mover with Granot CRM enabled, the server transmits the following XML payload format to the CRM endpoint: ```xml [Mover API ID] [Mover System ID] [Unique Lead ID] [USDOT Number] [Customer Name] [Customer Email] [Customer Phone] [YYYY-MM-DD] [e.g. 2-bedroom] [Zip Code] [Zip Code] [Optional Customer Notes] $[Calculated Cost] MoversToTrust.com Exclusive Lead ``` --- ## 5. Structured SEO Schema (JSON-LD) The root directory layout embeds the following organization schema for entity recognition: ```json { "@context": "https://schema.org", "@type": "Organization", "name": "Movers To Trust", "url": "https://www.moverstotrust.com", "logo": "https://www.moverstotrust.com/logo.jpg", "description": "Movers To Trust is an independent consumer safety directory verifying FMCSA licensing, safety ratings, and complaint histories for 7,800+ moving carriers.", "foundingDate": "2020", "areaServed": { "@type": "Country", "name": "United States" }, "knowsAbout": [ "moving companies", "FMCSA compliance", "consumer protection", "moving fraud prevention" ] } ```