Skip to main content
DataCrafters synthetic data · demonstration

Coder worklist · Clinician screen · Chart

Staff surface Coder view

P24 KE-P24 · 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-00024 · front-engine 1.2 · replay 48d48c9a1a41cf90…

Library check LRUN-00024 · library_default_set@1.1 · library-engine 1.1 · replay 18ab0f8b40fa40ad… · Data (JSON)

Core definitions 3

Core definitions: condition families for this encounter (3)
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: limb amputation on record (procedure history, since 2018-08-25): reduced muscle mass lowers creatinine, so the equation overestimates kidney filtering · 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: limb amputation on record (procedure history, since 2018-08-25): reduced muscle mass lowers creatinine, so the equation overestimates kidney filtering · not assessable
    • Chronic kidney disease stage 3a · needs filtering rate 45-59 on two results at least 90 days apart · record: limb amputation on record (procedure history, since 2018-08-25): reduced muscle mass lowers creatinine, so the equation overestimates kidney filtering · not assessable
    • Chronic kidney disease stage 3b · needs filtering rate 30-44 on two results at least 90 days apart · record: limb amputation on record (procedure history, since 2018-08-25): reduced muscle mass lowers creatinine, so the equation overestimates kidney filtering · not assessable
    • Chronic kidney disease stage 4 · needs filtering rate 15-29 on two results at least 90 days apart · record: limb amputation on record (procedure history, since 2018-08-25): reduced muscle mass lowers creatinine, so the equation overestimates kidney filtering · not assessable
    • Chronic kidney disease stage 5 · needs filtering rate below 15 on two results at least 90 days apart · record: limb amputation on record (procedure history, since 2018-08-25): reduced muscle mass lowers creatinine, so the equation overestimates kidney filtering · 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: limb amputation 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-000020

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

    Diabetes mellitus
    measured

    ada2026_diabetes@1.0 Draft · pending review

    Criteria not met

    • hba1c 6.1 % 2026-11-01 09:00 · LM-P24-01

    Window: 730 days before the check.

    Citation

    Diabetes diagnostic thresholds and the confirmation rule (ADA Standards of Care 2026)

    ada2026_diabetes@1.0

    In our words: Diabetes range: HbA1c 6.5% or higher, fasting glucose 126 mg/dL or higher, or 2-hour glucose 200 mg/dL or higher on a glucose tolerance test; two such results are needed (two different tests, or one test repeated). A random glucose of 200 mg/dL or higher counts on its own only with typical symptoms.

    Usually, your doctor will use a second test to confirm you have diabetes.

    National Institute of Diabetes and Digestive and Kidney Diseases (NIDDK), Diabetes Tests & Diagnosis (2022) · Section 'What test results tell me if I have diabetes or prediabetes?', table of test results · source

    Licence: U.S. government work (public domain); confirmation counting: two results, from different tests or one test repeated: fact only citation. Source checked: opened. No endorsement by the cited bodies is implied.

    Not encoded: Type of diabetes (type 1, type 2, other) is not assessed. Conditions that make A1C unreliable (some haemoglobin variants, pregnancy, G6PD deficiency, HIV, anaemia, haemodialysis, erythropoietin; recommendation 2.4 and text) are not checked: A1C results are used as sent. No maximum interval between the two abnormal results is stated by the source and none is applied. Whether the test method is NGSP-certified and whether a fasting sample was truly fasting are asserted by the sender through the analyte name. When two different tests are discordant ADA advises repeating the abnormal test; this entry simply reports one abnormal result.

    diabetes

    None entered

    Cannot be assessed

    Treatment lowers HbA1c and glucose: values below the diagnostic thresholds cannot show that a stated condition is unsupported.

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

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

    E11 Type 2 diabetes mellitus: distinguishes type 2 diabetes with or without complications by body system (kidney, eye, nerve, circulatory, skin, oral, hypoglycaemia, hyperglycaemia, ketoacidosis, hyperosmolarity), long-term drug use is separate (Z79) (87 codes in the category).

    87 codes; see the official files

    E10 Type 1 diabetes mellitus: distinguishes type 1 diabetes with the same complication axes as E11 (87 codes in the category).

    87 codes; see the official files

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

    Prediabetes
    measured

    ada2026_prediabetes@1.0 Draft · pending review

    Prediabetes range (A1C 5.7–6.4%, IFG 100–125 mg/dL or IGT 140–199 mg/dL)

    • hba1c 6.1 % 2026-11-01 09:00 · LM-P24-01

    Window: 365 days before the check.

    Citation

    Prediabetes ranges (ADA Standards of Care 2026)

    ada2026_prediabetes@1.0

    In our words: Intermediate range: HbA1c 5.7% to 6.4%, fasting glucose 100 to 125 mg/dL, or 2-hour glucose 140 to 199 mg/dL.

    National Institute of Diabetes and Digestive and Kidney Diseases (NIDDK), Diabetes Tests & Diagnosis (2022) · Section 'What test results tell me if I have diabetes or prediabetes?', table of test results · source

    Licence: U.S. government work (public domain). Source checked: opened. No endorsement by the cited bodies is implied.

    Contested: Other bodies (for example WHO) are understood to use a different impaired fasting glucose range and not to use an A1C prediabetes range; those texts were not opened, so no other thresholds are recorded. Review item.

    Not encoded: ADA does not require confirmation for prediabetes in Table 2.2; none is applied. A1C reliability conditions are not checked (see ada2026_diabetes). Only the most recent result of each test is used.

    Not stated

    None entered

    Nothing to act on

    a related condition is stated, so no item is raised here

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

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

    R73 Elevated blood glucose level: distinguishes R73.01 impaired fasting glucose, R73.02 impaired glucose tolerance (oral), R73.03 prediabetes, R73.09 other abnormal glucose, R73.9 hyperglycaemia unspecified (5 codes in the category).

    • R73.01 Impaired fasting glucose
    • R73.02 Impaired glucose tolerance (oral)
    • R73.03 Prediabetes
    • R73.09 Other abnormal glucose
    • R73.9 Hyperglycemia, unspecified

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

    Extended capabilities (licence required before commercial use) 0

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

    Nothing in this section for this encounter.