Production-ready AI-powered desktop application that helps clinical therapists validate Medicare compliance before claims submission.
Gold Standard Status: Verified & Optimized for Local Execution.
- 100% test pass rate across all critical modules
- Fixed authentication test suite with proper pytest environment handling
- Resolved datetime patching issues in accuracy enhancement modules
- Stabilized RAG fact checker and transformers backend tests
- Added PyTorch 2.9.1 support for advanced ML features
- Optimized test execution with proper async cleanup
- Enhanced error handling in LLM backends
- Improved memory management for large document processing
- Updated dependency versions for security patches
- Enhanced PHI scrubbing with better entity detection
- Improved database connection handling
- Added comprehensive security scanning with Bandit
The entire application can be launched with a single script that handles environment setup and dependency installation.
- Double-click
LAUNCH.bat.- This will check for Python and Node.js.
- It will create the virtual environment and install dependencies if needed.
- It optimizes the environment for offline/local stability.
- It launches the Backend API and the Desktop Application.
- Intelligent Document Analysis - supports PDF/DOCX/TXT with OCR, rubric-based scoring, and deterministic rule checks.
- Modern Interface - Electron + React desktop experience with real-time progress, AI chat, and WCAG-compliant theming.
- Enterprise Security - PHI scrubbing, encrypted storage, JWT auth, rate limiting, and incident tracking.
- Reporting & Analytics - interactive HTML/PDF exports, rubric management, historical trends, and audit trails.
- Offline-First - Optimized for local execution without external dependencies or Docker.
- Consolidated Startup:
LAUNCH.batreplaces multiple fragmented scripts. - Code Quality: Gold Standard review applied to Core Services and API.
- Documentation: Enhanced docstrings and JSDoc for maintainability.
- Production Ready: Comprehensive operational documentation and compliance research complete.
ElectroAnalyzer is production-ready with comprehensive operational documentation:
- Manual Update Process - Step-by-step Windows update instructions
- Cutover Checklist - 3-phase deployment plan for pilot launch
- Common Issues Runbook - Troubleshooting for 10+ common scenarios
- Incident Response Playbook - 4-severity incident management
- Rollback Procedures - Emergency rollback triggers and procedures
- Hypercare Plan - 30-day post-launch intensive support
- Bug Triage Process - Bug classification and patch release cadence
- Feedback Process - User feedback collection and processing
- Medicare Part B Compliance - CMS requirements for PT/OT/SLP
- MAC & State Requirements - Regional variations by Medicare contractor
- FAQ - 35+ frequently asked questions covering installation, usage, troubleshooting, security, and performance
- Common Issues Runbook - Diagnostic steps and resolutions
- Email: [email protected]
- Emergency Hotline: [Contact your deployment lead]
- Documentation: See
docs/operations/for complete runbooks
# Basic health check
Invoke-WebRequest -Uri "http://localhost:8001/health"
# Detailed system health
Invoke-WebRequest -Uri "http://localhost:8001/api/v2/system/health"- Backend:
src/(FastAPI, Python) - Frontend:
frontend/electron-react-app/(Electron, React, TypeScript) - Tests:
pytest(Backend),npm test(Frontend)
ElectroAnalyzer is built to keep clinical teams ahead of regulatory audits--deploy with confidence.
If you use PowerShell, Git Bash (MSYS/WSL), or cmd.exe on Windows, follow the short developer guide in docs/DEVELOPER_PRECOMMIT_GUIDE.md for exact activation and hook regeneration steps. Briefly:
- Activate the repository venv (PowerShell):
& .\venv\Scripts\Activate.ps1- Install pre-commit and hooks:
python -m pip install -r requirements-dev.txt
python -m pip install pre-commit
python -m pre_commit install --install-hooks- Test hooks across the repo:
python -m pre_commit run --all-filesIf you prefer, regenerate a cmd.exe-friendly hook (or ask me to create a helper script). See docs/DEVELOPER_PRECOMMIT_GUIDE.md for details.