arthexis 0.1.7__tar.gz → 0.1.8__tar.gz

{arthexis-0.1.7 → arthexis-0.1.8}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: arthexis
-Version: 0.1.7
+Version: 0.1.8
 Summary: Django-based MESH system
-Author-email: "Rafael J. Guillén-Osorio" <tecnologia@gelectriic.com>
+Author-email: "Rafael J. Guillén-Osorio" <tecnologia@gelectriic.com>
 License-Expression: MIT
 Project-URL: Repository, https://github.com/arthexis/arthexis
 Project-URL: Homepage, https://arthexis.com
@@ -109,18 +109,22 @@ Dynamic: license-file
 # Arthexis Constellation
 
 ## Purpose
-Arthexis Constellation is a narrative-driven Django-based suite that centralizes tools for managing charging infrastructure and orchestrating energy related products and services.
+
+Arthexis Constellation is a [narrative-driven](https://en.wikipedia.org/wiki/Narrative) [Django](https://www.djangoproject.com/)-based [software suite](https://en.wikipedia.org/wiki/Software_suite) that centralizes tools for managing [electric vehicle charging infrastructure](https://en.wikipedia.org/wiki/Charging_station) and orchestrating [energy](https://en.wikipedia.org/wiki/Energy)-related [products](https://en.wikipedia.org/wiki/Product_(business)) and [services](https://en.wikipedia.org/wiki/Service_(economics)).
 
 ## Features
-- Compatible with OCPP 1.6+ chargers
-- API integration with Odoo 1.6+
-- Runs on Windows and Linux (Ubuntu 16+)
-- One codebase. Six* specialized Roles.
+
+- Compatible with the [Open Charge Point Protocol (OCPP) 1.6](https://www.openchargealliance.org/protocols/ocpp-16/)
+- [API](https://en.wikipedia.org/wiki/API) integration with [Odoo](https://www.odoo.com/) 1.6
+- Runs on [Windows 11](https://www.microsoft.com/windows/windows-11) and [Ubuntu 22.04 LTS](https://releases.ubuntu.com/22.04/)
+- Tested for the [Raspberry Pi 4 Model B](https://www.raspberrypi.com/products/raspberry-pi-4-model-b/)
 
 ## Support
-Contact us at tecnologia at gelectriic dot com or visit our [web page](https://www.gelectriic.com/) for professional services and commercial support.
+
+Contact us at [tecnologia@gelectriic.com](mailto:tecnologia@gelectriic.com) or visit our [web page](https://www.gelectriic.com/) for [professional services](https://en.wikipedia.org/wiki/Professional_services) and [commercial support](https://en.wikipedia.org/wiki/Technical_support).
 
 ## About Me
-> "What, you wanna know about me too? Well, I enjoy developing software, role-playing games, long walks on the beach and a fourth secret thing."
+
+> "What, you want to know about me too? Well, I enjoy [developing software](https://en.wikipedia.org/wiki/Software_development), [role-playing games](https://en.wikipedia.org/wiki/Role-playing_game), long walks on the [beach](https://en.wikipedia.org/wiki/Beach) and a fourth secret thing."
 > --Arthexis
 

arthexis-0.1.8/README.md

@@ -0,0 +1,22 @@
+# Arthexis Constellation
+
+## Purpose
+
+Arthexis Constellation is a [narrative-driven](https://en.wikipedia.org/wiki/Narrative) [Django](https://www.djangoproject.com/)-based [software suite](https://en.wikipedia.org/wiki/Software_suite) that centralizes tools for managing [electric vehicle charging infrastructure](https://en.wikipedia.org/wiki/Charging_station) and orchestrating [energy](https://en.wikipedia.org/wiki/Energy)-related [products](https://en.wikipedia.org/wiki/Product_(business)) and [services](https://en.wikipedia.org/wiki/Service_(economics)).
+
+## Features
+
+- Compatible with the [Open Charge Point Protocol (OCPP) 1.6](https://www.openchargealliance.org/protocols/ocpp-16/)
+- [API](https://en.wikipedia.org/wiki/API) integration with [Odoo](https://www.odoo.com/) 1.6
+- Runs on [Windows 11](https://www.microsoft.com/windows/windows-11) and [Ubuntu 22.04 LTS](https://releases.ubuntu.com/22.04/)
+- Tested for the [Raspberry Pi 4 Model B](https://www.raspberrypi.com/products/raspberry-pi-4-model-b/)
+
+## Support
+
+Contact us at [tecnologia@gelectriic.com](mailto:tecnologia@gelectriic.com) or visit our [web page](https://www.gelectriic.com/) for [professional services](https://en.wikipedia.org/wiki/Professional_services) and [commercial support](https://en.wikipedia.org/wiki/Technical_support).
+
+## About Me
+
+> "What, you want to know about me too? Well, I enjoy [developing software](https://en.wikipedia.org/wiki/Software_development), [role-playing games](https://en.wikipedia.org/wiki/Role-playing_game), long walks on the [beach](https://en.wikipedia.org/wiki/Beach) and a fourth secret thing."
+> --Arthexis
+

{arthexis-0.1.7 → arthexis-0.1.8}/arthexis.egg-info/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: arthexis
-Version: 0.1.7
+Version: 0.1.8
 Summary: Django-based MESH system
-Author-email: "Rafael J. Guillén-Osorio" <tecnologia@gelectriic.com>
+Author-email: "Rafael J. Guillén-Osorio" <tecnologia@gelectriic.com>
 License-Expression: MIT
 Project-URL: Repository, https://github.com/arthexis/arthexis
 Project-URL: Homepage, https://arthexis.com
@@ -109,18 +109,22 @@ Dynamic: license-file
 # Arthexis Constellation
 
 ## Purpose
-Arthexis Constellation is a narrative-driven Django-based suite that centralizes tools for managing charging infrastructure and orchestrating energy related products and services.
+
+Arthexis Constellation is a [narrative-driven](https://en.wikipedia.org/wiki/Narrative) [Django](https://www.djangoproject.com/)-based [software suite](https://en.wikipedia.org/wiki/Software_suite) that centralizes tools for managing [electric vehicle charging infrastructure](https://en.wikipedia.org/wiki/Charging_station) and orchestrating [energy](https://en.wikipedia.org/wiki/Energy)-related [products](https://en.wikipedia.org/wiki/Product_(business)) and [services](https://en.wikipedia.org/wiki/Service_(economics)).
 
 ## Features
-- Compatible with OCPP 1.6+ chargers
-- API integration with Odoo 1.6+
-- Runs on Windows and Linux (Ubuntu 16+)
-- One codebase. Six* specialized Roles.
+
+- Compatible with the [Open Charge Point Protocol (OCPP) 1.6](https://www.openchargealliance.org/protocols/ocpp-16/)
+- [API](https://en.wikipedia.org/wiki/API) integration with [Odoo](https://www.odoo.com/) 1.6
+- Runs on [Windows 11](https://www.microsoft.com/windows/windows-11) and [Ubuntu 22.04 LTS](https://releases.ubuntu.com/22.04/)
+- Tested for the [Raspberry Pi 4 Model B](https://www.raspberrypi.com/products/raspberry-pi-4-model-b/)
 
 ## Support
-Contact us at tecnologia at gelectriic dot com or visit our [web page](https://www.gelectriic.com/) for professional services and commercial support.
+
+Contact us at [tecnologia@gelectriic.com](mailto:tecnologia@gelectriic.com) or visit our [web page](https://www.gelectriic.com/) for [professional services](https://en.wikipedia.org/wiki/Professional_services) and [commercial support](https://en.wikipedia.org/wiki/Technical_support).
 
 ## About Me
-> "What, you wanna know about me too? Well, I enjoy developing software, role-playing games, long walks on the beach and a fourth secret thing."
+
+> "What, you want to know about me too? Well, I enjoy [developing software](https://en.wikipedia.org/wiki/Software_development), [role-playing games](https://en.wikipedia.org/wiki/Role-playing_game), long walks on the [beach](https://en.wikipedia.org/wiki/Beach) and a fourth secret thing."
 > --Arthexis
 

{arthexis-0.1.7 → arthexis-0.1.8}/arthexis.egg-info/SOURCES.txt

@@ -23,6 +23,7 @@ config/workgroup_app.py
 config/wsgi.py
 core/__init__.py
 core/admin.py
+core/admindocs.py
 core/apps.py
 core/backends.py
 core/checks.py
@@ -41,6 +42,8 @@ core/tests.py
 core/urls.py
 core/user_data.py
 core/views.py
+core/workgroup_urls.py
+core/workgroup_views.py
 nodes/__init__.py
 nodes/actions.py
 nodes/admin.py
@@ -79,10 +82,14 @@ pages/urls.py
 pages/utils.py
 pages/views.py
 tests/test_acronym_capitalization.py
+tests/test_admin_doc_commands.py
 tests/test_admin_history.py
 tests/test_admin_index_actions.py
 tests/test_awg_admin.py
+tests/test_business_admin_group.py
 tests/test_celery_no_debug.py
+tests/test_chat_profile_admin.py
+tests/test_chat_profile_api.py
 tests/test_csrf_failure.py
 tests/test_csrf_origin_subnet.py
 tests/test_dist_cleanup.py
@@ -92,6 +99,7 @@ tests/test_email_inbox_admin.py
 tests/test_email_inbox_search_action.py
 tests/test_env_refresh_clean.py
 tests/test_env_refresh_unlink.py
+tests/test_experience_admin_group.py
 tests/test_fixture_check.py
 tests/test_footer_no_references.py
 tests/test_footer_presence.py
@@ -119,7 +127,9 @@ tests/test_rfid_admin_scan_csrf.py
 tests/test_rfid_background_reader.py
 tests/test_save_as_copy.py
 tests/test_seed_data.py
+tests/test_show_leads_command.py
 tests/test_sigil_resolution.py
+tests/test_update_fixtures_command.py
 tests/test_urls_autodiscover.py
 tests/test_user_datum_admin.py
 tests/test_version_file.py

{arthexis-0.1.7 → arthexis-0.1.8}/config/settings.py

@@ -85,6 +85,7 @@ ALLOWED_HOSTS = [
     "10.42.0.0/16",
     "192.168.0.0/16",
     "arthexis.com",
+    "www.arthexis.com",
 ]
 
 

{arthexis-0.1.7 → arthexis-0.1.8}/config/urls.py

@@ -13,12 +13,15 @@ from django.apps import apps
 from django.conf import settings
 from django.conf.urls.static import static
 from django.contrib import admin
+from django.contrib.admin import autodiscover
 from django.urls import include, path
 from django.views.decorators.csrf import csrf_exempt
 from django.views.i18n import set_language
 from django.utils.translation import gettext_lazy as _
 from core import views as core_views
+from core.admindocs import CommandsView
 
+autodiscover()
 admin.site.site_header = _("Constellation")
 admin.site.site_title = _("Constellation")
 
@@ -61,6 +64,11 @@ def autodiscovered_urlpatterns():
 
 
 urlpatterns = [
+    path(
+        "admin/doc/commands/",
+        CommandsView.as_view(),
+        name="django-admindocs-commands",
+    ),
     path("admin/doc/", include("django.contrib.admindocs.urls")),
     path(
         "admin/core/releases/<int:pk>/<str:action>/",
@@ -69,6 +77,7 @@ urlpatterns = [
     ),
     path("admin/", admin.site.urls),
     path("i18n/setlang/", csrf_exempt(set_language), name="set_language"),
+    path("api/", include("core.workgroup_urls")),
     path("", include("pages.urls")),
 ]
 

{arthexis-0.1.7 → arthexis-0.1.8}/core/admin.py

@@ -3,7 +3,7 @@ from django.contrib import admin
 from django.contrib.admin.widgets import RelatedFieldWidgetWrapper
 from django.urls import path, reverse
 from django.shortcuts import redirect, render
-from django.http import JsonResponse, HttpResponseBase
+from django.http import JsonResponse, HttpResponseBase, HttpResponseRedirect
 from django.template.response import TemplateResponse
 from django.views.decorators.csrf import csrf_exempt
 from django.core.exceptions import ValidationError
@@ -45,6 +45,7 @@ from .models import (
     ReleaseManager,
     SecurityGroup,
     InviteLead,
+    ChatProfile,
 )
 from .user_data import UserDatumAdminMixin
 
@@ -52,6 +53,30 @@ from .user_data import UserDatumAdminMixin
 admin.site.unregister(Group)
 
 
+class WorkgroupReleaseManager(ReleaseManager):
+    class Meta:
+        proxy = True
+        app_label = "post_office"
+        verbose_name = ReleaseManager._meta.verbose_name
+        verbose_name_plural = ReleaseManager._meta.verbose_name_plural
+
+
+class WorkgroupSecurityGroup(SecurityGroup):
+    class Meta:
+        proxy = True
+        app_label = "post_office"
+        verbose_name = SecurityGroup._meta.verbose_name
+        verbose_name_plural = SecurityGroup._meta.verbose_name_plural
+
+
+class ExperienceReference(Reference):
+    class Meta:
+        proxy = True
+        app_label = "pages"
+        verbose_name = Reference._meta.verbose_name
+        verbose_name_plural = Reference._meta.verbose_name_plural
+
+
 class SaveBeforeChangeAction(DjangoObjectActions):
     def response_change(self, request, obj):
         action = request.POST.get("_action")
@@ -65,7 +90,7 @@ class SaveBeforeChangeAction(DjangoObjectActions):
         return super().response_change(request, obj)
 
 
-@admin.register(Reference)
+@admin.register(ExperienceReference)
 class ReferenceAdmin(admin.ModelAdmin):
     list_display = (
         "alt_text",
@@ -141,14 +166,20 @@ class ReferenceAdmin(admin.ModelAdmin):
     qr_code.short_description = "QR Code"
 
 
-@admin.register(ReleaseManager)
+@admin.register(WorkgroupReleaseManager)
 class ReleaseManagerAdmin(admin.ModelAdmin):
     list_display = ("user", "pypi_username", "pypi_url")
 
 
 @admin.register(Package)
 class PackageAdmin(SaveBeforeChangeAction, admin.ModelAdmin):
-    list_display = ("name", "description", "homepage_url", "release_manager")
+    list_display = (
+        "name",
+        "description",
+        "homepage_url",
+        "release_manager",
+        "is_active",
+    )
     actions = ["prepare_next_release"]
     change_actions = ["prepare_next_release_action"]
 
@@ -177,6 +208,24 @@ class PackageAdmin(SaveBeforeChangeAction, admin.ModelAdmin):
             reverse("admin:core_packagerelease_change", args=[release.pk])
         )
 
+    def get_urls(self):
+        urls = super().get_urls()
+        custom = [
+            path(
+                "prepare-next-release/",
+                self.admin_site.admin_view(self.prepare_next_release_active),
+                name="core_package_prepare_next_release",
+            )
+        ]
+        return custom + urls
+
+    def prepare_next_release_active(self, request):
+        package = Package.objects.filter(is_active=True).first()
+        if not package:
+            self.message_user(request, "No active package", messages.ERROR)
+            return redirect("admin:core_package_changelist")
+        return self._prepare(request, package)
+
     @admin.action(description="Prepare next Release")
     def prepare_next_release(self, request, queryset):
         if queryset.count() != 1:
@@ -201,7 +250,7 @@ class SecurityGroupAdminForm(forms.ModelForm):
     )
 
     class Meta:
-        model = SecurityGroup
+        model = WorkgroupSecurityGroup
         fields = "__all__"
 
     def __init__(self, *args, **kwargs):
@@ -219,7 +268,7 @@ class SecurityGroupAdminForm(forms.ModelForm):
         return instance
 
 
-@admin.register(SecurityGroup)
+@admin.register(WorkgroupSecurityGroup)
 class SecurityGroupAdmin(DjangoGroupAdmin):
     form = SecurityGroupAdminForm
     fieldsets = ((None, {"fields": ("name", "parent", "users", "permissions")}),)
@@ -517,6 +566,46 @@ class EmailInboxAdmin(admin.ModelAdmin):
         return TemplateResponse(request, "admin/core/emailinbox/search.html", context)
 
 
+class WorkgroupChatProfile(ChatProfile):
+    class Meta:
+        proxy = True
+        app_label = "post_office"
+        verbose_name = ChatProfile._meta.verbose_name
+        verbose_name_plural = ChatProfile._meta.verbose_name_plural
+
+
+@admin.register(WorkgroupChatProfile)
+class ChatProfileAdmin(admin.ModelAdmin):
+    list_display = ("user", "created_at", "last_used_at", "is_active")
+    readonly_fields = ("user_key_hash",)
+
+    change_form_template = "admin/workgroupchatprofile_change_form.html"
+
+    def get_urls(self):
+        urls = super().get_urls()
+        custom = [
+            path(
+                "<path:object_id>/generate-key/",
+                self.admin_site.admin_view(self.generate_key),
+                name="post_office_workgroupchatprofile_generate_key",
+            ),
+        ]
+        return custom + urls
+
+    def generate_key(self, request, object_id, *args, **kwargs):
+        profile = self.get_object(request, object_id)
+        if profile is None:
+            return HttpResponseRedirect("../")
+        profile, key = ChatProfile.issue_key(profile.user)
+        context = {
+            **self.admin_site.each_context(request),
+            "opts": self.model._meta,
+            "original": profile,
+            "user_key": key,
+        }
+        return TemplateResponse(request, "admin/chatprofile_key.html", context)
+
+
 class EnergyCreditInline(admin.TabularInline):
     model = EnergyCredit
     fields = ("amount_kw", "created_by", "created_on")
@@ -720,6 +809,7 @@ class RFIDForm(forms.ModelForm):
         super().__init__(*args, **kwargs)
         self.fields["reference"].required = False
         rel = RFID._meta.get_field("reference").remote_field
+        rel.model = ExperienceReference
         widget = self.fields["reference"].widget
         self.fields["reference"].widget = RelatedFieldWidgetWrapper(
             widget,
@@ -809,6 +899,7 @@ class PackageReleaseAdmin(SaveBeforeChangeAction, admin.ModelAdmin):
     list_display_links = ("version",)
     actions = ["publish_release", "validate_releases"]
     change_actions = ["publish_release_action"]
+    changelist_actions = ["refresh_from_pypi"]
     readonly_fields = ("pypi_url", "is_current", "revision")
     fields = (
         "package",
@@ -829,6 +920,46 @@ class PackageReleaseAdmin(SaveBeforeChangeAction, admin.ModelAdmin):
 
     revision_short.short_description = "revision"
 
+    def refresh_from_pypi(self, request, queryset):
+        package = Package.objects.filter(is_active=True).first()
+        if not package:
+            self.message_user(request, "No active package", messages.ERROR)
+            return
+        try:
+            resp = requests.get(
+                f"https://pypi.org/pypi/{package.name}/json", timeout=10
+            )
+            resp.raise_for_status()
+        except Exception as exc:  # pragma: no cover - network failure
+            self.message_user(request, str(exc), messages.ERROR)
+            return
+        releases = resp.json().get("releases", {})
+        created = 0
+        for version in releases:
+            exists = PackageRelease.all_objects.filter(
+                package=package, version=version
+            ).exists()
+            if not exists:
+                PackageRelease.objects.create(
+                    package=package,
+                    release_manager=package.release_manager,
+                    version=version,
+                    pypi_url=f"https://pypi.org/project/{package.name}/{version}/",
+                )
+                created += 1
+        if created:
+            PackageRelease.dump_fixture()
+            self.message_user(
+                request,
+                f"Created {created} release{'s' if created != 1 else ''} from PyPI",
+                messages.SUCCESS,
+            )
+        else:
+            self.message_user(request, "No new releases found", messages.INFO)
+
+    refresh_from_pypi.label = "Refresh from PyPI"
+    refresh_from_pypi.short_description = "Refresh from PyPI"
+
     def _publish_release(self, request, release):
         try:
             release.full_clean()

arthexis-0.1.8/core/admindocs.py

@@ -0,0 +1,44 @@
+import argparse
+from django.core.management import get_commands, load_command_class
+from django.contrib.admindocs.views import BaseAdminDocsView
+
+
+class CommandsView(BaseAdminDocsView):
+    template_name = "admin_doc/commands.html"
+
+    def get_context_data(self, **kwargs):
+        commands = []
+        for name, app_name in sorted(get_commands().items()):
+            try:
+                cmd = load_command_class(app_name, name)
+                parser = cmd.create_parser("manage.py", name)
+            except Exception:  # pragma: no cover - command import issues
+                continue
+            args = []
+            options = []
+            for action in parser._actions:
+                if isinstance(action, argparse._HelpAction):
+                    continue
+                if action.option_strings:
+                    options.append(
+                        {
+                            "opts": ", ".join(action.option_strings),
+                            "help": action.help or "",
+                        }
+                    )
+                else:
+                    args.append(
+                        {
+                            "name": action.metavar or action.dest,
+                            "help": action.help or "",
+                        }
+                    )
+            commands.append(
+                {
+                    "name": name,
+                    "help": getattr(cmd, "help", ""),
+                    "args": args,
+                    "options": options,
+                }
+            )
+        return super().get_context_data(**{**kwargs, "commands": commands})

{arthexis-0.1.7 → arthexis-0.1.8}/core/models.py

@@ -17,6 +17,7 @@ from django.contrib.contenttypes.models import ContentType
 import hashlib
 import os
 import subprocess
+import secrets
 from io import BytesIO
 from django.core.files.base import ContentFile
 import qrcode
@@ -1153,14 +1154,30 @@ class Package(Entity):
     release_manager = models.ForeignKey(
         ReleaseManager, on_delete=models.SET_NULL, null=True, blank=True
     )
+    is_active = models.BooleanField(
+        default=False,
+        help_text="Designates the active package for version comparisons",
+    )
 
     class Meta:
         verbose_name = "Package"
         verbose_name_plural = "Packages"
+        constraints = [
+            models.UniqueConstraint(
+                fields=("is_active",),
+                condition=models.Q(is_active=True),
+                name="unique_active_package",
+            )
+        ]
 
     def __str__(self) -> str:  # pragma: no cover - trivial
         return self.name
 
+    def save(self, *args, **kwargs):
+        if self.is_active:
+            type(self).objects.exclude(pk=self.pk).update(is_active=False)
+        super().save(*args, **kwargs)
+
     def to_package(self) -> ReleasePackage:
         """Return a :class:`ReleasePackage` instance from package data."""
         return ReleasePackage(
@@ -1250,11 +1267,13 @@ class PackageRelease(Entity):
 
     @property
     def is_current(self) -> bool:
-        """Return ``True`` if this release matches the current revision."""
-        from utils import revision as revision_utils
-
-        current = revision_utils.get_revision()
-        return bool(current) and current == self.revision
+        """Return ``True`` when this release's version matches the VERSION file
+        and its package is active."""
+        version_path = Path("VERSION")
+        if not version_path.exists():
+            return False
+        current_version = version_path.read_text().strip()
+        return current_version == self.version and self.package.is_active
 
     @classmethod
     def latest(cls):
@@ -1316,3 +1335,54 @@ def _rfid_unique_energy_account(sender, instance, action, reverse, model, pk_set
             ).exclude(energy_accounts=instance)
             if conflict.exists():
                 raise ValidationError("RFID tags may only be assigned to one energy account.")
+
+
+def hash_key(key: str) -> str:
+    """Return a SHA-256 hash for ``key``."""
+
+    return hashlib.sha256(key.encode()).hexdigest()
+
+
+class ChatProfile(models.Model):
+    """Stores a hashed user key used by the assistant for authentication.
+
+    The plain-text ``user_key`` is generated server-side and shown only once.
+    Users must supply this key in the ``Authorization: Bearer <user_key>``
+    header when requesting protected endpoints. Only the hash is stored.
+    """
+
+    id = models.UUIDField(primary_key=True, default=uuid.uuid4, editable=False)
+    user = models.OneToOneField(
+        settings.AUTH_USER_MODEL, on_delete=models.CASCADE, related_name="chat_profile"
+    )
+    user_key_hash = models.CharField(max_length=64, unique=True)
+    scopes = models.JSONField(default=list, blank=True)
+    created_at = models.DateTimeField(auto_now_add=True)
+    last_used_at = models.DateTimeField(null=True, blank=True)
+    is_active = models.BooleanField(default=True)
+
+    class Meta:
+        db_table = "workgroup_chatprofile"
+        verbose_name = "Chat Profile"
+        verbose_name_plural = "Chat Profiles"
+
+    @classmethod
+    def issue_key(cls, user) -> tuple["ChatProfile", str]:
+        """Create or update a profile and return it with a new plain key."""
+
+        key = secrets.token_hex(32)
+        key_hash = hash_key(key)
+        profile, _ = cls.objects.update_or_create(
+            user=user,
+            defaults={"user_key_hash": key_hash, "last_used_at": None, "is_active": True},
+        )
+        return profile, key
+
+    def touch(self) -> None:
+        """Record that the key was used."""
+
+        self.last_used_at = timezone.now()
+        self.save(update_fields=["last_used_at"])
+
+    def __str__(self) -> str:  # pragma: no cover - simple representation
+        return f"ChatProfile for {self.user}"