fix: preserve numeric ref range metadata

app/Models/RefRange/RefNumModel.php

@@ -65,6 +65,7 @@ class RefNumModel extends BaseModel
                 'NumRefTypeLabel' => $r['NumRefType'] ? \App\Libraries\ValueSet::getLabel('numeric_ref_type', $r['NumRefType']) : '',
                 'RangeType'       => $r['RangeType'],
                 'RangeTypeLabel'  => $r['RangeType'] ? \App\Libraries\ValueSet::getLabel('range_type', $r['RangeType']) : '',
+                'SpcType'         => $r['SpcType'],
                 'Sex'             => $r['Sex'],
                 'SexLabel'        => $r['Sex'] ? \App\Libraries\ValueSet::getLabel('gender', $r['Sex']) : '',
                 'LowSign'         => $r['LowSign'],
@@ -77,6 +78,7 @@ class RefNumModel extends BaseModel
                 'AgeEnd'          => (int) $r['AgeEnd'],
                 'Flag'            => $r['Flag'],
                 'Interpretation'  => $r['Interpretation'],
+                'Notes'           => $r['Notes'],
             ];
         }, $rows ?? []);
     }
@@ -108,6 +110,7 @@ class RefNumModel extends BaseModel
             $this->insert([
                 'TestSiteID'    => $testSiteID,
                 'SiteID'        => $siteID,
+                'SpcType'       => $range['SpcType'] ?? 'GEN',
                 'NumRefType'    => $range['NumRefType'],
                 'RangeType'     => $range['RangeType'],
                 'Sex'           => $range['Sex'],
@@ -119,6 +122,7 @@ class RefNumModel extends BaseModel
                 'High'          => !empty($range['High']) ? (float) $range['High'] : null,
                 'Flag'          => $range['Flag'] ?? null,
                 'Interpretation'=> $range['Interpretation'] ?? null,
+                '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',
             ];
         }