feat(resources): add tool request demo mutation

Author: sudip-khanal

apps/resources/admin.py

@@ -1,7 +1,7 @@
 # Register your models here.
 from django.contrib import admin
 
-from apps.resources.models import CaseStudy, ContactRequest
+from apps.resources.models import CaseStudy, ContactRequest, RequestDemo
 from apps.tool_picker.admin import ReadOnlyMixin
 
 
@@ -17,3 +17,9 @@ class CaseStudyAdmin(admin.ModelAdmin[CaseStudy]):
     search_fields = ("title",)
     list_select_related = ("tool",)
     autocomplete_fields = ("tool",)
+
+
+@admin.register(RequestDemo)
+class RequestDemoAdmin(ReadOnlyMixin, admin.ModelAdmin[RequestDemo]):
+    list_display = ("name", "email", "national_society", "created_at")
+    search_fields = ("name", "email")

apps/resources/graphql/inputs.py

@@ -1,4 +1,7 @@
 import strawberry
+import strawberry_django
+
+from apps.resources.models import RequestDemo
 
 
 @strawberry.input
@@ -9,3 +12,12 @@ class ContactRequestInput:
     content: str
     captcha_hashkey: str
     captcha_code: str
+
+
+@strawberry_django.input(RequestDemo)
+class RequestDemoInput:
+    name: strawberry.auto
+    email: strawberry.auto
+    content: strawberry.auto
+    national_society: strawberry.auto
+    tool: int

apps/resources/graphql/mutations.py

@@ -1,9 +1,9 @@
 import strawberry
 import strawberry_django
 
-from apps.resources.graphql.inputs import ContactRequestInput
-from apps.resources.graphql.types import ContactRequestType
-from apps.resources.serializers import ContactRequestSerializer
+from apps.resources.graphql.inputs import ContactRequestInput, RequestDemoInput
+from apps.resources.graphql.types import ContactRequestType, RequestDemoType
+from apps.resources.serializers import ContactRequestSerializer, RequestDemoSerializer
 from main.graphql.context import Info
 from utils.graphql.mutations import ModelMutation
 from utils.graphql.types import MutationResponseType
@@ -18,3 +18,11 @@ async def create_contact_request(
         data: ContactRequestInput,
     ) -> MutationResponseType[ContactRequestType]:
         return await ModelMutation(ContactRequestSerializer).handle_create_mutation(data, info, None)
+
+    @strawberry_django.mutation()
+    async def create_demo_request(
+        self,
+        info: Info,
+        data: RequestDemoInput,
+    ) -> MutationResponseType[RequestDemoType]:
+        return await ModelMutation(RequestDemoSerializer).handle_create_mutation(data, info, None)

apps/resources/graphql/types.py

@@ -1,7 +1,7 @@
 import strawberry
 import strawberry_django
 
-from apps.resources.models import CaseStudy, ContactRequest
+from apps.resources.models import CaseStudy, ContactRequest, RequestDemo
 from utils.graphql.types import DjangoFileType
 
 
@@ -23,3 +23,14 @@ class ContactRequestType:
     created_at: strawberry.auto
     content: strawberry.auto
     national_society: strawberry.auto
+
+
+@strawberry_django.type(RequestDemo)
+class RequestDemoType:
+    id: strawberry.ID
+    name: strawberry.auto
+    email: strawberry.auto
+    created_at: strawberry.auto
+    content: strawberry.auto
+    national_society: strawberry.auto
+    tool: strawberry.auto

apps/resources/migrations/0003_requestdemo.py

@@ -0,0 +1,30 @@
+# Generated by Django 5.2.9 on 2026-03-17 08:23
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('resources', '0002_casestudy_link'),
+        ('tool_picker', '0004_alter_checkboxoption_order_alter_question_order'),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='RequestDemo',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('name', models.CharField(max_length=200)),
+                ('email', models.CharField(max_length=200)),
+                ('created_at', models.DateTimeField(auto_now_add=True)),
+                ('national_society', models.CharField(max_length=200)),
+                ('content', models.TextField(blank=True, null=True)),
+                ('tool', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='request_demo_tool', to='tool_picker.tool', verbose_name='Related Tool')),
+            ],
+            options={
+                'ordering': ['name'],
+            },
+        ),
+    ]

apps/resources/models.py

@@ -52,3 +52,26 @@ class Meta(UserResource.Meta):
     @typing.override
     def __str__(self):
         return self.title
+
+
+class RequestDemo(models.Model):
+    """Model representing contact where anyone can request the tool demo to the admins."""
+
+    name = models.CharField[str, str](max_length=200)
+    email = models.CharField[str, str](max_length=200)
+    created_at = models.DateTimeField[datetime.datetime, datetime.datetime](auto_now_add=True)
+    national_society = models.CharField[str, str](max_length=200)
+    content = models.TextField[str, str](blank=True, null=True)
+    tool = models.ForeignKey[Tool, Tool](
+        Tool,
+        related_name="request_demo_tool",
+        verbose_name="Related Tool",
+        on_delete=models.CASCADE,
+    )
+
+    class Meta:
+        ordering = ["name"]
+
+    @typing.override
+    def __str__(self):
+        return self.name

apps/resources/serializers.py

@@ -3,7 +3,8 @@
 from captcha.serializers import CaptchaModelSerializer
 from rest_framework import serializers
 
-from apps.resources.models import ContactRequest
+from apps.resources.models import ContactRequest, RequestDemo
+from apps.tool_picker.models import Tool
 
 
 class ContactRequestSerializer(CaptchaModelSerializer):
@@ -26,3 +27,19 @@ def create(self, validated_data: dict[str, typing.Any]):
         validated_data.pop("captcha_code", None)
         validated_data.pop("captcha_hashkey", None)
         return super().create(validated_data)
+
+
+class RequestDemoSerializer(serializers.ModelSerializer):
+    tool = serializers.PrimaryKeyRelatedField(
+        queryset=Tool.objects.all(),
+    )
+
+    class Meta:
+        model = RequestDemo
+        fields = (
+            "name",
+            "email",
+            "national_society",
+            "content",
+            "tool",
+        )

apps/resources/tests/mutation_test.py

@@ -2,7 +2,8 @@
 
 from captcha.models import CaptchaStore
 
-from apps.resources.models import ContactRequest
+from apps.resources.models import ContactRequest, RequestDemo
+from apps.tool_picker.factories import ToolFactory
 from apps.user.factories import UserFactory
 from main.tests import TestCase
 
@@ -114,3 +115,78 @@ def test_create_contact_request_without_captcha(self):
                 "pydantic_errors": None,
             },
         ]
+
+
+class TestRequestDemoMutation(TestCase):
+    class Mutation:
+        CREATE_DEMO_REQUEST = """
+            mutation createDemoRequest($data: RequestDemoInput!) {
+            createDemoRequest(data: $data) {
+                ... on RequestDemoTypeMutationResponseType {
+                errors
+                ok
+                result {
+                    id
+                    name
+                    email
+                    nationalSociety
+                    content
+                    tool{
+                        pk
+                    }
+                }
+                }
+                ... on OperationInfo {
+                __typename
+                messages {
+                    code
+                    field
+                    kind
+                    message
+                 }
+                }
+            }
+        }
+        """
+
+    @typing.override
+    @classmethod
+    def setUpClass(cls):
+        super().setUpClass()
+        cls.user = UserFactory.create(email="test@gmail.com")
+        cls.tool = ToolFactory.create()
+
+    def _create_tool_demo_request_mutation(self, data: dict[str, str | int], **kwargs: typing.Any):
+        return self.query_check(
+            query=self.Mutation.CREATE_DEMO_REQUEST,
+            variables={
+                "data": data,
+            },
+        )
+
+    def test_create_tool_demo_request(self):
+        tool_demo_request_data = {
+            "name": "John",
+            "email": "john@test.com",
+            "nationalSociety": "Test National Society",
+            "content": "This is test content",
+            "tool": self.tool.id,
+        }
+
+        content = self._create_tool_demo_request_mutation(data=tool_demo_request_data)
+        response_data = content["data"]["createDemoRequest"]
+
+        assert response_data["ok"] is True
+        assert response_data["errors"] is None
+
+        demo_request = RequestDemo.objects.get(pk=response_data["result"]["id"])
+        assert response_data["result"] == {
+            "id": self.gID(demo_request.pk),
+            "name": demo_request.name,
+            "email": demo_request.email,
+            "content": demo_request.content,
+            "nationalSociety": demo_request.national_society,
+            "tool": {
+                "pk": self.gID(demo_request.tool.pk),
+            },
+        }

schema.graphql

@@ -119,6 +119,8 @@ type ContactRequestTypeMutationResponseType {
 
 union CreateContactRequestPayload = ContactRequestTypeMutationResponseType | OperationInfo
 
+union CreateDemoRequestPayload = RequestDemoTypeMutationResponseType | OperationInfo
+
 union CreateUserSubmissionPayload = UserSubmissionTypeMutationResponseType | OperationInfo
 
 """A generic type to return error messages"""
@@ -133,8 +135,13 @@ type DjangoFileType {
   url: String!
 }
 
+type DjangoModelType {
+  pk: ID!
+}
+
 type Mutation {
   createContactRequest(data: ContactRequestInput!): CreateContactRequestPayload!
+  createDemoRequest(data: RequestDemoInput!): CreateDemoRequestPayload!
   createUserSubmission(data: UserSubmissionInput!): CreateUserSubmissionPayload!
 }
 
@@ -273,6 +280,36 @@ type RecommendationResultTypeOffsetPaginated {
   results: [RecommendationResultType!]!
 }
 
+"""
+Model representing contact where anyone can request the tool demo to the admins.
+"""
+input RequestDemoInput {
+  name: String!
+  email: String!
+  content: String
+  nationalSociety: String!
+  tool: Int!
+}
+
+"""
+Model representing contact where anyone can request the tool demo to the admins.
+"""
+type RequestDemoType {
+  id: ID!
+  name: String!
+  email: String!
+  createdAt: DateTime!
+  content: String
+  nationalSociety: String!
+  tool: DjangoModelType!
+}
+
+type RequestDemoTypeMutationResponseType {
+  ok: Boolean!
+  errors: CustomErrorType
+  result: RequestDemoType
+}
+
 """Model representing tool's selection of question and its answer."""
 type ToolAnswerType {
   id: ID!