Skip to main content
DataCrafters synthetic data · demonstration

Coder worklist · Clinician screen · Chart

Staff surface Coder view

P13 KE-P13 · 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-00013 · front-engine 1.2 · replay ccc114df24793a9a…

Library check LRUN-00013 · library_default_set@1.1 · library-engine 1.1 · replay 1b97a66cf4b35934… · 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: filtering rate 60 or above; needs a kidney damage marker (no persistent albuminuria 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: filtering rate 60 or above; needs a kidney damage marker (no persistent albuminuria on file) · not assessable
    • Chronic kidney disease stage 3a · needs filtering rate 45-59 on two results at least 90 days apart · record: results at least 90 days apart are 60 or above · not met
    • Chronic kidney disease stage 3b · needs filtering rate 30-44 on two results at least 90 days apart · record: results at least 90 days apart are 60 or above · not met
    • Chronic kidney disease stage 4 · needs filtering rate 15-29 on two results at least 90 days apart · record: results at least 90 days apart are 60 or above · not met
    • Chronic kidney disease stage 5 · needs filtering rate below 15 on two results at least 90 days apart · record: results at least 90 days apart are 60 or above · not met
    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

    N18.31 CKD stage 3a (from an outside lab report) (encounter diagnosis list)

    Cannot be assessed

    The two filtering-rate equations give different answers for these results (2021 equation: threshold not met; 2009 equation: threshold met, G3a). The tool does not choose.

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

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

    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 % 2026-11-12 13:05 · LM-P13-02

    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.

    Prediabetes

    R73.03 Prediabetes (visit diagnosis list (synthetic))

    Supported and specific

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

    Diabetes mellitus
    measured

    ada2026_diabetes@1.0 Draft · pending review

    Criteria not met

    • hba1c 6 % 2026-11-12 13:05 · LM-P13-02

    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.

    Not stated

    None entered

    Nothing to act on

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

    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.