Skip to main content
DataCrafters synthetic data · demonstration

Coder worklist · Clinician screen · Chart

Staff surface Coder view

P23 KE-P23 · 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-00023 · front-engine 1.2 · replay a1ab1c36b91e98e0…

Library check LRUN-00023 · library_default_set@1.1 · library-engine 1.1 · replay 449061ace2ad2180… · 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: pregnancy on record (problem list, since 2026-05-16): the estimating equations and creatinine thresholds are not validated in pregnancy · 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: pregnancy on record (problem list, since 2026-05-16): the estimating equations and creatinine thresholds are not validated in pregnancy · not assessable
    • Chronic kidney disease stage 3a · needs filtering rate 45-59 on two results at least 90 days apart · record: pregnancy on record (problem list, since 2026-05-16): the estimating equations and creatinine thresholds are not validated in pregnancy · not assessable
    • Chronic kidney disease stage 3b · needs filtering rate 30-44 on two results at least 90 days apart · record: pregnancy on record (problem list, since 2026-05-16): the estimating equations and creatinine thresholds are not validated in pregnancy · not assessable
    • Chronic kidney disease stage 4 · needs filtering rate 15-29 on two results at least 90 days apart · record: pregnancy on record (problem list, since 2026-05-16): the estimating equations and creatinine thresholds are not validated in pregnancy · not assessable
    • Chronic kidney disease stage 5 · needs filtering rate below 15 on two results at least 90 days apart · record: pregnancy on record (problem list, since 2026-05-16): the estimating equations and creatinine thresholds are not validated in pregnancy · 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: pregnancy is on record, and the filtering-rate equation is not reliable then.

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

    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
    Anaemia
    measured

    who2024_anaemia@1.0 Draft · pending review

    Not assessable: needed to choose the population-specific thresholds: context 'trimester' not provided

    • haemoglobin 102 g/L 2026-11-12 09:05 · LM-P23-01

    Window: 30 days before the check.

    Citation

    Anaemia and its severity by haemoglobin (WHO 2024)

    who2024_anaemia@1.0

    In our words: Haemoglobin, adults 15 to 65, adjusted for altitude and smoking: anaemia below 130 g/L in men and below 120 g/L in non-pregnant women; moderate below 110 g/L; severe below 80 g/L. Pregnancy by trimester and children have their own cut-offs.

    World Health Organization, Guideline on haemoglobin cutoffs to define anaemia in individuals and populations (2024) · Executive summary: Table 2 (PDF page 12), Table 3 (PDF page 13), Table 4 (PDF page 14), Table 5 (PDF page 15) · source

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

    Contested: Cut-offs are 5th percentiles of mostly higher-income populations (WHO's own remark); the men's 130 g/L cut-off and severity percentages were debated by the guideline group; CTCAE and laboratory reference ranges use other limits; older adults (>65) are not covered.

    Not encoded: The elevation formula (0.0056384 x elevation + 0.0000003 x elevation²) is not used; the 500 m table rows are. The remark that tailored adjustments may be warranted above 2500 m is not encoded. Adjustment for inflammation/infection (malaria) and for genetic ancestry: WHO recommends none (normative statements 2.b and 2.c); nothing is applied. Type and cause of anaemia (iron deficiency, blood loss, haemolysis) are not assessed. Persons older than 65 years and infants under 6 months: Table 2 gives no cut-off, so they are not assessable. Exactly 20 cigarettes per day: Table 5 lists '10–19' and '>20', so 20 per day is outside the table and not assessable (source gap).

    Not stated

    None entered

    Cannot be assessed

    context

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

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

    D64 Other anemias: distinguishes type of anaemia (sideroblastic, congenital dyserythropoietic, due to antineoplastic chemotherapy, other specified, unspecified) (8 codes in the category).

    • D64.0 Hereditary sideroblastic anemia
    • D64.1 Secondary sideroblastic anemia due to disease
    • D64.2 Secondary sideroblastic anemia due to drugs and toxins
    • D64.3 Other sideroblastic anemias
    • D64.4 Congenital dyserythropoietic anemia
    • D64.81 Anemia due to antineoplastic chemotherapy
    • D64.89 Other specified anemias
    • D64.9 Anemia, unspecified

    D50 Iron deficiency anemia: distinguishes iron deficiency 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

    D62 Acute posthemorrhagic anemia: distinguishes acute posthaemorrhagic anaemia (single code) (1 codes in the category).

    • D62 Acute posthemorrhagic anemia

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