What a trip is
A job's schedule is now a list of trips. Each trip is one visit to the site: a date (or a run of consecutive days for a long job), a start and end time, its own crew of one or more techs, and an optional label like "Install countertop". The job itself is unchanged: one job, one invoice, one set of photos and time logs. Trips are only about when and who.
The job's header date and time (what you see on job cards and lists) always shows the next upcoming trip. When nothing is scheduled ahead, it shows the most recent trip.
| Trip status | Meaning | How it gets there |
|---|---|---|
| Scheduled | On the calendar, not started | Any "add trip" or "schedule" action |
| In progress | A tech started a timer on that day | Tech taps Start Job / Resume |
| Waiting | That visit ended and the job needs another trip | Tech taps "Done for today, we're coming back", or the office clicks Mark waiting |
| Completed | That visit is finished | The job is completed, or a later trip is added |
A job with more than one trip shows a Trip 2/3 style badge on every schedule block and mobile card.
Desktop schedule: adding and moving trips
Three ways to add a return trip. All three open the same Return trip modal (the job locked in, a Trip label prefilled "Trip N", techs multi-select, date, start, end, reminder toggle).
- From a scheduled block: click any block of the job → popover → + Return Visit. The clicked tech is preselected; pick the date and time, add or change techs, click Schedule. The earlier trip stays exactly where it was.
- From the sidebar: the ↩ Return trip needed group lists in-progress jobs with nothing scheduled ahead. Drag a card onto a tech column and time (Day view) or a day (Week view) and the modal opens prefilled with that date, time and tech. Click a card to open the modal without a drop target.
- From a link:
schedule.php?add_visit_job=<job id>opens the schedule with the modal already open. The job editor's + Schedule next trip button and the pipeline's ↩ Next trip chip use this.
Moving one trip. Drag a block; only that trip moves. Dragging within the same tech column moves the whole crew to the new date and time. Dragging into another tech's column swaps only the dragged tech and keeps the rest of the crew. For a trip that spans several days, only its first day is draggable; dragging day 1 shifts every day of that trip together, and other trips of the job stay put.
Popover → Move. Opens the modal prefilled with that trip's date, start, end and tech (a multi-day trip opens the multi-day modal prefilled the same way). Saving it untouched changes nothing. Inside the Move modal, the red Unschedule button removes only that trip; the confirm reads "Remove this trip from the schedule? Other trips stay." If it was the job's only trip and nothing was ever worked, the job goes back to Unscheduled.
Popover → Reassign… / + Add tech… act on the clicked trip. Reassign moves the whole trip to the chosen tech; Add tech adds a second tech to that trip only.
Badges and colors. Blocks show 1/2, 2/2 when a job has more than one trip. A waiting trip renders yellow with a dashed border, a 🕐 icon and the reason text.
Desktop: waiting jobs and the "Return trip needed" group
Mark waiting. Click a job block → popover → Mark waiting. Pick a reason chip (Customer · Materials · Weather · Other), add a detail line if you want ("countertop on order"), optionally set Back around to a date, then click Mark waiting. The block turns yellow and dashed with the reason on it. Reopening the popover shows a banner such as "Waiting — Materials — countertop · back ~Oct 8" with a Clear link that returns the trip to normal.
Why mark waiting. It records why the crew left and roughly when to come back, and it puts the job at the front of the Return trip needed group sorted by that date. The date is a note to the office, not an automatic booking: nothing gets scheduled until someone adds the trip.
The sidebar group. Above Unscheduled, the sidebar shows ↩ Return trip needed (N). A job appears there when it is scheduled or in progress, has been worked (past trips or logged time), and has no trip dated today or later. Each card shows the customer, the title, "Last worked Sep 14 · Bill, Darren", and the waiting reason and return date when set. Adding a trip removes the card. Waiting jobs with a return date sort first; the rest sort oldest-worked first.
What the sidebar does not do. Jobs that were never scheduled stay in the plain Unscheduled list below, as before. Completed and cancelled jobs never appear.
Job editor and pipeline
Job editor → Trips card. Open any job and scroll to the Trips card (it replaced the old Visits table). One row per trip: label, date or date range, crew names, status pill (a waiting trip shows the 🕐 reason and "back ~date"), and hours logged on that trip.
| Button | Where | What it does |
|---|---|---|
| + Schedule next trip | Below the table | Opens the schedule with the Return trip modal already open for this job |
| Mark waiting… | Below the table | Inline panel: reason chips, detail, Back around date → marks the current trip waiting |
| Clear waiting | On a waiting row | Clears the waiting state |
| Remove | On future trips only | Removes that trip from the schedule; other trips stay. Past trips have no Remove |
Pipeline → ↩ Next trip chip. On the jobs board, every card whose job is In Progress shows a small ↩ Next trip chip under the title. Clicking it opens the schedule with the Return trip modal for that job. Clicking anywhere else on the card still opens the job editor.
Mobile app: scheduling trips from the phone
Job Detail → tap the status badge (the colored Scheduled / In Progress pill at the top). For a job that has any history, a sheet opens:
| Option | What it does |
|---|---|
| Add a return trip | Sheet with tech multi-select, date, start time, Duration chips (1h to 8h) and an optional label. Techs default to you if you are a tech, otherwise to the job's last crew. Tap Add trip. |
| Move next trip | The familiar reschedule sheet, prefilled with the next trip's date, time and crew. Changes only that trip. |
| Unschedule next trip | Removes the next trip. Earlier trips stay. |
| Mark waiting for return trip… | Admins and managers only. Same reason chips and return date as the desktop. |
A job that has never been scheduled still opens the plain Schedule sheet, unchanged.
Job Detail → Trips card. Under the schedule line: every trip with label, date, crew, status, and hours logged. A waiting trip shows the reason and "back ~date".
Schedule screen. Blocks are drawn per trip and sized to the trip's own hours. Each shows · Trip 2/3 when the job has several trips; a waiting trip is dashed with 🕐. Long-press and drag a block to move that one trip (the crew moves together). In the bar under the grid, gold ↩ LastName pills are jobs that need a return trip ("~10/02" shows the promised return date when set). Tap a pill for the Add-a-return-trip sheet; long-press it to open the job. In month view, the badge counts them and the expanded list has a "Return trips needed" section.
Mobile app: what the tech sees
A return trip is just the job, on its day. When a trip is added for a tech, the job appears on that tech's Dashboard for that date with that trip's time, and a small Trip 2/3 tag beside the job number. Tapping it opens the same Job Detail as any job: Start Job or Resume, directions, photos, materials.
Starting work. Start Job / Resume links the time log to that day's trip and marks the trip in progress. If a tech starts a job on a day with no trip scheduled, an "Unscheduled trip" row is recorded so the Trips card stays truthful (it does not appear on the calendar).
Ending the day with more to do. Tap Complete (or Complete the job on a multi-tech job) and choose the third option, Done for today — we're coming back. Pick a reason chip (Customer · Materials · Weather · Other), add a note if useful, and optionally tap a Back around date. This stops your timer, leaves the job In Progress, and marks the trip waiting so the office sees it in the Return trip needed group with your reason. No invoice screen opens.
The other stop buttons are unchanged. Pause ends your timer for now and does not touch the trip. I'm done (multi-tech jobs) ends only your part; the job stays open for the others. Job is Finished completes the job and every trip.
Rules worth knowing
- Past work is never erased. No scheduling action removes a trip dated before today unless you remove that specific trip on purpose.
- Older app versions are safe. A phone still on the old app's Reschedule replaces only the upcoming trips; it can no longer wipe earlier days.
- Header = next trip. Job cards and lists show the next upcoming trip's date and time. The Trips card has the full history.
- Multi-day scheduling is one trip. A three-day install scheduled through the multi-day modal is a single trip spanning three days; a return trip weeks later is a second trip. Day 2 and 3 of the long trip are locked; drag day 1 to move it.
- Different crews per trip are normal. Each trip has its own techs; the job's assigned tech follows the next trip's primary tech.
- The return date is a note. Marking a job waiting with "back around Oct 8" does not book anything. It sorts the job to the top of Return trip needed and pre-fills that date when you add the trip.
- Completing the job completes every trip. Job is Finished, Follow-Up Needed, or marking the job complete from the desktop closes all trips.
- Nobody texts the customer. Adding or moving a trip sends only the tech a push and a reminder. Customer messages for return trips are a separate idea (board #5014).
Quick reference: where to click
| I want to… | Desktop | Mobile |
|---|---|---|
| Add a return trip | Block → popover → + Return Visit; or drag/click a Return trip needed card; or job editor → + Schedule next trip; or pipeline → ↩ Next trip | Job Detail → tap status badge → Add a return trip; or Schedule → tap a gold ↩ pill |
| Move one trip | Drag its block; or popover → Move | Job Detail → badge → Move next trip; or Schedule → long-press-drag the block |
| Remove one trip | Popover → Move → Unschedule; or job editor → Remove on a future trip | Job Detail → badge → Unschedule next trip |
| Change who goes on a trip | Popover → Reassign… (whole trip) or + Add tech…; or drag the block into another tech's column (swaps that tech only) | Move next trip and change the tech chips |
| Say "we'll be back" with a reason | Popover → Mark waiting; or job editor → Mark waiting… | Tech: Complete → Done for today — we're coming back. Admin: badge → Mark waiting for return trip… |
| Clear a waiting flag | Popover banner → Clear; or job editor → Clear waiting | Add the next trip (clears it automatically) |
| See every trip on a job | Job editor → Trips card | Job Detail → Trips card |
| See jobs that need a return trip | Schedule sidebar → ↩ Return trip needed | Schedule → gold ↩ pills (month view: "Return trips needed" list) |
| Tell which visit a block is | 1/2, 2/2 badge on the block | · Trip 2/2 on the block; Trip 2/2 tag on the Dashboard card |