Skip to content

Domain model and vocabulary

Toolora separates customer identity, commercial agreements, project execution and financial records. A project connects these records throughout the customer relationship. Each record retains its own lifecycle and authority. A tenant is the company context used to scope operational records and permissions. The domain vocabulary in CONTEXT.md defines the terms used here; business workflows describe how records change together.

The customer and contact concept explains company relationships, shared identities and recipient selection. A customer is a household or organization. Contact people, quote recipients, invoice recipients and deduction recipients describe separate relationships. One person can hold several roles. A saved contact relationship does not itself grant customer portal access, and changing current contact information does not rewrite a sent document.

The project and work-order concept maps ownership, source allocation and lifecycle boundaries. A project represents the customer outcome and can exist before an accepted quote. A work order specifies a concrete assignment within that project. Project membership, work-order assignment and a calendar booking describe different responsibilities. Execution and review connect these records without treating a booking as evidence of completed work.

The commercial authority concept distinguishes offered versions, native/manual/historical acceptance, contracts and invoice basis. A source offer identifies the external record associated with a project. An accepted billing quote identifies the agreement that authorizes its billing basis. These relationships are distinct. An imported source-offer link can preserve provenance while acceptance remains unproven. Billing basis must retain the evidence required by its own contract.

The publication concept maps editorial revisions, planning snapshots and current audience projections. Project presentations, daily logs, files and conversations have defined audiences. Publishing a presentation makes one version visible to that audience. It does not change the accepted agreement, approve work or create financial authority. Conversation audiences and portal access determine which published information a caller can read.