System Overview

A practical map of Tempr's business objects, ownership model, and state-driven behavior.

Tempr is easiest to understand when you treat it as a record lifecycle system rather than a collection of unrelated screens.

The Big Picture

At a high level, Tempr moves work through four layers:

  1. Demand enters as a lead.
  2. A lead becomes a customer and usually a project.
  3. A project turns into signed, paid, scheduled work.
  4. Scheduled work becomes a completed work order and a closed project.

The Record Hierarchy

LevelDescriptionCommon owner
LeadPre-sale opportunity waiting for action.Consultant or sales queue
CustomerLong-lived account and contact record.Consultant or account owner
ProjectA specific sale, job, or engagement for that customer.Sales plus operations
MeasurementA quoted or installed product/service line.Project team
Work OrderFulfillment package for execution in the field.Operations or install team
PaymentMoney collected for a project.Sales, finance, or customer portal

Important State Models

Tempr uses explicit states in several parts of the system. Those states determine what users can do next.

Lead states

  • Received
  • Assigned
  • FollowUp
  • Qualified
  • Unqualified

Project states

  • Lead
  • Presented
  • AwaitingDeposit
  • PendingPO
  • InManufacturing
  • PendingScheduling
  • PendingInstall
  • PendingFinalPayment
  • Completed
  • Closed
  • hold or cancellation states such as AdminHold, CriticalHold, Canceled, and Lost

Project sale states

  • Unsold
  • Sold

Measurement approval states

  • Unreviewed
  • Accepted
  • Rejected

Work order states

  • Draft
  • ReadyToSchedule
  • Published
  • Completed

Payment states

  • Pending
  • SentToGateway
  • RequiresAction
  • Completed
  • Failed
  • Refunded
  • Voided

Ownership And Assignment

Most new-user confusion comes from ownership rules:

  • consultant_id is used widely to tie leads, customers, and projects to a specific internal owner.
  • tasks may be scoped to mine or all depending on permissions.
  • telephony extension assignment determines how inbound and outbound call context is mapped to Tempr users.
  • customer-facing activity may continue even when a consultant is later released or deleted, so some records can be intentionally unassigned.

Internal Surfaces Versus External Surfaces

SurfaceAudience
Main app pagesInternal employees doing daily work
Filament panelsInternal specialists and administrators
Customer portalExternal customers reviewing, signing, and paying
Public webhooks and callback routesExternal systems and integrations
API docsMobile clients, field tools, and machine-to-machine integrations

How To Think About Changes

When you update a record, ask:

  1. What state is it in right now?
  2. Who owns it?
  3. Which downstream area depends on this value?
  4. Should this action happen in the main app, a specialist panel, the customer portal, or through an integration?

Avoid making process assumptions from labels alone. In Tempr, the current state and panel context matter more than the route name.