[candidate_parameters] Add date precision field for DoD

Author: CamilleBeau

SQL/0000-00-00-schema.sql

@@ -159,6 +159,7 @@ CREATE TABLE `candidate` (
   `ExternalID` varchar(255) DEFAULT NULL,
   `DoB` date DEFAULT NULL,
   `DoD` date DEFAULT NULL,
+  `DoD_precision` enum('known_year_month','known_year','unknown') DEFAULT NULL,
   `EDC` date DEFAULT NULL,
   `Sex` varchar(255) DEFAULT NULL,
   `RegistrationCenterID` integer unsigned NOT NULL,

SQL/New_patches/2026-03-17-DoD-precision-field.sql

@@ -0,0 +1,2 @@
+ALTER TABLE candidate
+ADD COLUMN DoD_precision enum('known_year_month','known_year','unknown') DEFAULT NULL AFTER DoD;

modules/candidate_parameters/ajax/formHandler.php

@@ -630,14 +630,20 @@ function editCandidateDOB(\Database $db): void
 function editCandidateDOD(\Database $db): void
 {
     $candID       = new CandID($_POST['candID']);
-    $dod          = new DateTime($_POST['dod']);
+    $dod          = array_key_exists('dod', $_POST) ?
+        new DateTime($_POST['dod']) : null;
+    $precision    = $_POST['dod_precision'];
     $strippedDate = null;
     $dodString    = null;
 
-    if (!$dod) {
+    if (!$dod && $precision !== 'unknown') {
         throw new \LorisException('Date not valid.');
     }
+    if (!$precision) {
+        throw new \LorisException('Date of Death precision must be specified.');
+    }
 
+    $updateData = [];
     if (!empty($dod)) {
         $config    = \NDB_Config::singleton();
         $dodFormat = $config->getSetting('dodFormat');
@@ -646,10 +652,17 @@ function editCandidateDOD(\Database $db): void
         } else {
             $dodString = $dod->format('Y-m-d');
         }
+        $updateData['DoD'] = $strippedDate ?? $dodString;
+    } else {
+        $updateData['DoD'] = null;
+    }
+
+    if ($precision) {
+        $updateData['DoD_precision'] = $precision;
         $db->update(
             'candidate',
-            ['DoD' => $strippedDate ?? $dodString],
-            ['ID' => $candID->__toString()]
+            $updateData,
+            ['CandID' => $candID->__toString()]
         );
     }
 }

modules/candidate_parameters/jsx/CandidateDOD.js

@@ -9,6 +9,7 @@ import {
   StaticElement,
   DateElement,
   ButtonElement,
+  SelectElement,
 } from 'jsx/Form';
 
 /**
@@ -95,6 +96,12 @@ class CandidateDOD extends Component {
       disabled = false;
       updateButton = <ButtonElement label={t('Update', {ns: 'loris'})}/>;
     }
+    let precisionOptions = {
+      'known_year_month' : t('Known year and month'),
+      'known_year' : t('Known year'),
+      'unknown' : t('Unknown date'),
+    };
+    let required = this.state.formData.dod_precision != 'unknown';
 
     return (
       <div className='row'>
@@ -121,14 +128,23 @@ class CandidateDOD extends Component {
             }
             class='form-control-static text-danger bg-danger col-sm-10'
           />
+          <SelectElement
+            label={t('Precision of date:')}
+            name='dod_precision'
+            options={precisionOptions}
+            value={this.state.formData.dod_precision}
+            onUserInput={this.setFormData}
+            disabled={disabled}
+            required={true}
+          />
           <DateElement
             label={t('Date Of Death:', {ns: 'candidate_parameters'})}
             name='dod'
             dateFormat={dateFormat}
             value={this.state.formData.dod}
             onUserInput={this.setFormData}
-            disabled={disabled}
-            required={true}
+            disabled={disabled || !required}
+            required={required}
           />
           {updateButton}
         </FormElement>
@@ -194,7 +210,6 @@ class CandidateDOD extends Component {
     }
 
     formObject.append('tab', this.props.tabName);
-
     fetch(this.props.action, {
       method: 'POST',
       cache: 'no-cache',