Midoc Clinical Copilot (Cortex)

Desktop-first clinical copilot UI for doctors during live consultations. Chat-first notes experience with tool-run transparency, patient visit selection, clinic-scoped auth, and interactive vitals graphs.

Handoff documentation

Start here if you are new to this repo:

→ docs/README.md
→ docs/handoff/README.md

Author of the changes documented for handoff: tanish-tci (tanishk@thecloudintelligence.com), June 2026.

Stack

• React 19 + TypeScript
• Vite 8 (outDir: build)
• Tailwind CSS 4
• Zustand (auth + chat + consultation state)
• Recharts (vitals)
• react-markdown + Radix UI primitives (shadcn-style components)

Quick start

npm install
cp .env.example .env
npm run dev

Open http://localhost:5173.

Demo without backend

# .env
VITE_USE_MOCK=true

Sign in with any credentials. Use patient picker and/or ask for vitals/graph. Optionally use Load demo flow when available.

Connect to agent API

# .env
VITE_AGENT_API_URL=http://localhost:8080
VITE_USE_MOCK=false

Clinic/branch scope comes from /v1/auth/signin (not env vars).

Endpoints used:

• GET /health — connection check on load
• POST /v1/auth/signin — doctor login
• GET /v1/patients/search — visit search
• POST /v1/chat — message history round-trip
• GET /v1/meta — tools list (implemented; settings UI removed)

Current layout

Authenticated shell is chat-first:

1. Top bar (logo, patient picker, logout)
2. Full-width notes chat (NotesChatPanel)

Older three-column components may still exist under src/ but are not mounted. See docs/reference/orphaned-code.md.

Key components (live)

Component	Path
LoginScreen	src/components/auth/LoginScreen.tsx
NotesChatPanel	src/components/consultation/NotesChatPanel.tsx
PatientPickerModal	src/components/modals/PatientPickerModal.tsx
ToolRunCard	src/components/chat/ToolRunCard.tsx
VitalsChart	src/components/clinical/VitalsChart.tsx
ConfirmActionCard	src/components/clinical/ConfirmActionCard.tsx

Scripts

Command	Description
npm run dev	Development server
npm run build	Production build → build/
npm run lint	ESLint
npm run preview	Preview production build

CI

Azure Pipelines (azure-pipelines.yml): Node 22 → npm ci → lint → build → publish artifact drop from build/. Details in docs/infrastructure/azure-pipelines.md.