feat: add exchange rate config page

app/apps/currencies/forms.py

@@ -6,7 +6,8 @@ from django.forms import CharField
 from django.utils.translation import gettext_lazy as _
 
 from apps.common.widgets.crispy.submit import NoClassSubmit
-from apps.currencies.models import Currency
+from apps.common.widgets.decimal import ArbitraryDecimalDisplayNumberInput
+from apps.currencies.models import Currency, ExchangeRate
 
 
 class CurrencyForm(forms.ModelForm):
@@ -43,3 +44,42 @@ class CurrencyForm(forms.ModelForm):
                     ),
                 ),
             )
+
+
+class ExchangeRateForm(forms.ModelForm):
+    date = forms.DateTimeField(
+        widget=forms.DateTimeInput(
+            attrs={"type": "datetime-local"}, format="%Y-%m-%dT%H:%M"
+        )
+    )
+
+    class Meta:
+        model = ExchangeRate
+        fields = ["from_currency", "to_currency", "rate", "date"]
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+
+        self.helper = FormHelper()
+        self.helper.form_tag = False
+        self.helper.form_method = "post"
+        self.helper.layout = Layout("date", "from_currency", "to_currency", "rate")
+
+        self.fields["rate"].widget = ArbitraryDecimalDisplayNumberInput()
+
+        if self.instance and self.instance.pk:
+            self.helper.layout.append(
+                FormActions(
+                    NoClassSubmit(
+                        "submit", _("Update"), css_class="btn btn-outline-primary w-100"
+                    ),
+                ),
+            )
+        else:
+            self.helper.layout.append(
+                FormActions(
+                    NoClassSubmit(
+                        "submit", _("Add"), css_class="btn btn-outline-primary w-100"
+                    ),
+                ),
+            )

app/apps/currencies/urls.py

@@ -16,4 +16,17 @@ urlpatterns = [
         views.currency_delete,
         name="currency_delete",
     ),
+    path("exchange-rates/", views.exchange_rates_index, name="exchange_rates_index"),
+    path("exchange-rates/list/", views.exchange_rates_list, name="exchange_rates_list"),
+    path("exchange-rates/add/", views.exchange_rate_add, name="exchange_rate_add"),
+    path(
+        "exchange-rates/<int:pk>/edit/",
+        views.exchange_rate_edit,
+        name="exchange_rate_edit",
+    ),
+    path(
+        "exchange-rates/<int:pk>/delete/",
+        views.exchange_rate_delete,
+        name="exchange_rate_delete",
+    ),
 ]

app/apps/currencies/views/__init__.py

@@ -0,0 +1,2 @@
+from .currencies import *
+from .exchange_rates import *

app/apps/currencies/views/exchange_rates.py

@@ -0,0 +1,105 @@
+from django.contrib import messages
+from django.contrib.auth.decorators import login_required
+from django.http import HttpResponse
+from django.shortcuts import render, get_object_or_404
+from django.utils.translation import gettext_lazy as _
+from django.views.decorators.csrf import csrf_exempt
+from django.views.decorators.http import require_http_methods
+
+from apps.common.decorators.htmx import only_htmx
+from apps.currencies.forms import ExchangeRateForm
+from apps.currencies.models import ExchangeRate
+
+
+@login_required
+@require_http_methods(["GET"])
+def exchange_rates_index(request):
+    return render(
+        request,
+        "exchange_rates/pages/index.html",
+    )
+
+
+@only_htmx
+@login_required
+@require_http_methods(["GET"])
+def exchange_rates_list(request):
+    exchange_rates = ExchangeRate.objects.all().order_by("-date")
+    return render(
+        request,
+        "exchange_rates/fragments/list.html",
+        {"exchange_rates": exchange_rates},
+    )
+
+
+@only_htmx
+@login_required
+@require_http_methods(["GET", "POST"])
+def exchange_rate_add(request):
+    if request.method == "POST":
+        form = ExchangeRateForm(request.POST)
+        if form.is_valid():
+            form.save()
+            messages.success(request, _("Exchange rate added successfully"))
+
+            return HttpResponse(
+                status=204,
+                headers={
+                    "HX-Trigger": "updated, hide_offcanvas, toasts",
+                },
+            )
+    else:
+        form = ExchangeRateForm()
+
+    return render(
+        request,
+        "exchange_rates/fragments/add.html",
+        {"form": form},
+    )
+
+
+@only_htmx
+@login_required
+@require_http_methods(["GET", "POST"])
+def exchange_rate_edit(request, pk):
+    exchange_rate = get_object_or_404(ExchangeRate, id=pk)
+
+    if request.method == "POST":
+        form = ExchangeRateForm(request.POST, instance=exchange_rate)
+        if form.is_valid():
+            form.save()
+            messages.success(request, _("Exchange rate updated successfully"))
+
+            return HttpResponse(
+                status=204,
+                headers={
+                    "HX-Trigger": "updated, hide_offcanvas, toasts",
+                },
+            )
+    else:
+        form = ExchangeRateForm(instance=exchange_rate)
+
+    return render(
+        request,
+        "exchange_rates/fragments/edit.html",
+        {"form": form, "exchange_rate": exchange_rate},
+    )
+
+
+@only_htmx
+@login_required
+@csrf_exempt
+@require_http_methods(["DELETE"])
+def exchange_rate_delete(request, pk):
+    exchange_rate = get_object_or_404(ExchangeRate, id=pk)
+
+    exchange_rate.delete()
+
+    messages.success(request, _("Exchange rate deleted successfully"))
+
+    return HttpResponse(
+        status=204,
+        headers={
+            "HX-Trigger": "updated, hide_offcanvas, toasts",
+        },
+    )

app/templates/exchange_rates/fragments/add.html

@@ -0,0 +1,11 @@
+{% extends 'extends/offcanvas.html' %}
+{% load i18n %}
+{% load crispy_forms_tags %}
+
+{% block title %}{% translate 'Add exchange rate' %}{% endblock %}
+
+{% block body %}
+<form hx-post="{% url 'exchange_rate_add' %}" hx-target="#generic-offcanvas" novalidate>
+    {% crispy form %}
+</form>
+{% endblock %}

app/templates/exchange_rates/fragments/edit.html

@@ -0,0 +1,11 @@
+{% extends 'extends/offcanvas.html' %}
+{% load i18n %}
+{% load crispy_forms_tags %}
+
+{% block title %}{% translate 'Edit exchange rate' %}{% endblock %}
+
+{% block body %}
+<form hx-post="{% url 'exchange_rate_edit' pk=exchange_rate.id %}" hx-target="#generic-offcanvas" novalidate>
+    {% crispy form %}
+</form>
+{% endblock %}

app/templates/exchange_rates/fragments/list.html

@@ -0,0 +1,59 @@
+{% load currency_display %}
+{% load i18n %}
+<div class="container px-md-3 py-3 column-gap-5">
+  <div class="tw-text-3xl fw-bold font-monospace tw-w-full mb-3">
+    {% spaceless %}
+    <div>{% translate 'Exchange Rates' %}<span>
+      <a class="text-decoration-none tw-text-2xl p-1 category-action"
+                role="button"
+                data-bs-toggle="tooltip"
+                data-bs-title="{% translate "Add" %}"
+                hx-get="{% url 'exchange_rate_add' %}"
+                hx-target="#generic-offcanvas"
+                _="">
+            <i class="fa-solid fa-circle-plus fa-fw"></i></a>
+    </span></div>
+    {% endspaceless %}
+  </div>
+
+  <div class="border p-3 rounded-3 table-responsive">
+    <table class="table table-hover">
+    <thead>
+      <tr>
+        <th scope="col" class="col-auto"></th>
+        <th scope="col" class="col-auto">{% translate 'Date' %}</th>
+        <th scope="col" class="col">{% translate 'Pairing' %}</th>
+        <th scope="col" class="col">{% translate 'Rate' %}</th>
+      </tr>
+    </thead>
+    <tbody>
+      {% for exchange_rate in exchange_rates %}
+      <tr class="exchange-rate">
+        <td class="col-auto">
+          <a class="text-decoration-none tw-text-gray-400 p-1"
+                role="button"
+                data-bs-toggle="tooltip"
+                data-bs-title="{% translate "Edit" %}"
+                hx-get="{% url 'exchange_rate_edit' pk=exchange_rate.id %}"
+                hx-target="#generic-offcanvas">
+            <i class="fa-solid fa-pencil fa-fw"></i></a>
+          <a class="text-danger text-decoration-none p-1"
+                  role="button"
+                  data-bs-toggle="tooltip"
+                  data-bs-title="{% translate "Delete" %}"
+                  hx-delete="{% url 'exchange_rate_delete' pk=exchange_rate.id %}"
+                  hx-trigger='confirmed'
+                  data-bypass-on-ctrl="true"
+                  data-title="{% translate "Are you sure?" %}"
+                  data-text="{% translate "You won't be able to revert this!" %}"
+                  data-confirm-text="{% translate "Yes, delete it!" %}"
+                  _="install prompt_swal"><i class="fa-solid fa-trash fa-fw"></i></a></td>
+        <td class="col-auto">{{ exchange_rate.date|date:"SHORT_DATETIME_FORMAT" }}</td>
+        <td class="col"><span class="badge rounded-pill text-bg-secondary">{{ exchange_rate.from_currency.code }}</span> x <span class="badge rounded-pill text-bg-secondary">{{ exchange_rate.to_currency.code }}</span></td>
+        <td class="col">1 {{ exchange_rate.from_currency.code }} ≅ {% currency_display amount=exchange_rate.rate prefix=exchange_rate.to_currency.prefix suffix=exchange_rate.to_currency.suffix decimal_places=exchange_rate.to_currency.decimal_places%}</td>
+      </tr>
+      {% endfor %}
+    </tbody>
+  </table>
+  </div>
+</div>

app/templates/exchange_rates/pages/index.html

@@ -0,0 +1,8 @@
+{% extends "layouts/base.html" %}
+{% load i18n %}
+
+{% block title %}{% translate 'Exchange Rates' %}{% endblock %}
+
+{% block content %}
+<div hx-get="{% url 'exchange_rates_list' %}" hx-trigger="load, updated from:window" class="show-loading mx-5"></div>
+{% endblock %}

app/templates/includes/navbar.html

@@ -34,7 +34,7 @@
           </a>
         </li>
         <li class="nav-item dropdown">
-          <a class="nav-link dropdown-toggle {% active_link views='tags_index||categories_index||accounts_index||account_groups_index||currencies_index||installment_plans_index' %}"
+          <a class="nav-link dropdown-toggle {% active_link views='tags_index||categories_index||accounts_index||account_groups_index||currencies_index||exchange_rates_index||installment_plans_index' %}"
              href="#" role="button"
              data-bs-toggle="dropdown"
              aria-expanded="false">
@@ -56,8 +56,14 @@
                    href="{% url 'accounts_index' %}">{% translate 'Accounts' %}</a></li>
             <li><a class="dropdown-item {% active_link views='account_groups_index' %}"
                    href="{% url 'account_groups_index' %}">{% translate 'Account Groups' %}</a></li>
-            <li><a class="dropdown-item {% active_link views='currencies_index' %}"
+            <li>
+              <hr class="dropdown-divider">
+            </li>
+            <li><h6 class="dropdown-header">{% trans 'Currencies' %}</h6></li>
+            <li><a class="dropdown-item {% active_link views='currencies_index' %}" 
                    href="{% url 'currencies_index' %}">{% translate 'Currencies' %}</a></li>
+            <li><a class="dropdown-item {% active_link views='exchange_rates_index' %}" 
+                   href="{% url 'exchange_rates_index' %}">{% translate 'Exchange Rates' %}</a></li>
             <li>
               <hr class="dropdown-divider">
             </li>