runbookify
← All plans
Field Service & Dispatch / Subcontractor & Crew Coordination

Subcontractor Work-Order Dispatch Portal: End the Outsourced-Job Black Box

Dispatch work orders to your subcontractors through a portal where they accept, post status, and upload completion proof — with a coordinator approving the assignment before it goes out and approving the proof before the job closes or bills.

IntermediateA weekendBuilds onNext.jsSupabaseResend
What you'll build

A web tool where a coordinator assigns a work order to a compliant subcontractor and approves the dispatch, the sub logs in to accept it, post status updates, and upload completion photos and notes, the coordinator reviews and approves that proof, and only then is the job marked closed and added to a clean CSV export your billing/system of record expects.

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)
  • Your subcontractor list as a CSV/sheet (with compliance status)
  • The work orders you outsource as a CSV/sheet
  • Your status and SLA rules
  • Claude Code or any AI coding agent

The problem this kills

You outsource a job to a subcontractor and then it vanishes into a black box. Did they get the work order? Did they accept it? Are they on site today or next week? Is it done? You find out by texting them, calling them, and forwarding photos around an email thread — and you still can't say for sure whether the crew you just dispatched is even insured and current on their paperwork. When the invoice comes in, you're reconstructing what happened from memory and a phone's camera roll.

Outsourced work lives in group texts and gut feel. There's no single place that shows every open sub job, who it's assigned to, what state it's in, and the proof that it actually got done the way you need it. So jobs slip, the same work order accidentally goes to two subs, a sub who let their insurance lapse gets dispatched anyway, and you bill (or get billed) for work nobody can show was completed. You don't need a giant field-service platform to fix this, and you don't need to be a developer.

What you'll build

A simple internal portal with two sides. On the coordinator side, you see every work order you want to outsource, pick a subcontractor — and the tool only lets you pick compliant ones (insurance current, onboarding complete) — and the assignment waits at a hard approval gate before anything is dispatched. On the subcontractor side, the assigned sub logs in, accepts the work order, posts status updates as they go (en route, on site, in progress, completed), and uploads completion photos and notes as proof. When the sub marks it done, it doesn't just close — it comes back to the coordinator, who reviews the proof and approves the completion. Only then does the job flip to closed and land in a clean CSV export in the exact columns your billing or system of record expects. No more black box: one screen shows every outsourced job and exactly what state it's in.

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 — how you outsource work today, what your subcontractor records and compliance rules look like, the real fields and naming on your work orders, your status stages and SLA clocks, what "proof of completion" must include, and the messy edge cases (a sub declines, the scope changes mid-job, two subs split one work order, a sub whose insurance just lapsed) — and then it tailors the data model, the compliance check, the status workflow, and every later step to your answers. This is not a generic template; the agent reflects a short spec back to you and waits for your thumbs-up before it builds anything. From there it walks the agent through the work-order import, the compliance-gated assignment, the dispatch-approval gate, the subcontractor portal with status + photo upload, the completion-approval gate, and the 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 integration to your existing dispatch or accounting software.

The governance it includes (this is the point)

This portal puts outside crews on the path to your money and your system of record, so it ships with the controls a real operation needs: login so only your team and your subcontractors can use it, row-level security so each subcontractor only ever sees their own assigned jobs and you only see your own company's, a complete audit trail of who assigned, approved, accepted, updated, and closed each work order and when, a hard human-approval gate twice over (a coordinator approves the assignment before dispatch, and approves the completion proof before the job closes or bills), a compliance guard so only insured, fully-onboarded subs can be dispatched, and duplicate guards keyed on work order + subcontractor so the same job can't be dispatched twice.

Who it's for

Dispatchers, project coordinators, and service managers who outsource field work — at HVAC, plumbing, electrical, construction, restoration, landscaping, facilities, and property-management operations — anyone who hands jobs to outside crews and is tired of chasing status by text and reconstructing proof at invoice time. If you can describe how you decide which sub gets a job and what "done" looks like, you can build this.

You've got this — start with the plan, paste the first prompt, answer the interview, and you'll watch your first work order go out, get accepted, and come back with proof the same weekend.

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.