Job Detail
Purpose
The job detail view mirrors everything the operations team needs for a single job: who the customer is, what the crew is doing, how far the work has progressed, and whether finance can invoice. It matches /app/jobs/{id} in ESS Admin so the office, field leads, and the assistant follow the same steps.
Header snapshot
- Status badge: Shows
Created,In progress, orFinalized. APending revisionbadge appears if a change order is still in draft or awaiting approval. - Primary info: Job title, job number, assigned team (or "Unassigned"), and created/updated timestamps.
- Quick buttons:
- Edit job – adjust title, description, planned window, team, or site address while the job is not finalized.
- Open schedule – jump to the schedule board filtered to this job.
- View quote – review or action revisions/variations on the source quote.
- Final invoice draft buttons – appear when a draft exists or when the system can create one immediately after finalisation.
- Status changes (Created/In Progress/Finalized) still happen from the Jobs list action menu.
Tabs overview
Overview
- Client card: Company, contact, email, phone, site address, and whether the job is finalized.
- Schedule card: Planned window plus up to five upcoming/most recent entries, each with team, status badge (
Tentative,Confirmed,Completed,Cancelled), and start/end times. A link opens the full schedule board. - Finalisation notes: Displays the wrap-up notes captured when the job was finalized.
- Revisions & variations: Table of quote revisions (number, status, created date, notes) and a variations panel that points you back to the quote when a variation is active.
- Job timeline: Chronological feed of major events (status changes, schedule updates, attachments, claim actions, etc.).
Financials
- Contract, claimed, outstanding, and paid totals shown as cards.
- “Progress vs contract” bar visualises how much has been claimed.
- Progress claim form preview toggles between “To date” and “Next claim” so finance can see what will go on the next progress invoice.
- Invoice timeline lists invoices, credit notes, or adjustments tied to the job.
Labour Hours
- Compares actual hours and labour cost (from timesheets) against the quote allowance.
- Shows technician count, admin adjustments, and number of pay periods involved.
- Charts break down hours by technician; the table links to the weekly review screen or time insights if you need deeper analysis.
Post-completion
- Highlights callback visits logged after the job was marked complete: total hours, labour cost, visit count, and the most recent attendance.
- Breaks down visit reasons so you can spot recurring issues, plus an hour/cost summary for each reason.
- Includes a detailed visit log listing date, technician, hours, labour cost, captured reason, and when the visit was linked back to the job.
Progress
- Interactive allocations table (the same experience covered in Job progress & claims).
- Toggle to adjust all allocations together, sliders for line-by-line updates, Retainage inputs where applicable, and Save/Reset buttons.
- “Invoiced to date” vs “Next claim target” summaries help you see what will flow into the next progress claim.
Activity
- Timestamped log of everything that’s happened: status changes, schedule entries, instructions updates, attachment uploads, invoice hand-offs, etc. Use it to answer “who changed what and when.”
Attachments
- Upload multiple files at once, download with expiring links, or delete if something was added by mistake. The table shows name, file type, size, uploader, and upload time.
Crew brief
- Edit the crew summary and additional notes (2000 character limits with live counters).
- Displays the source (“Quote” or “Manual”) and when instructions were last generated.
- Work items table mirrors the scope lines the crew will see in the field.
Finalising & reopening
- Finalize jobs from the Jobs list. The system blocks finalisation until all schedule entries are
CompletedorCancelled. - Finalized jobs lock edits on the job detail page (schedule, instructions, progress, attachments). To reopen, switch status back to
In Progressfrom the Jobs list.
Troubleshooting
- Schedule looks empty: Check the date range on the schedule card or open the full board; the job detail only shows the five most relevant entries.
- Crew brief won’t save: Ensure the job isn’t finalized. The Save button also requires at least one character in the summary.
- Progress tab says “No allocations”: The quote did not send granular allocations. Raise a variation or adjust the quote if you need more detail.
- Finance tab missing data: Progress claims only populate once you’ve saved progress and generated invoices. Use the Progress tab first, then build the invoice.
- Need older history: Scroll the Job timeline or Activity tab—the audit trail keeps earlier events even after finalisation.