Concealed Damage Tracker
Log damage you find after a freight delivery, automatically check it against your carrier's reporting window, and get claims sign-off before you file - so nothing gets barred for late notice.
A private internal tool where receiving logs concealed damage with photos, the tool checks the delivery date against each carrier's reporting window, claims reviews and approves for timeliness, and at-risk shipments trigger an alert before the deadline passes.
Before you start
- A free Supabase account
- A free Vercel account
- A free Resend account (for at-risk alerts)
- Your carriers' concealed-damage reporting windows (often 5 or 15 days)
The problem this kills
Concealed damage is the freight claim that gets away. The pallet looked fine on the dock, the driver got a clean delivery receipt, and the dent or crushed carton only turns up days later when someone finally opens the box. By then the clock is already running - and most carriers will deny a concealed-damage claim outright if you report it after their window closes, often just 5 or 15 days from delivery.
The damage isn't the problem. The calendar is. Receiving finds the problem but doesn't know the deadline. Claims knows the deadline but doesn't hear about the damage until it's too late. Notes live in email threads, photos live on someone's phone, and the one report that needed to go out today quietly slips past the cutoff. Every barred claim is money you eat that the carrier owed you.
What you'll build
A small, private web app for your receiving and claims teams. Receiving logs a concealed-damage find - shipment, item, delivery date, discovery date, photos - and the tool instantly does the math against that carrier's reporting window. It tells you how many days are left, flags anything already at risk, and routes the report to claims. Claims reviews each one for timeliness, approves it, and only then is it marked as a filed, on-time report. Anything approaching its deadline triggers an email alert so it never falls through.
What's inside the Implementation Plan
The plan is a complete, copy-paste runbook you hand to an AI coding agent (Claude Code). It starts by interviewing you about your business - your carriers and their exact reporting windows, how your shipments and items are numbered, who in receiving logs damage and who in claims approves it, your real volumes, and your messy edge cases (partial pallets, re-consigned freight, weekend deliveries). It reflects a short spec back to you for a thumbs-up, then builds the tool tailored to how you actually work - not a generic template.
From there it walks you step by step: the data model, the logging screen with photo upload, the reporting-window calculator, the claims approval gate, the at-risk email alerts, login and per-organization security, a full audit trail, and a CSV export in the exact columns your claims system expects.
The governance it includes (this is the point)
- Login so only your team can open the tool.
- Row-level security so each organization only ever sees its own shipments and claims.
- A complete audit trail - who logged each damage, who approved it, and exactly when.
- A human-in-the-loop approval gate - the tool drafts the timeliness assessment, but a claims reviewer must approve before anything is marked as a filed report.
- Duplicate guards keyed on shipment + item, so the same damaged piece can't be logged or filed twice.
Who it's for
Receiving and claims teams at shippers, 3PLs, and distributors who deal with LTL and truckload freight and lose real money when concealed-damage claims get denied for late notice. If you can fill in a form and read your carrier's claims rules, you can build this.
You've got this - paste the first prompt and let the agent interview you.