Rel 702 Offsite document storage

.env.example

@@ -2,3 +2,4 @@
 OPENEMR__ENVIRONMENT=
 # Possible options are true to prevent dated reminders and background apps.Else empty or false. No spaces, no quotes.
 OPENEMR__NO_BACKGROUND_TASKS=
+

controllers/C_Document.class.php

@@ -24,6 +24,8 @@
 use OpenEMR\Services\FacilityService;
 use OpenEMR\Services\PatientService;
 use OpenEMR\Events\PatientDocuments\PatientDocumentTreeViewFilterEvent;
+use OpenEMR\Events\PatientDocuments\PatientRetrieveOffsiteDocument;
+use Symfony\Component\EventDispatcher\EventDispatcherInterface;
 
 class C_Document extends Controller
 {
@@ -39,6 +41,10 @@ class C_Document extends Controller
     private $cryptoGen;
     private bool $skip_acl_check = false;
     private DocumentTemplateService $templateService;
+    /**
+     * @var EventDispatcherInterface $eventDispatcher
+     */
+    private $eventDispatcher;
 
     public function __construct($template_mod = "general")
     {
@@ -795,6 +801,16 @@ public function retrieve_action(string $patient_id = null, $document_id, $as_fil
         if (file_exists($temp_url)) {
             $url = $temp_url;
         }
+        //fire a remote call to see if the file is stored somewhere else
+        $s3Key = explode("//", $temp_url); //split the url to get the s3 key
+        $retrieveOffsiteDocument = new PatientRetrieveOffsiteDocument("/" . $s3Key[1]);
+        $this->eventDispatcher->dispatch($retrieveOffsiteDocument, PatientRetrieveOffsiteDocument::REMOTE_DOCUMENT_LOCATION);
+        //this is for the s3 bucket module. If the file is not found locally, it will be found remotely
+        if ($retrieveOffsiteDocument->getOffsiteUrl() != null) {
+            header('Content-Description: File Transfer');
+            header("Location: " . $retrieveOffsiteDocument->getOffsiteUrl());
+            exit;
+        }
 
         if (!file_exists($url)) {
             echo xl('The requested document is not present at the expected location on the filesystem or there are not sufficient permissions to access it.', '', '', ' ') . $url;

src/Events/PatientDocuments/PatientDocumentStoreOffsite.php

@@ -0,0 +1,72 @@
+<?php
+
+/**
+ * PatientDocumentStoreOffsite
+ *
+ * @package   OpenEMR
+ * @link      http://www.open-emr.org
+ * @author    Sherwin Gaddis <sherwingaddis@gmail.com>
+ * @copyright Copyright (c) 2024 Sherwin Gaddis <sherwingaddis@gmail.com>
+ * @license   https://github.com/openemr/openemr/blob/master/LICENSE GNU General Public License 3
+ */
+
+namespace OpenEMR\Events\PatientDocuments;
+
+use Symfony\Contracts\EventDispatcher\Event;
+
+class PatientDocumentStoreOffsite extends Event
+{
+    const REMOTE_STORAGE_LOCATION = 'documents.remote.storage.location';
+    private mixed $data;
+    private string $remoteFileName;
+    private string $mimeType;
+    private mixed $category;
+    private mixed $patientId;
+
+    public function __construct($data)
+    {
+        $this->data = $data;
+    }
+    public function getData()
+    {
+        return $this->data;
+    }
+
+    public function setRemoteFileName(string $filename): void
+    {
+        $this->remoteFileName = $filename;
+    }
+
+    public function getRemoteFileName(): string
+    {
+        return $this->remoteFileName;
+    }
+
+    public function setRemoteMimeType(string $mimeType): void
+    {
+        $this->mimeType = $mimeType;
+    }
+
+    public function getRemoteMimeType(): string
+    {
+        return $this->mimeType;
+    }
+    public function setRemoteCategory($category): void
+    {
+        $this->category = $category;
+    }
+
+    public function getRemoteCategory(): mixed
+    {
+        return $this->category;
+    }
+
+    public function setPatientId(string $patientId): void
+    {
+        $this->patientId = $patientId;
+    }
+    public function getPatientId(): mixed
+    {
+        return $this->patientId;
+    }
+}

src/Events/PatientDocuments/PatientRetrieveOffsiteDocument.php

@@ -0,0 +1,36 @@
+<?php
+
+/**
+ * PatientRetrieveOffsiteDocument
+ *
+ * @package   OpenEMR
+ * @link      http://www.open-emr.org
+ * @author    Sherwin Gaddis <sherwingaddis@gmail.com>
+ * @copyright Copyright (c) 2024 Sherwin Gaddis <sherwingaddis@gmail.com>
+ * @license   https://github.com/openemr/openemr/blob/master/LICENSE GNU General Public License 3
+ */
+
+namespace OpenEMR\Events\PatientDocuments;
+
+use Symfony\Contracts\EventDispatcher\Event;
+
+class PatientRetrieveOffsiteDocument extends Event
+{
+    const REMOTE_DOCUMENT_LOCATION = 'remote.document.retrieve.location';
+    private string $url;
+    private $offsiteurl;
+    public function __construct($url)
+    {
+        $this->url = $url;
+    }
+
+    public function setOffsiteUrl(string $offsitedUrl): void
+    {
+        $this->offsiteurl = $offsiteUrl;
+    }
+
+    public function getOffsiteUrl()
+    {
+        return $this->offsiteurl;
+    }
+}