Skip to main content
DataCrafters synthetic data · demonstration

Coder worklist · Clinician screen · Chart

Staff surface Coder view

P10 KE-P10 · outpatient 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-00010 · front-engine 1.2 · replay bf7823ca1790e1f0…

Library check LRUN-00010 · library_default_set@1.1 · library-engine 1.1 · replay 5f1aa568b06ef975… · 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: one value below 60 (eGFR 45.4 on 2026-11-12) since the last value of 60 or more; persistence needs a repeat at least 90 days later · 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: one value below 60 (eGFR 45.4 on 2026-11-12) since the last value of 60 or more; persistence needs a repeat at least 90 days later · not assessable
    • Chronic kidney disease stage 3a · needs filtering rate 45-59 on two results at least 90 days apart · record: one value below 60 (eGFR 45.4 on 2026-11-12) since the last value of 60 or more; persistence needs a repeat at least 90 days later · not assessable
    • Chronic kidney disease stage 3b · needs filtering rate 30-44 on two results at least 90 days apart · record: one value below 60 (eGFR 45.4 on 2026-11-12) since the last value of 60 or more; persistence needs a repeat at least 90 days later · not assessable
    • Chronic kidney disease stage 4 · needs filtering rate 15-29 on two results at least 90 days apart · record: one value below 60 (eGFR 45.4 on 2026-11-12) since the last value of 60 or more; persistence needs a repeat at least 90 days later · not assessable
    • Chronic kidney disease stage 5 · needs filtering rate below 15 on two results at least 90 days apart · record: one value below 60 (eGFR 45.4 on 2026-11-12) since the last value of 60 or more; persistence needs a repeat at least 90 days later · 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 yet: only one result is below 60 (filtering rate 45.4 on 2026-11-12); a repeat at least 90 days later is needed.

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

    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) 1

    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 (1)
    Condition familyWhat the record supportsWhat the note states Visit diagnosis entriesAssessment
    Iron deficiency
    measured

    who2020_iron_deficiency_ferritin@1.0 Draft · pending review

    Iron deficiency (ferritin <15 µg/L)

    • ferritin serum 11 ug/L 2026-11-12 09:05 · LM-P10-01

    Window: 180 days before the check.

    Citation

    Iron deficiency by serum ferritin (WHO 2020)

    who2020_iron_deficiency_ferritin@1.0

    In our words: Ferritin suggesting iron deficiency: below 15 µg/L at 5 years and older (healthy) and in first-trimester pregnancy; below 12 µg/L under 5 years (healthy); below 30 µg/L under 5 with infection or inflammation; below 70 µg/L at 5 and older with infection or inflammation.

    World Health Organization, WHO guideline on use of ferritin concentrations to assess iron status in individuals and populations (2020) · Executive summary, recommendations 1.1-1.2 (PDF page 11) and Table 1 (PDF page 12) · source

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

    Contested: Ferritin cut-offs for iron deficiency vary widely between bodies and studies (the guideline's own review cites thresholds from <12 to <30 µg/L in pregnancy); WHO's are low (high specificity). Other bodies (e.g. gastroenterology guidance) use higher values; those texts were not opened.

    Not encoded: Pregnancy after the first trimester, and pregnancy with infection or inflammation: Table 1 gives no cut-off ('—'), so not assessable. Iron overload thresholds (Table 1 right half) are not encoded. Whether inflammation is present is supplied by the caller; CRP/AGP thresholds and population correction factors (question 4) are not applied.

    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): Iron deficiency Coders only

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

    E61 Deficiency of other nutrient elements: distinguishes E61.1 iron deficiency (without anaemia); the category holds other nutrient-element deficiencies (10 codes in the category).

    • E61.0 Copper deficiency
    • E61.1 Iron deficiency
    • E61.2 Magnesium deficiency
    • E61.3 Manganese deficiency
    • E61.4 Chromium deficiency
    • E61.5 Molybdenum deficiency
    • E61.6 Vanadium deficiency
    • E61.7 Deficiency of multiple nutrient elements
    • E61.8 Deficiency of other specified nutrient elements
    • E61.9 Deficiency of nutrient element, unspecified

    D50 Iron deficiency anemia: distinguishes iron deficiency anaemia (with anaemia): secondary to chronic blood loss, sideropenic dysphagia, other, unspecified (4 codes in the category).

    • D50.0 Iron deficiency anemia secondary to blood loss (chronic)
    • D50.1 Sideropenic dysphagia
    • D50.8 Other iron deficiency anemias
    • D50.9 Iron deficiency anemia, unspecified

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