flowchart TD
    N1(["Patient arrives at Patient Web Application"])
    N2["Age Verification Gate validates patient age for cannabis content access"]
    N1 --> N2
    N3["Patient completes Account Creation Flow and Onboarding Questionnaire"]
    N2 --> N3
    N4["Patient explores products via Kinloch Wheel and Product Browse Page with personalized recommendations"]
    N3 --> N4
    N5["Patient adds products to Shopping Cart and attempts checkout"]
    N4 --> N5
    N6["Gram Equivalency Calculator validates gram total against Cannabis Act limits"]
    N5 --> N6
    N7["Checkout Gate blocks purchase — no authorization"]
    N6 --> N7
    N8["Patient initiates AI voice clinical intake via Questionnaire Engine"]
    N7 --> N8
    N9["Clinical Summary Generator produces structured summary via AI / LLM Provider"]
    N8 --> N9
    N10["NP Workflow Service assigns case to available Nurse Practitioner"]
    N9 --> N10
    N11["Nurse Practitioner reviews case in Case Review Interface and approves via Decision Workflow"]
    N10 --> N11
    N12["Medical Document Generator produces Part 14 authorization document with e-signature"]
    N11 --> N12
    N13["Authorization Status API updates patient to active authorization with expiry date"]
    N12 --> N13
    N14["Patient receives authorization notification and returns to Shopping Cart"]
    N13 --> N14
    N15["Checkout Gate re-runs gram check and unlocks checkout"]
    N14 --> N15
    N16["Shopify processes payment via embedded buy flow and initiates fulfillment"]
    N15 --> N16
    N17["Patient Dashboard displays active authorization, order status, and tracking"]
    N16 --> N17
    N18(["Compliance Audit Trail records full audit trail"])
    N17 --> N18
  

flowchart TD
    N1(["Patient arrives at Patient Web Application and encounters Age Verification Gate"])
    N2["Age Verification Gate validates patient meets age requirement for cannabis content"]
    N1 --> N2
    N3["Patient begins Account Creation Flow — 4-screen progressive form (identity + onboarding)"]
    N2 --> N3
    N4["Account Creation Flow collects identity fields required for registration"]
    N3 --> N4
    N5["Onboarding Questionnaire captures patient needs and preferences to seed personalized discovery"]
    N4 --> N5
    N6["Auth Service sends email verification and creates account in Application Database"]
    N5 --> N6
    N7["Patient confirms email and completes registration"]
    N6 --> N7
    N8["Patient Registration Engine generates internal patient identifier and stores registration in Application Database"]
    N7 --> N8
    N9{"Patient sets up Two-Step Verification"}
    N8 --> N9
    N10["Auth Service sends verification code via SMS Provider"]
    N9 -->|if: SMS verification| N10
    N11(["Patient enters SMS code to confirm"])
    N10 --> N11
    N12["Auth Service generates QR code for authenticator app setup"]
    N9 -->|if: authenticator app| N12
    N13(["Patient scans QR and confirms with generated code"])
    N12 --> N13
    N14["Patient accesses Patient Dashboard showing account status, empty order history, and authorization state (none)"]
    N15(["Compliance Audit Trail records account creation and consent events"])
    N14 --> N15
  

flowchart TD
    N1(["Patient opens Patient Web Application and navigates to Login & Session Management"])
    N2["Patient enters email and password"]
    N1 --> N2
    N3{"Auth Service validates credentials against Application Database"}
    N2 --> N3
    N4["Auth Service prompts for Two-Step Verification"]
    N3 -->|if: credentials valid| N4
    N5["Patient completes 2FA via SMS code or authenticator app"]
    N4 --> N5
    N6["Auth Service establishes persistent session"]
    N5 --> N6
    N7(["Patient lands on Patient Dashboard with auth status and order history"])
    N6 --> N7
    N8["Auth Service increments failed attempt counter"]
    N3 -->|if: credentials invalid| N8
    N9(["Login & Session Management displays error and allows retry"])
    N8 --> N9
    N10["Auth Service blocks login after excessive failed attempts"]
    N3 -->|if: account locked| N10
    N11(["Login & Session Management displays lockout message with recovery options"])
    N10 --> N11
  

flowchart TD
    N1(["Patient opens Patient Web Application and lands on the Kinloch Wheel"])
    N2["Kinloch Wheel personalizes exploration using Onboarding Questionnaire responses captured during registration"]
    N1 --> N2
    N3["Discovery Service generates real-time product recommendations based on patient selections and onboarding preferences"]
    N2 --> N3
    N4["Patient browses recommended products on Product Browse Page with filters and detail pages"]
    N3 --> N4
    N5["Patient adds products to Shopping Cart"]
    N4 --> N5
    N6["Shopping Cart persists cart state via Commerce Service"]
    N5 --> N6
    N7["Patient proceeds to checkout, hitting the Checkout Gate"]
    N6 --> N7
    N8{"Gram Equivalency Calculator validates cart gram-equivalent total against Cannabis Act per-order l..."}
    N7 --> N8
    N9(["Checkout Gate queries Authorization Status API for auth state"])
    N8 -->|if: within limit| N9
    N10(["Checkout Gate blocks purchase with clear gram-limit message and cart-adjustment prompt"])
    N8 -->|if: exceeds limit| N10
    N11{"Checkout Gate evaluates authorization state"}
    N12["Checkout Gate unlocks and redirects to Shopify embedded buy flow"]
    N11 -->|if: active authorization| N12
    N13["Shopify processes payment and initiates fulfillment (Kinloch-selected provider, integrated through Shopify)"]
    N12 --> N13
    N14["Order & Fulfillment Service retrieves order data from Shopify"]
    N13 --> N14
    N15(["Patient Dashboard displays order status and tracking"])
    N14 --> N15
    N16["Checkout Gate blocks purchase and prompts patient to register or complete clinical intake"]
    N11 -->|if: no account or expired auth| N16
    N17(["Shopping Cart preserves cart for restoration after authorization"])
    N16 --> N17
  

flowchart TD
    N1(["Patient had items in Shopping Cart but was blocked by Checkout Gate due to missing authorization"])
    N2["Commerce Service persists cart state in Application Database tied to patient account"]
    N1 --> N2
    N3["Patient completes clinical intake and receives NP authorization"]
    N2 --> N3
    N4["Authorization Status API confirms active authorization status"]
    N3 --> N4
    N5["Patient returns to Patient Web Application"]
    N4 --> N5
    N6["Shopping Cart restores previously saved cart items via Commerce Service"]
    N5 --> N6
    N7["Gram Equivalency Calculator re-validates gram total against Cannabis Act limits"]
    N6 --> N7
    N8["Checkout Gate confirms active authorization and unlocks checkout"]
    N7 --> N8
    N9(["Patient proceeds to Shopify embedded buy flow to complete purchase"])
    N8 --> N9
  

flowchart TD
    N1(["Patient initiates clinical intake from Patient Web Application"])
    N2["Platform API routes intake request to AI Clinical Intake Engine"]
    N1 --> N2
    N3["Questionnaire Engine schedules voice intake and presents the clinical questionnaire in the correct sequence"]
    N2 --> N3
    N4["Patient selects preferred callback window"]
    N3 --> N4
    N5["Callback Scheduler schedules callback and confirms via SMS through SMS Provider"]
    N4 --> N5
    N6["Voice AI Platform initiates voice intake call at scheduled time"]
    N5 --> N6
    N7["Voice Recording Manager captures voice recording and generates transcript"]
    N6 --> N7
    N8["Voice Recording Manager stores encrypted recording in Object Storage"]
    N7 --> N8
    N9["Clinical Summary Generator sends intake data to AI / LLM Provider for processing"]
    N8 --> N9
    N10["AI / LLM Provider returns structured clinical summary with contraindication flags and completeness score"]
    N9 --> N10
    N11["Clinical Summary Generator stores summary in Application Database and marks case ready for NP review"]
    N10 --> N11
    N12(["Compliance Audit Trail records intake consent and handoff event"])
    N11 --> N12
  

flowchart TD
    N1(["Callback Scheduler triggers callback at patient-selected time via Voice AI Platform"])
    N2["Voice AI Platform attempts to reach Patient — call goes unanswered"]
    N1 --> N2
    N3["Callback Scheduler records missed callback in Application Database"]
    N2 --> N3
    N4["Callback Scheduler waits 1 hour and initiates retry via Voice AI Platform"]
    N3 --> N4
    N5{"Voice AI Platform attempts second call to Patient"}
    N4 --> N5
    N6["Voice Recording Manager begins voice intake recording"]
    N5 -->|if: patient answers| N6
    N7(["Questionnaire Engine continues intake from where patient left off"])
    N6 --> N7
    N8["Callback Scheduler sends SMS fallback via SMS Provider with link to reschedule"]
    N5 -->|if: missed again| N8
    N9(["Patient receives SMS and can reschedule the voice intake"])
    N8 --> N9
  

flowchart TD
    N1(["Clinical Summary Generator marks intake case as ready for NP review"])
    N2["NP Workflow Service checks NP Availability Management for online NPs with capacity"]
    N1 --> N2
    N3["NP Dispatch & Notification assigns case to best-match NP and opens claim window"]
    N2 --> N3
    N4["NP Dispatch & Notification sends push/SMS notification to assigned NP via SMS Provider"]
    N3 --> N4
    N5{"Nurse Practitioner receives notification"}
    N4 --> N5
    N6["NP Workflow Service locks case to claiming NP"]
    N5 -->|if: NP claims within window| N6
    N7(["Case Queue Dashboard updates queue to reflect claimed case"])
    N6 --> N7
    N8["NP Dispatch & Notification triggers escalation logic"]
    N5 -->|if: claim window expires| N8
    N9["NP Workflow Service reassigns case to next available NP"]
    N8 --> N9
    N10(["NP Dispatch & Notification sends notification to newly assigned NP"])
    N9 --> N10
  

flowchart TD
    N1(["NP Workflow Service assigns new case and sends notification to available Nurse Practitioner via SMS Provider"])
    N2["Nurse Practitioner opens NP Workbench and views Case Queue Dashboard"]
    N1 --> N2
    N3["Case Queue Dashboard displays queue with case filters, risk levels, and wait times"]
    N2 --> N3
    N4["Nurse Practitioner claims a case and opens Case Review Interface"]
    N3 --> N4
    N5["Case Review Interface displays three-column view: clinical summary, contraindication panel, and medication review"]
    N4 --> N5
    N6["Nurse Practitioner reviews AI-generated summary, transcript, and contraindication flags"]
    N5 --> N6
    N7{"Nurse Practitioner submits decision via Decision Workflow"}
    N6 --> N7
    N8["Medical Document Generator produces authorization document under Part 14"]
    N7 -->|if: approved| N8
    N9["Nurse Practitioner applies e-signature to medical document"]
    N8 --> N9
    N10["Authorization Status API updates patient status to active with expiry date"]
    N9 --> N10
    N11(["Patient receives notification that authorization is active"])
    N10 --> N11
    N12["Decision Workflow records refusal reason"]
    N7 -->|if: declined| N12
    N13["Amendment & Revocation Engine initiates refusal workflow under ss.137-139"]
    N12 --> N13
    N14(["Patient receives notification of decline with explanation"])
    N13 --> N14
    N15["Decision Workflow flags case with notes for escalation"]
    N7 -->|if: flagged for review| N15
    N16(["NP Dispatch & Notification escalates to senior NP"])
    N15 --> N16
    N17(["Compliance Audit Trail records decision, document generation, and handoff events"])
  

flowchart TD
    N1(["Nurse Practitioner initiates amendment or revocation from NP Workbench"])
    N2["Amendment & Revocation Engine loads active authorization from Application Database"]
    N1 --> N2
    N3{"Nurse Practitioner selects action type"}
    N2 --> N3
    N4["Amendment & Revocation Engine records amendment details (dosage, product, duration changes)"]
    N3 -->|if: amendment| N4
    N5["Medical Document Generator produces amended authorization document"]
    N4 --> N5
    N6(["Authorization Status API updates authorization with amended terms"])
    N5 --> N6
    N7["Amendment & Revocation Engine records revocation reason under ss.137-139"]
    N3 -->|if: revocation| N7
    N8["Authorization Status API sets patient status to expired immediately"]
    N7 --> N8
    N9(["Checkout Gate blocks future purchases for this patient"])
    N8 --> N9
    N10["Patient receives notification of authorization change via Patient Dashboard"]
    N11["Compliance Audit Trail records amendment or revocation event"]
    N10 --> N11
    N12(["Licensing Notice Module sends templated notice under s.277 if required"])
    N11 --> N12
  

flowchart TD
    N1(["Nurse Practitioner holds a voice call with the Patient outside the AI intake (clarification, follow-up, etc.) and rec..."])
    N2["Nurse Practitioner opens Call Recording Upload in NP Workbench and selects the patient and case"]
    N1 --> N2
    N3["Nurse Practitioner uploads the audio recording and optional notes"]
    N2 --> N3
    N4["Call Recording Upload transmits the file to Platform API via authenticated REST endpoint"]
    N3 --> N4
    N5["Platform API stores the audio encrypted in Object Storage and creates a record in Application Database linking the re..."]
    N4 --> N5
    N6["Compliance Audit Trail records the upload event (NP, patient, case, timestamp, file hash)"]
    N5 --> N6
    N7(["Nurse Practitioner sees the recording in the patient case view for future reference"])
    N6 --> N7
  

flowchart TD
    N1(["Shopify updates order status (confirmed, shipped, delivered) via Kinloch-selected fulfillment provider"])
    N2["Order & Fulfillment Service detects status change from Shopify via API polling or webhook"]
    N1 --> N2
    N3["Order & Fulfillment Service stores updated order data in Application Database"]
    N2 --> N3
    N4["Patient opens Patient Dashboard and views current order status and tracking"]
    N3 --> N4
    N5(["Patient Dashboard displays order history with fulfillment details from Shopify"])
    N4 --> N5
  

flowchart TD
    N1(["NP Workflow Service prepares to assign case to Nurse Practitioner"])
    N2{"Practitioner License Verification queries Provincial College Registry for NP license status"}
    N1 --> N2
    N3["Practitioner License Verification confirms license validity and stores result"]
    N2 -->|if: license active| N3
    N4(["NP Workflow Service proceeds with case assignment"])
    N3 --> N4
    N5["Practitioner License Verification flags NP for manual review"]
    N2 -->|if: license not found or expired| N5
    N6(["NP Availability Management sets NP status to offline pending verification"])
    N5 --> N6
    N7["Practitioner License Verification falls back to manual verification process"]
    N2 -->|if: unsupported province| N7
    N8(["NP Workflow Service holds case assignment until manual check completes"])
    N7 --> N8
    N9(["Compliance Audit Trail records license verification event"])
  

flowchart TD
    N1(["Kinloch Admin requests a Health Canada report for a date range from Compliance & Regulatory Service"])
    N2["Health Canada CSV Export queries Application Database for authorization events in the requested period"]
    N1 --> N2
    N3["Health Canada CSV Export generates a CSV file with the fields required for s.297 submission"]
    N2 --> N3
    N4["Kinloch Admin downloads the CSV file"]
    N3 --> N4
    N5["Kinloch Admin submits the report manually to Health Canada through Kinloch's existing regulatory channel"]
    N4 --> N5
    N6(["Compliance Audit Trail records the export event with timestamp, date range, and operator"])
    N5 --> N6
  

flowchart TD
    N1(["Provincial Disclosure Module identifies disclosure obligation for a patient's province"])
    N2["Provincial Disclosure Module queries Application Database for relevant authorization records"]
    N1 --> N2
    N3["Provincial Disclosure Module assembles scoped disclosure pack under s.299"]
    N2 --> N3
    N4["Provincial Disclosure Module transmits pack via secure channel"]
    N3 --> N4
    N5["Provincial Disclosure Module logs transmission in secure transmission log"]
    N4 --> N5
    N6(["Compliance Audit Trail records disclosure event"])
    N5 --> N6