Add truck freight ledger data

README.md

@@ -0,0 +1,28 @@
+Truck Freight Ledger
+
+This repository stores structured truck freight forwarding records for future analysis.
+
+Files
+- truck_freight_ledger.json: canonical structured ledger
+
+Schema notes
+- currency: currency code
+- records[]: one entry per load or payment arrangement
+- Common fields:
+  - date
+  - vehicle
+  - from / to / via
+  - shipper
+  - freight_charged
+  - advance_received
+  - paid_to_driver
+  - commission
+  - pending_from_shipper
+  - pending_to_driver
+  - status
+  - notes
+
+Usage
+- Append new loads as new records.
+- Keep corrections in notes when the user updates details.
+- Use the JSON file for future AI analysis and profit/pending calculations.

truck_freight_ledger.json

@@ -0,0 +1,204 @@
+{
+  "currency": "INR",
+  "created_from": "WhatsApp conversation with user",
+  "records": [
+    {
+      "id": "2026-05-17-jinu-coin-trivandrum-shabarimala-chennai",
+      "date": "2026-05-17",
+      "vehicle": null,
+      "from": "Trivandrum",
+      "via": ["Shabarimala"],
+      "to": "Chennai",
+      "shipper": "Jinu Coin",
+      "load_type": null,
+      "freight_charged": null,
+      "advance_received": null,
+      "paid_to_driver": null,
+      "commission": null,
+      "pending_from_shipper": null,
+      "pending_to_driver": null,
+      "status": "partial",
+      "notes": "User first said shipper was Minutes Coin, then corrected to Jinu Coin. No amounts were provided."
+    },
+    {
+      "id": "2026-05-17-ka04ag7476-drs-agarwal",
+      "date": "2026-05-17",
+      "vehicle": "KA04AG7476",
+      "from": "Thiruvananthapuram",
+      "to": "Mysore",
+      "shipper": "DRS Agarwal",
+      "load_type": "Household",
+      "freight_charged": 16500,
+      "advance_received": 14500,
+      "paid_to_driver": 14000,
+      "commission": 0,
+      "pending_from_shipper": 2000,
+      "pending_to_driver": 0,
+      "status": "pending collection",
+      "notes": "User said DRS paid 14500 advance. User paid driver 10000 advance and 4000 balance. Later user clarified DRS was charged 16500 and 2000 is still due."
+    },
+    {
+      "id": "2026-05-17-ka04ag7476-krs-partload",
+      "date": "2026-05-17",
+      "vehicle": "KA04AG7476",
+      "from": "Kollam",
+      "to": "Bangalore",
+      "shipper": "KRS",
+      "item": "MG car battery",
+      "freight_charged": 11000,
+      "advance_received": 5000,
+      "paid_to_driver": null,
+      "commission": null,
+      "pending_from_shipper": 6000,
+      "pending_to_driver": 0,
+      "status": "handled directly by shipper",
+      "notes": "KRS handled payment directly. Driver received 5000 advance from KRS and 6000 on delivery. User said this part-load does not create pending for them."
+    },
+    {
+      "id": "2026-05-17-hr38ac0945-agarwal-packers-movers",
+      "date": "2026-05-17",
+      "vehicle": "HR38AC0945",
+      "from": "Trivandrum",
+      "to": "Chennai",
+      "shipper": "Agarwal Packers and Movers",
+      "freight_charged": 19500,
+      "advance_received": 15000,
+      "paid_to_driver": 15000,
+      "commission": null,
+      "pending_from_shipper": 4500,
+      "pending_to_driver": 0,
+      "status": "pending collection",
+      "notes": "Manager Vikas paid driver 15000 as advance. Balance of 4500 was pending."
+    },
+    {
+      "id": "2026-05-15-tn25ca9552-century-polymers",
+      "date": "2026-05-15",
+      "vehicle": "TN25CA9552",
+      "from": "Kollam",
+      "to": "Chennai",
+      "deliveries": ["Ambattur", "Madhavaram"],
+      "shipper": "Century Polymers",
+      "freight_charged": 18000,
+      "advance_received": null,
+      "paid_to_driver": null,
+      "commission": 1000,
+      "pending_from_shipper": null,
+      "pending_to_driver": null,
+      "status": "commission received",
+      "notes": "Payment managed by Century Polymers. User received 1000 cash commission from driver."
+    },
+    {
+      "id": "2026-05-15-tn41dc5854-chips",
+      "date": "2026-05-15",
+      "vehicle": "TN41DC5854",
+      "from": "Thiruvananthapuram",
+      "to": "Palakkad",
+      "shipper": "Chips",
+      "freight_charged": 11000,
+      "advance_received": null,
+      "paid_to_driver": null,
+      "commission": 600,
+      "pending_from_shipper": null,
+      "pending_to_driver": null,
+      "status": "commission due",
+      "notes": "User said commission due is 600."
+    },
+    {
+      "id": "2026-05-14-kl07bp2609-sahara-packers",
+      "date": "2026-05-14",
+      "vehicle": "KL07BP2609",
+      "from": "Adoor",
+      "to": "Cochin",
+      "shipper": "Sahara Packers",
+      "freight_charged": 7000,
+      "advance_received": 7000,
+      "paid_to_driver": 6500,
+      "commission": 500,
+      "pending_from_shipper": 0,
+      "pending_to_driver": 0,
+      "status": "settled",
+      "notes": "User clarified Sahara paid 7000 total, user paid 5500 advance and 1000 balance to truck, leaving 500 profit."
+    },
+    {
+      "id": "2026-05-14-ka06ba2739-agarwal",
+      "date": "2026-05-14",
+      "vehicle": "KA06BA2739",
+      "from": "Thiruvananthapuram",
+      "to": "Hyderabad",
+      "shipper": "Agarwal",
+      "freight_charged": 38000,
+      "advance_received": 0,
+      "paid_to_driver": 33500,
+      "commission": null,
+      "pending_from_shipper": 38000,
+      "pending_to_driver": 4500,
+      "status": "fully pending from shipper",
+      "notes": "User said they did not receive any payment from Agarwal for this load. User paid driver 30000 and 3500."
+    },
+    {
+      "id": "2026-05-15-tn37bs7431-ambika-packers",
+      "date": "2026-05-15",
+      "vehicle": "TN37BS7431",
+      "from": "Thiruvananthapuram",
+      "to": "Thrissur",
+      "shipper": "Ambika Packers",
+      "freight_charged": 5500,
+      "advance_received": 5000,
+      "paid_to_driver": 5000,
+      "commission": 500,
+      "pending_from_shipper": 500,
+      "pending_to_driver": 500,
+      "status": "partially pending",
+      "notes": "User said 500 will be their commission. There is also 500 still due from the shipper based on the numbers given."
+    },
+    {
+      "id": "2026-05-13-tn48bd4858-agarwal-packers-movers",
+      "date": "2026-05-13",
+      "vehicle": "TN48BD4858",
+      "from": "Thiruvananthapuram",
+      "to": "Thirupathy",
+      "shipper": "Agarwal Packers and Movers",
+      "freight_charged": 23000,
+      "advance_received": 23000,
+      "paid_to_driver": 21700,
+      "commission": 1300,
+      "pending_from_shipper": 0,
+      "pending_to_driver": 0,
+      "status": "settled",
+      "notes": "User later confirmed the pending 2000 was also paid, so the load is settled."
+    },
+    {
+      "id": "2026-05-17-ka63a7003-indian-cbe-shipper",
+      "date": "2026-05-17",
+      "vehicle": "KA63A7003",
+      "from": "Thiruvananthapuram",
+      "to": "Coimbatore",
+      "shipper": "Indian CBE Shipper",
+      "freight_charged": 7000,
+      "advance_received": 6500,
+      "paid_to_driver": 5000,
+      "commission": 500,
+      "driver_freight": 6000,
+      "pending_from_shipper": 500,
+      "pending_to_driver": 500,
+      "status": "partially pending",
+      "notes": "User said they received 6500 advance, paid 5000, and will charge the driver another 500 as commission."
+    },
+    {
+      "id": "2026-05-12-mh48dc1206-agarwal-packers-movers",
+      "date": "2026-05-12",
+      "vehicle": "MH48DC1206",
+      "from": "Trivandrum",
+      "to": "Mumbai",
+      "shipper": "Agarwal Packers and Movers",
+      "freight_charged": 41000,
+      "advance_received": 38000,
+      "paid_to_driver": 40000,
+      "commission": 2000,
+      "pending_from_shipper": 3000,
+      "pending_to_driver": 0,
+      "status": "reconciled",
+      "notes": "User first shared total 41000, advance 38000, balance 3000. Later clarified they received 38000, paid 20000 + 15000, and the driver freight was 40000 with 2000 commission."
+    }
+  ]
+}