2.7 release

README.md

@@ -1,7 +1,12 @@
 # Emap
+
 A monorepo for all core Emap functions
 
-# Basic layout
+# Setup
+
+The EMAP project follows this structure, for deploying a live instance of EMAP follow the instructions
+in [docs/core.md](docs/core.md).
+
 ```
 EMAP [your root emap directory]
 ├── config [config files passed to docker containers, not in any repo]
@@ -14,8 +19,12 @@ EMAP [your root emap directory]
 │   ├── [etc.]
 ```
 
-# Using IntelliJ with emap
-How to [configure IntelliJ](docs/intellij.md) to build emap and run tests.
+## Developer onboarding
+
+- How to [configure IntelliJ](docs/intellij.md) to build emap and run tests.
+- [Onboarding](docs/onboarding.md) gives details on how data items are processed and the test strategies used.
+
 
 # Monorepo migration
+
 How were [old repos migrated into this repo?](docs/migration.md)

core/pom.xml

@@ -5,7 +5,7 @@
   <groupId>uk.ac.ucl.rits.inform</groupId>
   <artifactId>core</artifactId>
   <packaging>jar</packaging>
-  <version>2.6</version>
+  <version>2.7</version>
   <name>Emap Core Processor</name>
   <url>http://maven.apache.org</url>
 
@@ -20,8 +20,8 @@
     <java.version>17</java.version>
     <checkstyle.version>10.3.1</checkstyle.version>
     <checkstyle.plugin.version>3.3.0</checkstyle.plugin.version>
-    <emap-star.version>2.6</emap-star.version>
-    <emap-interchange.version>2.6</emap-interchange.version>
+    <emap-star.version>2.7</emap-star.version>
+    <emap-interchange.version>2.7</emap-interchange.version>
     <go-offline-maven-plugin.version>1.2.8</go-offline-maven-plugin.version>
   </properties>
 

docs/img/core-message-processing.mmd

@@ -0,0 +1,66 @@
+classDiagram
+  direction BT
+  class InformDbOperations {
+    + processMessage(AdtMessage) void
+    + processMessage(LabOrderMsg) void
+  }
+  class LabCache {
+    + saveEntityAndUpdateCache(RowState~LabBattery, LabBatteryAudit~) LabBattery
+    + updateLabTestDefinitionCache(RowState~LabTestDefinition, LabTestDefinitionAudit~) LabTestDefinition
+    + findExistingLabTestDefinition(String, String) LabTestDefinition
+    + createLabBatteryElementIfNotExists(LabTestDefinition, LabBattery, Instant, Instant) LabBatteryElement
+  }
+  class LabController {
+    + processLabOrder(Mrn, HospitalVisit?, LabOrderMsg, Instant) void
+    + deleteLabOrdersForVisit(HospitalVisit, Instant, Instant) void
+    + processLabMetadata(LabMetadataMsg, Instant) void
+  }
+  class LabOrderAuditRepository {
+    <<Interface>>
+    + findAllIds(Long, Long, Instant, String) List~Long~
+    + previouslyDeleted(Long, Long, InterchangeValue~Instant~, InterchangeValue~String~) boolean
+    + findAllByHospitalVisitIdIn(Iterable~Long~) List~LabOrderAudit~
+  }
+  class LabOrderController {
+    + processSampleAndOrderInformation(Mrn, HospitalVisit, LabBattery, LabOrderMsg, Instant, Instant) LabOrder
+    + deleteLabOrder(LabOrder, Instant, Instant) void
+    + findLabBatteryOrThrow(String, String) LabBattery
+    + getLabOrdersForVisit(HospitalVisit) List~LabOrder~
+    + processLabSampleAndDeleteLabOrder(Mrn, LabBattery, HospitalVisit, LabOrderMsg, Instant, Instant) void
+    + getOrCreateLabBattery(String, String, Instant, Instant) LabBattery
+  }
+  class LabOrderRepository {
+    <<Interface>>
+    + findByLabBatteryIdAndLabSampleId(LabBattery, LabSample) Optional~LabOrder~
+    + findByLabBatteryIdAndLabSampleIdAndValidFromBefore(LabBattery, LabSample, Instant) Optional~LabOrder~
+    + findByLabBatteryIdBatteryCodeAndLabSampleId(String, LabSample) Optional~LabOrder~
+    + findByLabSampleIdExternalLabNumber(String) Optional~LabOrder~
+    + findAllByHospitalVisitId(HospitalVisit) List~LabOrder~
+  }
+  class LabProcessor {
+    + processMessage(LabMetadataMsg, Instant) void
+    + processMessage(LabOrderMsg, Instant) void
+  }
+  class LabTestDefinitionAuditRepository {
+    <<Interface>>
+  }
+  class LabTestDefinitionRepository {
+    <<Interface>>
+    + findByLabProviderAndTestLabCode(String, String) Optional~LabTestDefinition~
+    + findByTestLabCode(String) Optional~LabTestDefinition~
+  }
+  class EmapOperationMessageProcessor {
+    <<Interface>>
+    + processMessage(LabMetadataMsg) void
+    + processMessage(AdtMessage) void
+  }
+
+  InformDbOperations *--> LabProcessor
+  LabCache *--> LabTestDefinitionAuditRepository
+  LabCache *--> LabTestDefinitionRepository
+  LabController *--> LabCache
+  LabController *--> LabOrderController
+  LabOrderController *--> LabOrderAuditRepository
+  LabOrderController *--> LabOrderRepository
+  LabProcessor *--> LabController
+  InformDbOperations ..> EmapOperationMessageProcessor