- add PrintStatusChanged event schema

- add C4 code diagram for print api status handler
- clean up existing schema descriptions for mesh, PDM, and print events

Author: tdroza-nhs

docs/architecture/c4/notifhir/printer/eventsfromprint/index.md

@@ -5,11 +5,11 @@ parent:  Print Supplier Services
 nav_order: 9
 has_children: true
 is_not_draft: false
-last_modified_date: 2024-05-28
+last_modified_date: 2025-12-12
 owner: Ross Buggins
-author: Ross Buggins
-diagrams: []
-events-raised: [print-printed]
+author: Tom D'Roza
+diagrams: [c4code-printer-statushandler]
+events-raised: [print-status-changed]
 events-consumed: [external-supplier-api-letter-printed]
 c4type: code
 ---

docs/collections/_diagrams/c4code-mesh-retriever.md

@@ -19,7 +19,7 @@ architecture-beta
 
     meshReceived:R --> L:meshDownloadQueue
     meshDownloadQueue:R --> L:meshDownloadLambda
-    meshDownloadLambda:T --> B:mesh
-    meshDownloadLambda:B --> T:s3
+    meshDownloadLambda:T --> B:s3
+    meshDownloadLambda:B --> T:mesh
     meshDownloadLambda:R --> L:meshDownloaded
 ```

docs/collections/_diagrams/c4code-mesh-statusreporter-sender.md

@@ -16,16 +16,20 @@ architecture-beta
     service s3(logos:aws-s3)[Reports] in reportSender
     junction j1 in reportSender
     junction j2
+    junction j3
+    junction j4 in reportSender
     service reportSent(aws:res-amazon-eventbridge-event)[ReportSent Event]
 
 
     reportGenerated:R --> L:sqs
     sqs:R --> L:reportSenderLambda
-    clientConfig:R -- T:reportSenderLambda
-    s3:L -- T:reportSenderLambda
+    clientConfig:B -- T:j2
+    s3:B -- T:j3
+    j2:R -- L:j1
+    j3:L -- R:j1
     j1:B --> T:reportSenderLambda
     reportSenderLambda:B --> T:mesh
-    reportSenderLambda:R -- L:j2
-    j2:R --> L:reportSent
+    reportSenderLambda:R -- L:j4
+    j4:R --> L:reportSent
 
 ```

docs/collections/_diagrams/c4code-printer-sendtoqueue.md

@@ -4,12 +4,12 @@ title: c4code-printer-sendtoqueue
 
 ```mermaid
    architecture-beta
-    group createTtl(cloud)[QueueAdder]
+    group queueAdder(cloud)[QueueAdder]
 
-    service db(aws:arch-amazon-dynamodb)[ItemsWithTTL] in createTtl
-    service clientConfig(aws:res-aws-systems-manager-parameter-store)[Client Configuration] in createTtl
-    service createLambda(logos:aws-lambda)[CreateTTL] in createTtl
-    service queue(logos:aws-sqs)[SQS] in createTtl
+    service db(aws:arch-amazon-dynamodb)[ItemsWithTTL] in queueAdder
+    service clientConfig(aws:res-aws-systems-manager-parameter-store)[Client Configuration] in queueAdder
+    service createLambda(logos:aws-lambda)[CreateTTL] in queueAdder
+    service queue(logos:aws-sqs)[SQS] in queueAdder
     service storedEvent(aws:res-amazon-eventbridge-event)[MESHInboxMessageDownloaded event]
     service scheduledEvent(aws:res-amazon-eventbridge-event) [ItemEnqueued event]
 

docs/collections/_diagrams/c4code-printer-statushandler.md

@@ -0,0 +1,39 @@
+---
+title: c4code-printer-statushandler
+---
+
+```mermaid
+   architecture-beta
+    group printStatusHandler(cloud)[PrinterStatusHandler]
+
+
+    service createLambda(logos:aws-lambda)[PrintStatusHandler] in printStatusHandler
+    service queue(logos:aws-sqs)[SQS] in printStatusHandler
+
+    service letterAcceptedEvent(aws:res-amazon-eventbridge-event)[letterACCEPTED event]
+    service letterRejectedEvent(aws:res-amazon-eventbridge-event)[letterREJECTED event]
+    service letterPrintedEvent(aws:res-amazon-eventbridge-event)[letterPRINTED event]
+    service letterDispatchedEvent(aws:res-amazon-eventbridge-event)[letterDISPATCHED event]
+    service letterFailedEvent(aws:res-amazon-eventbridge-event)[letterFAILED event]
+    service letterReturnedEvent(aws:res-amazon-eventbridge-event)[letterRETURNED event]
+
+    service printStatusEvent(aws:res-amazon-eventbridge-event) [PrintStatusChanged event]
+
+    junction j1
+    junction j2
+    junction j3
+    junction j4
+
+    j1:R --> L:queue
+    j2:B -- T:j1
+    j3:T -- B:j1
+    j4:T -- B:j3
+    letterRejectedEvent:R -- T:j2
+    letterAcceptedEvent:R -- L:j2
+    letterPrintedEvent:R -- B:j2
+    letterDispatchedEvent:R -- T:j4
+    letterFailedEvent:R -- L:j4
+    letterReturnedEvent:R -- B:j4
+    queue:R --> L:createLambda
+    createLambda:R --> L:printStatusEvent
+```

docs/collections/_events/print-status-cahnged.md

@@ -0,0 +1,10 @@
+---
+title: print-status-changed
+type: uk.nhs.notify.digital.letters.print.status.changed.v1
+nice_name: PrintStatusChanged
+service: Print Supplier Services
+schema_envelope:  https://notify.nhs.uk/cloudevents/schemas/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.print.status.changed.v1.schema.json
+schema_data: https://notify.nhs.uk/cloudevents/schemas/digital-letters/2025-10-draft/data/digital-letter-base-data.schema.json
+---
+
+This event signals that the status of a letter in the print supplier's system has changed. It is a Digital Letters internal representation of the various status update events received from the external print supplier API, such as "letter.ACCEPTED", "letter.REJECTED", "letter.PRINTED", "letter.DISPATCHED", "letter.FAILED", and "letter.RETURNED".