# Enum hints and typical ranges sourced from the SugarScale MSSQL sandbox.
# Update these after running profiling queries to keep the agent grounded.

columns:
  dbo.SugarLoadData.LoadType:
    values:
      - Sugar
      - Molases
    notes: "Free-text field; normalize casing before comparisons."
  dbo.SugarLoadData.TrailerTypeID:
    values:
      - Dump
    notes: "Derived from manual entry; expect misspellings such as 'hopper' or 'Dump Trailer'."
  dbo.SugarLoadData.LoadingLocation:
    values:
      - Hopper
      - WH1
      - WH2
      - WH3
      - BB
    notes: "Locations map to historian area tags; keep a lookup table in sync with operations."
  dbo.SugarLoadData.Destination:
    values:
      - Baldwin 3
      - CSC
      - BB
      - Railcar
      - LSR
      - WH1
      - WH2
      - Barge
      - Caldwell
      - Other
    notes: "Destination names align with production reporting dashboards; treat nulls as 'Unassigned'."
  dbo.SugarLoadData.TCompanyName:
    values:
      - AOA
      - JJAG,LLC
      - Michael Durand
      - Atchafalaya Seafood
      - CSC
      - Southern Prestige ENT
      - LACA
      - RALPH CALLIER
      - ASR
      - 14-1
      - BIGDAWG
      - Lasuca
      - Earl Pania
      - J Bradley
    notes: "Company names align with production reporting dashboards; treat nulls as 'Unassigned'."

ranges:
  dbo.SugarLoadData.GrossWt:
    units: pounds
    typical_min: 20000
    typical_max: 95000
    notes: "Scale enforces 40-ton cap; values above 90000 suggest sensor error."
  dbo.SugarLoadData.TareWt:
    units: pounds
    typical_min: 20000
    typical_max: 45000
    notes: "Use stored vehicle tare when this column is null; sudden drops >20% flag for review."
  dbo.SugarLoadData.Tons:
    units: short_tons
    typical_min: 5
    typical_max: 40
    notes: "Calculated payload; negative values indicate data entry mistakes."

confidence_flags:
  dbo.SugarLoadData.VehicleId_Fk:
    null_meaning: "Manual override or unregistered vehicle"
    mitigation: "Join to SugarVehicles only after filtering nulls or alias to 'UNKNOWN_VEHICLE'."
  dbo.SugarLoadData.DateOut:
    null_meaning: "Truck has not exited; treat as active load."
    mitigation: "Filter out null DateOut when reporting completed deliveries."