prototype · ZZ TEST data · nothing is sent

Work office → JobTread / HQ map (one page) · v0 · 2026-11-20

Read-only research. JobTread: Pave API reads only (schema, template list, cost codes, custom-field names, aggregate counts) + JobTread help articles. HQ: the live site needs a login (401), so this uses the HQ source code on the box (pinnacle-hq--hq-fault-fixes, commit 6af6f54, 2026-11-12). No customer data copied. Gate = where the one-tap Approve sits. Nothing in the prototype calls any of this.

Office action (desk bot)JobTread screen / recordHQ room / recordWhat changes (object · fields)Approval gateUnknowns
1. Material + labor orders off Brett's estimate (Kim → Vendor Desk + Production Coordinator)Job › Budget tab › + Document › Vendor Order templates "Purchase Order" (materials) and "Labor Order" (labor, signature required). Source = the job's approved Estimate (Document customerOrder) and its budget cost itemsProduction room ("Garage"): Orders, material statusNew Document type=vendorOrder · job, account (vendor), costItems (qty/unit, cost code 0901 Roofing Materials / 0902 Roofing Labor / 0650 Gutters), status draft→pending, requireSignature. Budget Committed Cost column fillsBot drafts only. Approve before Send to the vendorWhich estimate counts as "Brett's" (approved vs latest); vendor-pick rules; split of material vs labor lines
2. One-tap Approve(write lands on the Document above)HQ outbox (/api/outbox: pending → claim → result) → Pinnacle Gateway → JobTreadOutbox item · operation, intentKey (dedupe), statusThis is the gate. Approver must be the asker or someone with authorityWho besides Kim can approve; dollar limits
3. ReceiptDocument events / status read-backOutbox result + Gateway auditIdWho asked, bot, time, system, object id, before → afterafter the write is read backNo receipt screen in HQ today (outbox results exist). Planned, not built
4. New-lead intake (type or speak)Customer Account + Contact (Email, Mobile) + Location (address, Entry Code, Property Access Instructions) + Job (custom fields Lead Path, Work Type, Trade Type, Pinnacle Pipeline; customer Lead Source)Leads room ("Front door"): New lead panel, Who / What / Where, "How would you like to get started?" (lead path)Lead + job created at stage New · scope lines + options as notesApprove before "create in HQ". Nothing goes to the customerIs the lead created in HQ first, then synced to JobTread? Duplicate-match rules
5. Measurement order (Hover / EagleView)Job Dashboard › Manage Hover Job (create job, can send a capture request text/email to the customer) · Manage EagleView Reports › Order New Report (charged to the card on file)HQ has its own Hover connection (/api/hover)Report PDF + photos → job Files; measurements → budget parametersApprove before Place Order / capture request (costs money, contacts the customer)Whether Pinnacle's JobTread has Hover/EagleView connected (the API only shows permissions); Megan's ordering rules
6. Estimate from templateBudget from catalog (~29.8k catalog cost items; cost codes and types Labor/Materials) + Document template "Estimate" (customerOrder)Freddy's Room ("Lookout")Budget cost items + Estimate documentFreddy drafts → independent QA (Estimate Review) → HQ approval/outbox → Gateway. A second approval before it goes to the customerWhich catalog subset counts as approved standard
7. SignatureDocument requireSignature, signatureDisclaimer → signedAt, signedByUser (customer/vendor portal eSign). Templates with signature on: Estimate, Selections, Change Order, Labor Order, Home Construction EstimateSales ("Attic") / PMs ("Job room")Document status → approved when signedApprove before sending for signature. Bots never signn/a
8. QuickBooks syncSettings › Integrations › QuickBooks Online: pushes finalized invoices and bills; Document qboId, qboDocumentType, qboAccountId, qboClassIdBookkeeping ("Tower base")Invoice/Bill gets a qboId once syncedBookkeeping approves finalizing; bots don't finalize invoices or billsRead-only check: 0 documents carry a qboId, so the sync looks off or unused. Confirm with Bookkeeping
9. Docs + formsDocument templates: Bid Request, Estimate, Selections, Change Order, Deposit, Invoice, Progress Invoice, Purchase Order, Bill, Labor Order, Home Construction Estimate · Forms (form builder: name, fields, targetType, submissions)Library ("Study") for SOPsDocument or FormSubmission on a job/customerApprove before anything goes outside0 forms exist in JobTread today, so the form builder isn't in use yet
Rule under all rows: bots draft, a person taps Approve, the write goes HQ outbox → Pinnacle Gateway → JobTread with a dedupe key, then the result is read back into a receipt. JobTread stays the system of record.

← back to the three looks