Skip to main content
DataCrafters synthetic data · demonstration

Coder worklist · Clinician screen · Chart

Staff surface Coder view

P15 KE-P15 · inpatient visit

One row per condition family: what the record supports under the published definition, what the note states, the visit's diagnosis entries, and an assessment. Codes are coded from the signed documentation; the software never assigns one.

Note: unsigned draft

Side-panel conditions check FRUN-00015 · front-engine 1.2 · replay ef416e2b193bdec6…

Library check LRUN-00015 · library_default_set@1.1 · library-engine 1.1 · replay 73aad0b39ff1e626… · Data (JSON)

Core definitions 1

Core definitions: condition families for this encounter (1)
Condition familyWhat the record supportsWhat the note states Visit diagnosis entriesAssessment
Kidney disease stage (filtering rate)
measured · side-panel condition

front_kidney_stage_wording@1.0 Draft · pending review

No wording's requirement is met by the record (not assessable)

    Options and what the record shows
    • Chronic kidney disease stage 1 · needs filtering rate 90 or above with a kidney damage marker (for example albuminuria on two tests at least 90 days apart) · record: no steady-state creatinine result on file · not assessable
    • Chronic kidney disease stage 2 · needs filtering rate 60-89 with a kidney damage marker (for example albuminuria on two tests at least 90 days apart) · record: no steady-state creatinine result on file · not assessable
    • Chronic kidney disease stage 3a · needs filtering rate 45-59 on two results at least 90 days apart · record: no steady-state creatinine result on file · not assessable
    • Chronic kidney disease stage 3b · needs filtering rate 30-44 on two results at least 90 days apart · record: no steady-state creatinine result on file · not assessable
    • Chronic kidney disease stage 4 · needs filtering rate 15-29 on two results at least 90 days apart · record: no steady-state creatinine result on file · not assessable
    • Chronic kidney disease stage 5 · needs filtering rate below 15 on two results at least 90 days apart · record: no steady-state creatinine result on file · not assessable
    Citation

    Kidney disease stage wording by filtering rate, with the albumin-to-creatinine category (options for the clinician)

    front_kidney_stage_wording@1.0

    In our words: Kidney disease by filtering rate: below 60 on results at least 3 months apart; or urine albumin-to-creatinine ratio 30 mg/g or higher on two tests at least 3 months apart. Stage by filtering rate: G1 90 or above; G2 60-89; G3a 45-59; G3b 30-44; G4 15-29; G5 below 15 (G1 and G2 also need a marker of kidney damage). Albumin-to-creatinine category: A1 below 30, A2 30-299, A3 300 mg/g or above. The filtering rate is estimated with the 2021 race-free creatinine equation.

    Decreased eGFR <60 mL/min/1.73 m2 (GFR categories G3a-G5) for ≥3 months

    Department of Veterans Affairs and Department of Defense, VA/DoD Clinical Practice Guideline for the Primary Care Management of Chronic Kidney Disease, Provider Summary (Version 5.0) (2025) · Sidebar 6 'Criteria for CKD' (PDF page 16; printed page 13 of 37). Do not use Sidebar 9 (a reproduced third-party figure) · source

    Licence: U.S. government work (public domain); filtering-rate stage bands (90, 60, 45, 30, 15) and the G3a/G3b split: fact only citation; albumin-to-creatinine categories (A1 below 30, A2 30-299, A3 300 mg/g or above): fact only citation; 2021 creatinine equation: public domain. Source checked: opened. No endorsement by the cited bodies is implied.

    To confirm with a clinician: three months is encoded as 90 days (the VA/DoD summary says 3 months or more).

    Not stated

    None entered

    Cannot be assessed

    Could not check kidney function: there is no usable creatinine result outside an acute change.

    Clinician's response to the side-panel card: No response yet · offer OF-000011

    Whole code category, for reference (no code is selected, ranked or suggested): Kidney disease stage (filtering rate) Coders only

    reference for coders — the clinician's documented statement governs; the software does not assign codes

    N18 Chronic kidney disease (CKD) (9 codes in the category).

    • N18.1 Chronic kidney disease, stage 1
    • N18.2 Chronic kidney disease, stage 2 (mild)
    • N18.30 Chronic kidney disease, stage 3 unspecified
    • N18.31 Chronic kidney disease, stage 3a
    • N18.32 Chronic kidney disease, stage 3b
    • N18.4 Chronic kidney disease, stage 4 (severe)
    • N18.5 Chronic kidney disease, stage 5
    • N18.6 End stage renal disease
    • N18.9 Chronic kidney disease, unspecified

    Source: official ICD-10-CM FY2027 code descriptions (extract in library/data/code_reference_fy2027.json).

    Extended capabilities (licence required before commercial use) 2

    Extended capabilities: published criteria cited by title and restated in our own words, no text reproduced; a licence or permission is needed before commercial use. Shown to coders always; on clinician screens only when the setting is on (now off).

    Extended capabilities (licence required before commercial use): condition families for this encounter (2)
    Condition familyWhat the record supportsWhat the note states Visit diagnosis entriesAssessment
    Hyperkalaemia
    measured

    ukka2026_hyperkalaemia@1.0 Draft · pending review

    Mild hyperkalaemia (5.5–5.9 mmol/L)

    • potassium serum 5.8 mmol/L 2026-11-12 15:00 · LM-P15-02

    Window: 14 days before the check.

    Citation

    Hyperkalaemia and its severity (UK Kidney Association, July 2026 update)

    ukka2026_hyperkalaemia@1.0

    In our words: Serum potassium (adults): 5.5 to 5.9 mmol/L mild; 6.0 to 6.4 moderate; 6.5 or higher severe.

    UK Kidney Association, Clinical Practice Guidelines: Treatment of Acute Hyperkalaemia in Adults (2026) · Introduction, document page 9 (PDF page 10) · source

    Licence: cited source; wording is ours (numbers restated, no text reproduced). Source checked: opened. No endorsement by the cited bodies is implied.

    Contested: The guideline itself says that no definition of hyperkalaemia is universally accepted; it adopts the ERC threshold of 5.5 mmol/L. CTCAE grades differ (see ctcae6_hyperkalaemia).

    Not encoded: Pseudohyperkalaemia (guideline 15.3: haemolysis, delayed analysis, sampling technique) is not detected; a haemolysed sample is graded like any other unless the sender withholds it. Acute versus chronic (persistent) hyperkalaemia and the guideline's repeat-testing intervals (guidelines 1.2.1-1.2.3) are not encoded. ECG changes and clinical context are not assessed.

    Not stated

    None entered

    The record supports it; neither stated in the note nor entered

    Draft a query

    Whole code category, for reference (no code is selected, ranked or suggested): Hyperkalaemia Coders only

    reference for coders — the clinician's documented statement governs; the software does not assign codes

    E87 Other disorders of fluid, electrolyte and acid-base balance: distinguishes E87.5 hyperkalemia (one code; no severity axis) (14 codes in the category).

    • E87.0 Hyperosmolality and hypernatremia
    • E87.1 Hypo-osmolality and hyponatremia
    • E87.20 Acidosis, unspecified
    • E87.21 Acute metabolic acidosis
    • E87.22 Chronic metabolic acidosis
    • E87.29 Other acidosis
    • E87.3 Alkalosis
    • E87.4 Mixed disorder of acid-base balance
    • E87.5 Hyperkalemia
    • E87.6 Hypokalemia
    • E87.70 Fluid overload, unspecified
    • E87.71 Transfusion associated circulatory overload
    • E87.79 Other fluid overload
    • E87.8 Other disorders of electrolyte and fluid balance, not elsewhere classified

    Source: official ICD-10-CM FY2027 code descriptions (extract in library/data/code_reference_fy2027.json).

    Septic shock (lactate component)
    judgement tier

    sepsis3_septic_shock_lactate@1.0 Draft · pending review

    Lactate >2 mmol/L (18 mg/dL): the Sepsis-3 septic-shock lactate criterion is met

    • lactate serum 2.6 mmol/L 2026-11-11 15:10 · LM-P15-03

    Window: 7 days before the check.

    Citation

    Serum lactate above the Sepsis-3 septic-shock threshold (numeric component only)

    sepsis3_septic_shock_lactate@1.0

    In our words: A lactate above 2 mmol/L (18 mg/dL) is the lactate part of the septic-shock criteria; it never establishes septic shock on its own.

    Society of Critical Care Medicine and European Society of Intensive Care Medicine task force (JAMA 2016;315:801-810), The Third International Consensus Definitions for Sepsis and Septic Shock (Sepsis-3) (2016) · Box 3 'New Terms and Definitions' · source

    Licence: cited source; wording is ours (numbers restated, no text reproduced). Source checked: opened. No endorsement by the cited bodies is implied.

    Not encoded: Septic shock also requires sepsis (suspected or documented infection with an acute increase in SOFA ≥2), persisting hypotension requiring vasopressors to maintain MAP ≥65 mm Hg, and adequate volume resuscitation; none of these is assessed. This entry never says septic shock is present. Timing of the lactate relative to resuscitation is not checked; the most recent value is used.

    Not stated

    None entered

    Cannot be assessed

    judgement tier: the record shows these values; the condition needs clinical judgement

    Whole code category, for reference (no code is selected, ranked or suggested): Septic shock (lactate component) Coders only

    reference for coders — the clinician's documented statement governs; the software does not assign codes

    Source: official ICD-10-CM FY2027 code descriptions (extract in library/data/code_reference_fy2027.json).