Onboarding
authorRadek Czajka <rczajka@rczajka.pl>
Wed, 2 Sep 2026 13:38:22 +0000 (15:38 +0200)
committerRadek Czajka <rczajka@rczajka.pl>
Wed, 2 Sep 2026 13:38:22 +0000 (15:38 +0200)
13 files changed:
Dockerfile
src/accounts/admin.py [new file with mode: 0644]
src/accounts/forms.py
src/accounts/locale/pl/LC_MESSAGES/django.mo
src/accounts/locale/pl/LC_MESSAGES/django.po
src/accounts/migrations/0004_onboarding_email.py [new file with mode: 0644]
src/accounts/models.py
src/accounts/templates/account/base.html
src/accounts/templates/account/onboarding.html [new file with mode: 0644]
src/accounts/templates/admin/accounts/user/change_form.html [new file with mode: 0644]
src/accounts/templates/admin/accounts/user/send_onboarding_email.html [new file with mode: 0644]
src/accounts/urls.py
src/accounts/views.py

index 06bcb83..39b00f1 100644 (file)
@@ -10,6 +10,7 @@ WORKDIR /app/src
 
 FROM base AS dev
 
+RUN apk add --no-cache gettext
 RUN pip install --no-cache-dir coverage
 
 
diff --git a/src/accounts/admin.py b/src/accounts/admin.py
new file mode 100644 (file)
index 0000000..83d3c66
--- /dev/null
@@ -0,0 +1,80 @@
+from django.contrib import admin, messages
+from django.contrib.auth.admin import UserAdmin as BaseUserAdmin
+from django.contrib.auth.models import User
+from django.core.mail import send_mail
+from django.http import HttpResponseRedirect
+from django.template.response import TemplateResponse
+from django.urls import path, reverse
+from django.utils.translation import gettext_lazy as _
+from .models import OnboardingEmail
+
+
+@admin.register(OnboardingEmail)
+class OnboardingEmailAdmin(admin.ModelAdmin):
+    list_display = ('subject',)
+
+
+admin.site.unregister(User)
+
+
+@admin.register(User)
+class UserAdmin(BaseUserAdmin):
+    change_form_template = 'admin/accounts/user/change_form.html'
+
+    def get_urls(self):
+        urls = super().get_urls()
+        custom_urls = [
+            path(
+                '<id>/send-onboarding-email/',
+                self.admin_site.admin_view(self.send_onboarding_email_view),
+                name='accounts_user_send_onboarding_email',
+            ),
+        ]
+        return custom_urls + urls
+
+    def send_onboarding_email_view(self, request, id):
+        user = self.get_object(request, id)
+        if user is None:
+            return self._get_obj_does_not_exist_redirect(request, User._meta, id)
+
+        if request.method == 'POST':
+            template = OnboardingEmail.objects.first()
+            if not template:
+                messages.error(request, _("No onboarding email template configured."))
+            else:
+                # Generate new password
+                password = User.objects.make_random_password(length=12)
+                user.set_password(password)
+                user.save()
+
+                body = template.body.format(
+                    username=user.username,
+                    password=password,
+                    first_name=user.first_name,
+                    last_name=user.last_name,
+                )
+                send_mail(
+                    template.subject,
+                    body,
+                    None,
+                    [user.email],
+                )
+                messages.success(
+                    request,
+                    _("Onboarding email sent to %(email)s. Password has been reset.") % {'email': user.email}
+                )
+            return HttpResponseRedirect(
+                reverse('admin:auth_user_change', args=[user.pk])
+            )
+
+        context = {
+            **self.admin_site.each_context(request),
+            'opts': self.model._meta,
+            'user_obj': user,
+            'title': _("Send onboarding email"),
+        }
+        return TemplateResponse(
+            request,
+            'admin/accounts/user/send_onboarding_email.html',
+            context,
+        )
index 0c8cb66..5a1b62e 100644 (file)
@@ -1,5 +1,6 @@
 from django import forms
 from django.contrib.auth.models import User
+from django.utils.translation import gettext_lazy as _
 
 
 class UserBasicForm(forms.ModelForm):
@@ -8,3 +9,20 @@ class UserBasicForm(forms.ModelForm):
         model = User
         fields = ('first_name', 'last_name', 'email',)
 
+
+class OnboardingForm(forms.Form):
+    first_name = forms.CharField(label=_("First name"), max_length=150)
+    last_name = forms.CharField(label=_("Last name"), max_length=150)
+    email = forms.EmailField(label=_("External email"))
+    username = forms.CharField(
+        label=_("Username"),
+        max_length=150,
+        help_text=_("Auto-generated from first and last name")
+    )
+
+    def clean_username(self):
+        username = self.cleaned_data['username']
+        if User.objects.filter(username=username).exists():
+            raise forms.ValidationError(_("User with this username already exists."))
+        return username
+
index f75b1fd..a7ed699 100644 (file)
Binary files a/src/accounts/locale/pl/LC_MESSAGES/django.mo and b/src/accounts/locale/pl/LC_MESSAGES/django.mo differ
index a5fdb8e..828ce47 100644 (file)
@@ -155,3 +155,104 @@ msgstr "Resetowanie hasła"
 #: accounts/views.py:18
 msgid "Profile has been changed."
 msgstr "Profil został zmieniony."
+
+#: accounts/models.py
+msgid "subject"
+msgstr "temat"
+
+#: accounts/models.py
+msgid "body"
+msgstr "treść"
+
+#: accounts/models.py
+msgid "Available placeholders: {username}, {password}, {first_name}, {last_name}"
+msgstr "Dostępne zmienne: {username}, {password}, {first_name}, {last_name}"
+
+#: accounts/models.py
+msgid "onboarding email template"
+msgstr "szablon maila onboardingowego"
+
+#: accounts/models.py
+msgid "onboarding email templates"
+msgstr "szablony maili onboardingowych"
+
+#: accounts/forms.py
+msgid "First name"
+msgstr "Imię"
+
+#: accounts/forms.py
+msgid "Last name"
+msgstr "Nazwisko"
+
+#: accounts/forms.py
+msgid "External email"
+msgstr "Zewnętrzny email"
+
+#: accounts/forms.py
+msgid "Username"
+msgstr "Login"
+
+#: accounts/forms.py
+msgid "Auto-generated from first and last name"
+msgstr "Generowany automatycznie z imienia i nazwiska"
+
+#: accounts/forms.py
+msgid "User with this username already exists."
+msgstr "Użytkownik o tym loginie już istnieje."
+
+#: accounts/views.py
+msgid "User %(username)s has been created and email sent to %(email)s."
+msgstr "Użytkownik %(username)s został utworzony i wysłano email na %(email)s."
+
+#: accounts/views.py
+msgid "User %(username)s has been created, but no email template is configured."
+msgstr "Użytkownik %(username)s został utworzony, ale brak skonfigurowanego szablonu maila."
+
+#: accounts/templates/account/onboarding.html
+msgid "User onboarding"
+msgstr "Onboarding użytkownika"
+
+#: accounts/templates/account/onboarding.html
+msgid "Create user"
+msgstr "Utwórz użytkownika"
+
+#: accounts/templates/account/base.html
+msgid "Onboarding"
+msgstr "Onboarding"
+
+#: accounts/admin.py
+msgid "No onboarding email template configured."
+msgstr "Brak skonfigurowanego szablonu maila onboardingowego."
+
+#: accounts/admin.py
+msgid "Onboarding email sent to %(email)s. Password has been reset."
+msgstr "Mail onboardingowy wysłany na %(email)s. Hasło zostało zresetowane."
+
+#: accounts/admin.py
+msgid "Send onboarding email"
+msgstr "Wyślij mail onboardingowy"
+
+#: accounts/templates/admin/accounts/user/send_onboarding_email.html
+msgid "Home"
+msgstr "Strona główna"
+
+#: accounts/templates/admin/accounts/user/send_onboarding_email.html
+msgid "Authentication and Authorization"
+msgstr "Uwierzytelnianie i autoryzacja"
+
+#: accounts/templates/admin/accounts/user/send_onboarding_email.html
+msgid "Users"
+msgstr "Użytkownicy"
+
+#: accounts/templates/admin/accounts/user/send_onboarding_email.html
+#, python-format
+msgid "Are you sure you want to send an onboarding email to user \"%(username)s\" (%(email)s)?"
+msgstr "Czy na pewno chcesz wysłać mail onboardingowy do użytkownika \"%(username)s\" (%(email)s)?"
+
+#: accounts/templates/admin/accounts/user/send_onboarding_email.html
+msgid "This will generate a new password and send it to the user's email address."
+msgstr "Spowoduje to wygenerowanie nowego hasła i wysłanie go na adres email użytkownika."
+
+#: accounts/templates/admin/accounts/user/send_onboarding_email.html
+msgid "Cancel"
+msgstr "Anuluj"
diff --git a/src/accounts/migrations/0004_onboarding_email.py b/src/accounts/migrations/0004_onboarding_email.py
new file mode 100644 (file)
index 0000000..3cfb039
--- /dev/null
@@ -0,0 +1,27 @@
+# Generated by Django 4.2.16 on 2026-09-02 13:16
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+        ('accounts', '0003_auto_20190330_1311'),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='OnboardingEmail',
+            fields=[
+                ('id', models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('subject', models.CharField(max_length=255, verbose_name='subject')),
+                ('body', models.TextField(help_text='Available placeholders: {username}, {password}, {first_name}, {last_name}', verbose_name='body')),
+            ],
+            options={
+                'verbose_name': 'onboarding email template',
+                'verbose_name_plural': 'onboarding email templates',
+            },
+        ),
+    ]
index b0be8d4..0197eba 100644 (file)
@@ -1,6 +1,20 @@
+from django.db import models
+from django.utils.translation import gettext_lazy as _
 from cas_provider.signals import cas_collect_custom_attributes
 
 
+class OnboardingEmail(models.Model):
+    subject = models.CharField(_("subject"), max_length=255)
+    body = models.TextField(
+        _("body"),
+        help_text=_("Available placeholders: {username}, {password}, {first_name}, {last_name}")
+    )
+
+    class Meta:
+        verbose_name = _("onboarding email template")
+        verbose_name_plural = _("onboarding email templates")
+
+
 def user_attributes(sender, user, **kwargs):
     return {
         'firstname': user.first_name,
index 8e9245e..a8b7ad5 100644 (file)
       {% if use_ssh %}
         <p><a {% if menu == 'ssh' %}class="active"{% endif %} href="{% url 'ssh_keys' %}">{% trans "SSH keys" %}</a></p>
       {% endif %}
+      {% if perms.auth.add_user %}
+        <p><a {% if menu == 'onboarding' %}class="active"{% endif %} href="{% url 'onboarding' %}">{% trans "Onboarding" %}</a></p>
+      {% endif %}
     {% endblock %}
-
     {% if request.user.is_staff %}
       <p><a href='/admin/'>{% trans "Administration" %}</a></p>
     {% endif %}
diff --git a/src/accounts/templates/account/onboarding.html b/src/accounts/templates/account/onboarding.html
new file mode 100644 (file)
index 0000000..7370785
--- /dev/null
@@ -0,0 +1,74 @@
+{% extends "account/base.html" %}
+{% load i18n %}
+
+
+{% block title %}{% trans "User onboarding" %}{% endblock %}
+
+
+{% block menu %}
+  {% with menu="onboarding" %}
+    {{ block.super }}
+  {% endwith %}
+{% endblock %}
+
+
+{% block accounts-content %}
+  <h1>{% trans "User onboarding" %}</h1>
+  <form method="post">
+    {% csrf_token %}
+    {% if form.non_field_errors %}
+      <div class="alert alert-danger">
+        {{ form.non_field_errors }}
+      </div>
+    {% endif %}
+    <p>
+      <label for="id_first_name">{{ form.first_name.label }}</label>
+      {{ form.first_name }}
+      {% if form.first_name.errors %}<span class="text-danger">{{ form.first_name.errors }}</span>{% endif %}
+    </p>
+    <p>
+      <label for="id_last_name">{{ form.last_name.label }}</label>
+      {{ form.last_name }}
+      {% if form.last_name.errors %}<span class="text-danger">{{ form.last_name.errors }}</span>{% endif %}
+    </p>
+    <p>
+      <label for="id_email">{{ form.email.label }}</label>
+      {{ form.email }}
+      {% if form.email.errors %}<span class="text-danger">{{ form.email.errors }}</span>{% endif %}
+    </p>
+    <p>
+      <label for="id_username">{{ form.username.label }}</label>
+      {{ form.username }}
+      <small class="text-muted">{{ form.username.help_text }}</small>
+      {% if form.username.errors %}<span class="text-danger">{{ form.username.errors }}</span>{% endif %}
+    </p>
+    <p><button type="submit" class="btn btn-primary">{% trans "Create user" %}</button></p>
+  </form>
+
+  <script>
+    (function() {
+      const firstNameInput = document.getElementById('id_first_name');
+      const lastNameInput = document.getElementById('id_last_name');
+      const usernameInput = document.getElementById('id_username');
+
+      function removeDiacritics(str) {
+        return str.normalize('NFD').replace(/[\u0300-\u036f]/g, '');
+      }
+
+      function generateUsername() {
+        const firstName = firstNameInput.value || '';
+        const lastName = lastNameInput.value || '';
+        const combined = firstName + lastName;
+        const normalized = removeDiacritics(combined);
+        const ascii = normalized.replace(/[^a-zA-Z]/g, '');
+        usernameInput.value = ascii.toLowerCase();
+      }
+
+      firstNameInput.addEventListener('input', generateUsername);
+      lastNameInput.addEventListener('input', generateUsername);
+
+      // Generate on page load if values exist
+      generateUsername();
+    })();
+  </script>
+{% endblock %}
diff --git a/src/accounts/templates/admin/accounts/user/change_form.html b/src/accounts/templates/admin/accounts/user/change_form.html
new file mode 100644 (file)
index 0000000..ffeffee
--- /dev/null
@@ -0,0 +1,11 @@
+{% extends "admin/change_form.html" %}
+{% load i18n admin_urls %}
+
+{% block object-tools-items %}
+{{ block.super }}
+{% if original %}
+<li>
+    <a href="{% url 'admin:accounts_user_send_onboarding_email' original.pk %}">{% trans "Send onboarding email" %}</a>
+</li>
+{% endif %}
+{% endblock %}
diff --git a/src/accounts/templates/admin/accounts/user/send_onboarding_email.html b/src/accounts/templates/admin/accounts/user/send_onboarding_email.html
new file mode 100644 (file)
index 0000000..b903901
--- /dev/null
@@ -0,0 +1,25 @@
+{% extends "admin/base_site.html" %}
+{% load i18n admin_urls %}
+
+{% block breadcrumbs %}
+<div class="breadcrumbs">
+<a href="{% url 'admin:index' %}">{% trans 'Home' %}</a>
+&rsaquo; <a href="{% url 'admin:app_list' app_label='auth' %}">{% trans 'Authentication and Authorization' %}</a>
+&rsaquo; <a href="{% url 'admin:auth_user_changelist' %}">{% trans 'Users' %}</a>
+&rsaquo; <a href="{% url 'admin:auth_user_change' user_obj.pk %}">{{ user_obj }}</a>
+&rsaquo; {% trans "Send onboarding email" %}
+</div>
+{% endblock %}
+
+{% block content %}
+<p>{% blocktrans with username=user_obj.username email=user_obj.email %}Are you sure you want to send an onboarding email to user "{{ username }}" ({{ email }})?{% endblocktrans %}</p>
+<p>{% trans "This will generate a new password and send it to the user's email address." %}</p>
+
+<form method="post">
+{% csrf_token %}
+<div class="submit-row">
+    <input type="submit" value="{% trans 'Send onboarding email' %}">
+    <a href="{% url 'admin:auth_user_change' user_obj.pk %}" class="button cancel-link">{% trans "Cancel" %}</a>
+</div>
+</form>
+{% endblock %}
index 51f344e..dbea95e 100644 (file)
@@ -4,4 +4,5 @@ from . import views
 
 urlpatterns = [
     path('', views.ProfileView.as_view(), name='accounts_profile'),
+    path('onboarding/', views.OnboardingView.as_view(), name='onboarding'),
 ]
index 1b4a705..a8ebfca 100644 (file)
@@ -1,8 +1,12 @@
-from django.contrib.auth.mixins import LoginRequiredMixin
+from django.contrib.auth.mixins import LoginRequiredMixin, PermissionRequiredMixin
+from django.contrib.auth.models import User
 from django.contrib import messages
+from django.core.mail import send_mail
+from django.urls import reverse_lazy
 from django.utils.translation import gettext as _
-from django.views.generic.edit import UpdateView
-from accounts.forms import UserBasicForm
+from django.views.generic.edit import UpdateView, FormView
+from accounts.forms import UserBasicForm, OnboardingForm
+from accounts.models import OnboardingEmail
 
 
 class ProfileView(LoginRequiredMixin, UpdateView):
@@ -17,3 +21,55 @@ class ProfileView(LoginRequiredMixin, UpdateView):
         retval = super().form_valid(form)
         messages.add_message(self.request, messages.INFO, _("Profile has been changed."))
         return retval
+
+
+class OnboardingView(PermissionRequiredMixin, FormView):
+    permission_required = 'auth.add_user'
+    form_class = OnboardingForm
+    template_name = "account/onboarding.html"
+    success_url = reverse_lazy('onboarding')
+
+    def form_valid(self, form):
+        # Generate random password
+        password = User.objects.make_random_password(length=12)
+
+        # Create user
+        user = User.objects.create_user(
+            username=form.cleaned_data['username'],
+            email=form.cleaned_data['email'],
+            password=password,
+            first_name=form.cleaned_data['first_name'],
+            last_name=form.cleaned_data['last_name'],
+        )
+
+        # Send onboarding email
+        template = OnboardingEmail.objects.first()
+        if template:
+            body = template.body.format(
+                username=user.username,
+                password=password,
+                first_name=user.first_name,
+                last_name=user.last_name,
+            )
+            send_mail(
+                template.subject,
+                body,
+                None,  # Use DEFAULT_FROM_EMAIL
+                [form.cleaned_data['email']],
+            )
+            messages.success(
+                self.request,
+                _("User %(username)s has been created and email sent to %(email)s.") % {
+                    'username': user.username,
+                    'email': form.cleaned_data['email'],
+                }
+            )
+        else:
+            messages.warning(
+                self.request,
+                _("User %(username)s has been created, but no email template is configured.") % {
+                    'username': user.username,
+                }
+            )
+
+        return super().form_valid(form)