feat(#10676): require acknowledgement checkbox before continuing without location

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: cliftonmcintosh

api/resources/translations/messages-en.properties

@@ -728,7 +728,8 @@ geolocation.permission.denied = Location access is turned off. Check your device
 geolocation.progress = Progress
 geolocation.result.label = Result
 geolocation.retry = Retry here to capture GPS location
-geolocation.skip = Continue without location tracking
+geolocation.skip.acknowledge = I understand this record will be saved without a location.
+geolocation.skip.button = Continue without location
 geolocation.skipped = Continuing without location capture
 geolocation.success = Success
 geolocation.unavailable = GPS is not available on this device.

api/resources/translations/messages-es.properties

@@ -728,7 +728,8 @@ geolocation.permission.denied = El acceso a la ubicación está desactivado. Ver
 geolocation.progress = Progreso
 geolocation.result.label = Resultado
 geolocation.retry = Reintentar
-geolocation.skip = Continuar sin seguimiento de ubicación
+geolocation.skip.acknowledge = Entiendo que este registro se guardará sin una ubicación.
+geolocation.skip.button = Continuar sin ubicación
 geolocation.skipped = Continuando sin capturar la ubicación
 geolocation.success = Exitoso
 geolocation.unavailable = El GPS no está disponible en este dispositivo.

api/resources/translations/messages-fr.properties

@@ -728,7 +728,8 @@ geolocation.permission.denied = L'accès à la localisation est désactivé. Vé
 geolocation.progress = Progression
 geolocation.result.label = Résultat
 geolocation.retry = Réessayer
-geolocation.skip = Continuer sans suivi de localisation
+geolocation.skip.acknowledge = Je comprends que cet enregistrement sera sauvegardé sans localisation.
+geolocation.skip.button = Continuer sans localisation
 geolocation.skipped = Poursuite sans capture de localisation
 geolocation.success = Succès
 geolocation.unavailable = Le GPS n'est pas disponible sur cet appareil.

api/resources/translations/messages-ne.properties

@@ -728,7 +728,8 @@ geolocation.permission.denied = स्थान पहुँच बन्द छ
 geolocation.progress = प्रगति
 geolocation.result.label = परिणाम
 geolocation.retry = पुनः प्रयास गर्नुहोस्
-geolocation.skip = स्थान ट्र्याकिङ बिना जारी राख्नुहोस्
+geolocation.skip.acknowledge = म बुझ्छु कि यो रेकर्ड स्थान बिना सुरक्षित गरिनेछ।
+geolocation.skip.button = स्थान बिना जारी राख्नुहोस्
 geolocation.skipped = स्थान कैप्चर बिना जारी राख्दै
 geolocation.success = सफल
 geolocation.unavailable = यस उपकरणमा GPS उपलब्ध छैन।

api/resources/translations/messages-sw.properties

@@ -728,7 +728,8 @@ geolocation.permission.denied = Ufikiaji wa eneo umezimwa. Angalia mipangilio ya
 geolocation.progress = Maendeleo
 geolocation.result.label = Matokeo
 geolocation.retry = Jaribu tena
-geolocation.skip = Endelea bila ufuatiliaji wa eneo
+geolocation.skip.acknowledge = Ninaelewa kwamba rekodi hii itahifadhiwa bila eneo.
+geolocation.skip.button = Endelea bila eneo
 geolocation.skipped = Inaendelea bila kupata eneo
 geolocation.success = Imefaulu
 geolocation.unavailable = GPS haipatikani kwenye kifaa hiki.

webapp/src/css/enketo/medic.less

@@ -424,6 +424,20 @@
         background-color: @gray-light;
       }
 
+      .geolocation-acknowledge-label {
+        display: flex;
+        align-items: flex-start;
+        gap: 8px;
+        margin: 8px 0;
+        cursor: pointer;
+        font-weight: normal;
+      }
+
+      .geolocation-acknowledge-checkbox {
+        margin-top: 3px;
+        flex-shrink: 0;
+      }
+
       .geolocation-skipped-msg {
         margin: 4px 0;
         font-style: italic;

webapp/src/js/enketo/widgets/geolocation-widget.js

@@ -98,9 +98,21 @@ class GeolocationWidget extends Widget {
           this._startCapture();
         });
 
+        const $acknowledgeCheckbox = $('<input type="checkbox" class="geolocation-acknowledge-checkbox ignore">');
+        const $acknowledgeSpan = $('<span class="geolocation-acknowledge-text">');
+        const $acknowledgeLabel = $('<label class="geolocation-acknowledge-label">').append($acknowledgeCheckbox, $acknowledgeSpan);
+
         const $skipBtn = $('<button type="button" class="btn btn-default geolocation-skip-btn">');
+        $skipBtn.prop('disabled', true);
+
+        $acknowledgeCheckbox.on('change', event => {
+          event.stopPropagation();
+          $skipBtn.prop('disabled', !$acknowledgeCheckbox.prop('checked'));
+        });
+
         $skipBtn.on('click', () => {
           $retryBtn.remove();
+          $acknowledgeLabel.remove();
           $skipBtn.remove();
 
           const $skippedMsg = $('<p class="geolocation-skipped-msg">');
@@ -109,13 +121,14 @@ class GeolocationWidget extends Widget {
 
           $(this.element).val('skipped').trigger('change');
         });
-        $status.append($retryBtn, $skipBtn);
+        $status.append($retryBtn, $acknowledgeLabel, $skipBtn);
 
         globalThis.CHTCore.Translate.get('geolocation.result.label').then(text => $resultLabel.text(text));
         globalThis.CHTCore.Translate.get('geolocation.failure').then(text => $resultText.text(text));
         globalThis.CHTCore.Translate.get('geolocation.retry')
           .then(text => $retryBtn.append($('<span class="geolocation-btn-label">').text(text)));
-        globalThis.CHTCore.Translate.get('geolocation.skip').then(text => $skipBtn.text(text));
+        globalThis.CHTCore.Translate.get('geolocation.skip.button').then(text => $skipBtn.text(text));
+        globalThis.CHTCore.Translate.get('geolocation.skip.acknowledge').then(text => $acknowledgeSpan.text(text));
       } else {
         $bar.addClass('geolocation-progress-success');
 

webapp/tests/karma/js/enketo/widgets/geolocation-widget.spec.ts

@@ -287,7 +287,7 @@ describe('Enketo: Geolocation Widget', () => {
         expect(changeHandler.callCount).to.equal(1);
       });
 
-      it('should show retry and skip buttons when GPS acquisition fails', async () => {
+      it('should show retry button, acknowledgement checkbox, and skip button when GPS acquisition fails', async () => {
         const promise = Promise.resolve({ code: -2, message: 'Geolocation timeout exceeded' });
         window.CHTCore.Geolocation = { currentPromise: promise };
         buildHtml();
@@ -302,9 +302,78 @@ describe('Enketo: Geolocation Widget', () => {
         await promise;
 
         expect(container.querySelector('.geolocation-retry-btn')).to.not.be.null;
+        expect(container.querySelector('.geolocation-acknowledge-checkbox')).to.not.be.null;
         expect(container.querySelector('.geolocation-skip-btn')).to.not.be.null;
       });
 
+      it('should disable the "Continue without location" button immediately after GPS failure', async () => {
+        const promise = Promise.resolve({ code: -2, message: 'Geolocation timeout exceeded' });
+        window.CHTCore.Geolocation = { currentPromise: promise };
+        buildHtml();
+        const widget = createWidget();
+        widget._isGeolocationAvailable = () => true;
+        widget._init();
+        selectHomeContext();
+
+        const container = document.querySelector('#geolocation-widget-test .or-appearance-geolocation-capture')!;
+        (container.querySelector('.geolocation-capture-btn') as HTMLElement).click();
+
+        await promise;
+
+        const skipBtn = container.querySelector('.geolocation-skip-btn') as HTMLButtonElement;
+        expect(skipBtn).to.not.be.null;
+        expect(skipBtn.disabled).to.be.true;
+      });
+
+      it('should enable the "Continue without location" button when the acknowledgement checkbox is checked', async () => {
+        const promise = Promise.resolve({ code: -2, message: 'Geolocation timeout exceeded' });
+        window.CHTCore.Geolocation = { currentPromise: promise };
+        buildHtml();
+        const widget = createWidget();
+        widget._isGeolocationAvailable = () => true;
+        widget._init();
+        selectHomeContext();
+
+        const container = document.querySelector('#geolocation-widget-test .or-appearance-geolocation-capture')!;
+        (container.querySelector('.geolocation-capture-btn') as HTMLElement).click();
+
+        await promise;
+
+        const checkbox = container.querySelector('.geolocation-acknowledge-checkbox') as HTMLInputElement;
+        const skipBtn = container.querySelector('.geolocation-skip-btn') as HTMLButtonElement;
+
+        checkbox.checked = true;
+        $(checkbox).trigger('change');
+
+        expect(skipBtn.disabled).to.be.false;
+      });
+
+      it('should re-disable the "Continue without location" button when the acknowledgement checkbox is unchecked', async () => {
+        const promise = Promise.resolve({ code: -2, message: 'Geolocation timeout exceeded' });
+        window.CHTCore.Geolocation = { currentPromise: promise };
+        buildHtml();
+        const widget = createWidget();
+        widget._isGeolocationAvailable = () => true;
+        widget._init();
+        selectHomeContext();
+
+        const container = document.querySelector('#geolocation-widget-test .or-appearance-geolocation-capture')!;
+        (container.querySelector('.geolocation-capture-btn') as HTMLElement).click();
+
+        await promise;
+
+        const checkbox = container.querySelector('.geolocation-acknowledge-checkbox') as HTMLInputElement;
+        const skipBtn = container.querySelector('.geolocation-skip-btn') as HTMLButtonElement;
+
+        checkbox.checked = true;
+        $(checkbox).trigger('change');
+        expect(skipBtn.disabled).to.be.false;
+
+        checkbox.checked = false;
+        $(checkbox).trigger('change');
+        expect(skipBtn.disabled).to.be.true;
+      });
+
       it('should include a map icon in the retry button', async () => {
         const promise = Promise.resolve({ code: -2, message: 'Geolocation timeout exceeded' });
         window.CHTCore.Geolocation = { currentPromise: promise };
@@ -359,13 +428,17 @@ describe('Enketo: Geolocation Widget', () => {
         const changeHandler = sinon.stub();
         $(widget.element).on('change', changeHandler);
 
+        const checkbox = container.querySelector('.geolocation-acknowledge-checkbox') as HTMLInputElement;
+        checkbox.checked = true;
+        $(checkbox).trigger('change');
+
         (container.querySelector('.geolocation-skip-btn') as HTMLElement).click();
 
         expect(widget.element.value).to.equal('skipped');
         expect(changeHandler.callCount).to.equal(1);
       });
 
-      it('should remove retry and skip buttons and show a confirmation message when skip is clicked', async () => {
+      it('should remove retry, acknowledge, and skip elements and show confirmation when skip is clicked', async () => {
         const promise = Promise.resolve({ code: -2, message: 'Geolocation timeout exceeded' });
         window.CHTCore.Geolocation = { currentPromise: promise };
         buildHtml();
@@ -379,9 +452,14 @@ describe('Enketo: Geolocation Widget', () => {
 
         await promise;
 
+        const checkbox = container.querySelector('.geolocation-acknowledge-checkbox') as HTMLInputElement;
+        checkbox.checked = true;
+        $(checkbox).trigger('change');
+
         (container.querySelector('.geolocation-skip-btn') as HTMLElement).click();
 
         expect(container.querySelector('.geolocation-retry-btn')).to.be.null;
+        expect(container.querySelector('.geolocation-acknowledge-label')).to.be.null;
         expect(container.querySelector('.geolocation-skip-btn')).to.be.null;
         expect(container.querySelector('.geolocation-skipped-msg')).to.not.be.null;
       });