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 / record | HQ room / record | What changes (object · fields) | Approval gate | Unknowns |
|---|---|---|---|---|---|
| 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 items | Production room ("Garage"): Orders, material status | New 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 fills | Bot drafts only. Approve before Send to the vendor | Which 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 → JobTread | Outbox item · operation, intentKey (dedupe), status | This is the gate. Approver must be the asker or someone with authority | Who besides Kim can approve; dollar limits |
| 3. Receipt | Document events / status read-back | Outbox result + Gateway auditId | Who asked, bot, time, system, object id, before → after | after the write is read back | No 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 notes | Approve before "create in HQ". Nothing goes to the customer | Is 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 parameters | Approve 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 template | Budget 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 document | Freddy drafts → independent QA (Estimate Review) → HQ approval/outbox → Gateway. A second approval before it goes to the customer | Which catalog subset counts as approved standard |
| 7. Signature | Document requireSignature, signatureDisclaimer → signedAt, signedByUser (customer/vendor portal eSign). Templates with signature on: Estimate, Selections, Change Order, Labor Order, Home Construction Estimate | Sales ("Attic") / PMs ("Job room") | Document status → approved when signed | Approve before sending for signature. Bots never sign | n/a |
| 8. QuickBooks sync | Settings › Integrations › QuickBooks Online: pushes finalized invoices and bills; Document qboId, qboDocumentType, qboAccountId, qboClassId | Bookkeeping ("Tower base") | Invoice/Bill gets a qboId once synced | Bookkeeping approves finalizing; bots don't finalize invoices or bills | Read-only check: 0 documents carry a qboId, so the sync looks off or unused. Confirm with Bookkeeping |
| 9. Docs + forms | Document 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 SOPs | Document or FormSubmission on a job/customer | Approve before anything goes outside | 0 forms exist in JobTread today, so the form builder isn't in use yet |