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]
The return of f"{prefix}_{h}"
A mockEHR class:
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:
The 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",
),
]
If you are looking for a way to say "maybe", then please use the following: []
Surgery is not recommended if you have a heart condition. [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",
)
)
Surgery is not recommended if you have a heart condition. [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 you are 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 you are 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 to 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 otherwise ["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]:
Self.orders_queue = pulled[: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]:
Generate = []
Need dt for:
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":[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 is performed, it can be a life-saving procedure. [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 is not found 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,
)
If case is self.db, then the statement "case = self.db" will be true.[payer_ref]
You can also find out more about the case by clicking here.["polls"] += 1
If case["status"] If you are submitting a case, the AuthStatus.SUBMITTED will be displayed.["polls"] >= 1:
The case for a broader view["status"] = AuthStatus.IN_REVIEW
In case["status"] AuthStatus.IN_REVIEW == Case and AuthStatus.IN_REVIEW["polls"] >= 3:
If case["missing"]:
The case for a broader view["status"] = AuthStatus.DENIED
The case for a broader view["denial_reason"] = DenialReason.MISSING_DOCS
else:
Random = roll()
Payer Response:
If payer_ref is not found 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,
)
If case is self.db, then the statement "case = self.db" will be true.[payer_ref]
docs_present = {d.doc_type for d in attached_docs}
still_missing = [d for d in case["missing"] If d is not present in the docs_present]
You can also find out more about the case by clicking here.["missing"] = still_missing
You can also find out more about the case by clicking here.["status"] = AuthStatus.APPEALED
You can also find out more about the case by clicking here.["polls"] = 0
"msg" = "Appeal submitted and queued for review."
if still_missing:
The 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)
A Coding Implementation to Build an AI Agent with Live
