Skip to main content

Appendix — Glossary

In one line: the alphabetical term list. The fuller definitions with file:line live on Core concepts & glossary; this is the quick lookup.

TermOne-line meaning
Admin / ApproverA property manager or finance signer; recognised by matching APPROVER_EMAIL. Gets terse data answers; can approve, query, relay — not reassign/close.
AgentMailSeparate email API/transport; every send is force-overridden to a test address. Distinct from the production Lua send-message lane.
Alex CarterThe agent's persona — one "Property Maintenance Coordinator" identity for all audiences.
Business Central (BC)Microsoft Dynamics 365 ERP; HIGHFIELD's system of record.
Brief (daily / weekly)Automated summary emails to managers (09:00 daily; Fri 17:00 weekly).
Dual-writeTicket data written as a JSON attachment (source of truth) AND mirrored to custom BC tables (fire-and-forget).
EscalationA flag emailed to admins when the agent can't resolve something (silent vendor, dispute, SLA breach).
Lock-inThe moment both gates clear and the visit is settled; the agent never re-asks the time.
Money-blindnessTenants never see cost/price/approval — the finance gate is invisible to them.
PO (Purchase Order)BC document authorising vendor payment; invoice auto-post behind a kill-switch.
QuoteVendor's cost + scope (submit_quote); visit options come via offer_visit_slots.
Slot schedulingVendor offers ≥2 visit options; tenant picks from a numbered menu.
TenantA resident; every report becomes a ticket (no deflection).
TicketOne maintenance request, id MT-YYYY-NNN; one email = at most one ticket.
Ticket lifecycle / statusThe 13 states from reported to closed (plus on_hold/disputed/rejected/cancelled).
Two-gate (cost + time) flowCost approval (internal) + tenant time confirmation must both clear before work proceeds.
Urgency anti-liability ruleUrgency is internal-only; never surfaced in tenant/vendor copy.
Vendor / ContractorAn approved trade who claims, quotes, schedules, and completes jobs.