diff --git a/Nop.Plugin.Misc.AIPlugin/docs/SCHEMA.md b/Nop.Plugin.Misc.AIPlugin/docs/SCHEMA.md
index b663d9e..f6179a5 100644
--- a/Nop.Plugin.Misc.AIPlugin/docs/SCHEMA.md
+++ b/Nop.Plugin.Misc.AIPlugin/docs/SCHEMA.md
@@ -572,23 +572,23 @@
 
   Shipping: "Shipping record with documents and measurement tracking"
     table-name: "fbShipping"
-    purpose: "Represents a physical inbound delivery event (truck arrival) at the warehouse, tracking the vehicle and the overall measurement status of the shipment"
+    purpose: "Inbound delivery event (truck arrival) at the warehouse. Created early and filled progressively — carrier, truck and trailer are assigned later."
     CargoCompany: string
     CargoPartner: CargoPartner
-      purpose: "The transport company (carrier) that hauled this delivery — distinct from the goods supplier, which is reached via ShippingDocument.Partner."
+      purpose: "Carrier (transport company); assigned later, null until known. Supplier is separate — see ShippingDocument.Partner."
       foreign-key: "CargoPartnerId"
       navigation: "many-to-one"
-    CargoPartnerId: int
+    CargoPartnerId: int?
     CargoTrailer: CargoTruck
-      purpose: "The trailer — the SAME CargoTruck table as CargoTruck, but the row with IsTrailer=true (CargoTrailerId → CargoTruck.Id)."
+      purpose: "Trailer (CargoTruck table, IsTrailer=true); optional, assigned later — null if none or not yet known."
       foreign-key: "CargoTrailerId"
       navigation: "many-to-one"
-    CargoTrailerId: int
+    CargoTrailerId: int?
     CargoTruck: CargoTruck
-      purpose: "The tractor/truck unit — a CargoTruck row with IsTrailer=false."
+      purpose: "Tractor unit (CargoTruck, IsTrailer=false) from the carrier's fleet; assigned later, null until known."
       foreign-key: "CargoTruckId"
       navigation: "many-to-one"
-    CargoTruckId: int
+    CargoTruckId: int?
     Comment: string
     Created: DateTime
     IsAllMeasured: bool
@@ -607,7 +607,7 @@
 
   ShippingDocument: "Shipping document with partner, items and files"
     table-name: "fbShippingDocument"
-    purpose: "A digital representation of a supplier's delivery note or invoice associated with the shipment, used for reconciling paper-based data with measured reality"
+    purpose: "Supplier's delivery note or invoice for the shipment; reconciles paper data with measured reality. Populated progressively — much entered at order time, the rest as it becomes known."
     Comment: string
     Country: string
     Created: DateTime
@@ -854,4 +854,4 @@
     Id: int
       purpose: "Primary key / unique identification"
       primary-key: true
-}
\ No newline at end of file
+}