Build a Cold-Chain Marine Reefer Log Evidence and Insurance Claim Workspace — implementation

## Build
Analyze temperature telemetry logs from ocean reefer containers berthing at PSA terminals. Prepare verified OpenAttestation claim packages when spoilage limits are breached.

## User
Marine cargo insurance claims adjuster

## Workflow
1. Ingest container datalogger CSV files and berthing time records from Singapore port arrivals.
2. Compute cumulative thermal exposure degrees and identify exact voyage excursion timestamps.
3. Compile cryptographic OpenAttestation v2 claim bundles linking raw sensor hashes with invoice values.
4. Draft an adjuster claim evaluation summary with liability apportionments across voyage segments.

## Interface
Multi-segment voyage timeline showing temperature deviations against vessel route milestones, accompanied by an attestation packaging preview.

## Data
Synthesize maritime reefer telemetry records aligned with OpenAttestation v2 signing tools from source 2.
Starter examples below are synthetic. They are not downloaded records.

## Source
[OpenAttestation](https://raw.githubusercontent.com/Open-Attestation/open-attestation/master/README.md)
Applies OpenAttestation v2 wrapDocuments and obfuscateDocument to protect sensitive commercial cargo prices.

## Tools
dspy, @govtechsg/open-attestation, pandas.
DSPy compiles robust prompt pipelines to summarize complex time-series anomalies into objective legal dispute findings.
API-hosted LLM with strong quantitative reasoning and structured audit trail formatting.

## 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
- Quantifies cumulative Degree-Hours of excursion beyond contract setpoints.
- Produces valid OpenAttestation v2 JSON output with valid Merkle roots.
- Obfuscates confidential pricing data using OA obfuscateDocument when sharing with third-party adjusters.
- Generates clean itemized loss liability assessments.

## Starter Examples
```json
[
  {
    "input": {
      "voyage_id": "PSA-VOY-2025-44",
      "setpoint_celsius": -18,
      "tolerance_margin": 2,
      "readings": [
        {
          "time": "Day 1",
          "temp": -18.1
        },
        {
          "time": "Day 2",
          "temp": -17.9
        },
        {
          "time": "Day 3",
          "temp": -8.5
        },
        {
          "time": "Day 4",
          "temp": -7.2
        }
      ],
      "cargo_category": "Frozen Tuna"
    },
    "expected_output": {
      "excursion_confirmed": true,
      "cumulative_degree_hours": 247.2,
      "cargo_salvageable": false,
      "oa_bundle_created": true,
      "recommended_settlement": "FULL_LOSS_ADMISSIBLE"
    }
  },
  {
    "input": {
      "voyage_id": "PSA-VOY-2025-45",
      "setpoint_celsius": -18,
      "tolerance_margin": 2,
      "readings": [
        {
          "time": "Day 1",
          "temp": -18
        },
        {
          "time": "Day 2",
          "temp": -17.5
        },
        {
          "time": "Day 3",
          "temp": -17.8
        }
      ],
      "cargo_category": "Frozen Meat"
    },
    "expected_output": {
      "excursion_confirmed": false,
      "cumulative_degree_hours": 0,
      "cargo_salvageable": true,
      "oa_bundle_created": false,
      "recommended_settlement": "NO_CLAIM"
    }
  }
]
```

## Safety
Claim reports are non-binding draft recommendations for professional loss adjusters; no bank payouts occur.
Use mock external writes. Require human review before any real deployment.