feat: add invitation flow to invite users

This allows bringing in users for newly created subscription.

Author: nijel

weblate_web/crm/forms.py

@@ -42,6 +42,11 @@ class ManualInteractionForm(forms.Form):
     )
 
 
+class CustomerUserForm(forms.Form):
+    email = forms.EmailField(label=gettext_lazy("E-mail"))
+    full_name = forms.CharField(label=gettext_lazy("Full name"), max_length=150)
+
+
 class ServiceMaintenanceWindowForm(forms.ModelForm):
     class Meta:
         model = Service

weblate_web/crm/hosted.py

@@ -0,0 +1,86 @@
+#
+# Copyright © Michal Čihař <michal@weblate.org>
+#
+# This file is part of Weblate <https://weblate.org/>
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <https://www.gnu.org/licenses/>.
+#
+
+from __future__ import annotations
+
+from typing import Any
+
+import requests
+from django.conf import settings
+from django.core.signing import BadSignature, SignatureExpired, dumps, loads
+from django.utils.translation import gettext
+
+USER_ENSURE_SALT = "weblate.user-ensure"
+USER_ENSURE_RESPONSE_SALT = "weblate.user-ensure-response"
+INVALID_HOSTED_USER_RESPONSE = "Invalid hosted user response"
+
+
+class HostedUserEnsureError(RuntimeError):
+    """Hosted user provisioning failed."""
+
+
+def raise_invalid_hosted_user_response() -> None:
+    raise HostedUserEnsureError(gettext(INVALID_HOSTED_USER_RESPONSE))
+
+
+def ensure_hosted_user(email: str, full_name: str) -> tuple[dict[str, Any], bool]:
+    if not settings.PAYMENT_SECRET:
+        raise HostedUserEnsureError(gettext("Hosted user synchronization is disabled."))
+
+    try:
+        response = requests.post(
+            settings.HOSTED_USER_CREATE_API,
+            data={
+                "payload": dumps(
+                    {"email": email, "full_name": full_name},
+                    key=settings.PAYMENT_SECRET,
+                    salt=USER_ENSURE_SALT,
+                )
+            },
+            timeout=60,
+        )
+        response.raise_for_status()
+    except requests.RequestException as error:
+        raise HostedUserEnsureError(str(error)) from error
+
+    try:
+        response_payload = response.json()
+    except ValueError as error:
+        raise HostedUserEnsureError(gettext(INVALID_HOSTED_USER_RESPONSE)) from error
+    if not isinstance(response_payload, dict):
+        raise_invalid_hosted_user_response()
+    signed_payload = response_payload.get("payload")
+    if not isinstance(signed_payload, str):
+        raise_invalid_hosted_user_response()
+
+    try:
+        payload = loads(
+            signed_payload,
+            key=settings.PAYMENT_SECRET,
+            max_age=300,
+            salt=USER_ENSURE_RESPONSE_SALT,
+        )
+    except (BadSignature, SignatureExpired) as error:
+        raise HostedUserEnsureError(gettext(INVALID_HOSTED_USER_RESPONSE)) from error
+    if not isinstance(payload, dict):
+        raise_invalid_hosted_user_response()
+    user_payload = payload.get("user")
+    if not isinstance(user_payload, dict):
+        raise_invalid_hosted_user_response()
+    return user_payload, bool(payload.get("created"))

weblate_web/crm/templates/payments/customer_detail.html

@@ -52,6 +52,12 @@ <h2>Actions</h2>
       </label>
       <input type="submit" value="Review merge">
     </form>
+    <form method="post">
+      <p>{% translate "Add user to customer" %}</p>
+      {% csrf_token %}
+      {{ customer_user_form }}
+      <input type="submit" name="add_customer_user" value="{% translate "Add user" %}">
+    </form>
 
     <h2>Services</h2>
     {% include "weblate_web/service_list_content.html" with object_list=services %}