Build a Warehouse Dock Turnaround and Carrier Detention Dispute Reconciler
Cross-examine warehouse electronic gate timestamp records against carrier detention fee invoices. Verify actual queue delays against dock appointment logs to formulate evidence-backed dispute responses.
What you are building
The core problem, expected build, and operating context for this challenge.
Cross-examine warehouse electronic gate timestamp records against carrier detention fee invoices. Verify actual queue delays against dock appointment logs to formulate evidence-backed dispute responses.
Warehouse Contract Manager
Extract gate-in, dock-in, unloading complete, and gate-out timestamps from warehouse management logs.
Compare timestamps against scheduled carrier pickup windows and contractual grace period limits.
Determine whether driver turnaround exceedance was caused by warehouse bottlenecks or late carrier arrival.
Synthesize an evidence breakdown ledger and draft a verified carrier detention settlement letter.
A time-log audit view with stacked timeline bars representing carrier transit, gate waiting, and dock bay turnaround.
Generate synthetic CSV warehouse RFID gate logs alongside carrier detention claim tickets. Starter examples below are synthetic. They are not downloaded records.
Singapore open data API Employ data.gov.sg API query parameter conventions to filter time-series gate event logs.
pydantic-ai, fastapi, pandas. Pydantic AI structures event timestamp calculations into auditable output types with strict delta checks. Fast hosted model capable of precise time delta comparisons and audit report structuring.
Submit runnable source, pinned dependencies, setup commands, a working interface, example outputs, and a recorded end-to-end demo. Include tests and an action log.
Computes carrier detention hours accurately minus contractual two-hour free allowances.
Assigns delay liability to the carrier when gate arrival was outside the scheduled booking slot.
Generates an itemized detention ledger detailing approved versus rejected demurrage hours.
Requires human contract manager verification before final carrier notice dispatch.
```json [ { "input": { "claim_id": "DET-2025-01", "carrier_id": "HaulWell Logistics", "scheduled_slot": "2025-03-15T09:00:00+08:00", "actual_gate_in": "2025-03-15T08:55:00+08:00", "dock_assigned": "2025-03-15T12:30:00+08:00", "gate_out": "2025-03-15T13:45:00+08:00", "free_hours": 2, "billed_detention_hours": 2.75 }, "expected_output": { "liability": "warehouse_fault", "turnaround_duration_hours": 4.83, "allowed_billable_hours": 2.83, "disposition": "claim_accepted_partial", "reconciled_hours": 2.75, "settlement_note": "Approved 2.75 detention hours as warehouse bay assignment was delayed by 3.5 hours." } }, { "input": { "claim_id": "DET-2025-02", "carrier_id": "FastPort Drayage", "scheduled_slot": "2025-03-15T09:00:00+08:00", "actual_gate_in": "2025-03-15T11:45:00+08:00", "dock_assigned": "2025-03-15T12:00:00+08:00", "gate_out": "2025-03-15T13:00:00+08:00", "free_hours": 2, "billed_detention_hours": 1.25 }, "expected_output": { "liability": "carrier_fault", "turnaround_duration_hours": 1.25, "allowed_billable_hours": 0, "disposition": "claim_rejected", "reconciled_hours": 0, "settlement_note": "Carrier arrived 2 hours 45 minutes late for appointed slot. Turnaround inside terminal was under 2 hours." } } ] ```
Calculates billable hours and drafts settlement notes; no automated payments or credit adjustments occur. Use mock external writes. Require human review before any real deployment.
Participation guide
Calculates billable hours and drafts settlement notes; no automated payments or credit adjustments occur. Use mock external writes and human review.
How work is evaluated
Computes carrier detention hours accurately minus contractual two-hour free allowances. Assigns delay liability to the carrier when gate arrival was outside the scheduled booking slot. Generates an itemized detention ledger detailing approved versus rejected demurrage hours. Requires human contract manager verification before final carrier notice dispatch.
Runnable source, pinned dependencies, setup commands, working interface, example outputs, recorded demo, tests, and action logs.
Challenge datasets
Public datasets, plus the private datasets you have access to.
How submissions are scored
These dimensions define what the evaluator checks and which criteria separate a passable run from a strong one.
Complete workflow
Extract gate-in, dock-in, unloading complete, and gate-out timestamps from warehouse management logs. Compare timestamps against scheduled carrier pickup windows and contractual grace period limits. Determine whether driver turnaround exceedance was caused by warehouse bottlenecks or late carrier arrival. Synthesize an evidence breakdown ledger and draft a verified carrier detention settlement letter.
Missing or incorrect.
Partly complete, with documented gaps.
Complete, with reproducible evidence.
Correctness and evidence
Computes carrier detention hours accurately minus contractual two-hour free allowances. Assigns delay liability to the carrier when gate arrival was outside the scheduled booking slot. Generates an itemized detention ledger detailing approved versus rejected demurrage hours. Requires human contract manager verification before final carrier notice dispatch.
Missing or incorrect.
Partly complete, with documented gaps.
Complete, with reproducible evidence.
Review interface
A time-log audit view with stacked timeline bars representing carrier transit, gate waiting, and dock bay turnaround.
Missing or incorrect.
Partly complete, with documented gaps.
Complete, with reproducible evidence.
Safe execution
Calculates billable hours and drafts settlement notes; no automated payments or credit adjustments occur.
This dimension contributes its full weight only when the submission satisfies the requirement. Partial credit is not awarded.
What you should walk away with
Extract gate-in, dock-in, unloading complete, and gate-out timestamps from warehouse management logs.
Compare timestamps against scheduled carrier pickup windows and contractual grace period limits.
Determine whether driver turnaround exceedance was caused by warehouse bottlenecks or late carrier arrival.
Synthesize an evidence breakdown ledger and draft a verified carrier detention settlement letter.
Reference links and supporting material
Generate synthetic CSV warehouse RFID gate logs alongside carrier detention claim tickets. Supplied starter examples are synthetic, not source extracts.
Challenge setup
Configuration summary for this challenge.
Challenge input
Input details are not configured.
Pydantic AI
Typed Python agent framework.
Evaluated output
No output checks are configured.
- Extract gate-in, dock-in, unloading complete, and gate-out timestamps from warehouse management logs. Compa...
- Computes carrier detention hours accurately minus contractual two-hour free allowances. Assigns delay liabi...
- A time-log audit view with stacked timeline bars representing carrier transit, gate waiting, and dock bay t...
- 2 public reference cases
- 2 configured tools
Summary shows the first task, up to three tools, and up to three evidence items. Open the technical recipe to view all configured items.
View technical recipe
Configured tools
- Pydantic AI · Optional
- Pydantic AI · Optional
Evaluation contract
- Complete workflow · Weight 40
- Correctness and evidence · Weight 30
- Review interface · Weight 20
- Safe execution · Weight 10
Reference cases
- 2 public reference cases
Workflow tasks
No workflow tasks are configured.
Recipe freeze marker
No recipe freeze time is recorded.