arthexis 0.1.7__py3-none-any.whl → 0.1.8__py3-none-any.whl

{arthexis-0.1.7.dist-info → arthexis-0.1.8.dist-info}/METADATA

@@ -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.dist-info → arthexis-0.1.8.dist-info}/RECORD

@@ -1,4 +1,4 @@
-arthexis-0.1.7.dist-info/licenses/LICENSE,sha256=rBjcKtvD5yIpzAnkw3XRofK8KCAeL43DXmNaiRuYJrg,1092
+arthexis-0.1.8.dist-info/licenses/LICENSE,sha256=rBjcKtvD5yIpzAnkw3XRofK8KCAeL43DXmNaiRuYJrg,1092
 config/__init__.py,sha256=5EyLFDrM6aTOHSnyBcLXRvMInZMPmAAy9Icu0cHHK5o,110
 config/active_app.py,sha256=MET_G7oHL7GkoSo3VkkMzymM-PwsSZazMLZxpgjFLTo,388
 config/asgi.py,sha256=n09URedOmQ_59II3UCl3iodGSDWOuN_A8DFyfLjuylA,803
@@ -10,12 +10,13 @@ config/loadenv.py,sha256=bhFbHTbRJSkSwrFk3UInKEKQ8ZY-poatOGi7rC57YAI,298
 config/logging.py,sha256=334jADN4dM5GNHaCWlYPOKYa5BhfxbsuejH_QDALG6g,1793
 config/middleware.py,sha256=EvraDumepnKwCDswHGXb1mK7vud_dEEoZ4eh0IQ7fhQ,744
 config/offline.py,sha256=7XHGFlV7IAWUJ93dEjknrHkAHDEyzWxK_hj_ht4-6-Q,1427
-config/settings.py,sha256=hyqTxQhVh1UYMRxZVuPil32IChJEvthJ7hkh2UGVehI,10897
-config/urls.py,sha256=mgC0PqY1JBH6GdOxM6A_p5rDzx9vDoEVAOrH36DWSB4,2991
+config/settings.py,sha256=FN0lZfKFnp0fy3uV-ev3068wNWRKjNLOyFTUlE0Omz4,10922
+config/urls.py,sha256=qUTXHIyfe74QljKtvGyEyK6ber1lo2PcHEK88RGagT4,3273
 config/workgroup_app.py,sha256=rm6KrjxtRNdkrxl2_in9FAaHpIltRUhpDrt4tP9yanE,202
 config/wsgi.py,sha256=Fu-ONO2SgYeU6rhmy909P-uLX-n8ALJQObdm9MHPS-k,450
 core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-core/admin.py,sha256=bKncxl6b_dEPXfbIbJYMMF6Nf3a6Su6IZ7ymzy_RD8Q,29687
+core/admin.py,sha256=XRnmIdFQ14KiQK2p9AAblmGQWSJUVXFc1cNBiybeAt4,34352
+core/admindocs.py,sha256=uGM55KYZhHKViaNgqTqiIeRe6Y_87BfIE1DwmsbNMj4,1663
 core/apps.py,sha256=5wmxTrED-4WBWA0khEpqVAUH7V-g7DLtPDNEtSINnSM,2617
 core/backends.py,sha256=f8gb5D3_f8sM6UJop0aS8TAkrkh14NaP0JrqTcT_L3Y,2686
 core/checks.py,sha256=sRIA9tYAKXO6kJf96ADFrkYyvp47gYqv18Y12vukUqg,931
@@ -24,16 +25,18 @@ core/environment.py,sha256=QcOshpWNG0l_agW-b9efNvVFKqdatj6sUK8FT6p92gU,1238
 core/fields.py,sha256=uS5nDozL6IsTAbjg08VcOB8K85e0XROUYCBAOIfAcPE,2127
 core/lcd_screen.py,sha256=7iSg8OZMK8qHGM1FVOwbgsWCogEe5eR6mie-A5YQKY4,2649
 core/middleware.py,sha256=utMGESBrR-rHRV5_q1X2g2wnmpziaUcc9jGzoZwvqqQ,1258
-core/models.py,sha256=_Ng5pxlF2gTKzHd4si1t7r312sj--Zk3AOArCQ8BZbA,44518
+core/models.py,sha256=RrWPU5JpLBXehN1vJvKMFyuRWu7ko25MVD_KS10g7EQ,47095
 core/notifications.py,sha256=w9rPCsZfZNSoBUH-1KVe9Yr8LvG9vtkgmzw3DKLcDoM,3787
 core/release.py,sha256=DzK44yr7vkAK_xzDeejVFwQnkE23yqWvmIWZHQZ1nwI,11003
 core/system.py,sha256=EVvxYxnmJ1Wn-XIkt8pk2E0Rr8poRozkZ218E3TNHCY,3504
 core/tasks.py,sha256=Q4QweRlhahbXYEeL9ytlyQWwWQFP63q-ZY_fN0EXwtg,3145
 core/test_system_info.py,sha256=AXo-HqTLMyOpsQIShDDzyl_nMHOyKbAIuNr9fYZzoKg,605
-core/tests.py,sha256=6dZ3CvAZ5fg7t5a11OsPktNfjRH-Fk8HDTPIRVhXWkg,26581
+core/tests.py,sha256=kDdHDlsUJot4CucYZWM3THAtYqpvo1dQDUukqJVspCU,30281
 core/urls.py,sha256=pBkcWdiA0Aag7z4UOu7HT4Im4ghPPfBZKeogmoO0H5U,406
 core/user_data.py,sha256=pfi4fgHl0CosG9jkfe__bSNN-Knhnzp7UirnCT_tae8,12029
 core/views.py,sha256=-4k3YSv9RfsAY14aLXkngzjXT0yyXD90D6KOJ3cwSLQ,16137
+core/workgroup_urls.py,sha256=1jo3Oay26lU45LYk5kMfU0667xRsA16rILK8DZmvO6U,331
+core/workgroup_views.py,sha256=ku9i--ilN8o9fDzjo8WhqaIjMU3TqAN48w60k-WJHpg,1753
 nodes/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 nodes/actions.py,sha256=2QOtRdhm__4f0Pgy3n2tg9HCbS47ZK9qBdTXJ9YZJfA,2339
 nodes/admin.py,sha256=a-LAbgNG-0QHA8Og24fslyPyze_kPKhuUs3syAVbNr4,21824
@@ -47,7 +50,7 @@ nodes/utils.py,sha256=aVEHtoisHyhWe_Fy2KPiP24Fs0wELtQMyfs4JGYnkuY,2320
 nodes/views.py,sha256=LISm9jqIdyUwQm45PegGg8RvmGRZH1jvCTCC14owRdQ,8444
 ocpp/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 ocpp/admin.py,sha256=9A_uLUg7l9DiqJq1foy47oFLb7zPuBOJeS73p7l0M0k,11851
-ocpp/apps.py,sha256=Hja6uavSO4Srbp7kZmp0yGuhEq1abKBhH004QcUG90I,759
+ocpp/apps.py,sha256=wFRuhGMuFi_6pqBZGNU0V18Xs4-b1ARLv4Bik8ezffY,868
 ocpp/consumers.py,sha256=ykAkAicHRmn_qfUTp6psNUFkDrOnzuJfnHca9vgJLQI,11768
 ocpp/evcs.py,sha256=ZQKLqN8yJ4IOdedVt1z_gz_2eXBPdHHPvgxU2NkWgpw,33333
 ocpp/models.py,sha256=5g6JDdaLtX07jbuuJAbwPi-Z58LuCR25XjJHh7oe8kk,10367
@@ -71,7 +74,7 @@ pages/tests.py,sha256=B3MX2du5aZ8NztR-e8pTbypXTqhA-_NHZMy6O_OuqWE,28022
 pages/urls.py,sha256=glhQExK2vVLzzvaRypWfmMdnggBrpjlxCaN1BUbC_MY,457
 pages/utils.py,sha256=bCcjku0mQhzgvTR46QwQgyc8YnSS7VumC6Qv968aCic,313
 pages/views.py,sha256=lkgx2X2AwOGa_URCRVCxju_z_uG1_xW43PUNmjOEibU,7993
-arthexis-0.1.7.dist-info/METADATA,sha256=UpY_iJF5Qcumd_YWTnqBZXZDVLl1lG8k4Chpf95Zeuo,4458
-arthexis-0.1.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-arthexis-0.1.7.dist-info/top_level.txt,sha256=J2a2q8_BWrCZ8H2WFUNMBfO2jz8j2gax6zZh-_1QDac,29
-arthexis-0.1.7.dist-info/RECORD,,
+arthexis-0.1.8.dist-info/METADATA,sha256=ZdIS51Qh3wyywvXkAoXyxCJLWCZmAUh-bhka8OohwRI,5383
+arthexis-0.1.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+arthexis-0.1.8.dist-info/top_level.txt,sha256=J2a2q8_BWrCZ8H2WFUNMBfO2jz8j2gax6zZh-_1QDac,29
+arthexis-0.1.8.dist-info/RECORD,,

config/settings.py

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

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")),
 ]
 

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()

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})

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}"

core/tests.py

@@ -30,7 +30,7 @@ from .models import (
     PackageRelease,
 )
 from django.contrib.admin.sites import AdminSite
-from core.admin import PackageReleaseAdmin
+from core.admin import PackageReleaseAdmin, PackageAdmin
 from ocpp.models import Transaction, Charger
 
 from django.core.exceptions import ValidationError
@@ -647,7 +647,8 @@ class ReleaseProcessTests(TestCase):
             self.client.get(f"{url}?step=0")
             self.assertEqual(run, ["step", "step"])
             self.client.get(f"{url}?restart=1")
-            self.assertEqual(count_file.read_text(), "2")
+            # Restart counter resets after running a step
+            self.assertEqual(count_file.read_text(), "1")
 
 
 class PackageReleaseAdminActionTests(TestCase):
@@ -680,3 +681,94 @@ class PackageReleaseAdminActionTests(TestCase):
         self.assertEqual(PackageRelease.objects.count(), 1)
         dump.assert_not_called()
 
+    @mock.patch("core.admin.PackageRelease.dump_fixture")
+    @mock.patch("core.admin.requests.get")
+    def test_refresh_from_pypi_creates_releases(self, mock_get, dump):
+        mock_get.return_value.raise_for_status.return_value = None
+        mock_get.return_value.json.return_value = {
+            "releases": {"1.0.0": [], "1.1.0": []}
+        }
+        self.admin.refresh_from_pypi(
+            self.request, PackageRelease.objects.none()
+        )
+        self.assertTrue(
+            PackageRelease.objects.filter(version="1.1.0").exists()
+        )
+        dump.assert_called_once()
+
+
+class PackageActiveTests(TestCase):
+    def test_only_one_active_package(self):
+        default = Package.objects.get(name="arthexis")
+        self.assertTrue(default.is_active)
+        other = Package.objects.create(name="pkg", is_active=True)
+        default.refresh_from_db()
+        other.refresh_from_db()
+        self.assertFalse(default.is_active)
+        self.assertTrue(other.is_active)
+
+
+class PackageReleaseCurrentTests(TestCase):
+    def setUp(self):
+        self.package = Package.objects.get(name="arthexis")
+        self.version_path = Path("VERSION")
+        self.original = self.version_path.read_text()
+        self.version_path.write_text("1.0.0")
+        self.release = PackageRelease.objects.create(
+            package=self.package, version="1.0.0"
+        )
+
+    def tearDown(self):
+        self.version_path.write_text(self.original)
+
+    def test_is_current_true_when_version_matches_and_package_active(self):
+        self.assertTrue(self.release.is_current)
+
+    def test_is_current_false_when_package_inactive(self):
+        self.package.is_active = False
+        self.package.save()
+        self.assertFalse(self.release.is_current)
+
+    def test_is_current_false_when_version_differs(self):
+        self.release.version = "2.0.0"
+        self.release.save()
+        self.assertFalse(self.release.is_current)
+
+
+class PackageAdminPrepareNextReleaseTests(TestCase):
+    def setUp(self):
+        self.factory = RequestFactory()
+        self.site = AdminSite()
+        self.admin = PackageAdmin(Package, self.site)
+        self.admin.message_user = lambda *args, **kwargs: None
+        self.package = Package.objects.get(name="arthexis")
+
+    def test_prepare_next_release_active_creates_release(self):
+        PackageRelease.all_objects.filter(package=self.package).delete()
+        request = self.factory.get("/admin/core/package/prepare-next-release/")
+        response = self.admin.prepare_next_release_active(request)
+        self.assertEqual(response.status_code, 302)
+        self.assertEqual(
+            PackageRelease.all_objects.filter(package=self.package).count(), 1
+        )
+
+
+class PackageReleaseChangelistTests(TestCase):
+    def setUp(self):
+        self.client = Client()
+        User.objects.create_superuser("admin", "admin@example.com", "pw")
+        self.client.force_login(User.objects.get(username="admin"))
+
+    def test_prepare_next_release_button_present(self):
+        response = self.client.get(reverse("admin:core_packagerelease_changelist"))
+        self.assertContains(
+            response, reverse("admin:core_package_prepare_next_release"), html=False
+        )
+
+    def test_refresh_from_pypi_button_present(self):
+        response = self.client.get(reverse("admin:core_packagerelease_changelist"))
+        refresh_url = reverse(
+            "admin:core_packagerelease_actions", args=["refresh_from_pypi"]
+        )
+        self.assertContains(response, refresh_url, html=False)
+

core/workgroup_urls.py

@@ -0,0 +1,13 @@
+"""URL routes for chat profile endpoints."""
+
+from django.urls import path
+
+from . import workgroup_views as views
+
+app_name = "workgroup"
+
+urlpatterns = [
+    path("chat-profiles/<int:user_id>/", views.issue_key, name="chatprofile-issue"),
+    path("assistant/test/", views.assistant_test, name="assistant-test"),
+]
+

core/workgroup_views.py

@@ -0,0 +1,57 @@
+"""REST endpoints for ChatProfile issuance and authentication."""
+
+from __future__ import annotations
+
+from functools import wraps
+
+from django.contrib.auth import get_user_model
+from django.http import HttpResponse, JsonResponse
+from django.views.decorators.csrf import csrf_exempt
+from django.views.decorators.http import require_GET, require_POST
+
+from .models import ChatProfile, hash_key
+
+
+@csrf_exempt
+@require_POST
+def issue_key(request, user_id: int) -> JsonResponse:
+    """Issue a new ``user_key`` for ``user_id``.
+
+    The response reveals the plain key once. Store only the hash server-side.
+    """
+
+    user = get_user_model().objects.get(pk=user_id)
+    profile, key = ChatProfile.issue_key(user)
+    return JsonResponse({"user_id": user_id, "user_key": key})
+
+
+def authenticate(view_func):
+    """View decorator that validates the ``Authorization`` header."""
+
+    @wraps(view_func)
+    def wrapper(request, *args, **kwargs):
+        header = request.META.get("HTTP_AUTHORIZATION", "")
+        if not header.startswith("Bearer "):
+            return HttpResponse(status=401)
+
+        key_hash = hash_key(header.split(" ", 1)[1])
+        try:
+            profile = ChatProfile.objects.get(user_key_hash=key_hash, is_active=True)
+        except ChatProfile.DoesNotExist:
+            return HttpResponse(status=401)
+
+        profile.touch()
+        request.chat_profile = profile
+        return view_func(request, *args, **kwargs)
+
+    return wrapper
+
+
+@require_GET
+@authenticate
+def assistant_test(request):
+    """Return a simple greeting to confirm authentication."""
+
+    user_id = request.chat_profile.user_id
+    return JsonResponse({"message": f"Hello from user {user_id}"})
+

ocpp/apps.py

@@ -9,8 +9,9 @@ class OcppConfig(AppConfig):
     verbose_name = "3. Protocols"
 
     def ready(self):  # pragma: no cover - startup side effects
-        lock = Path(settings.BASE_DIR) / "locks" / "control.lck"
-        if not lock.exists():
+        control_lock = Path(settings.BASE_DIR) / "locks" / "control.lck"
+        rfid_lock = Path(settings.BASE_DIR) / "locks" / "rfid.lck"
+        if not (control_lock.exists() and rfid_lock.exists()):
             return
         from .rfid.background_reader import start
         from .rfid.signals import tag_scanned