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
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
- Click "New prescription" in the sidebar (or open Workbench).
- 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).
- 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.
- Stop recording. The AI runs four stages: Transcribe → Enhance → Extract → Validate. You'll see the structured fields fill in.
- Smart Rx auto-runs after the voice insert. Review the safety findings panel on the right (interactions, dose alerts).
- Click "Preview" to see the rendered PDF. If it looks good, click "Share" → copy the patient link, or "Download" to print.
- The prescription auto-promotes to ISSUED the moment it has any content; no Save button to remember.
No need to save manually
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
Heads up
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 in
interaction-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
- In the workbench patient picker, type the patient's name and click "+ Create".
- Fill any extra known fields (phone, email, gender, age) — only name is required.
- 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
- Open Clinic profile → Templates tab.
- Choose "Custom letterhead" and upload your design (PNG / JPG).
- Hakeem scans the image with vision AI and auto-maps a starter set of field boxes.
- Open Template Mapping (T) to drag/resize boxes and tweak per-field font + color.
- Pick the template style you want from the gallery and select a primary color.
Tip
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
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.
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
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).