Toward Health Fax Automation¶
Local harness and Cloud Run scaffolding for fax → Elation workflows with plug-and-play OCR/extractors and HIPAA-safe defaults.
Clinic staff: Who does what — MA vs doctor vs mapping list
Quick start (local)¶
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -e ".[dev,local]"
copy .env.example .env
uvicorn faxautomation.main:app --reload
Open http://127.0.0.1:8000 — upload a PDF, select parsers, view structured results.
Documentation map¶
| Topic | Page |
|---|---|
| MA / doctor workflow | Who does what |
| Step-by-step (Tesseract, Docker, GCP) | Your setup checklist |
| Docker one-command dev | Docker |
| Cloud Run deploy (Phase 3c) | Cloud Run |
| Adding/removing parsers | Plugin system |
| API contracts | Data models |
| How we write code | Coding standards |
| REST endpoints | REST API |
| HIPAA local dev | Local HIPAA |
| Path to cloud | Local to cloud |
Related repo docs¶
- PLAN.md — production architecture and rollout
- SECURITY.md — VPC egress, supply chain, CI/CD
- scripts/cloudrun/deploy.md — full
gcloudrunbook
Scope¶
- In scope (docs site): Local harness, plugin system, Cloud Run deploy runbook, HIPAA local rules
- Out of scope on Pages: Live secrets, PHI samples, Cloud Run login password (share out of band)