MIGRATION DIARYPRODUCT

Internal tools as real products, added late

Retrofitting internal tools as real products onto a field service platform that wasn't allowed to stop.

FILED
READ
AUTHOR
REF

Greenfield advice is easy to write and not much use. This is the same idea applied to a system already carrying production load that isn't allowed to stop, with the compromises left in view.

The software your own staff use all day deserves the same care as the software you sell. It usually gets a fraction of it, on the theory that a captive audience can be trained. They can. They'll also quietly build a better tool in a spreadsheet.

THE CAPTIVE AUDIENCE FALLACY

Internal users can't leave, so their frustration never shows up as churn. It shows up as slower work, more errors, and a hiring problem nobody connects back to the tooling. The feedback loop that keeps customer-facing software honest simply doesn't exist here, so quality drifts down until someone measures it.

The people using it all day also stop reporting problems, which is the part that fools everyone. Silence reads as satisfaction. It's usually resignation. If nobody's complained about the internal tool in six months, that's worth investigating rather than celebrating.

WHERE THE RETURN IS

The arithmetic is unusually friendly. Twelve people, all day, on one screen: shaving thirty seconds off a task performed forty times a day is an hour a week each. You rarely get returns that clean on customer-facing work, and you never have to guess at the usage numbers.

There's a second return that's harder to put a number on. Good internal tools make the process legible, and legible processes can be improved. Bad ones hide the process inside habit and tribal knowledge, and you can't improve what you can't see.

The code wasn't the hard part. Convincing schedulers that a second reader wouldn't cause a technician drove three hours to a job someone had already closed was, because the last project that promised that did exactly that.

WHAT GOOD LOOKS LIKE HERE

Not polish. Internal tools can be plain and should be dense. The people using them are experts and don't need onboarding wizards or generous whitespace. What they need is speed, keyboard access, honest error messages, and states that match the job.

The single highest-value feature is usually undo. Expert users work fast and fast users make mistakes, and the difference between a tool people trust and one they're careful around is whether a wrong click is recoverable.

We ran both paths against live traffic for three weeks and compared every work order. The mismatch rate started at four percent, all of it the old system's undocumented rounding.

WHERE IT GOES WRONG

  • No undo, so expert users move slowly on purpose to avoid mistakes they can't take back.
  • Error messages written for the developer rather than the person who has to act on them.
  • A tool nobody has complained about in six months, mistaken for a tool that works.
  • Designing for onboarding when the same twelve people have used it daily for three years.

If a dozen people use it all day, it's a product. Fund it like one.

WHAT THE MIGRATION COST

Eleven weeks, one reverted step, nothing customer-visible. The reverted step was the one where we changed two things at once. We keep relearning that and we keep writing it down.

RELATED
SAME GROUND, DIFFERENT ANGLE
ALL TRANSMISSIONS