Ubiquitous Language

Browse and discover ubiquitous language terms in the Construction Management domain

Construction Management Domain Language(16 terms)

Site Image

One site-visit photo for a field report. Aggregate root. Create-only; no lifecycle. One record per photo. Backed by site_images.

View details

Site Image Id

UUIDv7 identity stored as site_images.domain_id (ADR-0048).

View details

Project Id

Reference to a construction project by projects.domain_id. Not a Project aggregate in this domain. The API never accepts rec… as projectId.

View details

Report Date

Calendar date of the site visit as YYYY-MM-DD. Value object on Site Image.

View details

Site Image Attachment

Exactly one http(s) image URL plus optional filename. Value object on Site Image. Not a bulk batch.

View details

Bulk Site-Image Upload

One AT-E1 request that splits into N SiteImage creates. Application use case QueueBulkUploadSiteImagesUseCase. Not a SiteImageBatch aggregate.

View details

Request Record Id

Airtable ui_site_images_bulk_upload row id. HTTP/adapter-only. Must not appear on Site Image. Required on POST so polling can find the ui row.

View details

Bulk Upload Operation

Pollable status of a bulk upload. Stored on the ui row (operation_id, status, status_message). There is no separate operations table. Statuses are queued, running, success, error.

View details

Site Image Recorded

Domain event recorded when SiteImage.create succeeds. Dispatched in-process to DomainEventAuditLogger after persist. No outbox.

View details

Product Order

One submission of selected BOM lines for one project, billed as one invoice. Aggregate root (product_order). Created by Create Order; invoice lifecycle draft → issued → paid, or cancelled. Not a purchase order to a vendor, not the Part 05 invoice aggregate, not the archived cart (ADR-0133).

View details

Product Order Item

One selected BOM line on a Product Order, with the product facts copied from the variant's owner for the invoice. Entity inside ProductOrder (product_order_items). Not a BOM line and not a printed invoice-document line.

View details

Invoice (printed)

The rendered invoice PDF attached to a Product Order (InvoiceDocument). A draft prints a DRAFT preview with unknown figures as To be determined, re-rendered on each print; after issue the first print attaches the final invoice once and later prints only re-sign it. Rendered by document-generation; stored in a private bucket. Printing never issues.

View details

Issue

The command that locks a draft Product Order when its invoice is sent: checks billing, draws the invoice number <project_number>-<NNN>, and freezes tax rate, shipping, bill-to and totals. Withdraws the DRAFT preview. Not printing, and not a field-report issue (issueNumber on Site Image).

View details

Invoice Status

Where a Product Order's invoice is in its lifecycle: draft, issued, paid, cancelled (discarded is transient, never stored). Set shipping, Update and Delete change a draft only.

View details

Source Status

How a Product Order Item's BOM line has drifted since it was copied: current, outdated (counts differ; Update copies the new count) or orphaned (no live count; Update removes the item). Observed by Refresh status, never set by a person.

View details

Invoice Number

<project_number>-<NNN> on an issued order, NNN = 1 + the project's highest issued sequence, drawn only after the issue checks pass. Not the order name (ORD-…), which exists from creation.

View details