Tiet · Consult
No owner-confirmed release status is recorded in the retained evidence. Check that Consult and its close service are enabled on your deployment. A draft design header alone does not establish release availability; see Capability status. The retained design documents behind Consult are drafts (docs/architecture/consult-clinical-workspace-design.md, status "Draft for design review"; consult-encounter-workflow-proposal.md, "Approved design input"). The mobile companion has phases P0 to P4 built, and store distribution and SSO (P5) not started. Consult output is decision support: a clinician reviews, attests and signs everything.
Consult treats each consultation as one record with several documents produced from it. Open it from Tiet · Hub → Apps → Tiet · Consult. You need the Consult or Medical AI access permission.
Open a consult
- Choose New consult. The panel is titled "Open consult".
- Pick a patient from the FHIR server, or Register a new patient. A patient registered here is stored as Local and can be published to FHIR when the consult closes. A consult cannot be opened without a patient.
- Enter the Reason for visit (for example "Chest pain for two days"). It becomes the consult title and is required.
- Optionally turn on Start recording, then choose Open consult.
Until a consult is open, the composer reads "Open a consult to start".
The workspace
The workspace views are Patient, Record / dictate, Attach file, Documents, Sources & analyses, Assistant, Consultation tools and Review & close. The stages shown are Capture, Review and Complete. A Calendar button opens the clinical calendar (Day, Week, Month) with saved consultations and appointments, and Back to consultation returns.
The side pane has three tabs:
| Tab | Shows |
|---|---|
| Patient | The linked patient, their folder documents and earlier consults. Without a FHIR patient it says "Link a FHIR patient to browse and attach patient-folder documents." |
| Evidence | Sealed exhibits, attached files, folder documents, the sources cited by the assistant, and which knowledge to ground answers on. A count badge shows the number of exhibits. |
| Coding | Coding suggestions for the record. The tab is disabled when coding is not available for the consult. |
Capture
- Record encounter (recorder): choose a language, Start recording, watch the Live transcript, then Send transcript. You can also paste a transcript. If speech-to-text is not configured the recorder says "Transcription is not configured (VITE_ELEVENLABS_API_KEY missing)."
- Attach file: attachments are limited in number and size, and an ECG in WFDB format needs its
.heaand.datfiles together. - Assistant: describe the case or ask a question. Each answer shows the sources it used (Patient record, This consult, Library).
Proposals
The assistant, recorder, analysers, coder and extractor do not write to the record. They propose changes. Each proposal card shows its origin and has Accept, Reject and, when the record changed since, Re-propose. You can add a note that is stored with the decision. Accept all accepts every proposed section into an empty record. Extract facts proposes medication and follow-up rows from the record text.
The record
The record has sections (Reason for visit, History, History of present illness, Examination, Investigations, Clinical assessment, Plan, Follow-up, or Subjective, Objective, Assessment for SOAP) and fact lists: Diagnoses, Medications, Orders, Follow-up, Allergies, Vitals, Labs. Medication rows carry a status of new, continued, changed or stopped.
Analyses and exhibits
An ECG analysis can be sealed as an exhibit: the recording and the model output are stored immutably under an id, and reports cite it by that id. A clinician with the review permission records a verdict on it: Accept, Reject or Amend. The model's original output is not overwritten. If a newer analysis replaces the one you reviewed, the review is marked stale and must be repeated. In Evidence, Include in... puts a source into a draft document as a figure with the clinician's read, a summary, or an appendix.
Documents
The tab strip shows the documents of the consult. New offers the kinds not yet opened:
| Kind in the tab strip | Notes |
|---|---|
| Record | The working surface. Older rows may say working_note. |
| Clinical report | For the clinician |
| Patient report | For the patient; the close step asks for its language |
| SOAP | |
| Referral, Discharge summary | Offered by the interface and accepted by the database, but the design document lists them as "Later". Treat them as not yet supported. |
A document is a draft, then Filed, awaiting sign-off, then Signed. A signed document takes no more edits. Reports are rendered from the record, so editing the record updates them until they are filed; a filed report is frozen. In the editor you can Save draft, Copy, Email (through the locally configured email provider) and Export PDF, and open Note history for every saved version.
Close a consult
- Choose Review & close. The Close consult dialog shows the Close checklist. Green means it can close.
- Fix what is not green:
| Checklist item | Fix |
|---|---|
| Patient in the record | Publish the local patient to the record before closing |
| No proposals pending | Decide the remaining proposals |
| Cited analyses reviewed | Review stale or unreviewed analyses from Evidence |
| Coded diagnosis | Code a diagnosis, or give a "Reason for closing without a coded diagnosis" |
| Medications reconciled | Give every medication row a status |
| Doses on new and changed medications | Add the dose |
| Patient report language | Choose the language the patient reads |
- Under Documents to produce, choose which opened documents to sign. Turn Store in the patient record on to write the encounter, diagnoses, medications, orders, reviewed analyses and the chosen documents as one transaction. If it is off, the consult closes here only and can be stored later with Store in patient record.
- Tick the Attestation: "I confirm that I reviewed the record and the chosen documents and that they accurately reflect my clinical assessment."
- Choose Sign and close. To hand over without signing, choose File preliminary instead.
Signing freezes the record and the chosen documents. Later changes need an Addendum, which opens the record to proposals again.
If the dialog says "Closing consults is not available on this deployment yet.", that deployment lacks the close service.
Mobile companion
The Consult mobile app (Expo, iOS and Android) has built: sign-in scoped to your organization with a biometric lock (P0), consult list and detail with document tabs and rendering (P1), asking a follow-up (P2), capture of audio to SOAP, photo to attachment and an offline queue (P3), and file and sign with attestation and a fresh biometric check (P4). Store distribution and SSO (P5) and a patient app (P6) are not started; SSO does not work on mobile yet.
Related
Something unclear? Send documentation feedback by email.