← Back to index

Drug allergy checking in Gentu, idea map

PRD-006 · iteration 2, 27 Oct · Moment 3 shows allergy and drug-drug alerts together · keeps Gentu's Adverse Reactions card and New Adverse Reaction form (Tam, 27 Oct) · alerts on the Vitality Callout from Michael's alert surface (INTOP-4371) · corrected against PRD-006 v8: prescribing is never blocked, a clean check shows nothing, the uncoded notice lives in the sidebar · questions for the design are tagged Q

SUPERSEDED on 3 Nov 2026 by iteration 4. This page shows the 27 Oct design, and its field names describe that design. The POC is now the design. Use iteration 4, the field reference and the POC. Kept as it was, for the record.
critical → red (same ingredient) warning → orange (same class) info → blue (cross-sensitivity) neutral → grey (could not check) no match → nothing shown, MIMS disclaimer Q → a question for the design

Moment 1. Recording the allergy

Gentu's own New Adverse Reaction form, kept as it is (Tam, 27 Oct). Agent and Manifestation are searches, Severity is required. The check can only work on what MIMS can recognise from this record.

1 New Adverse Reaction · Gentu today, kept

KEEPPatient file › Adverse Reactions › +. Four states: empty, agent search, manifestation search, filled.

ANSWEREDQ1 and Q2 of the 22 Oct map: the MIMS allergen search is not brought into recording. Gentu's agent list stays (the list itself is PRD-008's).

THE FACTGentu records a severity on every reaction (Mild to Fatal, or Unknown). MIMS gives none. This may be what the alert's weight hangs on, see Q6 and Q10.

2 Adverse Reactions · Gentu today, kept, plus severity

KEEPThe Adverse Reactions card in the sidebar, the flags, and "2 Flagged Adverse Reactions" in the patient header (Tam, 27 Oct).

ADDThe severity recorded on the reaction, as a Vitality StatusBadge on a second line under the agent and manifestation. The one change to the card (Tam, 27 Oct).

CODEThe sidebar has three widths (ClinicalShell.styles.ts): 270px up to a 1440px screen, 380px up to 1919px, 440px from 1920px. The long agent fits on one line at 380px and 440px and wraps at 270px, so the badge goes on its own line at every width. Vitality's Badge is a number or a dot only; a text label is StatusBadge.

270px · screens up to 1440px
⌃ Adverse Reactions +
Penicillin -class of antibiotic- Facial swelling⚑
High
Amoxicillin Rash
Moderate
Aspirin Facial swelling⚑
Mild
Sulpha
High
380px · 1441px to 1919px
⌃ Adverse Reactions +
Penicillin -class of antibiotic- Facial swelling⚑
High
Amoxicillin Rash
Moderate
Aspirin Facial swelling⚑
Mild
Sulpha
High
440px · 1920px and wider
⌃ Adverse Reactions +
Penicillin -class of antibiotic- Facial swelling⚑
High
Amoxicillin Rash
Moderate
Aspirin Facial swelling⚑
Mild
Sulpha
High

Q3Which of these can MIMS check? "Sulpha" is free text. Who matches free-text records to a coded agent, and when: the doctor at the next consult, reception in bulk, or a one-off migration? Baseline today: 20.5% of patients with an allergy have it coded.

Q4Where does the uncoded notice sit against this card (frame 6)?

GENTUSeverity is required on the New Adverse Reaction form, so every reaction carries one and every row gets a badge. Records made before the field was required may have none.

Q13Which badge colour per level: Mild, Moderate, High, Life Threatening, Fatal, Unknown? Drawn for now: High critical, Moderate warning, Mild info.

Moment 2. Prescribing

One call: the patient's coded allergens against every medicine on the script. Three kinds of match come back, plus a list of anything MIMS could not check. There is no severity. MIMS says so itself.

Each element is shown twice: what the user sees, and beside it the field each part of it comes from (Brendan, 29 Oct).

allergies[].allergyType from the MIMS responseGentu from Gentu, never sent to MIMSPlain text is Gentu's own copy
What the user sees
Medications
Selected Medication
Aspro Clear 300 mg Effervescent Tablets, 30
Allergies on file: Aspirin (ingredient)
Allergy · Aspirin × Aspro Clear
Same ingredient
Aspro Clear contains aspirin, which is documented as this patient's allergen.
⌄ Ingredients, class and references
Field names
Medications
Selected Medication
input.name
Allergies on file: adverse reaction agent
Allergy · allergens[].name × input.name
allergyType
input.name contains input.moleculeName[], which is documented as this patient's allergen.
⌄ moleculeName[] · allergyClass · references[]

3 Same ingredient · the strongest match

MIMSallergyType = same ingredient · summaryStatement · MoleculeName · references.

PRD-006Prescribing is never blocked, so this is drawn passive, with the red of the strongest match.

Q5The PRD's Q6, Rory with Daryl: which alerts need acknowledgement, and is an override reason captured. With no severity, acknowledgement would apply to every alert, which may be too much friction.

What the user sees
Medications
Selected Medication
Curam Duo 500/125 Tablets, 10
Allergies on file: Penicillins (class)
Allergy · Penicillins × Curam Duo
Same class
Curam Duo contains amoxicillin, a penicillin. The patient's documented allergy is to the penicillin class.
⌄ Ingredients, class and references
Field names
Medications
Selected Medication
input.name
Allergies on file: adverse reaction agent
Allergy · allergens[].name × input.name
allergyType
input.name contains input.moleculeName[], a input.allergyClass. The patient's documented allergy is to the allergens[].allergyClass class.
⌄ moleculeName[] · allergyClass · references[]

4 Same class

MIMSallergyType = same allergy class.

Q6Is "same class" weaker than "same ingredient"? Clinically a class allergy is often the more cautious record, so this may deserve the same weight as 3. The ladder is a design call, not a MIMS one.

What the user sees
Medications
Selected Medication
Keflex 250 mg Capsules, 20
Allergies on file: Penicillins (class)
Possible allergy · Penicillins × Keflex
Cross-sensitivity
Cefalexin is a cephalosporin. Cross-reaction with penicillin allergy is reported in the literature.
⌄ References (international)
Field names
Medications
Selected Medication
input.name
Allergies on file: adverse reaction agent
Possible allergy · allergens[].name × input.name
allergyType
input.moleculeName[] is a input.allergyClass. Cross-reaction with allergens[].allergyClass allergy is reported in the literature.
⌄ references[]

5 Cross-sensitivity · inferred from literature

MIMSallergyType = cross sensitivity · references[].

Q7This is the one that will fire most often and annoy most. Penicillin to cephalosporin cross-reaction is low in practice. Passive inline, like Michael's Moderate, or quieter still?

What the user sees
Medications
Selected Medication
Bactrim DS 800/160 Tablets, 10
Allergies on file: Sulpha (free text)
No alert, no confirmation. The check found nothing it could check against.
Sidebar · Adverse Reactions
Not checked
This patient has free-text allergies which can't be checked for interactions. Review them before prescribing.
Sulpha
High
Penicillin -class of antibiotic- Facial swelling⚑
High
Field names
Medications
Selected Medication
input.name
Allergies on file: adverse reaction agent (no SNOMED code, so not sent)
allergies[] is empty, because no coded allergen was sent.
Sidebar · Adverse Reactions
Not checked
Shown when the patient has a free-text agent, or when unrecognized[] is not empty. Copy is Gentu's (Daryl, 22 Oct).
agent
severity
agent manifestation⚑
severity

6 Could not check · a sidebar notice, not an interrupting alert

GENTU-SIDEA free-text allergy is never sent. MIMS unrecognized[] covers bad ids and inactive SNOMED codes.

PRD-006 Q8The notice lives in the sidebar, shown when the check finds no conflict and the patient has uncoded allergies. Copy chosen by Daryl, 22 Oct.

Q8The PRD's Q11, yours: when exactly it shows, whether alongside a conflict alert too, and whether it also covers coded allergies MIMS did not recognise. Drawn here at the top of the Adverse Reactions card.

What the user sees
Medications
Selected Medication
Rosuvastatin 10 mg Tablets, 30
Allergies on file: Penicillins (class)
No alert, no confirmation, no extra step. Daryl's advice on DDI, carried over as a PRD trade-off.
Field names
Medications
Selected Medication
input.name
Allergies on file: adverse reaction agent
allergies[] is empty and unrecognized[] is empty, so nothing shows. noAllergyDisclaimer is not shown here (Q9).

7 No match · shows nothing, as DDI does

MIMSnoAllergyDisclaimer, required by MIMS. PRD-006 Q13, Brendan: where does it show if a clean check shows nothing.

Q9The PRD's Q13. MIMS requires its absence disclaimer, and the PRD shows nothing on a clean check. Once per session, in MIMS settings, behind an info icon, or does the DDI precedent already answer it? The tension with "not-checked must never look like clean" is carried by frame 6's sidebar notice, not by this screen.

What MIMS sends, what Gentu adds
From MIMS, verbatimMatch type (3 kinds) · summary sentence · allergen and medicine with ingredient names and class · references · the two disclaimers · unrecognised ids
Gentu authorsThe title line · the weight of each match type · acknowledge and override · the not-coded notice · the no-match wording · what to log

8 What MIMS sends, what Gentu adds

THE FACTDrug-drug alerts arrive tiered (severe, moderate, minor, with documentation levels). Drug-allergy alerts do not. The only differentiation MIMS gives is the kind of match. Reusing the drug-drug severity ladder here has nothing to feed it, so the ladder, if there is one, is ours to decide and to defend.

NOT COVEREDExcipients and delivery systems. Non-drug allergies (shellfish, latex) never go to the check.

What the user sees
Medications
Selected Medication
Augmentin Duo Forte 875/125 Tablets, 10
Allergies on file (6): Penicillins · Amoxicillin · Cephalosporins · Sulfonamides · Codeine · Latex
Allergy · 3 of 6 allergens match Augmentin Duo Forte
Grouped
Amoxicillin · Augmentin contains amoxicillinSame ingredient
Penicillins · amoxicillin is a penicillinSame class
Cephalosporins · cross-reaction reported with penicillinsCross-sensitivity
⌄ Ingredients, classes and references · 3 allergens did not match
Field names
Medications
Selected Medication
input.name
Allergies on file: adverse reaction agent, every one
Allergy · count of allergies[] of count of allergens sent allergens match input.name
Gentu
allergens[].name · input.name contains input.moleculeName[]allergyType
allergens[].name · input.moleculeName[] is a input.allergyClassallergyType
allergens[].name · cross-reaction reported with input.allergyClassallergyType
⌄ moleculeName[] · allergyClass · references[] · allergens with no match

9 Grouped · one alert per medicine, every matching allergen inside it

MIMSallergies[] holds one entry per allergen and medicine pair. The grouping is Gentu's.

WHY GROUPEDInline alerts stack one per allergen. Six allergens would be six callouts for one decision, and the Prescribe button leaves the screen. 38% of patients with an allergy have two or more.

Q10The group takes the colour of its strongest match (red, from the same-ingredient row). Prescribing is never blocked, per the PRD. Right?

Q11Strongest first, or in the order the allergies are on file?

Q12On a script with several medicines, one group per medicine, or one group for the script?

Moment 3. Allergy and drug-drug alerts together

The same medicine can raise drug-drug alerts and allergy alerts at once. Drug-drug alerts are drawn as Michael's alert surface does them (INTOP-4409, on platform staging): Severe blocks with labelled actions, Moderate is passive inline, Minor collapses. Allergy alerts never block (PRD-006).

Medications
Selected Medication
Curam Duo 500/125 Tablets, 10
Allergies on file: Penicillins (class) · current medicines: Warfarin 5 mg
Zone 1 · Clinical safety
Allergy · Penicillins × Curam Duo
Same class
Curam Duo contains amoxicillin, a penicillin. The patient's documented allergy is to the penicillin class.
⌄ Ingredients, class and references
Moderate · Amoxicillin × Warfarin
Good
Amoxicillin may increase the anticoagulant effect of warfarin. Monitor INR.
⌄ Mechanism, precautions & references

10 One allergy match and one drug-drug interaction

REUSEBoth are passive inline Callouts with the same ✕ and ✓, so they read as one family. Both sit in Michael's Zone 1, clinical safety, above any PBS notice.

ILLUSTRATIVEThe interaction text is a stand-in, not MIMS output.

Q14Which goes first when the weight looks the same: allergy before drug-drug, or the order MIMS returns them? Drawn: allergy first, because it is about this patient, not the combination.

Q15Does the title need to say which kind it is ("Allergy ·" against "Moderate ·"), or does the pill do that? Today the drug-drug title leads with severity and the allergy title cannot.

Medications
Selected Medication
Clarithromycin 250 mg tablet, 14
Allergies on file: Erythromycin (ingredient) · current medicines: Simvastatin 40 mg
Zone 1 · Clinical safety
Severe · Clarithromycin × Simvastatin
Well Established
Clarithromycin increases toxicity of Simvastatin. 1. Avoid combination.
⌄ Mechanism & references
Allergy · Erythromycin × Clarithromycin
Same class
Clarithromycin is a macrolide. The patient's documented allergen, erythromycin, is a macrolide.
⌄ Ingredients, class and references

11 A Severe interaction and an allergy match

D3The Severe interaction blocks: labelled actions, Prescribe disabled until acknowledged. The allergy alert under it stays passive, because PRD-006 says an allergy alert never blocks.

ILLUSTRATIVEThe allergy match is drawn to show the case. Whether MIMS returns erythromycin to clarithromycin as same class has not been checked.

Q16Is it right that a drug-drug interaction can block and an allergy to the medicine cannot? A prescriber may read the louder alert as the more dangerous one.

Q17Does "Acknowledge & prescribe…" also clear the allergy alert, or does each need its own action?

Medications
Selected Medication
Augmentin Duo Forte 875/125 Tablets, 10
6 allergies on file · 9 current medicines
Zone 1 · Clinical safety
Allergy · 3 of 6 allergens match
Grouped
AmoxicillinSame ingredient
PenicillinsSame class
CephalosporinsCross-sensitivity
⌄ Ingredients, classes and references
Sidebar · Adverse Reactions
Not checked
This patient has free-text allergies which can't be checked for interactions. Review them before prescribing.

12 Everything at once

D4Michael's rule for many drug-drug alerts: anything you must act on stays open, Moderate and Minor collapse behind counts tinted by their own severity.

STACKINGThe allergy group stays open above the collapsed interactions. The uncoded notice stays in the sidebar, so the panel still says what was not checked.

Q18Does the allergy group ever collapse like a Moderate, for example when its strongest match is only cross-sensitivity? Drawn: it always stays open.

Q19Does the recorded severity on the allergy (Mild to Fatal, frame 2) decide where it sits among the drug-drug alerts? A Fatal reaction on file next to a Minor interaction is not the same as a Mild one.

SOURCE MIMS Web Services V3, Drug Allergy Alert. Visual language and tokens from Michael's drug-drug alert surface (INTOP-4371). Iteration 2 of the 22 Oct idea map.