Skip to main content
DataCrafters synthetic data · demonstration

Coder worklist · Clinician screen · Chart

Staff surface Coder view

P09 KE-P09 · 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-00009 · front-engine 1.2 · replay e49065c27285a366…

Library check LRUN-00009 · library_default_set@1.1 · library-engine 1.1 · replay 68090963ecf6e3fe… · Data (JSON)

Core definitions 2

Core definitions: condition families for this encounter (2)
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 53.6 on 2026-11-11); 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 53.6 on 2026-11-11); 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 53.6 on 2026-11-11); 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 53.6 on 2026-11-11); 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 53.6 on 2026-11-11); 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 53.6 on 2026-11-11); 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 53.6 on 2026-11-11); a repeat at least 90 days later is needed.

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

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

    Hypertension
    measured

    nhlbi_bp_categories@1.0 Draft · pending review

    Not assessable: no measurement in the window

    • bp diastolic office 90 mmHg 2026-11-11 14:05 · LM-P09-02
    • bp systolic office 146 mmHg 2026-11-11 14:05 · LM-P09-01

    Window: 365 days before the check.

    Another published definition (esc2024_office_bp@1.0) gives: Hypertension: office ≥140/90 mmHg.

    Citation

    Adult blood pressure categories: normal, elevated, stage 1, stage 2 (NHLBI, as in the 2017/2025 ACC/AHA guidelines)

    nhlbi_bp_categories@1.0

    In our words: Adult blood pressure (mm Hg): normal below 120/80; elevated 120 to 129 systolic with diastolic below 80; stage 1 130 to 139 or 80 to 89; stage 2 140 or higher or 90 or higher; crisis range above 180 or above 120. Diagnosis needs readings at two or more separate visits.

    Normal: Less than 120 systolic AND Less than 80 diastolic; Elevated: 120 to 129 AND Less than 80; Stage 1: 130 to 139 OR 80 to 89; Stage 2: 140 or higher OR 90 or higher; Hypertensive Crisis: Higher than 180 OR Higher than 120

    National Heart, Lung, and Blood Institute (U.S. National Institutes of Health), High Blood Pressure — Diagnosis (2025) · Blood pressure categories table · source

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

    Contested: European guidelines define hypertension at 140/90 (ESC 2024, encoded separately as esc2024_office_bp) while AHA/ACC use 130/80.

    Not encoded: Measurement technique (seated, rested, correct cuff), averaging of several readings per visit, out-of-office (home, ambulatory) thresholds, white-coat and masked hypertension are not encoded. The 2025 AHA/ACC guideline's own table was not opened; the categories are taken from the NHLBI page. Children and adolescents are not covered (population limited to 18 and older as an interpretation).

    hypertension

    Elevated blood pressure

    None entered

    Cannot be assessed

    single

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

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

    I10 Essential (primary) hypertension: distinguishes essential (primary) hypertension (one code); hypertension with heart or kidney disease uses I11-I13 (1 codes in the category).

    • I10 Essential (primary) hypertension

    R03 Abnormal blood-pressure reading, without diagnosis: distinguishes R03.0 elevated blood-pressure reading without diagnosis of hypertension; R03.1 nonspecific low reading (2 codes in the category).

    • R03.0 Elevated blood-pressure reading, without diagnosis of hypertension
    • R03.1 Nonspecific low blood-pressure reading

    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.