Treatment workspace

Consultation, contraindications, plan, order, consent, session, administration and signed notes.

Open /platform/appointments/[id]/treatment. Requires canManageClinical.

Consultation

recordConsultation: candidacy candidate, deferred, declined or referred.

Contraindications

recordContraindicationFinding, then decideContraindication for the clinician's disposition.

Plan

approveTreatmentPlan creates the TreatmentPlan and items. States: draft, active, paused, completed, cancelled.

Order

issueClinicalOrder authorizes a performer. transitionClinicalOrder moves it through active, partially_fulfilled, fulfilled, held, revoked, expired or entered_in_error.

signTreatmentConsent against a published template; withdrawTreatmentConsent withdraws.

Session

prepareTreatmentSession then startTreatmentSession: planned, ready, in_progress.

Administration

recordTreatmentAdministration records what was given and, for lot-traced products, the AdministrationLot and StockMovement.

Note

appendSignedClinicalNote adds an append-only, supersedable ClientNote.

Readiness gate

Before a session runs, clinicalExecutionReadiness checks that: the exact approved plan, item and consultation still authorize the encounter; a current order and matching consent exist; current reviewed intake covers every required template version; no contraindication review blocks; the session is inside the appointment window; and no required resource has a maintenance or unavailable block. The check confirms records exist and match. Clinical appropriateness remains the clinician's judgment.

Intake evidence must be newer than MEDSPA_INTAKE_MAX_AGE_DAYS. If a template changes after an order, treatment is refused with Required intake template changed after the clinical order was issued.

On this page