Skip to main content
DataCrafters synthetic data · demonstration

Coder worklist · Clinician screen · Chart

Staff surface Coder view

P27 KE-P27 · 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-00027 · front-engine 1.2 · replay c4afe92815bdc4bc…

Library check LRUN-00027 · library_default_set@1.1 · library-engine 1.1 · replay 9290d4fca0df016b… · 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

Record meets: Chronic kidney disease stage 3a

  • Filtering rate 51.5 on 2026-07-17 (G3a range) and 47.6 on 2026-11-12 (G3a range) · L-0060
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 51.5 on 2026-07-17 and 47.6 on 2026-11-12 (G3a range) · not met
  • 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 51.5 on 2026-07-17 and 47.6 on 2026-11-12 (G3a range) · not met
  • Chronic kidney disease stage 3a · needs filtering rate 45-59 on two results at least 90 days apart · record: filtering rate 51.5 on 2026-07-17 and 47.6 on 2026-11-12 (G3a range) · met
  • Chronic kidney disease stage 3b · needs filtering rate 30-44 on two results at least 90 days apart · record: filtering rate 51.5 on 2026-07-17 and 47.6 on 2026-11-12 (G3a range) · not met
  • Chronic kidney disease stage 4 · needs filtering rate 15-29 on two results at least 90 days apart · record: filtering rate 51.5 on 2026-07-17 and 47.6 on 2026-11-12 (G3a range) · not met
  • Chronic kidney disease stage 5 · needs filtering rate below 15 on two results at least 90 days apart · record: filtering rate 51.5 on 2026-07-17 and 47.6 on 2026-11-12 (G3a range) · 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).

Chronic kidney disease stage 4

None entered

Supported, but entered or stated less specifically than the record supports

The note says “Chronic kidney disease stage 4”; two results 118 days apart are in the G3a range (filtering rate 51.5 on 2026-07-17 and 47.6 on 2026-11-12), not the stage written.

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

Draft a query

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 reading with all of bp_systolic_office, bp_diastolic_office recorded at the same time; no usable bp_diastolic_office measurement; no usable bp_systolic_office measurement

Window: 365 days before the check.

Another published definition (esc2024_office_bp@1.0) gives: not assessable.

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

None entered

Cannot be assessed

no_value

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.