runbookify
← All plans
Field Service & Dispatch / Asset / Equipment Service History

Per-Asset Service History Timeline: Every Work Order, Part & Reading in One Scroll

Consolidate every work order, part, reading, and note for a machine into one chronological timeline a tech can read in seconds — with a manager approving any merges before two records become one asset.

IntermediateAn afternoonBuilds onNext.jsSupabaseResend
What you'll build

A web tool where you import work-order history, link it to assets by serial, see one clean chronological timeline per machine (parts and downtime included), have a manager approve any merges when one physical asset shows up under different ids, and export a per-asset timeline as CSV.

Gated download

Enter your email — the plan downloads instantly and a copy lands in your inbox.

By submitting your email you'll also receive the weekly runbookify newsletter. You can unsubscribe at any time.

Before you start

  • A Supabase account (free)
  • A Vercel account (free)
  • A Resend account (free)
  • A work-order history CSV (work orders, parts, notes keyed to asset/serial)
  • Claude Code or any AI coding agent

The problem this kills

A tech rolls up to a machine and has no idea what happened to it last month, let alone last year. The work-order history is scattered across a maintenance system, a couple of spreadsheets, and a folder of notes — and half of it is filed under the wrong id because the same physical machine got re-serialized, re-tagged, or entered twice when the asset register was rebuilt. So the tech starts blind: repeats a repair that already failed, swaps a part that was just replaced, or misses the pattern that this pump has overheated three times this quarter.

The history exists. It's just unreadable. Nobody can answer "what's the story on this asset?" in under twenty minutes of digging, and when two records are secretly the same machine, the real story is split in half. You don't need a new enterprise CMMS to fix this, and you don't need to be a developer to build the fix.

What you'll build

A simple internal web tool. You import your work-order history, the parts used, and the notes — all keyed to an asset or serial number. The tool links every event to the right asset, dedupes on work-order id so nothing is counted twice, and renders one chronological timeline per machine: every work order, every part swapped, every meter reading, every note, with downtime per event right there on the line. A tech opens the asset and reads its whole life in seconds before touching a wrench.

When the same physical machine shows up under different ids or serials — the classic mess — the tool flags the likely duplicates and shows a manager a side-by-side. The manager reviews and approves the merge, and only then are the two histories combined into one timeline. You can export any asset's full timeline as a CSV to hand off, archive, or paste into your system of record.

What's inside the Implementation Plan

The downloadable plan is a step-by-step file you paste into an AI coding agent. It opens by interviewing you about your business — what you call an asset, how serials and tag numbers are formatted, which systems and spreadsheets your work orders live in, exactly what your columns are named, how you record parts and downtime, your typical and peak event volumes, and the messy ways one machine ends up under several ids — and then it tailors the data model, the matching rules, and every later step to your answers. This is not a generic template; the agent reads a short spec back to you and waits for your thumbs-up before it builds anything. From there it walks the agent through the import, the asset-linking and dedupe logic, the timeline view, the manager merge-and-approve screen, and the per-asset CSV export — each step with a ready-to-copy prompt. There's also a fallback so you can build the whole thing today even with no API to your maintenance system.

The governance it includes (this is the point)

This is real operational tooling, so it ships with the controls a service team needs: login so only your team can use it, row-level security so you only ever see your own organization's assets, a complete audit trail of who imported, edited, merged, and exported what and when, a hard human-approval gate so two records are never combined into one asset until a manager signs off, and duplicate guards keyed on work-order id so the same event can't be imported or counted twice. Merges are reversible-by-record: the original source ids are preserved so you can always see where a timeline event came from.

Who it's for

Technicians who want the machine's story before they start, service managers who own the asset register, and asset controllers tired of reconciling the same machine under three different ids by hand. If you can describe how your shop tracks a piece of equipment, you can build this.

You've got this — start with the plan, paste the first prompt, answer the interview, and you'll see your first asset's full timeline come together the same afternoon.

Gated download

Enter your email — the plan downloads instantly and a copy lands in your inbox.

By submitting your email you'll also receive the weekly runbookify newsletter. You can unsubscribe at any time.