{"data":{"name":"Phase A Healthcare Governance API Architecture","purpose":"System-to-system medication safety governance with deterministic validation, explainable decisions, escalation status, and immutable audit evidence.","interface_contract":{"style":"REST JSON API","base_path":"\/api\/v1","content_type":"application\/json","intended_consumers":["hospital portals","EMR\/EHR systems","mobile apps","admin systems","audit\/reporting tools","third-party healthcare platforms"]},"layers":[{"layer":"Client Systems","components":["Doctor systems","Admin systems","Auditor systems","External healthcare platforms"]},{"layer":"API Edge","components":["JSON request validation","routing","future token-based identity\/RBAC"]},{"layer":"Governance Services","components":["Prescription check API","Override workflow service","Rule management service","Audit query API"]},{"layer":"Decision Core","components":["Domain entities","deterministic rule engine","AI-ready assessment adapter","risk\/status classifier"]},{"layer":"Storage","components":["MySQL operational database","append-only hashed audit events","Laravel-managed cache\/queue runtime"]}],"endpoints":[{"method":"GET","path":"\/api\/v1\/architecture","description":"API architecture and integration contract."},{"method":"POST","path":"\/api\/v1\/prescription-checks","description":"Submit a medication safety check and receive a machine-readable governance decision."},{"method":"GET","path":"\/api\/v1\/prescription-checks\/{id}","description":"Read a previous governance decision with patient snapshot and audit events."},{"method":"GET","path":"\/api\/v1\/audit-events","description":"Read append-only audit events for external audit\/reporting systems."},{"method":"GET","path":"\/api\/v1\/rules","description":"Read active\/versioned clinical governance rules."}],"sample_request":{"patient_reference":"PT-API-1001","patient_name":"API Patient","allergies":["Penicillin"],"current_medications":["Warfarin"],"prescribed_medications":["Aspirin"],"actor_name":"External System Doctor","actor_role":"Doctor"}}}