Clinical coding assistant — interview exercise

Scaffolding for the Senior Software Engineer (IPD) live coding exercise: an assistant that reads visit data (structured or transcript) and suggests CPT billing codes.

Prompts align with:

• Part 1 — Clinical Coding Assistant (Phase 1)
• Part 2 — Transcript parsing (Phase 2)
• Part 3 — Handling uncertainty (Phase 3)

Project layout

File	Purpose
src/types.ts	VisitRecord, ParsedVisit
src/prompt.ts	Optional OpenAI Responses helper (prompt) with structured JSON wiring
src/phase1.ts / phase1.test.ts	Structured visit → CPT codes
src/phase2.ts / phase2.test.ts	Transcript → VisitRecord, then Phase 1 suggestCodes
src/phase3.ts / phase3.test.ts	ParsedVisit + review flag

Starter implementations are stubs; npm run test is expected to fail until you implement logic.

Setup

Clone with HTTPS:

git clone https://github.com/osmind-development-org/coding-exercise.git
cd coding-exercise
npm install

OpenAI API key (later phases)

If you use the included prompt helper:

cp .env.example .env
# Put your OPENAI_API_KEY in .env (provided at interview time).

Run tests

All phases:

npm run test

Individual phases:

npm run test:phase1
npm run test:phase2
npm run test:phase3