fix: preserve numeric ref range metadata

app/Models/RefRange/RefNumModel.php

@@ -59,27 +59,29 @@ class RefNumModel extends BaseModel
       $rows = $this->getActiveByTestSiteID($testSiteID);
       
       return array_map(function ($r) {
-          return [
+            return [
-              'RefNumID'        => $r['RefNumID'],
+                'RefNumID'        => $r['RefNumID'],
-              'NumRefType'      => $r['NumRefType'],
+                'NumRefType'      => $r['NumRefType'],
-              'NumRefTypeLabel' => $r['NumRefType'] ? \App\Libraries\ValueSet::getLabel('numeric_ref_type', $r['NumRefType']) : '',
+                'NumRefTypeLabel' => $r['NumRefType'] ? \App\Libraries\ValueSet::getLabel('numeric_ref_type', $r['NumRefType']) : '',
-              'RangeType'       => $r['RangeType'],
+                'RangeType'       => $r['RangeType'],
-              'RangeTypeLabel'  => $r['RangeType'] ? \App\Libraries\ValueSet::getLabel('range_type', $r['RangeType']) : '',
+                'RangeTypeLabel'  => $r['RangeType'] ? \App\Libraries\ValueSet::getLabel('range_type', $r['RangeType']) : '',
-              'Sex'             => $r['Sex'],
+                'SpcType'         => $r['SpcType'],
-              'SexLabel'        => $r['Sex'] ? \App\Libraries\ValueSet::getLabel('gender', $r['Sex']) : '',
+                'Sex'             => $r['Sex'],
-              'LowSign'         => $r['LowSign'],
+                'SexLabel'        => $r['Sex'] ? \App\Libraries\ValueSet::getLabel('gender', $r['Sex']) : '',
-              'LowSignLabel'    => $r['LowSign'] ? \App\Libraries\ValueSet::getLabel('math_sign', $r['LowSign']) : '',
+                'LowSign'         => $r['LowSign'],
-              'HighSign'        => $r['HighSign'],
+                'LowSignLabel'    => $r['LowSign'] ? \App\Libraries\ValueSet::getLabel('math_sign', $r['LowSign']) : '',
-              'HighSignLabel'   => $r['HighSign'] ? \App\Libraries\ValueSet::getLabel('math_sign', $r['HighSign']) : '',
+                'HighSign'        => $r['HighSign'],
-              'High'            => $r['High'] !== null ? (float) $r['High'] : null,
+                'HighSignLabel'   => $r['HighSign'] ? \App\Libraries\ValueSet::getLabel('math_sign', $r['HighSign']) : '',
-              'Low'             => $r['Low'] !== null ? (float) $r['Low'] : null,
+                'High'            => $r['High'] !== null ? (float) $r['High'] : null,
-              'AgeStart'        => (int) $r['AgeStart'],
+                'Low'             => $r['Low'] !== null ? (float) $r['Low'] : null,
-              'AgeEnd'          => (int) $r['AgeEnd'],
+                'AgeStart'        => (int) $r['AgeStart'],
-              'Flag'            => $r['Flag'],
+                'AgeEnd'          => (int) $r['AgeEnd'],
-              'Interpretation'  => $r['Interpretation'],
+                'Flag'            => $r['Flag'],
-          ];
+                'Interpretation'  => $r['Interpretation'],
-      }, $rows ?? []);
+                'Notes'           => $r['Notes'],
-  }
+            ];
+        }, $rows ?? []);
+    }
 
   /**
    * Disable all numeric reference ranges for a test
@@ -105,23 +107,25 @@ class RefNumModel extends BaseModel
   public function batchInsert($testSiteID, $siteID, $ranges)
   {
       foreach ($ranges as $index => $range) {
-          $this->insert([
+            $this->insert([
-              'TestSiteID'    => $testSiteID,
+                'TestSiteID'    => $testSiteID,
-              'SiteID'        => $siteID,
+                'SiteID'        => $siteID,
-              'NumRefType'    => $range['NumRefType'],
+                'SpcType'       => $range['SpcType'] ?? 'GEN',
-              'RangeType'     => $range['RangeType'],
+                'NumRefType'    => $range['NumRefType'],
-              'Sex'           => $range['Sex'],
+                'RangeType'     => $range['RangeType'],
-              'AgeStart'      => (int) ($range['AgeStart'] ?? 0),
+                'Sex'           => $range['Sex'],
-              'AgeEnd'        => (int) ($range['AgeEnd'] ?? 150),
+                'AgeStart'      => (int) ($range['AgeStart'] ?? 0),
-              'LowSign'       => !empty($range['LowSign']) ? $range['LowSign'] : null,
+                'AgeEnd'        => (int) ($range['AgeEnd'] ?? 150),
-              'Low'           => !empty($range['Low']) ? (float) $range['Low'] : null,
+                'LowSign'       => !empty($range['LowSign']) ? $range['LowSign'] : null,
-              'HighSign'      => !empty($range['HighSign']) ? $range['HighSign'] : null,
+                'Low'           => !empty($range['Low']) ? (float) $range['Low'] : null,
-              'High'          => !empty($range['High']) ? (float) $range['High'] : null,
+                'HighSign'      => !empty($range['HighSign']) ? $range['HighSign'] : null,
-              'Flag'          => $range['Flag'] ?? null,
+                'High'          => !empty($range['High']) ? (float) $range['High'] : null,
-              'Interpretation'=> $range['Interpretation'] ?? null,
+                'Flag'          => $range['Flag'] ?? null,
-              'Display'       => $index,
+                'Interpretation'=> $range['Interpretation'] ?? null,
-              'CreateDate'    => date('Y-m-d H:i:s'),
+                'Notes'         => $range['Notes'] ?? null,
-          ]);
+                'Display'       => $index,
-      }
+                'CreateDate'    => date('Y-m-d H:i:s'),
-  }
+            ]);
+        }
+    }
 }

public/api-docs.bundled.yaml

@@ -5182,12 +5182,49 @@ paths:
                   message:
                     type: string
                     example: 'Invalid member TestSiteID(s): 185, 186. Make sure to use TestSiteID, not SeqScr or other values.'
+  /api/test/{id}:
+    get:
+      tags:
+        - Test
+      summary: Get test definition by ID
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: integer
+          description: Test Site ID
+      responses:
+        '200':
+          description: Test definition details
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  status:
+                    type: string
+                  message:
+                    type: string
+                  data:
+                    $ref: '#/components/schemas/TestDefinition'
+        '404':
+          description: Test not found
     patch:
       tags:
         - Test
       summary: Update test definition
       security:
         - bearerAuth: []
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: integer
+          description: Test Site ID
       requestBody:
         required: true
         content:
@@ -5335,36 +5372,6 @@ paths:
                   message:
                     type: string
                     example: 'Invalid member TestSiteID(s): 185, 186. Make sure to use TestSiteID, not SeqScr or other values.'
-  /api/test/{id}:
-    get:
-      tags:
-        - Test
-      summary: Get test definition by ID
-      security:
-        - bearerAuth: []
-      parameters:
-        - name: id
-          in: path
-          required: true
-          schema:
-            type: integer
-          description: Test Site ID
-      responses:
-        '200':
-          description: Test definition details
-          content:
-            application/json:
-              schema:
-                type: object
-                properties:
-                  status:
-                    type: string
-                  message:
-                    type: string
-                  data:
-                    $ref: '#/components/schemas/TestDefinition'
-        '404':
-          description: Test not found
     delete:
       tags:
         - Test
@@ -7072,6 +7079,9 @@ components:
                 type: string
               RangeTypeLabel:
                 type: string
+              SpcType:
+                type: string
+                description: Specimen type code (e.g., GEN, EDTA)
               Sex:
                 type: string
               SexLabel:
@@ -7098,6 +7108,9 @@ components:
                 type: string
               Interpretation:
                 type: string
+              Notes:
+                type: string
+                description: Optional note attached to the numeric reference range
         reftxt:
           type: array
           description: Text reference ranges (optional). Mutually exclusive with refnum - a test can only have ONE reference type.

public/components/schemas/tests.yaml

@@ -241,6 +241,9 @@ TestDefinition:
             type: string
           RangeTypeLabel:
             type: string
+          SpcType:
+            type: string
+            description: Specimen type code (e.g., GEN, EDTA)
           Sex:
             type: string
           SexLabel:
@@ -267,6 +270,9 @@ TestDefinition:
             type: string
           Interpretation:
             type: string
+          Notes:
+            type: string
+            description: Optional note attached to the numeric reference range
     reftxt:
       type: array
       description: Text reference ranges (optional). Mutually exclusive with refnum - a test can only have ONE reference type.

public/paths/tests.yaml

@@ -698,11 +698,48 @@
                   type: string
                   example: 'Invalid member TestSiteID(s): 185, 186. Make sure to use TestSiteID, not SeqScr or other values.'
 
+/api/test/{id}:
+  get:
+    tags: [Test]
+    summary: Get test definition by ID
+    security:
+      - bearerAuth: []
+    parameters:
+      - name: id
+        in: path
+        required: true
+        schema:
+          type: integer
+        description: Test Site ID
+    responses:
+      '200':
+        description: Test definition details
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                status:
+                  type: string
+                message:
+                  type: string
+                data:
+                  $ref: '../components/schemas/tests.yaml#/TestDefinition'
+      '404':
+        description: Test not found
+
   patch:
     tags: [Test]
     summary: Update test definition
     security:
       - bearerAuth: []
+    parameters:
+      - name: id
+        in: path
+        required: true
+        schema:
+          type: integer
+        description: Test Site ID
     requestBody:
       required: true
       content:
@@ -836,36 +873,6 @@
                   type: string
                   example: 'Invalid member TestSiteID(s): 185, 186. Make sure to use TestSiteID, not SeqScr or other values.'
 
-/api/test/{id}:
-  get:
-    tags: [Test]
-    summary: Get test definition by ID
-    security:
-      - bearerAuth: []
-    parameters:
-      - name: id
-        in: path
-        required: true
-        schema:
-          type: integer
-        description: Test Site ID
-    responses:
-      '200':
-        description: Test definition details
-        content:
-          application/json:
-            schema:
-              type: object
-              properties:
-                status:
-                  type: string
-                message:
-                  type: string
-                data:
-                  $ref: '../components/schemas/tests.yaml#/TestDefinition'
-      '404':
-        description: Test not found
-
   delete:
     tags: [Test]
     summary: Soft delete test definition

tests/feature/Test/TestCreateVariantsTest.php

@@ -42,6 +42,52 @@ class TestCreateVariantsTest extends CIUnitTestCase
         }
     }
 
+    public function testNumericRefRangeNotesPersistAfterCreate(): void
+    {
+        $notes = 'Auto note ' . uniqid();
+        $refnum = $this->buildRefNumEntries('NMRC', false);
+        $refnum[0]['Notes'] = $notes;
+
+        $payload = $this->buildTechnicalPayload('TEST', [
+            'ResultType' => 'NMRIC',
+            'RefType' => 'RANGE',
+        ]);
+        $payload['refnum'] = $refnum;
+
+        $response = $this->withBodyFormat('json')->call('post', $this->endpoint, $payload);
+        $response->assertStatus(201);
+        $json = json_decode($response->getJSON(), true);
+        $testSiteId = $json['data']['TestSiteId'];
+
+        $show = $this->call('get', $this->endpoint . '/' . $testSiteId);
+        $show->assertStatus(200);
+        $showJson = json_decode($show->getJSON(), true);
+        $this->assertSame($notes, $showJson['data']['refnum'][0]['Notes']);
+    }
+
+    public function testNumericRefRangeSpcTypePersistAfterCreate(): void
+    {
+        $spcType = 'EDTA';
+        $refnum = $this->buildRefNumEntries('NMRC', false);
+        $refnum[0]['SpcType'] = $spcType;
+
+        $payload = $this->buildTechnicalPayload('TEST', [
+            'ResultType' => 'NMRIC',
+            'RefType' => 'RANGE',
+        ]);
+        $payload['refnum'] = $refnum;
+
+        $response = $this->withBodyFormat('json')->call('post', $this->endpoint, $payload);
+        $response->assertStatus(201);
+        $json = json_decode($response->getJSON(), true);
+        $testSiteId = $json['data']['TestSiteId'];
+
+        $show = $this->call('get', $this->endpoint . '/' . $testSiteId);
+        $show->assertStatus(200);
+        $showJson = json_decode($show->getJSON(), true);
+        $this->assertSame($spcType, $showJson['data']['refnum'][0]['SpcType']);
+    }
+
     public function testCreateTechnicalWithThresholdReference(): void
     {
         $refnum = $this->buildRefNumEntries('THOLD', true);
@@ -321,6 +367,8 @@ class TestCreateVariantsTest extends CIUnitTestCase
                 'AgeEnd' => 120,
                 'Flag' => 'N',
                 'Interpretation' => 'Normal range',
+                'SpcType' => 'GEN',
+                'Notes' => 'Default numeric range note',
             ],
         ];
 
@@ -337,6 +385,8 @@ class TestCreateVariantsTest extends CIUnitTestCase
                 'AgeEnd' => 99,
                 'Flag' => 'N',
                 'Interpretation' => 'Alternate range',
+                'SpcType' => 'GEN',
+                'Notes' => 'Alternate numeric range note',
             ];
         }