autopilot-core-sandbox 0.0.1

package/dist/dist/migrations/20260725230000_onboarding_preload_data.sql

@@ -0,0 +1,1074 @@
+-- Shared, immutable image keys replace the old per-company copies in Storage.
+-- A null key means the row has no bundled default image.
+alter table "public"."category"
+  add column "default_image_key" text;
+
+alter table "public"."category"
+  add constraint "category_default_image_key_format_check"
+  check (
+    "default_image_key" is null
+    or "default_image_key" ~ '^categories/[a-z0-9]+(-[a-z0-9]+)*[.]gif$'
+  );
+
+create unique index "category_company_default_image_key_key"
+  on "public"."category" ("company_id", "default_image_key")
+  where "default_image_key" is not null;
+
+alter table "public"."item"
+  add column "default_image_key" text;
+
+alter table "public"."item"
+  add constraint "item_default_image_key_format_check"
+  check (
+    "default_image_key" is null
+    or "default_image_key" ~ '^items/[a-z0-9]+(-[a-z0-9]+)*[.]gif$'
+  );
+
+create unique index "item_company_default_image_key_key"
+  on "public"."item" ("company_id", "default_image_key")
+  where "default_image_key" is not null;
+
+-- One committed row means this company completed this exact preload version.
+-- The composite primary key is also the concurrency-safe claim used by the RPC.
+create table "public"."onboarding_preload_run" (
+  "company_id" uuid not null,
+  "preload_key" text not null,
+  "requested_by" uuid,
+  "created_at" timestamp with time zone not null default now(),
+  "completed_at" timestamp with time zone not null default now(),
+  "result" jsonb not null default '{}'::jsonb,
+  constraint "onboarding_preload_run_pkey"
+    primary key ("company_id", "preload_key"),
+  constraint "onboarding_preload_run_company_id_fkey"
+    foreign key ("company_id")
+    references "public"."company" ("id")
+    on delete cascade,
+  constraint "onboarding_preload_run_requested_by_fkey"
+    foreign key ("requested_by")
+    references "public"."user" ("id")
+    on delete set null,
+  constraint "onboarding_preload_run_preload_key_check"
+    check ("preload_key" ~ '^[a-z0-9]+(-[a-z0-9]+)*-v[1-9][0-9]*$')
+);
+
+create index "onboarding_preload_run_requested_by_idx"
+  on "public"."onboarding_preload_run" ("requested_by")
+  where "requested_by" is not null;
+
+-- This RPC deliberately accepts no tenant or seed-data arguments. It derives
+-- the requester, role, company, owner, address, industry, and timezone from the
+-- database. Postgres executes a function call as one transaction, so any error
+-- rolls back the claim and every inserted sample row.
+create or replace function "public"."preload_onboarding_data"()
+returns jsonb
+language plpgsql
+security definer
+set search_path = pg_catalog, public, pg_temp
+as $function$
+declare
+  v_preload_key constant text := 'junk-removal-v1';
+  v_requester_id uuid := "auth"."uid"();
+  v_company_id uuid;
+  v_company_name text;
+  v_industry text;
+  v_time_zone text;
+  v_owner_id uuid;
+  v_owner_email text;
+  v_owner_first_name text;
+  v_owner_last_name text;
+  v_owner_phone text;
+  v_company_address_id uuid;
+  v_company_address text;
+  v_company_city text;
+  v_company_state text;
+  v_company_zip_code text;
+  v_company_latitude double precision;
+  v_company_longitude double precision;
+  v_include_owner boolean := false;
+  v_local_date date;
+  v_claimed integer;
+  v_result jsonb;
+
+  v_client_1_id uuid := "extensions"."gen_random_uuid"();
+  v_client_2_id uuid := "extensions"."gen_random_uuid"();
+  v_client_3_id uuid := "extensions"."gen_random_uuid"();
+  v_owner_client_id uuid := "extensions"."gen_random_uuid"();
+  v_address_1_id uuid := "extensions"."gen_random_uuid"();
+  v_address_2_id uuid := "extensions"."gen_random_uuid"();
+  v_address_3_id uuid := "extensions"."gen_random_uuid"();
+  v_owner_address_id uuid := "extensions"."gen_random_uuid"();
+  v_job_1_id uuid := "extensions"."gen_random_uuid"();
+  v_job_2_id uuid := "extensions"."gen_random_uuid"();
+  v_job_3_id uuid := "extensions"."gen_random_uuid"();
+  v_schedule_1_id uuid := "extensions"."gen_random_uuid"();
+  v_schedule_2_id uuid := "extensions"."gen_random_uuid"();
+  v_schedule_3_id uuid := "extensions"."gen_random_uuid"();
+  v_invoice_1_id uuid := "extensions"."gen_random_uuid"();
+  v_invoice_2_id uuid := "extensions"."gen_random_uuid"();
+  v_invoice_3_id uuid := "extensions"."gen_random_uuid"();
+begin
+  if v_requester_id is null then
+    raise exception using
+      errcode = '42501',
+      message = 'Authentication is required to preload onboarding data';
+  end if;
+
+  select
+    "user_role"."company_id",
+    "company"."company_name",
+    "company"."industry",
+    "company"."time_zone"
+  into
+    v_company_id,
+    v_company_name,
+    v_industry,
+    v_time_zone
+  from "public"."user_role"
+  inner join "public"."user"
+    on "user"."id" = "user_role"."user_id"
+    and "user"."company_id" = "user_role"."company_id"
+  inner join "public"."company"
+    on "company"."id" = "user_role"."company_id"
+  where "user_role"."user_id" = v_requester_id
+    and "user_role"."role_id" in (1, 2)
+    and "user"."is_current_employee" = true
+    and "user"."is_hidden" = false
+  order by
+    case when "user_role"."role_id" = 1 then 0 else 1 end,
+    "user_role"."created_at"
+  limit 1;
+
+  if v_company_id is null then
+    raise exception using
+      errcode = '42501',
+      message = 'Only a current company owner or admin can preload onboarding data';
+  end if;
+
+  if v_industry is null
+    or v_industry not in ('junk_removal', 'junk_removal_dumpster_rental')
+  then
+    raise exception using
+      errcode = '22023',
+      message = 'Onboarding preload data is only available for junk-removal companies';
+  end if;
+
+  insert into "public"."onboarding_preload_run" (
+    "company_id",
+    "preload_key",
+    "requested_by"
+  )
+  values (
+    v_company_id,
+    v_preload_key,
+    v_requester_id
+  )
+  on conflict ("company_id", "preload_key") do nothing;
+
+  get diagnostics v_claimed = row_count;
+
+  if v_claimed = 0 then
+    select "onboarding_preload_run"."result"
+    into v_result
+    from "public"."onboarding_preload_run"
+    where "onboarding_preload_run"."company_id" = v_company_id
+      and "onboarding_preload_run"."preload_key" = v_preload_key;
+
+    return coalesce(v_result, '{}'::jsonb)
+      || jsonb_build_object(
+        'already_preloaded', true,
+        'preload_key', v_preload_key
+      );
+  end if;
+
+  -- Validate the timezone before writing any sample rows.
+  v_local_date := (clock_timestamp() at time zone v_time_zone)::date;
+
+  select
+    "user"."id",
+    "user"."email",
+    "user"."first_name",
+    "user"."last_name",
+    "user"."phone_number"
+  into
+    v_owner_id,
+    v_owner_email,
+    v_owner_first_name,
+    v_owner_last_name,
+    v_owner_phone
+  from "public"."user_role"
+  inner join "public"."user"
+    on "user"."id" = "user_role"."user_id"
+    and "user"."company_id" = "user_role"."company_id"
+  where "user_role"."company_id" = v_company_id
+    and "user_role"."role_id" = 1
+    and "user"."is_current_employee" = true
+    and "user"."is_hidden" = false
+  order by "user_role"."created_at"
+  limit 1;
+
+  select
+    "address"."id",
+    "address"."address",
+    "address"."city",
+    "address"."state",
+    "address"."zip_code",
+    "address"."latitude",
+    "address"."longitude"
+  into
+    v_company_address_id,
+    v_company_address,
+    v_company_city,
+    v_company_state,
+    v_company_zip_code,
+    v_company_latitude,
+    v_company_longitude
+  from "public"."address"
+  where "address"."company_id" = v_company_id
+    and "address"."is_companys" = true
+    and "address"."is_deleted" is null
+  order by "address"."is_primary" desc, "address"."created_at"
+  limit 1;
+
+  v_include_owner := v_owner_id is not null
+    and v_company_address_id is not null;
+
+  insert into "public"."job_source" ("company_id", "name", "category")
+  values
+    (v_company_id, 'Google Ads', 'paid'),
+    (v_company_id, 'Facebook Ads', 'paid'),
+    (v_company_id, 'Bing Ads', 'paid'),
+    (v_company_id, 'Yelp Ads', 'paid'),
+    (v_company_id, 'Yard Signs', 'paid'),
+    (v_company_id, 'Craigslist', 'paid'),
+    (v_company_id, 'Door Hangers', 'paid'),
+    (v_company_id, 'Angies', 'paid'),
+    (v_company_id, 'Google Local Services', 'paid'),
+    (v_company_id, 'EDDM', 'paid'),
+    (v_company_id, 'Thumbtack', 'paid'),
+    (v_company_id, 'Repeat', 'organic'),
+    (v_company_id, 'Google Maps', 'organic'),
+    (v_company_id, 'Website', 'organic'),
+    (v_company_id, 'Online Booking', 'organic'),
+    (v_company_id, 'Referral', 'organic'),
+    (v_company_id, 'Unknown', 'unknown');
+
+  insert into "public"."job_type" ("company_id", "name")
+  values
+    (v_company_id, 'Junk Removal'),
+    (v_company_id, 'Demolition'),
+    (v_company_id, 'Junk Removal & Demolition'),
+    (v_company_id, 'Moving / Labor Only'),
+    (v_company_id, 'Delivery / Pickup'),
+    (v_company_id, 'Odd Jobs'),
+    (v_company_id, 'Cleanout');
+
+  insert into "public"."category" (
+    "company_id",
+    "name",
+    "note",
+    "default_image_key"
+  )
+  values
+    (
+      v_company_id,
+      'Junk Removal',
+      'Junk removal is the process of collecting, hauling, and responsibly disposing of unwanted items, debris, and waste from homes, businesses, or construction sites.',
+      'categories/junk-removal.gif'
+    ),
+    (
+      v_company_id,
+      'Dumpster Rental',
+      'Dumpster rental is a service that provides temporary waste containers for homes, businesses, or construction projects, allowing for easy disposal of debris and junk.',
+      'categories/dumpster-rental.gif'
+    ),
+    (
+      v_company_id,
+      'Overages',
+      'Applies when the job exceeds the selected load size, time, or labor and requires additional truck space or effort.',
+      'categories/overages.gif'
+    ),
+    (
+      v_company_id,
+      'Fees',
+      'Additional charges that may apply for payment processing, special handling, or regulated disposal requirements.',
+      'categories/fees.gif'
+    ),
+    (
+      v_company_id,
+      'Demolition',
+      'Light demolition services such as sheds, small structures, or interior tear-outs, including teardown, loading, and hot tubs.',
+      'categories/demolition.gif'
+    );
+
+  with "inserted_items" as (
+    insert into "public"."item" (
+      "company_id",
+      "is_booking",
+      "is_pricebook",
+      "item_name",
+      "item_price",
+      "description",
+      "category_id",
+      "item_type",
+      "model_number",
+      "taxable",
+      "payment_upfront",
+      "default_image_key"
+    )
+    select
+      v_company_id,
+      false,
+      true,
+      "seed"."item_name",
+      "seed"."item_price",
+      "seed"."description",
+      "category"."id",
+      'Service',
+      '',
+      "seed"."taxable",
+      false,
+      "seed"."default_image_key"
+    from (
+      values
+        (
+          'Demo - Hot Tub Removal',
+          450::numeric,
+          'Hot tub removed safely and professionally; when one-piece removal is not possible, the unit is cut into up to four sections to ensure safe transport and proper disposal. All labor, cutting, loading, and cleanup are included.',
+          true,
+          'categories/demolition.gif',
+          'items/demo-hot-tub-removal.gif'
+        ),
+        (
+          'Demo - Shed Removal',
+          450::numeric,
+          'We tear down and haul away sheds up to a full 7.5 cubic yards, including the walls, roof, and debris. You don''t lift a thing - we demolish it, load it, and leave the area clean and ready to use.',
+          true,
+          'categories/demolition.gif',
+          'items/demo-shed-removal.gif'
+        ),
+        (
+          'Fees - Bed Bugs',
+          300::numeric,
+          'Items contaminated with bed bugs require special handling and disposal to prevent spread; the space they take up still counts toward your total cubic yardage. Please notify us in advance so we can arrive prepared and handle everything safely and properly.',
+          false,
+          'categories/fees.gif',
+          'items/fees-bed-bugs.gif'
+        ),
+        (
+          'Fees - Disassemble Item',
+          20::numeric,
+          'We safely take apart items so they fit efficiently within the truck''s cubic yard limits.',
+          false,
+          'categories/fees.gif',
+          'items/fees-disassemble-item.gif'
+        ),
+        (
+          'Fees - Drug Paraphernalia',
+          50::numeric,
+          'Applies to items that require special handling and compliant disposal due to safety or legal requirements.',
+          false,
+          'categories/fees.gif',
+          'items/fees-drug-paraphernalia.gif'
+        ),
+        (
+          'Fees - Extra Labor',
+          50::numeric,
+          'Additional manpower needed due to item size, weight, or complexity, regardless of cubic yards. ($50/hr per person)',
+          false,
+          'categories/fees.gif',
+          'items/fees-extra-labor.gif'
+        ),
+        (
+          'Fees - Feces & Urine',
+          300::numeric,
+          'Biohazard material requiring special handling; volume still counts toward truck space.',
+          false,
+          'categories/fees.gif',
+          'items/fees-feces-urine.gif'
+        ),
+        (
+          'Fees - Stairs',
+          25::numeric,
+          'Charged when items must be carried up or down stairs; volume is unchanged. ($20 per flight)',
+          false,
+          'categories/fees.gif',
+          'items/fees-stairs.gif'
+        ),
+        (
+          'Overages - Bagging & Packing',
+          50::numeric,
+          'We bag loose items and organize everything to maximize space within your selected cubic yardage.',
+          false,
+          'categories/overages.gif',
+          'items/overages-bagging-packing.gif'
+        ),
+        (
+          'Overages - Elevator + Long Distance',
+          50::numeric,
+          'Applies when items must be moved long distances or via elevators; volume remains unchanged.',
+          false,
+          'categories/overages.gif',
+          'items/overages-elevator-long-distance.gif'
+        ),
+        (
+          -- Deliberately in the Fees category despite the name, matching the
+          -- original onboarding dataset this migration replaces.
+          'Overages - Hazardous Waste',
+          50::numeric,
+          'Materials needing regulated disposal; cubic yardage applies but restrictions may limit volume. ($50 per 5 gallons)',
+          false,
+          'categories/fees.gif',
+          'items/overages-hazardous-waste.gif'
+        ),
+        (
+          'Overages - Heavy Weight',
+          50::numeric,
+          'Extremely heavy items that take up cubic yards and require extra effort or equipment. ($50 per quarter load)',
+          false,
+          'categories/overages.gif',
+          'items/overages-heavy-weight.gif'
+        ),
+        (
+          'Overages - Long Distance',
+          50::numeric,
+          'Applies when items are far from the truck; cubic yardage remains the same. ($50 per 100 feet)',
+          false,
+          'categories/overages.gif',
+          'items/overages-long-distance.gif'
+        ),
+        (
+          'Truck - 1/2 Truck Load',
+          495::numeric,
+          'About 7.5 cubic yards, commonly used for garage cleanouts or larger furniture loads.',
+          true,
+          'categories/junk-removal.gif',
+          'items/truck-1-2-truck-load.gif'
+        ),
+        (
+          'Truck - 1/3 Truck Load',
+          435::numeric,
+          'Roughly 5 cubic yards, great for a small room cleanout or several furniture pieces.',
+          true,
+          'categories/junk-removal.gif',
+          'items/truck-1-3-truck-load.gif'
+        ),
+        (
+          'Truck - 1/6 Truck Load',
+          250::numeric,
+          'About 2.5 cubic yards, ideal for a small pile or a couple of bulky items.',
+          true,
+          'categories/junk-removal.gif',
+          'items/truck-1-6-truck-load.gif'
+        ),
+        (
+          'Truck - 1/8 Truck Load',
+          195::numeric,
+          'Approximately 1.9 cubic yards, perfect for a few small items or a very light pickup.',
+          true,
+          'categories/junk-removal.gif',
+          'items/truck-1-8-truck-load.gif'
+        ),
+        (
+          'Truck - 2/3 Truck Load',
+          565::numeric,
+          'Around 10 cubic yards, ideal for major cleanups taking most of the truck.',
+          true,
+          'categories/junk-removal.gif',
+          'items/truck-2-3-truck-load.gif'
+        ),
+        (
+          'Truck - 3/4 Truck Load',
+          645::numeric,
+          'About 11.25 cubic yards, perfect for large decluttering or partial property cleanouts.',
+          true,
+          'categories/junk-removal.gif',
+          'items/truck-3-4-truck-load.gif'
+        ),
+        (
+          'Truck - 3/8 Truck Load',
+          450::numeric,
+          'Around 5.6 cubic yards, suitable for medium-sized piles with some bulk.',
+          true,
+          'categories/junk-removal.gif',
+          'items/truck-3-8-truck-load.gif'
+        ),
+        (
+          'Truck - 5/8 Truck Load',
+          530::numeric,
+          'Approximately 9.4 cubic yards, when the job is getting big but not overwhelming.',
+          true,
+          'categories/junk-removal.gif',
+          'items/truck-5-8-truck-load.gif'
+        ),
+        (
+          'Truck - 7/8 Truck Load',
+          715::numeric,
+          'Roughly 13.1 cubic yards, nearly a full truck with very little space left.',
+          true,
+          'categories/junk-removal.gif',
+          'items/truck-7-8-truck-load.gif'
+        ),
+        (
+          'Truck - Full Load',
+          795::numeric,
+          'The entire truck, 15 cubic yards, filled completely from floor to ceiling.',
+          true,
+          'categories/junk-removal.gif',
+          'items/truck-full-load.gif'
+        ),
+        (
+          'Truck - Minimum',
+          125::numeric,
+          'The minimum service charge for very small jobs, typically under 1 cubic yard.',
+          true,
+          'categories/junk-removal.gif',
+          'items/truck-minimum.gif'
+        )
+    ) as "seed" (
+      "item_name",
+      "item_price",
+      "description",
+      "taxable",
+      "category_image_key",
+      "default_image_key"
+    )
+    inner join "public"."category"
+      on "category"."company_id" = v_company_id
+      and "category"."default_image_key" = "seed"."category_image_key"
+    returning "id"
+  )
+  insert into "public"."item_cost" ("company_id", "item_id", "cost")
+  select v_company_id, "inserted_items"."id", 0
+  from "inserted_items";
+
+  insert into "public"."client" (
+    "id",
+    "email",
+    "first_name",
+    "last_name",
+    "client_company_name",
+    "client_notes",
+    "company_id",
+    "client_or_lead",
+    "primary_phone_number",
+    "source_id",
+    "stripe_customer_id"
+  )
+  values
+    (
+      v_client_1_id,
+      'john.doe@example.com',
+      'John',
+      'Doe',
+      'Example Inc.',
+      'Amazing customer, tips very well.',
+      v_company_id,
+      'client',
+      '',
+      null,
+      null
+    ),
+    (
+      v_client_2_id,
+      'jane.doe@example.com',
+      'Jane',
+      'Doe',
+      'Example Inc.',
+      'Super friendly, tips great.',
+      v_company_id,
+      'client',
+      '',
+      null,
+      null
+    ),
+    (
+      v_client_3_id,
+      'sam.doe@example.com',
+      'Sam',
+      'Doe',
+      '',
+      'We had a great connection about us both playing the guitar.',
+      v_company_id,
+      'client',
+      '',
+      null,
+      null
+    );
+
+  insert into "public"."address" (
+    "id",
+    "client_id",
+    "address",
+    "city",
+    "state",
+    "zip_code",
+    "company_id",
+    "is_primary",
+    "latitude",
+    "longitude"
+  )
+  values
+    (
+      v_address_1_id,
+      v_client_1_id,
+      '215 West Janss Road',
+      'Thousand Oaks',
+      'CA',
+      '91360',
+      v_company_id,
+      true,
+      34.2067796,
+      -118.8830898
+    ),
+    (
+      v_address_2_id,
+      v_client_2_id,
+      '490 Oak Tree Lane',
+      'Thousand Oaks',
+      'CA',
+      '91360',
+      v_company_id,
+      true,
+      34.183939,
+      -118.8709229
+    ),
+    (
+      v_address_3_id,
+      v_client_3_id,
+      '5300 Lost Hills Road',
+      'Calabasas',
+      'CA',
+      '91302',
+      v_company_id,
+      true,
+      34.1437013,
+      -118.7088545
+    );
+
+  if v_include_owner then
+    insert into "public"."client" (
+      "id",
+      "email",
+      "first_name",
+      "last_name",
+      "client_company_name",
+      "client_notes",
+      "company_id",
+      "client_or_lead",
+      "primary_phone_number",
+      "source_id",
+      "stripe_customer_id"
+    )
+    values (
+      v_owner_client_id,
+      v_owner_email,
+      v_owner_first_name,
+      v_owner_last_name,
+      v_company_name,
+      'Autopilot #1 Fan.',
+      v_company_id,
+      'client',
+      v_owner_phone,
+      null,
+      null
+    );
+
+    insert into "public"."address" (
+      "id",
+      "client_id",
+      "address",
+      "city",
+      "state",
+      "zip_code",
+      "company_id",
+      "is_primary",
+      "latitude",
+      "longitude"
+    )
+    values (
+      v_owner_address_id,
+      v_owner_client_id,
+      v_company_address,
+      v_company_city,
+      v_company_state,
+      v_company_zip_code,
+      v_company_id,
+      true,
+      -- Null coordinates mean the company address is not geocoded yet; copy
+      -- them through so the app treats this like any other un-geocoded address.
+      v_company_latitude,
+      v_company_longitude
+    );
+  end if;
+
+  insert into "public"."job" (
+    "id",
+    "company_id",
+    "client_id",
+    "notes",
+    "type",
+    "job_source",
+    "address_id",
+    "unpaid_upfront",
+    "job_recurring_id",
+    "job_number"
+  )
+  values
+    (
+      v_job_1_id,
+      v_company_id,
+      v_client_1_id,
+      'Just a bunch of random stuff all around the house, estimated full load',
+      'Junk Removal',
+      'Online Booking',
+      v_address_1_id,
+      false,
+      null,
+      0
+    ),
+    (
+      v_job_2_id,
+      v_company_id,
+      v_client_2_id,
+      'just a bunch of trash bags upstairs',
+      'Junk Removal',
+      'Yard Signs',
+      v_address_2_id,
+      false,
+      null,
+      0
+    ),
+    (
+      v_job_3_id,
+      v_company_id,
+      v_client_3_id,
+      'he says its a hard to reach hot tub, for 6 people, and its already disconnected',
+      'Demolition',
+      'Google Ads',
+      v_address_3_id,
+      false,
+      null,
+      0
+    );
+
+  insert into "public"."job_schedule" (
+    "id",
+    "company_id",
+    "job_id",
+    "start_time",
+    "end_time",
+    "status"
+  )
+  values
+    (
+      v_schedule_1_id,
+      v_company_id,
+      v_job_1_id,
+      make_timestamptz(
+        extract(year from v_local_date)::integer,
+        extract(month from v_local_date)::integer,
+        extract(day from v_local_date)::integer,
+        8,
+        0,
+        0,
+        v_time_zone
+      ),
+      make_timestamptz(
+        extract(year from v_local_date)::integer,
+        extract(month from v_local_date)::integer,
+        extract(day from v_local_date)::integer,
+        9,
+        0,
+        0,
+        v_time_zone
+      ),
+      'Completed'
+    ),
+    (
+      v_schedule_2_id,
+      v_company_id,
+      v_job_2_id,
+      make_timestamptz(
+        extract(year from v_local_date)::integer,
+        extract(month from v_local_date)::integer,
+        extract(day from v_local_date)::integer,
+        11,
+        0,
+        0,
+        v_time_zone
+      ),
+      make_timestamptz(
+        extract(year from v_local_date)::integer,
+        extract(month from v_local_date)::integer,
+        extract(day from v_local_date)::integer,
+        12,
+        0,
+        0,
+        v_time_zone
+      ),
+      'On My Way'
+    ),
+    (
+      v_schedule_3_id,
+      v_company_id,
+      v_job_3_id,
+      make_timestamptz(
+        extract(year from v_local_date)::integer,
+        extract(month from v_local_date)::integer,
+        extract(day from v_local_date)::integer,
+        14,
+        0,
+        0,
+        v_time_zone
+      ),
+      make_timestamptz(
+        extract(year from v_local_date)::integer,
+        extract(month from v_local_date)::integer,
+        extract(day from v_local_date)::integer,
+        16,
+        0,
+        0,
+        v_time_zone
+      ),
+      'Open'
+    );
+
+  if v_owner_id is not null then
+    insert into "public"."job_user" (
+      "company_id",
+      "job_id",
+      "user_id",
+      "job_schedule_id"
+    )
+    values
+      (v_company_id, v_job_1_id, v_owner_id, v_schedule_1_id),
+      (v_company_id, v_job_2_id, v_owner_id, v_schedule_2_id),
+      (v_company_id, v_job_3_id, v_owner_id, v_schedule_3_id);
+  end if;
+
+  insert into "public"."invoice" (
+    "id",
+    "client_id",
+    "status",
+    "company_id",
+    "job_id",
+    "address_id",
+    "notes",
+    "due_date",
+    "invoice_number"
+  )
+  values
+    (
+      v_invoice_1_id,
+      v_client_1_id,
+      'Unsent',
+      v_company_id,
+      v_job_1_id,
+      v_address_1_id,
+      'We appreciate your patience waiting while our team changed their flat tire; I''m glad we were still able to get everything cleaned up in time for your event. Thank you for your business!',
+      make_timestamptz(
+        extract(year from v_local_date)::integer,
+        extract(month from v_local_date)::integer,
+        extract(day from v_local_date)::integer,
+        0,
+        0,
+        0,
+        v_time_zone
+      ),
+      0
+    ),
+    (
+      v_invoice_2_id,
+      v_client_2_id,
+      'Unsent',
+      v_company_id,
+      v_job_2_id,
+      v_address_2_id,
+      'Thank you for your business!',
+      make_timestamptz(
+        extract(year from v_local_date)::integer,
+        extract(month from v_local_date)::integer,
+        extract(day from v_local_date)::integer,
+        0,
+        0,
+        0,
+        v_time_zone
+      ),
+      0
+    ),
+    (
+      v_invoice_3_id,
+      v_client_3_id,
+      'Unsent',
+      v_company_id,
+      v_job_3_id,
+      v_address_3_id,
+      'Removal of 6-person hot tub from difficult access area. Unit was pre-disconnected. Thank you for your business!',
+      make_timestamptz(
+        extract(year from (v_local_date + 1))::integer,
+        extract(month from (v_local_date + 1))::integer,
+        extract(day from (v_local_date + 1))::integer,
+        0,
+        0,
+        0,
+        v_time_zone
+      ),
+      0
+    );
+
+  insert into "public"."job_item" (
+    "company_id",
+    "job_id",
+    "invoice_id",
+    "item_name",
+    "item_price",
+    "item_cost",
+    "taxable",
+    "quantity",
+    "description",
+    "payment_upfront"
+  )
+  values
+    (
+      v_company_id,
+      v_job_1_id,
+      v_invoice_1_id,
+      'Truck - Full Load',
+      795,
+      0,
+      true,
+      1,
+      'The entire truck, 15 cubic yards, filled completely from floor to ceiling.',
+      null
+    ),
+    (
+      v_company_id,
+      v_job_1_id,
+      v_invoice_1_id,
+      'Overages - Bagging & Packing',
+      50,
+      0,
+      false,
+      1,
+      'Overages for bagging and packing',
+      null
+    ),
+    (
+      v_company_id,
+      v_job_2_id,
+      v_invoice_2_id,
+      'Truck - 1/8 Truck Load',
+      195,
+      0,
+      true,
+      1,
+      'Approximately 1.9 cubic yards, perfect for a few small items or a very light pickup.',
+      null
+    ),
+    (
+      v_company_id,
+      v_job_2_id,
+      v_invoice_2_id,
+      'Fees - Stairs',
+      25,
+      0,
+      false,
+      1,
+      'Charged when items must be carried up or down stairs; volume is unchanged. ($20 per flight)',
+      null
+    ),
+    (
+      v_company_id,
+      v_job_3_id,
+      v_invoice_3_id,
+      'Demo - Hot Tub Removal',
+      450,
+      0,
+      true,
+      1,
+      'Hot tub removed safely and professionally; when one-piece removal is not possible, the unit is cut into up to four sections to ensure safe transport and proper disposal. All labor, cutting, loading, and cleanup are included.',
+      null
+    );
+
+  insert into "public"."payment" (
+    "company_id",
+    "job_id",
+    "invoice_id",
+    "amount_base",
+    "amount_tip",
+    "payment_type",
+    "payment_date",
+    "status"
+  )
+  values
+    (
+      v_company_id,
+      v_job_1_id,
+      v_invoice_1_id,
+      845,
+      0,
+      'cash',
+      make_timestamptz(
+        extract(year from v_local_date)::integer,
+        extract(month from v_local_date)::integer,
+        extract(day from v_local_date)::integer,
+        0,
+        0,
+        0,
+        v_time_zone
+      ),
+      null
+    ),
+    (
+      v_company_id,
+      v_job_2_id,
+      v_invoice_2_id,
+      220,
+      0,
+      'offline_credit_card',
+      make_timestamptz(
+        extract(year from v_local_date)::integer,
+        extract(month from v_local_date)::integer,
+        extract(day from v_local_date)::integer,
+        0,
+        0,
+        0,
+        v_time_zone
+      ),
+      null
+    );
+
+  v_result := jsonb_build_object(
+    'already_preloaded', false,
+    'preload_key', v_preload_key,
+    'default_images', 29,
+    'counts', jsonb_build_object(
+      'job_sources', 17,
+      'job_types', 7,
+      'categories', 5,
+      'items', 24,
+      'item_costs', 24,
+      'clients', case when v_include_owner then 4 else 3 end,
+      'addresses', case when v_include_owner then 4 else 3 end,
+      'jobs', 3,
+      'job_schedules', 3,
+      'job_users', case when v_owner_id is not null then 3 else 0 end,
+      'invoices', 3,
+      'job_items', 5,
+      'payments', 2
+    )
+  );
+
+  update "public"."onboarding_preload_run"
+  set
+    "completed_at" = clock_timestamp(),
+    "result" = v_result
+  where "onboarding_preload_run"."company_id" = v_company_id
+    and "onboarding_preload_run"."preload_key" = v_preload_key;
+
+  return v_result;
+end;
+$function$;
+
+comment on function "public"."preload_onboarding_data"() is
+  'Atomically preloads versioned junk-removal sample data for the authenticated owner/admin company. Accepts no tenant-controlled arguments and rejects unsupported industries.';