feat(clients): add client management views and URL routes

Implement client management functionality with CRUD operations, including list, create, edit, and delete views. The changes introduce URL routing and form handling for client interactions.

**New Features**
- **Client CRUD operations**: Added views for listing, creating, editing, and deleting client records
- **ClientForm**: Introduced a model form with phone number formatting and initial country code
- **HTMX support**: Implemented conditional template rendering for HTMX-based partial updates

**Enhancements & Refinements**
- **Form styling**: Enhanced phone number input fields with custom widget attributes
- **Form behavior**: Disabled short_code field input while maintaining model structure
- **Route organization**: Structured URL patterns for client operations in `urls.py`

src/api/clients/urls.py

@@ -0,0 +1,10 @@
+from django.urls import path
+
+from src.api.clients import views
+
+urlpatterns = [
+    path("", views.client_list, name="client_list"),
+    path("create/", views.client_create, name="client_create"),
+    path("<int:pk>/edit/", views.client_edit, name="client_edit"),
+    path("<int:pk>/delete/", views.client_delete, name="client_delete"),
+]

src/api/clients/views.py

@@ -0,0 +1,91 @@
+from django import forms
+from django.shortcuts import get_object_or_404, redirect, render
+from django.views.decorators.http import require_http_methods
+from phonenumber_field.formfields import SplitPhoneNumberField
+
+from src.models.clients import Client
+
+
+class ClientForm(forms.ModelForm):
+    phone = SplitPhoneNumberField(initial="+977")
+
+    class Meta:
+        model = Client
+        fields = ["name", "email", "phone", "company_name", "address", "short_code"]
+        widgets = {
+            "short_code": forms.TextInput(attrs={"placeholder": "Optional"}),
+        }
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self.fields["phone"].widget.widgets[0].attrs.update(
+            {"class": "select select-bordered join-item"}
+        )
+        self.fields["phone"].widget.widgets[1].attrs.update(
+            {"class": "input input-bordered join-item w-full"}
+        )
+        self.fields["short_code"].disabled = True
+
+
+def client_list(request):
+    clients = Client.objects.all()
+    return render(request, "clients/client_list.html", {"clients": clients})
+
+
+@require_http_methods(["GET", "POST"])
+def client_create(request):
+    if request.method == "POST":
+        form = ClientForm(request.POST)
+        if form.is_valid():
+            form.save()
+            if request.htmx:
+                clients = Client.objects.all()
+                return render(
+                    request, "clients/partials/client_list.html", {"clients": clients}
+                )
+            return redirect("client_list")
+    else:
+        form = ClientForm()
+
+    template = (
+        "clients/partials/client_form.html"
+        if request.htmx
+        else "clients/client_form.html"
+    )
+    return render(request, template, {"form": form})
+
+
+@require_http_methods(["GET", "POST"])
+def client_edit(request, pk):
+    client = get_object_or_404(Client, pk=pk)
+    if request.method == "POST":
+        form = ClientForm(request.POST, instance=client)
+        if form.is_valid():
+            form.save()
+            if request.htmx:
+                clients = Client.objects.all()
+                return render(
+                    request, "clients/partials/client_list.html", {"clients": clients}
+                )
+            return redirect("client_list")
+    else:
+        form = ClientForm(instance=client)
+
+    template = (
+        "clients/partials/client_form.html"
+        if request.htmx
+        else "clients/client_form.html"
+    )
+    return render(request, template, {"form": form, "client": client})
+
+
+@require_http_methods(["DELETE", "POST"])
+def client_delete(request, pk):
+    client = get_object_or_404(Client, pk=pk)
+    client.delete()
+    if request.htmx:
+        clients = Client.objects.all()
+        return render(
+            request, "clients/partials/client_list.html", {"clients": clients}
+        )
+    return redirect("client_list")