How kamalesakki/medcode works
MedCode AI is a clinical documentation and revenue-cycle assistant. Its principal workflow takes a consultation or clinical text into a session, extracts a transcript and structured SOAP note, suggests ICD-10/CPT codes, runs claim checks, and leaves final decisions to human reviewers with an audit trail. Supporting capabilities include authentication, case management, dashboards, notifications, performance reporting, and Zoom/Teams integrations. The README documents the end-to-end stages; sampled source confirms session intake, AI extraction, persistence, and review/audit behavior. Other router internals were not sampled, so their detailed calls are not asserted.
Main entry points: main.py FastAPI API · sessions.py Session Intake · database.py Database Access · reviews.py Human Review
Components 21
Clinical Workflow
- Session Intake
backend/routers/sessions.py - Transcripts
backend/routers/transcripts.py - Clinical Notes
backend/routers/clinical_notes.py - Code Suggestions
backend/routers/coding.py - Claim Scrubbing
backend/routers/scrubbing.py - Human Review
backend/routers/reviews.py - Dashboard Metrics
backend/routers/dashboard.py - Assistant
backend/routers/assistant.py
AI Processing
- AI Engine
backend/services/ai_service.py
Platform Services
- FastAPI API
backend/main.py - Authentication
backend/services/auth_service.py - Zoom Connector
backend/services/zoom_service.py - Teams Connector
backend/services/teams_service.py - Operations APIs
backend/routers - Configuration
backend/config.py - API Schemas
backend/schemas
Persistence
- Database Access
backend/database.py - Clinical Records
backend/models - Code Suggestions
backend/models/code_suggestion.py - Review Audits
backend/models/review_audit.py
Other components
- Clinical User
Connections 36
- Clinical User → FastAPI API: uses
README.md - FastAPI API → Session Intake: routes to
backend/main.py - FastAPI API → Transcripts: routes to
backend/main.py - FastAPI API → Clinical Notes: routes to
backend/main.py - FastAPI API → Code Suggestions: routes to
backend/main.py - FastAPI API → Claim Scrubbing: routes to
backend/main.py - FastAPI API → Human Review: routes to
backend/main.py - FastAPI API → Dashboard Metrics: routes to
backend/main.py - FastAPI API → Assistant: routes to
backend/main.py - Session Intake → AI Engine: extracts clinical data
backend/routers/sessions.py - Session Intake → Clinical Records: stores case data
backend/routers/sessions.py - Session Intake → Database Access: queries and writes
backend/routers/sessions.py - Session Intake → Transcripts: captures transcript
- Transcripts → Clinical Notes: informs extraction
README.md - Clinical Notes → Code Suggestions: informs suggestions
README.md - Code Suggestions → Claim Scrubbing: provides codes
README.md - Claim Scrubbing → Human Review: queues for review
README.md - Human Review → Code Suggestions: updates decisions
backend/routers/reviews.py - Human Review → Review Audits: records actions
backend/routers/reviews.py - Human Review → Database Access: commits changes
backend/routers/reviews.py - Dashboard Metrics → Clinical Records: aggregates metrics
backend/routers/dashboard.py - Assistant → Clinical Records: reads and writes
backend/routers/assistant.py - Assistant → Authentication: checks identity
backend/routers/assistant.py - Session Intake → Authentication: checks identity
backend/routers/sessions.py - FastAPI API → Authentication: serves authentication
backend/main.py - FastAPI API → Operations APIs: routes to
backend/main.py - Operations APIs → Zoom Connector: uses connector
backend/routers/zoom.py - Operations APIs → Teams Connector: uses connector
backend/routers/teams.py - Zoom Connector → Configuration: reads settings
backend/services/zoom_service.py - Teams Connector → Zoom Connector: uses integration
backend/services/teams_service.py - Database Access → Configuration: reads database settings
backend/database.py - Clinical Records → Database Access: maps tables
backend/models/session.py - Code Suggestions → Database Access: maps table
backend/models/code_suggestion.py - Review Audits → Database Access: maps table
backend/models/review_audit.py - FastAPI API → API Schemas: validates API data
- AI Engine → Configuration: reads AI settings
backend/services/ai_service.py