Skip to content

Domain Glossary

Ankit Upadhyay edited this page Jul 24, 2026 · 2 revisions

Domain Glossary

The vocabulary used across the codebase and this wiki — veterinary domain terms, platform concepts, and the acronyms that show up in models and APIs.

Platform & architecture

Term Meaning
PIMS / PMS Practice (Information) Management System — the clinic-facing product that runs a veterinary practice. Used interchangeably here.
Organization / Org A veterinary practice; the tenant boundary. Almost every record is scoped by organisationId. See Multi-Tenancy and RBAC.
Tenant An isolated data boundary. Core product uses row-level org scoping; the developer platform uses schema-per-tenant.
Companion A patient — the animal receiving care (dog, cat, horse, or other with a free-text species label).
Parent The pet owner responsible for a companion. Co-parent — an additional owner sharing access to a companion.
FHIR R4 Fast Healthcare Interoperability Resources, release 4 — the health-data standard core clinical entities map to. See FHIR and Interoperability.
HL7 v2.5 Health-data messaging standard (ADT / ORU / ORM messages) exportable from the system.
RBAC Role-Based Access Control — the seven-role permission model. See Multi-Tenancy and RBAC.
Event bus Redis Pub/Sub channel (org:{orgId}:events) that fans mutations out to browsers (Socket.IO) and mobile (FCM). See Realtime and Notifications.

Clinical workflow

Term Meaning
SOAP Subjective, Objective, Assessment, Plan — the structured clinical note for an appointment, organized by body system (not free text).
Vitals Recorded clinical measurements (weight, temperature, HR, RR, SpO2, pain score) with species-specific reference ranges and grimace scales.
Grimace scale Species-specific pain assessment — CGS (canine), FGS (feline), EGS (equine) — scored per facial action unit.
BCS Body Condition Score (1-9 scale). MCS — Muscle Condition Score.
Treatment plan The set of services, in-clinic medications, and procedures planned for an appointment, with a client estimate.
Prescription A clinical medication document (take-home), distinct from in-clinic administration; deducts inventory on dispense.
Controlled substance log DEA-style append-only log of scheduled-drug transactions (received / dispensed / wasted), for regulatory export.
Triage Prioritization of an arriving patient (P1 emergency → P5 non-urgent).
In-patient / Admitted A companion staying in the clinic (ward/bed, daily rounds) vs an outpatient visit.
Discharge The end-of-care handoff (instructions, medications, follow-up) for an admitted patient.
Observation Tool (OT) A configurable recording task (e.g. per-shift vitals monitoring), also billable as a nursing service.

Domain & coding standards

Term Meaning
AAHA American Animal Hospital Association — its Chart of Accounts codes classify services.
SNOMED / ICD-11 Standard clinical terminology / diagnosis codes referenced in assessments.
RxNorm / NDC / ATC Standard drug identifiers used in prescriptions.
AEMPS / RCVS / DEA Regulatory bodies whose audit-export formats the system supports per country.
Species: other Any non dog/cat/horse companion; uses a free-text speciesLabel and generic vital ranges.

Integrations & providers

Term Meaning
Stripe Connect The payment rail; each clinic is the merchant of record on its own Standard Connect account. See Payments Architecture.
CareCredit / Scratchpay Point-of-care financing partners (not card processors).
IDEXX / Antech Lab providers behind the LabOrderAdapter interface.
Merck (Veterinary Manual) Clinical reference content integrated into the mobile app.
SuperTokens Self-hosted auth provider that replaced Cognito + Firebase across web, mobile, and backend (ADR-0003; landed via PR #1763, merged 2026-07-16). A legacy-token grace verifier (AUTH_LEGACY_TOKEN_GRACE) remains during the cutover window.
BullMQ Redis-backed job queue for async work (lab syncs, reminders, notifications).

Related

Product & Domain
Architecture
Applications
Design & Accessibility
Engineering Handbook
Decisions (ADRs)
Design Docs & Plans
Roadmap
Operations
Meta

Canonical code & docs: main repo · Auto-generated companion: DeepWiki

Clone this wiki locally