6
def _now_iso() -> str:
return datetime.utcnow().replace(microsecond=0).isoformat() + "Z"
def _stable_id(prefix: str, seed: str) -> str:
h = hashlib.sha256(seed.encode("utf-8")).hexdigest()(:10)
return f"{prefix}_{h}"
class MockEHR:
def __init__(self):
self.orders_queue: List(SurgeryOrder) = ()
self.patient_docs: Dict(str, List(ClinicalDocument)) = {}
def seed_data(self, n_orders: int = 5):
random.seed(7)
def make_patient(i: int) -> Patient:
pid = f"PT{i:04d}"
plan = random.choice(list(InsurancePlan))
return Patient(
patient_id=pid,
name=f"Patient {i}",
dob="1980-01-01",
member_id=f"M{i:08d}",
plan=plan,
)
def docs_for_order(patient: Patient, surgery: SurgeryType) -> List(ClinicalDocument):
base = (
ClinicalDocument(
doc_id=_stable_id("DOC", patient.patient_id + "H&P"),
doc_type=DocType.H_AND_P,
created_at=_now_iso(),
content="H&P: Relevant history, exam findings, and surgical indication.",
source="EHR",
),
ClinicalDocument(
doc_id=_stable_id("DOC", patient.patient_id + "NOTE"),
doc_type=DocType.CLINICAL_NOTE,
created_at=_now_iso(),
content="Clinical note: Symptoms, conservative management attempted, clinician assessment.",
source="EHR",
),
ClinicalDocument(
doc_id=_stable_id("DOC", patient.patient_id + "MEDS"),
doc_type=DocType.MED_LIST,
created_at=_now_iso(),
content="Medication list: Current meds, allergies, contraindications.",
source="EHR",
),
)
maybe = ()
if surgery in (SurgeryType.KNEE_ARTHROPLASTY, SurgeryType.SPINE_FUSION, SurgeryType.BARIATRIC):
maybe.append(
ClinicalDocument(
doc_id=_stable_id("DOC", patient.patient_id + "LABS"),
doc_type=DocType.LABS,
created_at=_now_iso(),
content="Labs: CBC/CMP within last 30 days.",
source="LabSystem",
)
)
if surgery in (SurgeryType.SPINE_FUSION, SurgeryType.KNEE_ARTHROPLASTY):
maybe.append(
ClinicalDocument(
doc_id=_stable_id("DOC", patient.patient_id + "IMG"),
doc_type=DocType.IMAGING,
created_at=_now_iso(),
content="Imaging: MRI/X-ray report supporting diagnosis and severity.",
source="Radiology",
)
)
final = base + (d for d in maybe if random.random() > 0.35)
if random.random() > 0.6:
final.append(
ClinicalDocument(
doc_id=_stable_id("DOC", patient.patient_id + "PRIOR_TX"),
doc_type=DocType.PRIOR_TX,
created_at=_now_iso(),
content="Prior treatments: PT, meds, injections tried over 6+ weeks.",
source="EHR",
)
)
if random.random() > 0.5:
final.append(
ClinicalDocument(
doc_id=_stable_id("DOC", patient.patient_id + "CONSENT"),
doc_type=DocType.CONSENT,
created_at=_now_iso(),
content="Consent: Signed procedure consent and risk disclosure.",
source="EHR",
)
)
return final
for i in range(1, n_orders + 1):
patient = make_patient(i)
surgery = random.choice(list(SurgeryType))
order = SurgeryOrder(
order_id=_stable_id("ORD", patient.patient_id + surgery.value),
patient=patient,
surgery_type=surgery,
scheduled_date=(datetime.utcnow().date() + timedelta(days=random.randint(3, 21))).isoformat(),
ordering_provider_npi=str(random.randint(1000000000, 1999999999)),
diagnosis_codes=("M17.11", "M54.5") if surgery != SurgeryType.CATARACT else ("H25.9"),
created_at=_now_iso(),
)
self.orders_queue.append(order)
self.patient_docs(patient.patient_id) = docs_for_order(patient, surgery)
def poll_new_surgery_orders(self, max_n: int = 1) -> List(SurgeryOrder):
pulled = self.orders_queue(:max_n)
self.orders_queue = self.orders_queue(max_n:)
return pulled
def get_patient_documents(self, patient_id: str) -> List(ClinicalDocument):
return list(self.patient_docs.get(patient_id, ()))
def fetch_additional_docs(self, patient_id: str, needed: List(DocType)) -> List(ClinicalDocument):
generated = ()
for dt in needed:
generated.append(
ClinicalDocument(
doc_id=_stable_id("DOC", patient_id + dt.value + str(time.time())),
doc_type=dt,
created_at=_now_iso(),
content=f"Auto-collected document for {dt.value}: extracted and formatted per payer policy.",
source="AutoCollector",
)
)
self.patient_docs.setdefault(patient_id, ()).extend(generated)
return generated
class MockPayerPortal:
def __init__(self):
self.db: Dict(str, Dict(str, Any)) = {}
random.seed(11)
def required_docs_policy(self, plan: InsurancePlan, surgery: SurgeryType) -> List(DocType):
base = (DocType.H_AND_P, DocType.CLINICAL_NOTE, DocType.MED_LIST)
if surgery in (SurgeryType.SPINE_FUSION, SurgeryType.KNEE_ARTHROPLASTY):
base += (DocType.IMAGING, DocType.LABS, DocType.PRIOR_TX)
if surgery == SurgeryType.BARIATRIC:
base += (DocType.LABS, DocType.PRIOR_TX)
if plan in (InsurancePlan.PAYER_BETA, InsurancePlan.PAYER_GAMMA):
base += (DocType.CONSENT)
return sorted(list(set(base)), key=lambda x: x.value)
def submit(self, pa: PriorAuthRequest) -> PayerResponse:
payer_ref = _stable_id("PAYREF", pa.request_id + _now_iso())
docs_present = {d.doc_type for d in pa.docs_attached}
required = self.required_docs_policy(pa.order.patient.plan, pa.order.surgery_type)
missing = (d for d in required if d not in docs_present)
self.db(payer_ref) = {
"status": AuthStatus.SUBMITTED,
"order_id": pa.order.order_id,
"plan": pa.order.patient.plan,
"surgery": pa.order.surgery_type,
"missing": missing,
"polls": 0,
"submitted_at": _now_iso(),
"denial_reason": None,
}
msg = "Submission received. Case queued for review."
if missing:
msg += " Initial validation indicates incomplete documentation."
return PayerResponse(status=AuthStatus.SUBMITTED, payer_ref=payer_ref, message=msg)
def check_status(self, payer_ref: str) -> PayerResponse:
if payer_ref not in self.db:
return PayerResponse(
status=AuthStatus.DENIED,
payer_ref=payer_ref,
message="Case not found (possible payer system error).",
denial_reason=DenialReason.OTHER,
confidence=0.4,
)
case = self.db(payer_ref)
case("polls") += 1
if case("status") == AuthStatus.SUBMITTED and case("polls") >= 1:
case("status") = AuthStatus.IN_REVIEW
if case("status") == AuthStatus.IN_REVIEW and case("polls") >= 3:
if case("missing"):
case("status") = AuthStatus.DENIED
case("denial_reason") = DenialReason.MISSING_DOCS
else:
roll = random.random()
if roll < 0.10:
case("status") = AuthStatus.DENIED
case("denial_reason") = DenialReason.CODING_ISSUE
elif roll < 0.18:
case("status") = AuthStatus.DENIED
case("denial_reason") = DenialReason.MEDICAL_NECESSITY
else:
case("status") = AuthStatus.APPROVED
if case("status") == AuthStatus.DENIED:
dr = case("denial_reason") or DenialReason.OTHER
missing = case("missing") if dr == DenialReason.MISSING_DOCS else ()
conf = 0.9 if dr != DenialReason.OTHER else 0.55
return PayerResponse(
status=AuthStatus.DENIED,
payer_ref=payer_ref,
message=f"Denied. Reason={dr.value}.",
denial_reason=dr,
missing_docs=missing,
confidence=conf,
)
if case("status") == AuthStatus.APPROVED:
return PayerResponse(
status=AuthStatus.APPROVED,
payer_ref=payer_ref,
message="Approved. Authorization issued.",
confidence=0.95,
)
return PayerResponse(
status=case("status"),
payer_ref=payer_ref,
message=f"Status={case('status').value}. Polls={case('polls')}.",
confidence=0.9,
)
def file_appeal(self, payer_ref: str, appeal_text: str, attached_docs: List(ClinicalDocument)) -> PayerResponse:
if payer_ref not in self.db:
return PayerResponse(
status=AuthStatus.DENIED,
payer_ref=payer_ref,
message="Appeal failed: case not found.",
denial_reason=DenialReason.OTHER,
confidence=0.4,
)
case = self.db(payer_ref)
docs_present = {d.doc_type for d in attached_docs}
still_missing = (d for d in case("missing") if d not in docs_present)
case("missing") = still_missing
case("status") = AuthStatus.APPEALED
case("polls") = 0
msg = "Appeal submitted and queued for review."
if still_missing:
msg += f" Warning: still missing {', '.join((d.value for d in still_missing))}."
return PayerResponse(status=AuthStatus.APPEALED, payer_ref=payer_ref, message=msg, confidence=0.9)