Skip to main content

Help & guide

Everything Hakeem can do, in one place.

Read the workflows top-to-bottom for the full happy path, or jump to the area you need using the table of contents on the right.

Getting started

Hakeem is a voice-first prescription workbench: you dictate, an AI pipeline turns the dictation into structured medication / lab / imaging orders, validates them against the Egyptian drug catalog and clinical-safety rules, and prints a branded PDF you can hand to the patient or share via a link.

You only need to know three places to be productive:

  • Workbench — where you write a single prescription. Voice, Smart Rx checks, preview, and share all live here.
  • Patients — your patient list. Each row opens a full timeline of past prescriptions and follow-ups.
  • Clinic profile + Templates — where you set the clinic identity, choose a PDF style, and (optionally) upload your own letterhead.

Tip

Your clinic comes pre-loaded with a sample patient (Mona Hassan) and a sample prescription so the workbench isn't empty on day one. Open them, poke around, then delete when you're ready.

Workflow: your first prescription

The end-to-end happy path, in roughly the order you'll do it:

New prescription · voice → print, in under 2 minutes

  1. Click "New prescription" in the sidebar (or open Workbench).
  2. Pick the patient: type the name in the top search to find an existing one, or click + to create a new patient (only the name is mandatory).
  3. Click the microphone in "Dictate the prescription". Speak in any mix of Arabic and English — diagnosis, medications with dose + frequency, labs, imaging, follow-up date.
  4. Stop recording. The AI runs four stages: Transcribe → Enhance → Extract → Validate. You'll see the structured fields fill in.
  5. Smart Rx auto-runs after the voice insert. Review the safety findings panel on the right (interactions, dose alerts).
  6. Click "Preview" to see the rendered PDF. If it looks good, click "Share" → copy the patient link, or "Download" to print.
  7. The prescription auto-promotes to ISSUED the moment it has any content; no Save button to remember.

No need to save manually

The workbench autosaves continuously. As soon as you pick a patient AND add any content, the prescription becomes ISSUED with a unique Rx number for pharmacist tracking.

The workbench

The workbench is the central editor for one prescription. It has three columns on wide screens (patient on the left, content in the middle, AI panel on the right) and stacks on smaller widths.

  • Patient column — gating: you can't edit anything until a patient is selected. Patient name, age, weight, allergies, and chronic conditions feed the safety checks.
  • Content column — diagnosis + clinical notes, then medications, labs, imaging, and a follow-up. Each row can be entered manually or filled by voice.
  • AI column — Smart Rx safety findings, dose suggestions, and the voice-pipeline debug viewer (only shown when needed).

Buttons at the top: Preview (HTML render), Download (PDF), Share (patient link with all their visits), Delete (drafts only), Archive (issued prescriptions, hides them from default lists without losing the record).

Voice dictation

The voice button accepts continuous bilingual dictation. The pipeline runs four stages, streamed live so you see progress:

  • Transcribe — raw text from speech, in whatever language you used.
  • Enhance — fixes minor misspellings against the local drug + lab registers (Levenshtein-bounded; never invents brands).
  • Extract — pulls structured fields: diagnosis, medications (name, strength, dose, frequency, duration), lab orders, imaging, follow-up date.
  • Validate — runs the catalog match, drug interactions, and pediatric dosing rules.

Get cleaner extractions

Speak the strength after the drug name (“Tareg 40 mg, twice daily for 2 weeks”). For follow-ups, say a clear interval (“and review me in 2 weeks” / “شوفني بعد أسبوعين”).

Heads up

The voice stream isn't bounded by the regular AI timeout. If it appears stuck for more than ~45 seconds, click the debug button beside the title to inspect each stage.

Smart Rx safety checks

Smart Rx runs after every voice insert and on demand from the AI panel. It surfaces three kinds of findings:

  • Drug interactions — based on a curated rule set ininteraction-rules.tscovering common Egyptian-formulary combinations.
  • Pediatric dosing alerts — for patients with a recorded weight, medications matched to weight-based rules return a recommended mg range and a max-dose ceiling.
  • Catalog ambiguity — if the dictated drug name + strength can't be collapsed to a single catalog SKU, you'll see a hint with the candidates.

Findings are persisted in the prescription snapshot — they survive close/reopen. Editing a medication clears the score so you re-run Smart Rx on the new content.

Patients

The Patients list supports search, gender filter, “active since” date filter, and pagination. Click any patient to open their full workspace: profile fields, prescription history, follow-ups, and per-row delete/archive controls.

Adding a new patient mid-flow

  1. In the workbench patient picker, type the patient's name and click "+ Create".
  2. Fill any extra known fields (phone, email, gender, age) — only name is required.
  3. The patient appears in the global patients list immediately and can be linked to future prescriptions.

A new patient share token is generated the first time you share their portal. It's long-lived (no expiry) and points to the patient — not a single prescription — so the URL you share once stays valid for every visit.

Templates & PDF styles

Hakeem ships with 7 built-in PDF templates: hakeem, classic, modern, minimal, banded, two-column, executive. You can also upload your own clinic letterhead and let the AI auto-map field boxes (patient name, date, medications, etc.) onto it.

Use your own letterhead

  1. Open Clinic profile → Templates tab.
  2. Choose "Custom letterhead" and upload your design (PNG / JPG).
  3. Hakeem scans the image with vision AI and auto-maps a starter set of field boxes.
  4. Open Template Mapping (T) to drag/resize boxes and tweak per-field font + color.
  5. Pick the template style you want from the gallery and select a primary color.

Tip

Every printed prescription always carries the Rx number (serial). Custom templates can either map a dedicated Rx number field or fall back to a top-right stamp.

Catalogs (drugs · labs · imaging)

Three master catalogs live under Data setup: Medications, Lab tests, and Imaging tests. They're shared across the app and feed both the workbench picker and the voice pipeline.

  • Search in the top-right of each list.
  • Compact filter bar — open any chip (e.g. Manufacturer ▾) to multi-select with a searchable list.
  • Star the rows you prescribe most. They jump to the top of the workbench picker dropdown so your usual 20–30 SKUs are one scroll away.
  • Favorites filter — toggle “Favorites” on the catalog page to focus on just your starred entries.

Tip

Lab catalog includes a Fasting required filter and a tristate to find tests by preparation requirement.Imaging catalog filters by modality and body region.

Follow-ups

A follow-up is a scheduled callback for a patient. They can be created three ways:

  • Manually in the workbench follow-up panel.
  • From voice — the AI extracts phrases like “review in 2 weeks” and proposes a date.
  • From the Follow-ups page, against any patient.

Follow-ups autosave with stable keys, so adding/editing one in the workbench reflects immediately in the patient's portal and the global Follow-ups list. Status moves OPEN → DONE / CANCELLED.

Sharing & the patient portal

The Share button in the workbench gives you one URL: the patient's portal. It opens a clean read-only workspace showing the clinic header, every issued prescription for that patient (most recent in focus), and the follow-up panel.

  • The URL is per-patient, not per-prescription — share it once, valid forever (until you rotate or revoke from the patient profile).
  • Pharmacists can scan the Rx number / QR (when present) to look up the prescription.
  • The portal mirrors the clinic's chosen template and language preference.

Heads up

Drafts are never visible in the portal — only ISSUED / DISPENSED prescriptions show up.

Team & roles

From Team you can invite additional doctors and clinic admins by email. The first user (the account owner) is permanent: their role can't be changed and they can't be removed without contacting support.

Every write — patient edits, prescription mutations, clinic settings, follow-ups — is logged with actor, IP, and user-agent. Open Audit log to review changes with a friendly Field / Before / After diff.

Clinic profile

The Clinic profile page collects everything that prints on the prescription: clinic name + Arabic name, doctor name + title, specialty (autocompleted from a curated list), address, phone, email, logo, and primary color. It's also where you choose between a built-in template and your custom letterhead.

Tip

Specialty is fuzzy-matched in Arabic + English. If yours isn't in the list, contact support — adding one takes seconds on our end.

Tips & shortcuts

  • Rx number format: CLN<clinic>-YYYYMM-NNN, monthly serial scoped per clinic.
  • Star catalog rows () — biggest ergonomic win for repeat prescribing.
  • Voice retry: if a stage hangs, click the debug button beside the voice title to see each stage's prompt + response.
  • Use existing patients: the workbench search will surface partial name + phone + email matches.
  • Press Esc to dismiss any popover (filter dropdown, etc.).

Troubleshooting

  • Logo missing in PDF — re-upload from Clinic profile; very small (< 48px) PNGs are accepted but may print blurry.
  • Custom template fields print in odd places — open Template mapping (T), drag the box for the affected field; positions are stored as 0-1 fractions of the page.

Anything not listed here? Email support and we'll help.

Glossary

  • Smart Rx — the post-extraction safety pass: drug interactions, pediatric dosing, catalog ambiguity.
  • Custom letterhead — your own clinic header image, with field boxes mapped onto it for printing.
  • Rx number — per-clinic monthly serial, always printed on every issued Rx.
  • Audit log — append-only record of every clinical mutation (patients, prescriptions, clinic settings, follow-ups).