meta-edc 1.1.17__py3-none-any.whl → 1.1.19__py3-none-any.whl

meta_subject/admin/spfg_admin.py

@@ -0,0 +1,103 @@
+from django.contrib import admin
+from django.utils.safestring import mark_safe
+from django_audit_fields import audit_fieldset_tuple
+from edc_crf.fieldset import crf_status_fieldset
+from edc_model_admin.history import SimpleHistoryAdmin
+
+from ..admin_site import meta_subject_admin
+from ..forms import SpfqForm
+from ..models import Spfq
+from .modeladmin import CrfModelAdminMixin
+
+
+@admin.register(Spfq, site=meta_subject_admin)
+class SpfqAdmin(CrfModelAdminMixin, SimpleHistoryAdmin):
+    additional_instructions = mark_safe(
+        "The Study Participant Feedback Questionnaire Toolkit (SPFQ) is a set of three "
+        "brief validated patient questionnaires designed to capture patients’ experiences "
+        "at the beginning, during, and end of each clinical study, independent of disease "
+        "and treatment.<BR>"
+        "<B><font color='orange'>Interviewer to read</font></B>: Thank you for your "
+        "participation. Your experiences in this trial are important to us and we "
+        "would like to hear about them. Your answers will help us improve future trials. "
+        "There are no right or wrong answers. Your answers will be kept anonymous and "
+        "will not impact your participation in this trial."
+    )
+
+    form = SpfqForm
+
+    fieldsets = (
+        (None, {"fields": ("subject_visit", "report_datetime")}),
+        (
+            "Section A: Your experience before you started the study",
+            {
+                "description": "Please select one response for each of the following items.",
+                "fields": ("a01", "a02", "a03", "a04"),
+            },
+        ),
+        (
+            "Section B: Your experience during the trial",
+            {
+                "description": "Please select one response for each of the following items.",
+                "fields": (
+                    "b01",
+                    "b02",
+                    "b03",
+                    "b04",
+                    "b05",
+                    "b06",
+                    "b07",
+                    "b08",
+                    "b09",
+                    "b10",
+                ),
+            },
+        ),
+        (
+            "Section C: Your experience at the end of the trial",
+            {
+                "description": "Please select one response for each of the following items.",
+                "fields": (
+                    "c01",
+                    "c02",
+                    "c03",
+                    "c04",
+                    "c05",
+                    "c06",
+                    "c07",
+                    "c08",
+                    "c09",
+                    "c10",
+                ),
+            },
+        ),
+        crf_status_fieldset,
+        audit_fieldset_tuple,
+    )
+
+    radio_fields = {  # noqa: RUF012
+        "a01": admin.VERTICAL,
+        "a02": admin.VERTICAL,
+        "a03": admin.VERTICAL,
+        "a04": admin.VERTICAL,
+        "b01": admin.VERTICAL,
+        "b02": admin.VERTICAL,
+        "b03": admin.VERTICAL,
+        "b04": admin.VERTICAL,
+        "b05": admin.VERTICAL,
+        "b06": admin.VERTICAL,
+        "b07": admin.VERTICAL,
+        "b08": admin.VERTICAL,
+        "b09": admin.VERTICAL,
+        "b10": admin.VERTICAL,
+        "c01": admin.VERTICAL,
+        "c02": admin.VERTICAL,
+        "c03": admin.VERTICAL,
+        "c04": admin.VERTICAL,
+        "c05": admin.VERTICAL,
+        "c06": admin.VERTICAL,
+        "c07": admin.VERTICAL,
+        "c08": admin.VERTICAL,
+        "c09": admin.VERTICAL,
+        "c10": admin.VERTICAL,
+    }

meta_subject/choices.py

@@ -26,14 +26,28 @@ from .constants import (
     ALL_OF_THE_TIME,
     APPT,
     APPT_OTHER,
+    EXTREME,
     GOOD_BIT_OF_THE_TIME,
+    HIGHLY,
     LITTLE_OF_THE_TIME,
     LIVE_AT_TERM,
     LIVE_PRETERM,
+    MODERATE,
+    MODERATELY,
     MOST_OF_THE_TIME,
+    MUCH_LESS_EXPECTED,
+    MUCH_MORE_EXPECTED,
     NO_COMPLICATIONS,
     NONE_OF_THE_TIME,
+    NOT_AT_ALL,
+    SAME_AS_EXPECTED,
+    SEVERE,
+    SLIGHT,
+    SLIGHTLY,
     SOME_OF_THE_TIME,
+    SOMEWHAT_LESS_EXPECTED,
+    SOMEWHAT_MORE_EXPECTED,
+    VERY_HIGHLY,
 )
 
 ACTIVITY_CHOICES = (
@@ -242,3 +256,26 @@ YES_NO_NO_EXAM = (
     (NO, _(NO)),
     (NO_EXAM, _("Exam not performed")),
 )
+
+NOT_AT_ALL_TO_SEVERE_CHOICE = (
+    (NOT_AT_ALL, _("Not at all")),
+    (SLIGHT, _("Slight")),
+    (MODERATE, _("Moderate")),
+    (EXTREME, _("Extreme")),
+    (SEVERE, _("Severe")),
+)
+
+NOT_AT_ALL_TO_HIGHLY_CHOICE = (
+    (NOT_AT_ALL, _("Not at all")),
+    (SLIGHTLY, _("Slightly")),
+    (MODERATELY, _("Moderately")),
+    (HIGHLY, _("Highly")),
+    (VERY_HIGHLY, _("Very highly")),
+)
+LESS_EXPECTED_TO_MORE_EXPECTED_CHOICE = (
+    (MUCH_LESS_EXPECTED, _("Much less than expected")),
+    (SOMEWHAT_LESS_EXPECTED, _("Somewhat less than expected")),
+    (SAME_AS_EXPECTED, _("Same as expected")),
+    (SOMEWHAT_MORE_EXPECTED, _("Somewhat more than expected")),
+    (MUCH_MORE_EXPECTED, _("Much more than expected")),
+)

meta_subject/constants.py

@@ -6,15 +6,29 @@ APPT = "appt"
 APPT_OTHER = "other_routine_appt"
 DELIVERY_ACTION = "delivery_action"
 DM_FOLLOWUP_ACTION = "dm_followup_action"
+EXTREME = "extreme"
 FOLLOWUP_EXAMINATION_ACTION = "followup-examination-ae"
 GOOD_BIT_OF_THE_TIME = "good_bit_of_the_time"
+HIGHLY = "highly"
 LITTLE_OF_THE_TIME = "little_of_the_time"
 LIVE_AT_TERM = "live_at_term"
 LIVE_PRETERM = "live_preterm"
 LOW_EGFR_ACTION = "low-egfr"
 MISSED_VISIT_ACTION = "missed_visit_action"
+MODERATE = "moderate"
+MODERATELY = "moderately"
 MOST_OF_THE_TIME = "most_of_the_time"
+MUCH_LESS_EXPECTED = "much_less_expected"
+MUCH_MORE_EXPECTED = "much_more_expected"
 NONE_OF_THE_TIME = "none_of_the_time"
+NOT_AT_ALL = "not_at_all"
 NO_COMPLICATIONS = "no_complications"
+SAME_AS_EXPECTED = "same_as_expected"
+SEVERE = "severe"
+SLIGHT = "slight"
+SLIGHTLY = "slightly"
+SOMEWHAT_LESS_EXPECTED = "somewhat_less_expected"
+SOMEWHAT_MORE_EXPECTED = "somewhat_more_expected"
 SOME_OF_THE_TIME = "some_of_the_time"
 URINE_PREGNANCY_ACTION = "urine_pregnancy_action"
+VERY_HIGHLY = "very_highly"

meta_subject/forms/__init__.py

@@ -29,6 +29,7 @@ from .patient_history_form import PatientHistoryForm
 from .physical_exam_form import PhysicalExamForm
 from .pregnancy_update_form import PregnancyUpdateForm
 from .sf12_form import Sf12Form
+from .spfq_form import SpfqForm
 from .study_medication_form import StudyMedicationForm
 from .subject_requisition_form import SubjectRequisitionForm
 from .subject_visit_form import SubjectVisitForm
@@ -69,6 +70,7 @@ __all__ = [
     "PhysicalExamForm",
     "PregnancyUpdateForm",
     "Sf12Form",
+    "SpfqForm",
     "StudyMedicationForm",
     "SubjectRequisitionForm",
     "SubjectVisitForm",

meta_subject/forms/spfq_form.py

@@ -0,0 +1,65 @@
+from django import forms
+from django.core.exceptions import ObjectDoesNotExist
+from edc_crf.crf_form_validator import CrfFormValidator
+from edc_crf.modelform_mixins import CrfModelFormMixin
+from edc_registration.models import RegisteredSubject
+
+from meta_consent.models import SubjectConsentSpfq
+from meta_rando.models import SpfqList
+
+from ..models import Spfq
+
+
+class SpfqFormValidator(CrfFormValidator):
+    pass
+
+
+class SpfqForm(CrfModelFormMixin, forms.ModelForm):
+    form_validator_cls = SpfqFormValidator
+
+    def clean(self):
+        cleaned_data = super().clean()
+
+        try:
+            RegisteredSubject.objects.get(
+                subject_identifier=cleaned_data.get("subject_identifier"),
+                initials=cleaned_data.get("initials"),
+                gender=cleaned_data.get("gender"),
+            )
+        except ObjectDoesNotExist as e:
+            raise forms.ValidationError(
+                {
+                    "__all__": (
+                        "Subject not known to the META trial. "
+                        "Check that the identifier, initials and gender match the patient "
+                        "register from the main META trial."
+                    )
+                }
+            ) from e
+        try:
+            SpfqList.objects.get(
+                subject_identifier=cleaned_data.get("subject_identifier"),
+            )
+        except ObjectDoesNotExist as e:
+            raise forms.ValidationError(
+                {
+                    "__all__": (
+                        "Subject not found. A subject with this identifier "
+                        "has not been selected for the sub-study."
+                    )
+                }
+            ) from e
+
+        try:
+            SubjectConsentSpfq.objects.get(
+                subject_identifier=cleaned_data.get("subject_identifier"),
+            )
+        except ObjectDoesNotExist as e:
+            raise forms.ValidationError(
+                {"__all__": "Subject not consented for the sub-study."}
+            ) from e
+        return cleaned_data
+
+    class Meta:
+        model = Spfq
+        fields = "__all__"