§1
Term Register
mandatory
1 decision1 evidence rule
validators: definition_free_of_headword · every_term_has_steward · forbidden_variants_redirect_to_preferred
One card per term: steward, status, a genus-differentia definition (the
nearest broader concept, then what distinguishes this one), a worked example, and the
variants: permitted synonyms, and forbidden words that redirect to the preferred term.
"Don't say X" always comes with "say Y".
TERM-001Assignment
approved
steward: A. Reyessince Jul 2, 2026
Definition A dispatch record that binds one technician to one
job, from acceptance or override until completion.
Example "Dana's override created an assignment of
JOB-2214 to Marcus."
Variants Synonyms: none. Forbidden: booking →
Assignment (a customer-scheduling word; wrong domain).
TERM-004Override
approved
steward: A. Reyes
Definition A dispatcher action that replaces the suggested
technician with the dispatcher's own choice, recorded with a reason code.
Variants Forbidden:
manual assignment → Override:
every assignment is manual under the propose-only posture
(
ADR-3[2]); the phrase misleads.
TERM-002Suggestion
approved
steward: A. Reyes
Definition A ranked technician candidate the board proposes
for a job, carrying the reasons it qualifies; a suggestion becomes an assignment only
through acceptance.
Variants Forbidden: auto-assignment → Suggestion:
nothing assigns automatically under the propose-only posture.
TERM-005Reason code
approved
steward: A. Reyes
Abbreviation, governed "RC" is permitted in identifiers only
(RC-03), never in prose; the same treatment as any variant.
TERM-007Idle time
approved
steward: P. Novak
Definition Paid technician time between a shift's start and
end not attached to any assignment, measured from assignment events per the agreed
methodology (
BRD success criteria[3]).
Example A technician on an 8-hour shift with 6.5 hours of
assignment coverage carries 1.5 hours of idle time that day; the KPI aggregates this
across the four-week trailing window.
TERM-009Job
approved
steward: M. Chen
Definition A customer service request with a required skill and
a priority, dispatched to exactly one technician at a time.
Deprecation Dispatch ticket (the legacy scheduler's
word) is deprecated with a replacement link to this term, retired at cutover with the
scheduler (
decision[4]).
TERM-011Proximity band
approved
steward: A. Reyes
Definition One of four ranges of estimated travel time
(under 10 minutes; 10 to 20; 20 to 40; over 40) used to rank nearby technicians
(
FR-011[6]).
Example A technician nine minutes out sits in the first band;
at exactly ten she moves to the second. The edges are the story set's boundary
tests.
TERM-015Shortfall
proposed · dispute open
steward: T. Fontainesee open questions
Definition The state where fewer than three technicians
qualify for a job, shown honestly with the count and the missing skill named.
Evidence: the definition bar held
No definition contains its own headword; none states a storage location ("the value in
the status column" is not a meaning); one concept per term (variants route to synonyms,
never parallel entries); the one proposed term wears its status and its dispute
visibly.
§2
Bounded Contexts & Sources
mandatory
1 decision1 evidence rule
validators: overloaded_words_disambiguated_by_context · every_term_resolves_to_kb_source_record
One word, two meanings: two governed terms, disambiguated by context,
never banned. Every term resolves to its KB source record: edits happen there and flow
here on regeneration, never the other way.
| Word | Context | Term | Meaning |
|---|
| Position | Telematics |
TERM-012 |
A timestamped vehicle location reading
(DC-1 cites this id[5]; the feed
can never be read as staffing data) |
| Staffing | TERM-013 |
An open role in a hub's roster |
Provenance: every term exports from its
KB record[1];
TERM-007 entered through the BRD workshop of July 2, 2026. The
export note renders once, up front: this document regenerates from the KB.
Refs
References & Package Contents
In this export package
package
[3] Business Requirements Document: success criteria methodology
./brd-dispatch-modernization.docx
package
[5] DC-1: telematics feed data contract (cites TERM-012)
./contracts/dc-1-telematics-feed.html
In the Specira workspace
specira
[1] KB term records: the source of truth this artifact exports
app.specira.ai/kb/terms
specira
[2] Decision: ADR-3 propose-only posture
app.specira.ai/projects/dispatch-modernization/decisions
specira
[4] Decision: pilot cutover plan (scheduler retirement)
app.specira.ai/projects/dispatch-modernization/decisions/93
specira
[6] Functional spec: FR-011 bands, ERR-06 shortfall notice
app.specira.ai/projects/dispatch-modernization/artifacts/frd-recommendation-rules
specira
[7] Data model: ReasonCode governed enumeration
app.specira.ai/projects/dispatch-modernization/artifacts/data-model#enumerations