Build a Warehouse Gate Turnaround and Demurrage Dispute Engine — implementation

## Build
Cross-examine warehouse electronic gate logs against hauler demurrage and detention invoices. Construct verifiable OpenAttestation proof dossiers to resolve disputed delay surcharges.

## User
Warehouse Operations Supervisor

## Workflow
1. Extract automated gate RFID timestamps and dock assignment milestones.
2. Compute billable dwell durations against contracted free-time thresholds.
3. Identify overcharges between billed detention amounts and measured turnaround times.
4. Wrap verified gate records into OpenAttestation proofs and generate formal dispute notices.

## Interface
Detention audit console showing gate event timestamps, dwell timelines, and one-click dispute letter synthesis.

## Data
Provide synthetic warehouse gate RFID logs and mock carrier detention billing invoices.
Starter examples below are synthetic. They are not downloaded records.

## Source
[OpenAttestation](https://raw.githubusercontent.com/Open-Attestation/open-attestation/master/README.md)
Employs OpenAttestation signDocument and verifySignature routines to notarize electronic gate logs.

## Tools
anthropic-claude, open-attestation, pydantic.
Anthropic Claude excels at reconciling nuanced logistics dispute records and drafting clear, professional legal notices.
Hosted or local model for drafting formal carrier invoice challenge letters.

## Deliverables
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.

## Acceptance
- Parse electronic gate-in and gate-out timestamp records for Jurong industrial warehouse docks.
- Reconcile actual truck dwell times against contractual free-time allowances.
- Wrap verified gate event records into signed OpenAttestation attestation packages.
- Generate objective demurrage dispute dossiers citing verified electronic physical logs.

## Starter Examples
```json
[
  {
    "input": {
      "dock_assigned_time": "11:30",
      "free_time_allowed_hours": 2,
      "gate_in_time": "09:00",
      "gate_out_time": "13:00",
      "hauler_id": "CARRIER-X",
      "invoiced_detention_hours": 3
    },
    "expected_output": {
      "actual_detention_hours": 2,
      "dispute_eligible": true,
      "dispute_reason": "FREE_TIME_EXCLUSION_NOT_CREDITED",
      "overcharge_hours": 1,
      "status": "DRAFT_DISPUTE_DOSSIER"
    }
  },
  {
    "input": {
      "dock_assigned_time": "08:15",
      "free_time_allowed_hours": 2,
      "gate_in_time": "08:00",
      "gate_out_time": "09:30",
      "hauler_id": "CARRIER-Y",
      "invoiced_detention_hours": 0
    },
    "expected_output": {
      "actual_detention_hours": 0,
      "dispute_eligible": false,
      "dispute_reason": null,
      "overcharge_hours": 0,
      "status": "APPROVE_INVOICE"
    }
  }
]
```

## Safety
Simulates detention disputes; does not trigger financial deductions or carrier contract terminations.
Use mock external writes. Require human review before any real deployment.