Skip to main content
DataCrafters synthetic data · demonstration

Coder worklist · Clinician screen · Chart

Staff surface Coder view

P01 KE-P01 · 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-00001 · front-engine 1.2 · replay ae0b65c3e1dedccb…

Library check LRUN-00001 · library_default_set@1.1 · library-engine 1.1 · replay dd20f6cef210fa30… · 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 3b

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

CKD stage 3b

None entered

Supported and specific

The note says “CKD stage 3b” and two results 200 days apart agree (G3b range, filtering rate 37.0 on 2026-04-26 and 34.8 on 2026-11-12).

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

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

High blood pressure stage 1: 130 to 139 systolic or 80 to 89 diastolic

  • bp diastolic office 78 mmHg 2026-11-12 10:05 · LM-P01-04
  • bp systolic office 132 mmHg 2026-11-12 10:05 · LM-P01-03

Window: 365 days before the check.

Another published definition (esc2024_office_bp@1.0) gives: Elevated BP: office 120–139 systolic or 70–89 diastolic.

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

Not stated

None entered

The record supports it; neither stated in the note nor entered

Draft a query

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.