DocsForeman quickstart

Foreman quickstart

Run the kiosk, approve tier-1, post the daily log.

Foreman is the tier-1 approver. You see your crew live, approve their entries, post one daily log per shift, and resolve disputes before they reach the PM.

25 minute read -- 20 minute kiosk setup

1. A typical foreman shift

Eight steps from gate to gate. Read top-to-bottom the first day; refer back to specific sections later.

6:00 AM

Arrive at site -- 6:00 AM

You are 30 minutes ahead of the crew. The kiosk is a ruggedized tablet at the gate or in the field office. Wake it up, sign in with your phone.

  • Tap the kiosk. It auto-shows the Sign In QR. Open the ConstructOps app on your phone and scan it.
  • Kiosk asks: "Today, are you running the gate or the field office?" Pick gate for batch clock-in, office for indoor crew rotation.
  • The kiosk now displays your roster -- everyone scheduled for today, color-coded by classification.

6:10 AM

Set up the kiosk -- 6:10 AM

One-time setup per day. Make sure the kiosk has signal, the speaker volume is up, and the NFC reader is enabled if you use NFC tags.

  • Top-right corner: tap the gear -> verify the project is correct (the one you are running today, not yesterday).
  • Tap "Open gate" -- the kiosk now accepts NFC taps, voice clock-in, or manual select. Workers walking up will see the green status light.
  • Plug the kiosk in. Cold mornings drain batteries fast; the kiosk should run on AC all day.

6:30 AM

Batch crew clock-in -- 6:30 AM

Your crew arrives. Three ways they clock in -- choose what fits your gate. All three end with the same record.

  • Voice: worker walks up, says "Hey Connixt, clock me in." Kiosk hears it, voice-prints the worker, marks them on roster.
  • NFC: worker taps phone or wristband against the kiosk. Sub-second clock-in.
  • Manual: tap worker name on the kiosk, then "Clock in." Fallback for workers without phones.
  • If you have a 50-person crew, the kiosk handles 40 to 60 clock-ins in 15 minutes without slowing down.

9:00 AM

Mid-morning -- crew status check -- 9:00 AM

Switch from kiosk view to your phone. The Crew screen shows everyone live -- who is on task, on break, off-site, or flagged.

  • Red dot = an issue (geofence anomaly, missed break, exceeded OT threshold, unverified classification).
  • Yellow dot = soft warning you should look at within the hour.
  • Green = healthy.
  • Tap any worker to see their day-so-far: cost codes, hours, photos, notes.

12:00 PM

Approve tier-1 timesheets -- 12:00 PM

During lunch you approve entries from the morning. Approval is bulk -- pick rows, sign, done. Disputes go to a separate queue.

  • Open Tier 1 Approval. You see all morning entries from your crew.
  • Anything with an anomaly (e.g., 5+ hours straight without a break, cost code mismatch) is flagged with a yellow border.
  • Bulk select clean rows -> Approve. Voice or thumbprint signature applied.
  • Flagged rows -> tap each, review GPS trail and photos, then Approve or Dispute. Disputes go to the Dispute Resolution queue (section 6).

2:30 PM

Daily log -- 2:30 PM

One daily log per shift. The app pre-fills most of it from worker entries; you add narrative and confirm.

  • Tap Daily Log. Weather pulls from the GPS coordinates automatically.
  • Workforce count, hours, cost codes -- pre-filled from approved tier-1 entries.
  • Work performed -- dictate a paragraph by voice: "Hey Connixt, daily log: completed grade beam pour west elevation, started rebar tie east face."
  • Equipment used -- voice or check from list.
  • Materials delivered, visitors, safety incidents -- all voice-friendly fields.
  • Hit Submit. The PM gets a push. The log is preserved in the Confidential Ledger for 7+ years.

3:45 PM

End-of-shift wrap-up -- 3:45 PM

The crew is clocking out. Your last task is to make sure nothing is unfinished before you leave.

  • Open Crew screen. Confirm every worker shows status Clocked Out or Off Site.
  • Any worker still showing Clocked In after 4:30 PM -- check on them or remote-clock-out from kiosk.
  • Confirm the daily log is Submitted (not Draft). Drafts at end of day push to PM as alerts.
  • Close the kiosk. Plug it in for charging overnight.

4:00 PM

Off the clock -- 4:00 PM

You can clock yourself out via voice or kiosk. Your phone still gets push notifications -- if a worker disputes something overnight, you respond in the morning.

  • You are not on call for tier-1 issues outside your shift -- the PM handles after-hours dispute escalation.
  • Tomorrow morning, your crew screen will show all overnight messages, any escalations from the PM, and the day-ahead roster.

2. Crew management screen walkthrough

The Crew screen is your live picture of everyone on your watch. Columns and actions are below.

ColumnExplainer
Photo + nameWorker headshot from their profile. Tap to drill into their day so far.
StatusClocked In / On Break / On Lunch / Off Site / Clocked Out. Updates in real time.
Cost codeCurrent cost code they are charged to. Shows red if not in the approved list for this project.
Hours todayRunning total. Turns yellow at 8 hours, orange at 10, red at 12 (OT thresholds).
GPS statusGreen = inside project geofence. Yellow = outside but within 100m buffer. Red = clear-outside (review).
Photos / notesNumber of photos and voice notes they have logged today. Tap to view.
FlagsAnomaly count. Click to see what is flagged: missed break, classification mismatch, OT alert.

Actions

  • Tap a worker -> open their full day timeline with timestamps + cost codes.
  • Long-press a worker -> "Send a message" or "Remote clock-out" or "Dispute this entry".
  • Pinch to zoom on the crew map view -- see workers placed on the site plan in real time.
  • Filter bar at top: by classification, by trade, by cost code, by status.

3. NFC tag tap workflow

NFC tags are the fastest clock-in method. Workers tap their phone (or wristband) against a tag at the gate; the kiosk picks it up sub-second.

  1. Stick the NFC tag on the kiosk casing at chest height, or mount it on a pole/wall at the gate.
  2. Workers add the tag to their phone wallet once -- the app walks them through it on the install screen.
  3. At the gate, they tap the back of their phone against the tag. The kiosk reads the worker ID, voice-prints them via the microphone (3-second sample), and clocks them in.
  4. For wristbands (common in unionized crews): same flow, the wristband stores the worker ID. No phone needed.
  5. If a tag malfunctions, the kiosk shows "NFC offline -- voice or manual clock-in only" and proceeds without it.
NFC is overkill for crews under 10. For small crews, voice or manual select is faster to set up and less to maintain. Use NFC when your crew is 25+ or you have heavy gate traffic.

4. Broadcast vs. direct messaging

You have three message types. Pick the right one or you train your crew to ignore everything.

ScenarioChannelWhy
Crew-wide alert (safety stand-down, weather delay)BroadcastGoes to every worker on your crew with a sound + push. Use sparingly -- once a day max, or it gets ignored.
Question to one worker (cost code clarification, missing badge)Direct messageOne-to-one chat thread. Worker can reply by voice. Stays in their history for context.
Conversation about a specific RFI / daily log / incidentAnchored threadThread links to the object (RFI #1234, daily log #5678). When the object closes, the thread archives with it. Auditable.
Generic chit-chat / off-topicDirect message (informally)Keep work threads clean. Off-topic in DMs only -- broadcasts and anchored threads stay focused.
Sub-crew coordination (2-5 people on the same task)Sub-channelCreate a sub-channel scoped to a cost code or task. Lives for the duration of the task. Auto-archives when the task closes.

5. Dispute resolution flow

When you flag an entry as Dispute (instead of Approve), it goes into the Dispute Resolution queue. The worker sees a notification and can respond. Most disputes resolve in under 24 hours.

  1. Open Dispute Resolution from your home screen (orange badge if any are open).
  2. Each dispute shows the entry, your reason for disputing, GPS/photo evidence on file, and the worker reply if any.
  3. Common dispute types: wrong cost code, hours overstated, classification claim mismatch, geofence anomaly.
  4. Worker can reply by voice or text. They can also attach a photo or voice memo as evidence.
  5. You either: (a) Accept worker explanation -> Approve the original entry, (b) Stand by your dispute -> Escalate to PM, or (c) Mark Correction -> edit the entry to a corrected version with both signatures.
  6. Every step is logged in the Confidential Ledger. If the dispute reaches HR or labor relations, the full audit chain is available.
  7. Disputes that sit open more than 48 hours auto-escalate to PM. Do not let them pile up.